sensor.modbus.markdown

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release
page	Modbus Sensor	Instructions how to integrate Modbus sensors into Home Assistant.	2015-08-30 23:38	true	false	true	true	modbus.png	Sensor	pre 0.7

The modbus sensor platform allows you to gather data from your Modbus sensors.

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

# Example configuration.yml entry
sensor:
  platform: modbus
  slave: 1
  registers:
    16:
      name: My integer sensor
      unit: C
    24:
      bits:
        0:
          name: My boolean sensor
        2:
          name: My other boolean sensor
  coils:
    0:
      name: My coil switch

Configuration variables:

• slave (Required): The number of the slave (ignored and can be omitted if not serial Modbus).
• registers array (Required): The array contains a list of relevant registers to read from.
  • number of register (Required): Listing relevant bits. It must contain a bits section.
    • bits array (Required): Listing relevant bits. It must contain a bits section.
      • name (Required): Name of the sensor.
      • unit (Required): Unit to attach to value (optional, ignored for boolean sensors).
• coils (Optional): A list of relevant coils to read from/write to
  • number of coil array (Required):
    • name (Required): Name of the coil.

Each named register will create an integer sensor and each named bit will create a boolean sensor.