home-assistant.io/source/_components/sensor.modbus.markdown
LvivEchoes f7854d9287 Add support of modbus input registers query (#2423)
* Add support of modbus input registers query

Documentation updated according pull request.
Add support of modbus input registers query

* Update sensor.modbus.markdown

Removed some extra space.

* Update according main PR change

config option name was changed.
2017-04-21 21:15:26 -07:00

1.8 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
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 allows you to gather data from Modbus registers.

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

# Example configuration.yml entry
sensor:
  platform: modbus
  registers:
    - name: Sensor1
      unit_of_measurement: °C
      slave: 1
      register: 100
    - name: Sensor2
      unit_of_measurement: mg
      slave: 1
      register: 110
      count: 2
    - name: Sensor3
      unit_of_measurement: °C
      slave: 1
      register: 120
      register_type: input
      data_type: float
      scale: 0.01
      offset: -273.16
      precision: 2

Configuration variables:

  • registers array (Required): The array contains a list of relevant registers to read from.
    • name (Required): Name of the sensor.
    • slave (Required): The number of the slave (Optional for tcp and upd Modbus).
    • register (Required): Register number.
    • register_type (Optional): Modbus register type (holding, input), default holding
    • unit_of_measurement (Optional): Unit to attach to value.
    • count (Optional): Number of registers to read.
    • scale (Optional): Scale factor (output = scale * value + offset), default 1
    • offset (Optional): Final offset (output = scale * value + offset), default 0
    • precision (Optional): Number of valid decimals, default 0
    • data_type (Optional): Response representation (int, float). If float selected, value will be converted to IEEE 754 floating point format. default int