Modbus Controller Binary Sensor¶
modbus_controller binary sensor platform creates a binary sensor from a modbus_controller component
and requires Modbus Controller to be configured.
id (Optional, ID): Manually specify the ID used for code generation.
name (Required, string): The name of the sensor.
register_type (Required): type of the modbus register.
coil: Function 01 (01hex) Read Coils - Reads the ON/OFF status of discrete coils in the device.
discrete_input: Function 02(02hex) - Reads the ON/OFF status of discrete inputs in the device.
holding: Function 03 (03hex) Read Holding Registers - Read the binary contents of holding registers in the device.
read: Function 04 (04hex) Read Input Registers - Read the binary contents of input registers in the device.
address (Required, int): start address of the first register in a range
bitmask (Optional, int): Some values are packed in a response. The bitmask is used to determined if the result is true or false
skip_updates (Optional, int): By default all sensors of a modbus_controller are updated together. For data points that don’t change very frequently updates can be skipped. A value of 5 would only update this sensor range in every 5th update cycle
response_size (Optional, int): Size of the response for the register in bytes. Defaults to register_count*2.
force_new_range (Optional, boolean): If possible sensors with sequential addresses are grouped together and requested in one range. Setting
force_new_range: trueenforces the start of a new range at that address.
custom_command (Optional, list of bytes): raw bytes for modbus command. This allows using non-standard commands. If
register_typecan’t be used. custom data must contain all required bytes including the modbus device address. The crc is automatically calculated and appended to the command. See Using custom_command how to use
lambda (Optional, lambda): Lambda to be evaluated every update interval to get the new value of the sensor
x (bool): The parsed float value of the modbus data
data (std::vector<uint8_t): vector containing the complete raw modbus response bytes for this sensor
item (const pointer to a ModbusBinarySensor object): The sensor object itself.
Possible return values for the lambda:
return true/false;the new value for the sensor.
offset (Optional, int): not required for most cases offset from start address in bytes. If more than one register is read a modbus read registers command this value is used to find the start of this datapoint relative to start address. The component calculates the size of the range based on offset and size of the value type The value for offset depends on the register type. If a binary_sensor is created from an input register the offset is in bytes. For coil and discrete input resisters the LSB of the first data byte contains the coil addressed in the request. The other coils follow toward the high-order end of this byte and from low order to high order in subsequent bytes. For the registers offset is the position of the relevant bit. To get the value of the coil register 2 can be retrieved using address: 2 / offset: 0 or address: 0 / offset 2
binary_sensor: - platform: modbus_controller modbus_controller_id: epever id: battery_internal_resistance_abnormal name: "Battery internal resistance abnormal" register_type: read address: 0x3200 bitmask: 0x80 #(bit 8)