---
title: Pencom
description: How to use Pencom Designs 8 channel relay boards.
ha_category:
  - Switch
ha_release: 0.85
ha_iot_class: Local Polling
ha_domain: pencom
ha_platforms:
  - switch
ha_integration_type: integration
---

[Pencom Design](https://www.pencomdesign.com/) is a manufacturer of computer-controlled relay, I/O and custom boards for commercial and industrial applications.  This interface to [Pencom's Relay Control Boards](https://www.pencomdesign.com/relay-boards) is designed to work over an ethernet to serial adapter (NPort).  Each switch (relay) can be turned on/off, and the state of the relay can be read.

## Configuration

The Pencom relays can be daisy-chained to allow for up to 8 boards.

``` yaml
# Example configuration.yaml entry
switch:
  - platform: pencom
    host: host.domain.com
    port: 4001
    boards: 2
    relays:
      - name: "Irrigation"
        addr: 0
      - name: "Upper Entry Door"
        addr: 1
      - name: "Fountain"
        addr: 0
        board: 2
```

{% configuration %}
host:
  description: The IP address of the ethernet to serial adapter.  It is assumed that the adapter has been preconfigured.
  required: true
  type: string
port:
  description: The port of the ethernet to serial adapter.
  required: true
  type: integer
boards:
  description: Number of boards daisy-chained together (default is 1).
  required: false
  type: integer
relays:
  description: List of relays.
  required: true
  type: list
  keys:
    name:
      description: The name of the switch (component).
      required: true
      type: string
    addr:
      description: The relay on the board starting with 0.
      required: true
      type: integer
    board:
      description: The board number (defaults to 1).
      required: false
      type: integer
{% endconfiguration %}