Что умеет
| Функция | Свойство | Значения | Управление |
|---|---|---|---|
| Light | state, brightness | вкл / выкл, яркость | можно менять |
| Fan | fan_state | — | можно менять |
| Breeze mode | breezeMode | — | только чтение |
| DimmingSpeedUpRemote 1 | dimmingSpeedUpRemote_1 | 0…127 | можно менять |
| RampRateOffToOnRemote 1 | rampRateOffToOnRemote_1 | 0…127 | можно менять |
| DimmingSpeedDownRemote 1 | dimmingSpeedDownRemote_1 | 0…127 | можно менять |
| RampRateOnToOffRemote 1 | rampRateOnToOffRemote_1 | 0…127 | можно менять |
| MinimumLevel 1 | minimumLevel_1 | 1…254 | можно менять |
| MaximumLevel 1 | maximumLevel_1 | 2…255 | можно менять |
| AutoTimerOff 1 | autoTimerOff_1 | seconds · 0…32767 | можно менять |
| DefaultLevelRemote 1 | defaultLevelRemote_1 | 0…255 | можно менять |
| StateAfterPowerRestored 1 | stateAfterPowerRestored_1 | 0…255 | можно менять |
| QuickStartTime 1 | quickStartTime_1 | 0…60 | можно менять |
| QuickStartLevel 1 | quickStartLevel_1 | 1…254 | можно менять |
| HigherOutputInNonNeutral 1 | higherOutputInNonNeutral_1 | Disabled (default), Enabled | можно менять |
| DimmingMode 1 | dimmingMode_1 | Leading edge, Trailing edge | можно менять |
| SmartBulbMode 1 | smartBulbMode_1 | Disabled, Smart Bulb Mode | можно менять |
| LedColorWhenOn 1 | ledColorWhenOn_1 | 0…255 | можно менять |
| LedIntensityWhenOn 1 | ledIntensityWhenOn_1 | 0…100 | можно менять |
| OutputMode 1 | outputMode_1 | Dimmer, On/Off | можно менять |
| DimmingSpeedUpRemote 2 | dimmingSpeedUpRemote_2 | 0…127 | можно менять |
| RampRateOffToOnRemote 2 | rampRateOffToOnRemote_2 | 0…127 | можно менять |
| DimmingSpeedDownRemote 2 | dimmingSpeedDownRemote_2 | 0…127 | можно менять |
| RampRateOnToOffRemote 2 | rampRateOnToOffRemote_2 | 0…127 | можно менять |
| MinimumLevel 2 | minimumLevel_2 | 1…254 | можно менять |
| MaximumLevel 2 | maximumLevel_2 | 2…255 | можно менять |
| AutoTimerOff 2 | autoTimerOff_2 | seconds · 0…32767 | можно менять |
| DefaultLevelRemote 2 | defaultLevelRemote_2 | 0…255 | можно менять |
| StateAfterPowerRestored 2 | stateAfterPowerRestored_2 | 0…255 | можно менять |
| QuickStartTime 2 | quickStartTime_2 | 0…60 | можно менять |
| SmartBulbMode 2 | smartBulbMode_2 | Disabled, Smart Fan Mode | можно менять |
| OutputMode 2 | outputMode_2 | Ceiling Fan (3-Speed), Exhaust Fan (On/Off) | можно менять |
| Опознать (мигнуть) | identify | identify | можно менять |
MQTT: состояние и команды
Zigbee2MQTT публикует состояние устройства в топик zigbee2mqtt/my_device (вместо my_device — имя, которое вы дали устройству). Пример сообщения:
{
"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
}
Команды отправляют в 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"}'
Проверить топики и сообщения прямо из браузера — MQTT-клиент.
Пример автоматизации Home Assistant
Zigbee2MQTT создаёт объекты Home Assistant по имени устройства. Если назвать его my_device, автоматизация в automations.yaml может выглядеть так:
- alias: "Свет на закате"
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
Проверить YAML на ошибки — проверка YAML.
Как подключить
- В Zigbee2MQTT нажмите «Разрешить подключение» (Permit join).
- Переведите устройство в режим сопряжения: обычно — долгое нажатие кнопки сброса (5–10 секунд) до мигания индикатора; лампы — включить и выключить питание 5–6 раз подряд.
- Держите устройство рядом с координатором или ретранслятором, пока идёт сопряжение.
- Дайте устройству понятное имя — от него зависят топики MQTT и объекты в Home Assistant.
Точная процедура и особенности модели — страница устройства в документации Zigbee2MQTT. Нет координатора — подбор Zigbee-стика.