home-assistant.io/source/_components/binary_sensor.modbus.markdown

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release	ha_iot_class
page	Modbus Binary Sensor	Instructions on how to set up Modbus binary sensors within Home Assistant.	2016-09-13 12:02	true	false	true	true	modbus.png	Binary Sensor	0.28	Local Push

The modbus binary sensor allows you to gather data from Modbus coils.

To use your Modbus binary sensors in your installation, add the following to your configuration.yaml file:

# Example configuration.yml entry
binary_sensor:
  - platform: modbus
    coils:
      - name: Sensor1
        slave: 1
        coil: 100
      - name: Sensor2
        slave: 1
        coil: 110

Configuration variables:

• coils array (Required): The array contains a list of coils to read from.
  • name (Required): Name of the sensor.
  • slave (Required): The number of the slave (Optional for TCP and UDP Modbus).
  • coil (Required): Coil number.

It's possible to change the default 30 seconds scan interval for the sensor updates as shown in the Platform options documentation.

{% linkable_title Full example %}

Example a sensor with a 10 seconds scan interval:

binary_sensor:
  - platform: modbus
    scan_interval: 10
    coils:
      - name: Sensor1
        slave: 1
        coil: 100
      - name: Sensor2
        slave: 1
        coil: 110