Version
0.8.x

Modbus sensors


Modbus sensors

Dependency modules

modbus

Modbus sensors component. You need to know address of device you want to connect to! Supported devices:

DeviceModel name
Eastron SDM6301 Energy metersdm630
Eastron SDM1201 Energy metersdm120
Sofar Solar PV Invertersofar
Socomec E23 Energy Meter 3-Phasesocomec_e23
Socomec E03 Energy Meter 1-Phasesocomec_e03
r4dcb08 Temperature Dallas Boardr4dcb08
CWT-TH0x Temperature and Humidity sensorcwt
SHT20 Temperature and Humidity sensorsht20
Liquid depth sensorliquid-sensor
Orno-or-we-517 Energy Meterorno-or-we-517

Example config

modbus:
  uart: uart4

modbus_sensors:
  - id: sofar1
    model: sofar
    address: 1
  - id: sdm1
    model: sdm630
    address: 32
  - id: Liquid sensor
    model: liquid-sensor
    address: 41
  - id: CWT TH0x
    model: cwt
    address: 61
  - id: SHT20
    model: sht20
    address: 62
    sensors_filters:
      temperature:
        - offset: -2
        - round: 2
      humidity:
        - round: 3

Configuration variables:

  • id (Required, string) - uniquely identifies this device in MQTT and Home Assistant
  • address (Required, string) - modbus address of the device you want to communicate with.
  • model (Required, string) - model schema to use. Check table above to get model name.
  • update_interval (Optional, timeperiod, default: 60 seconds) - update interval. Modbus connection is pretty cpu intensive so customize with care. Minimum is 1 second, but recommended minimum is 10 secs.
  • sensors_filters (Optional, dictionary) - dictionary of sensor_name: list of filters. See example above how to use those. Currently possible filters are for temperature and humidity. For filter list see Filters. Sensor filters are working for temperature and humidity values only for now.

Footnotes

  1. Those energy metters can be found in two versions and only one supports Modbus - sometimes it’s marked with suffix M (SDM120M / SDM6301M), other time Modbus is mentioned in the title. Don’t confuse it with cheaper version with suffix D (SDM120D / SDM6301D) - it doesn’t support Modbus communication so it can’t be connected with Bone.io. 2