What it exposes
| Feature | Property | Values | Control |
|---|---|---|---|
| Presence | presence | — | read only |
| On / off | state | none, presence, move | read only |
| Illuminance | illuminance | lx | read only |
| Min distance | min_distance | m · 0…8.4 | settable |
| Max distance | max_distance | m · 0…8.4 | settable |
| Target distance | target_distance | m · 0…9.9 | read only |
| Gate enable 01 | gate_enable_01 | disable, enable | settable |
| Gate enable 02 | gate_enable_02 | disable, enable | settable |
| Gate enable 03 | gate_enable_03 | disable, enable | settable |
| Gate enable 04 | gate_enable_04 | disable, enable | settable |
| Gate enable 05 | gate_enable_05 | disable, enable | settable |
| Gate enable 06 | gate_enable_06 | disable, enable | settable |
| Gate enable 07 | gate_enable_07 | disable, enable | settable |
| Gate enable 08 | gate_enable_08 | disable, enable | settable |
| Gate enable 09 | gate_enable_09 | disable, enable | settable |
| Gate enable 10 | gate_enable_10 | disable, enable | settable |
| Gate enable 11 | gate_enable_11 | disable, enable | settable |
| Configuration gate | configuration_gate | 1…11 | settable |
| Move threshold | move_threshold | 0…99 | settable |
| Presence threshold | presence_threshold | 0…99 | settable |
| Nearest target gate | nearest_target_gate | 0…11 | read only |
| Target countdown | target_countdown | s · 0…3600 | read only |
| Target velocity | target_velocity | m/s · -9.99…9.99 | read only |
| Debug switch | debug_switch | — | settable |
| Led mode | led_mode | silence, status | settable |
| Delay time | delay_time | s · 5…3600 | settable |
| Block time | block_time | s · 0…10 | settable |
| Judge logic | judge_logic | large_move, small_move, custom_move | settable |
| Start noise collect | start_noise_collect | start | settable |
| Noise collect status | noise_collect_status | start, ongoing, complete | read only |
| Device control | device_control | no_action, restart, reset_param | settable |
| Presence sensitivity | presence_sensitivity | high, medium, low, custom | settable |
| Move sensitivity | move_sensitivity | high, medium, low, custom | settable |
| Scene mode | scene_mode | custom, toilet, kitchen, corridor, bedroom, living_room, meeting_room | settable |
| Illuminance report | illuminance_report | — | settable |
| Move detect | move_detect | — | settable |
| Distance report | distance_report | — | settable |
| Speed report | speed_report | — | settable |
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:
{
"presence": false,
"state": "none",
"illuminance": 120,
"min_distance": 4,
"max_distance": 4,
"target_distance": 5,
"gate_enable_01": "disable",
"gate_enable_02": "disable",
"gate_enable_03": "disable",
"gate_enable_04": "disable",
"gate_enable_05": "disable",
"gate_enable_06": "disable",
"gate_enable_07": "disable",
"gate_enable_08": "disable",
"linkquality": 120
}
Send commands to zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"gate_enable_01":"enable"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"gate_enable_02":"enable"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"gate_enable_03":"enable"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"gate_enable_04":"enable"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"gate_enable_05":"enable"}'
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: "Light on motion"
mode: single
triggers:
- trigger: state
entity_id: binary_sensor.my_device_presence
to: "on"
conditions:
- condition: sun
after: sunset
actions:
- action: light.turn_on
target:
entity_id: light.hallway
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.