What it exposes
| Feature | Property | Values | Control |
|---|---|---|---|
| Modbus address | modbus_address | 1…247 | settable |
| Uart baud rate | uart_baud_rate | 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 | settable |
| Wireless sensor pairing | wireless_sensor_pairing | — | settable |
| Child lock | child_lock | — | settable |
| Zone count | zone_count | Single-zone, Dual-zone | settable |
| Close valves if sensor lost | close_valves_if_sensor_lost | — | settable |
| Switch relay on alarm | switch_relay_on_alarm | Dont switch, On first zone alarm, On second zone alarm, On any zone alarm | settable |
| Switch relay on valve closing | switch_relay_on_valve_closing | Dont switch, On first zone, On second zone, On any zone | settable |
| Rf sensor count | rf_sensor_count | — | read only |
| Wired sensor feedback | wired_sensor_feedback | — | settable |
| Count wired sensors | count_wired_sensors | — | settable |
| Alarm duration | alarm_duration | min · 0…255 | settable |
| Error code | error_code | — | read only |
| Valve 1 status | valve_1_status | Unknown, Ok, Open circuit, Valve stuck | read only |
| Valve 2 status | valve_2_status | Unknown, Ok, Open circuit, Valve stuck | read only |
| Valve 3 status | valve_3_status | Unknown, Ok, Open circuit, Valve stuck | read only |
| Valve 4 status | valve_4_status | Unknown, Ok, Open circuit, Valve stuck | read only |
| Floor washing mode | floor_washing_mode | — | settable |
| Switch (valve_group_1) | state_valve_group_1 | — | settable |
| Switch (valve_group_2) | state_valve_group_2 | — | settable |
| Type (wire_1) | type_wire_1 | Water leak sensor, Button (falling edge trigger), Switch (switch valve on signal level) | settable |
| Zone assignment (wire_1) | zone_assignment_wire_1 | Close valves in zone 1, Close valves in zone 2, Close valves in both zones | settable |
| Status (wire_1) | status_wire_1 | Ok, Sensor lost, Sensor detected, Short circuit | read only |
| Wired sensor count (wire_1) | wired_sensor_count_wire_1 | — | read only |
| Type (wire_2) | type_wire_2 | Water leak sensor, Button (falling edge trigger), Switch (switch valve on signal level) | settable |
| Zone assignment (wire_2) | zone_assignment_wire_2 | Close valves in zone 1, Close valves in zone 2, Close valves in both zones | settable |
| Status (wire_2) | status_wire_2 | Ok, Sensor lost, Sensor detected, Short circuit | read only |
| Wired sensor count (wire_2) | wired_sensor_count_wire_2 | — | read only |
| Type (wire_3) | type_wire_3 | Water leak sensor, Button (falling edge trigger), Switch (switch valve on signal level) | settable |
| Zone assignment (wire_3) | zone_assignment_wire_3 | Close valves in zone 1, Close valves in zone 2, Close valves in both zones | settable |
| Status (wire_3) | status_wire_3 | Ok, Sensor lost, Sensor detected, Short circuit | read only |
| Wired sensor count (wire_3) | wired_sensor_count_wire_3 | — | read only |
| Type (wire_4) | type_wire_4 | Water leak sensor, Button (falling edge trigger), Switch (switch valve on signal level) | settable |
| Zone assignment (wire_4) | zone_assignment_wire_4 | Close valves in zone 1, Close valves in zone 2, Close valves in both zones | settable |
| Status (wire_4) | status_wire_4 | Ok, Sensor lost, Sensor detected, Short circuit | read only |
| Wired sensor count (wire_4) | wired_sensor_count_wire_4 | — | read only |
| Water leak (both_zones) | water_leak_both_zones | — | read only |
| Water leak (zone_1) | water_leak_zone_1 | — | read only |
| Water leak (zone_2) | water_leak_zone_2 | — | read only |
| Water leak (wire_1) | water_leak_wire_1 | — | read only |
| Water leak (wire_2) | water_leak_wire_2 | — | read only |
| Water leak (wire_3) | water_leak_wire_3 | — | read only |
| Water leak (wire_4) | water_leak_wire_4 | — | read only |
| Water leak | water_leak | — | read only |
| Summation delivered (meter_1) | summation_delivered_meter_1 | — | read only |
| Summation delivered (meter_2) | summation_delivered_meter_2 | — | read only |
| Summation delivered (meter_3) | summation_delivered_meter_3 | — | read only |
| Summation delivered (meter_4) | summation_delivered_meter_4 | — | read only |
| Multiplier (meter_1) | multiplier_meter_1 | — | read only |
| Multiplier (meter_2) | multiplier_meter_2 | — | read only |
| Multiplier (meter_3) | multiplier_meter_3 | — | read only |
| Multiplier (meter_4) | multiplier_meter_4 | — | read only |
| Divisor (meter_1) | divisor_meter_1 | — | read only |
| Divisor (meter_2) | divisor_meter_2 | — | read only |
| Divisor (meter_3) | divisor_meter_3 | — | read only |
| Divisor (meter_4) | divisor_meter_4 | — | read only |
MQTT: state and commands
Zigbee2MQTT publishes the device state to zigbee2mqtt/my_device (my_device is the name you give the device). An example message:
{
"modbus_address": 124,
"uart_baud_rate": "1200",
"wireless_sensor_pairing": false,
"child_lock": false,
"zone_count": "Single-zone",
"close_valves_if_sensor_lost": false,
"switch_relay_on_alarm": "Dont switch",
"switch_relay_on_valve_closing": "Dont switch",
"rf_sensor_count": 0,
"wired_sensor_feedback": false,
"count_wired_sensors": false,
"alarm_duration": 128,
"error_code": 0,
"valve_1_status": "Unknown",
"state_valve_group_1": "ON",
"state_valve_group_2": "ON",
"linkquality": 120
}
Send commands to zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state_valve_group_1":"TOGGLE"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state_valve_group_2":"TOGGLE"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"uart_baud_rate":"2400"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"wireless_sensor_pairing":true}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"child_lock":true}'
Watch the topics live from the browser: MQTT client.
Home Assistant automation example
Zigbee2MQTT creates Home Assistant entities from the device name. If it is called my_device, an automation in automations.yaml can look like this:
- alias: "Off at night"
mode: single
triggers:
- trigger: time
at: "23:30:00"
actions:
- action: switch.turn_off
target:
entity_id: switch.my_device_valve_group_1
Check the YAML: YAML checker.
How to pair it
- In Zigbee2MQTT click Permit join.
- Put the device in pairing mode: usually a long press of the reset button (5–10 s) until the LED blinks; bulbs: switch the power off and on 5–6 times.
- Keep the device close to the coordinator or a router while pairing.
- Give it a clear name: MQTT topics and Home Assistant entities are built from it.
Exact procedure and model notes: the device page in the Zigbee2MQTT docs. No coordinator yet: coordinator picker.