What it exposes
| Feature | Property | Values | Control |
|---|---|---|---|
| Illuminance | illuminance | lx | read only |
| On / off | state | — | settable |
| Packet Mode | pack | — | settable |
| Button 1 Code Learning | button_1 | Learn, Delete, Saved | settable |
| Button 2 Code Learning | button_2 | Learn, Delete, Saved | settable |
| Button 3 Code Learning | button_3 | Learn, Delete, Saved | settable |
| Button 4 Code Learning | button_4 | Learn, Delete, Saved | settable |
| Button 5 Code Learning | button_5 | Learn, Delete, Saved | settable |
| Button 6 Code Learning | button_6 | Learn, Delete, Saved | settable |
| Button 7 Code Learning | button_7 | Learn, Delete, Saved | settable |
| Button 8 Code Learning | button_8 | Learn, Delete, Saved | settable |
| Button 1 Code Transmit | start_1 | Transmit | settable |
| Button 2 Code Transmit | start_2 | Transmit | settable |
| Button 3 Code Transmit | start_3 | Transmit | settable |
| Button 4 Code Transmit | start_4 | Transmit | settable |
| Button 5 Code Transmit | start_5 | Transmit | settable |
| Button 6 Code Transmit | start_6 | Transmit | settable |
| Button 7 Code Transmit | start_7 | Transmit | settable |
| Button 8 Code Transmit | start_8 | Transmit | 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:
{
"illuminance": 120,
"state": false,
"pack": false,
"button_1": "Learn",
"button_2": "Learn",
"button_3": "Learn",
"button_4": "Learn",
"button_5": "Learn",
"button_6": "Learn",
"button_7": "Learn",
"button_8": "Learn",
"start_1": "Transmit",
"start_2": "Transmit",
"start_3": "Transmit",
"linkquality": 120
}
Send commands to zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state":true}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"pack":true}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"button_1":"Delete"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"button_2":"Delete"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"button_3":"Delete"}'
Watch the topics live from the browser: MQTT client.
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.