diff --git a/source/_components/switch.pencom.markdown b/source/_components/switch.pencom.markdown new file mode 100644 index 00000000000..fb26f7b3231 --- /dev/null +++ b/source/_components/switch.pencom.markdown @@ -0,0 +1,69 @@ +--- +layout: page +title: "Pencom" +description: "How to use Pencom Designs 8 channel relay boards." +date: 2018-10-05 23:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: pencom.png +ha_category: Switch +ha_release: 0.85 +ha_iot_class: "Local Polling" +--- + +[Pencom Design](http://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. + +## {% linkable_title Configuration %} + +The Pencom relays can be daisychained 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: port (positive integer between 1-65535) +boards: + description: Number of boards daisychained together (default is 1). + required: false + type: int between 1 and 8 +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: int + board: + description: The board number (defaults to 1). + required: false + type: int between 1 and 8 +{% endconfiguration %} diff --git a/source/images/supported_brands/pencom.png b/source/images/supported_brands/pencom.png new file mode 100644 index 00000000000..f09b7870786 Binary files /dev/null and b/source/images/supported_brands/pencom.png differ