What it exposes
| Feature | Property | Values | Control |
|---|---|---|---|
| Light | state, brightness | on / off, brightness | settable |
| Fan | fan_state | — | settable |
| Breeze mode | breezeMode | — | read only |
| DimmingSpeedUpRemote 1 | dimmingSpeedUpRemote_1 | 0…127 | settable |
| RampRateOffToOnRemote 1 | rampRateOffToOnRemote_1 | 0…127 | settable |
| DimmingSpeedDownRemote 1 | dimmingSpeedDownRemote_1 | 0…127 | settable |
| RampRateOnToOffRemote 1 | rampRateOnToOffRemote_1 | 0…127 | settable |
| MinimumLevel 1 | minimumLevel_1 | 1…254 | settable |
| MaximumLevel 1 | maximumLevel_1 | 2…255 | settable |
| AutoTimerOff 1 | autoTimerOff_1 | seconds · 0…32767 | settable |
| DefaultLevelRemote 1 | defaultLevelRemote_1 | 0…255 | settable |
| StateAfterPowerRestored 1 | stateAfterPowerRestored_1 | 0…255 | settable |
| QuickStartTime 1 | quickStartTime_1 | 0…60 | settable |
| QuickStartLevel 1 | quickStartLevel_1 | 1…254 | settable |
| HigherOutputInNonNeutral 1 | higherOutputInNonNeutral_1 | Disabled (default), Enabled | settable |
| DimmingMode 1 | dimmingMode_1 | Leading edge, Trailing edge | settable |
| SmartBulbMode 1 | smartBulbMode_1 | Disabled, Smart Bulb Mode | settable |
| LedColorWhenOn 1 | ledColorWhenOn_1 | 0…255 | settable |
| LedIntensityWhenOn 1 | ledIntensityWhenOn_1 | 0…100 | settable |
| OutputMode 1 | outputMode_1 | Dimmer, On/Off | settable |
| DimmingSpeedUpRemote 2 | dimmingSpeedUpRemote_2 | 0…127 | settable |
| RampRateOffToOnRemote 2 | rampRateOffToOnRemote_2 | 0…127 | settable |
| DimmingSpeedDownRemote 2 | dimmingSpeedDownRemote_2 | 0…127 | settable |
| RampRateOnToOffRemote 2 | rampRateOnToOffRemote_2 | 0…127 | settable |
| MinimumLevel 2 | minimumLevel_2 | 1…254 | settable |
| MaximumLevel 2 | maximumLevel_2 | 2…255 | settable |
| AutoTimerOff 2 | autoTimerOff_2 | seconds · 0…32767 | settable |
| DefaultLevelRemote 2 | defaultLevelRemote_2 | 0…255 | settable |
| StateAfterPowerRestored 2 | stateAfterPowerRestored_2 | 0…255 | settable |
| QuickStartTime 2 | quickStartTime_2 | 0…60 | settable |
| SmartBulbMode 2 | smartBulbMode_2 | Disabled, Smart Fan Mode | settable |
| OutputMode 2 | outputMode_2 | Ceiling Fan (3-Speed), Exhaust Fan (On/Off) | settable |
| Identify | identify | identify | 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:
{
"state": "ON",
"brightness": 180,
"dimmingSpeedUpRemote_1": 64,
"rampRateOffToOnRemote_1": 64,
"dimmingSpeedDownRemote_1": 64,
"rampRateOnToOffRemote_1": 64,
"minimumLevel_1": 128,
"maximumLevel_1": 129,
"autoTimerOff_1": 16384,
"defaultLevelRemote_1": 128,
"stateAfterPowerRestored_1": 128,
"quickStartTime_1": 30,
"quickStartLevel_1": 128,
"higherOutputInNonNeutral_1": "Disabled (default)",
"linkquality": 120
}
Send commands to zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state":"ON","brightness":180}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state":"OFF","transition":2}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"higherOutputInNonNeutral_1":"Enabled"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"dimmingMode_1":"Trailing edge"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"smartBulbMode_1":"Smart Bulb Mode"}'
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 at sunset"
mode: single
triggers:
- trigger: sun
event: sunset
offset: "-00:15:00"
actions:
- action: light.turn_on
target:
entity_id: light.my_device
data:
brightness_pct: 70
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.