To contribute to this page, edit the following file
SONOFF SNZB-03 #
Model | SNZB-03 |
Vendor | SONOFF |
Description | Motion sensor |
Exposes | occupancy, battery_low, tamper, battery, linkquality |
Picture | ![]() |
White-label | eWeLink RHK09 |
Notes #
Pairing #
If brand new, when powered on it will attempt to pair to Zigbee2MQTT automatically. If not (or if has been paired before and needs to be re-paired) - press and hold the reset button through the small hole at the top for about 5 seconds until the light flashes several times. The device will then go into pairing mode. It should then be connected to Zigbee2MQTT. Pressing the button should activate the relay on/off as normal, and the red LED will be on/off.
Exposes #
Occupancy (binary) #
Indicates whether the device detected occupancy.
Value can be found in the published state on the occupancy
property.
It’s not possible to read (/get
) or write (/set
) this value.
If value equals true
occupancy is ON, if false
OFF.
Battery_low (binary) #
Indicates if the battery of this device is almost empty.
Value can be found in the published state on the battery_low
property.
It’s not possible to read (/get
) or write (/set
) this value.
If value equals true
battery_low is ON, if false
OFF.
Tamper (binary) #
Indicates whether the device is tampered.
Value can be found in the published state on the tamper
property.
It’s not possible to read (/get
) or write (/set
) this value.
If value equals true
tamper is ON, if false
OFF.
Battery (numeric) #
Remaining battery in %.
Value can be found in the published state on the battery
property.
It’s not possible to read (/get
) or write (/set
) this value.
The minimal value is 0
and the maximum value is 100
.
The unit of this value is %
.
Linkquality (numeric) #
Link quality (signal strength).
Value can be found in the published state on the linkquality
property.
It’s not possible to read (/get
) or write (/set
) this value.
The minimal value is 0
and the maximum value is 255
.
The unit of this value is lqi
.
Manual Home Assistant configuration #
Although Home Assistant integration through MQTT discovery is preferred, manual integration is possible with the following configuration:
binary_sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.occupancy }}"
payload_on: true
payload_off: false
device_class: "motion"
binary_sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.battery_low }}"
payload_on: true
payload_off: false
device_class: "battery"
binary_sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.tamper }}"
payload_on: true
payload_off: false
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.battery }}"
unit_of_measurement: "%"
device_class: "battery"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.linkquality }}"
unit_of_measurement: "lqi"
icon: "mdi:signal"