Что умеет
| Функция | Свойство | Значения | Управление |
|---|---|---|---|
| Light | state, brightness | вкл / выкл, яркость | можно менять |
| Led effect | led_effect | — | только чтение |
| Individual led effect | individual_led_effect | — | только чтение |
| NotificationComplete | notificationComplete | LED_1, LED_2, LED_3, LED_4, LED_5, LED_6, LED_7, ALL_LEDS … | только чтение |
| DimmingSpeedUpRemote | dimmingSpeedUpRemote | 0…127 | можно менять |
| DimmingSpeedUpLocal | dimmingSpeedUpLocal | 0…127 | можно менять |
| RampRateOffToOnRemote | rampRateOffToOnRemote | 0…127 | можно менять |
| RampRateOffToOnLocal | rampRateOffToOnLocal | 0…127 | можно менять |
| DimmingSpeedDownRemote | dimmingSpeedDownRemote | 0…127 | можно менять |
| DimmingSpeedDownLocal | dimmingSpeedDownLocal | 0…127 | можно менять |
| RampRateOnToOffRemote | rampRateOnToOffRemote | 0…127 | можно менять |
| RampRateOnToOffLocal | rampRateOnToOffLocal | 0…127 | можно менять |
| InvertSwitch | invertSwitch | Yes, No | можно менять |
| AutoTimerOff | autoTimerOff | seconds · 0…32767 | можно менять |
| DefaultLevelLocal | defaultLevelLocal | 0…255 | можно менять |
| DefaultLevelRemote | defaultLevelRemote | 0…255 | можно менять |
| StateAfterPowerRestored | stateAfterPowerRestored | 0…255 | можно менять |
| LoadLevelIndicatorTimeout | loadLevelIndicatorTimeout | Stay Off, 1 Second, 2 Seconds, 3 Seconds, 4 Seconds, 5 Seconds, 6 Seconds, 7 Seconds … | можно менять |
| SwitchType | switchType | Single Pole, Aux Switch | можно менять |
| InternalTemperature | internalTemperature | °C · 0…127 | только чтение |
| Overheat | overheat | No Alert, Overheated | только чтение |
| ButtonDelay | buttonDelay | 0ms, 100ms, 200ms, 300ms, 400ms, 500ms, 600ms, 700ms … | можно менять |
| DeviceBindNumber | deviceBindNumber | — | только чтение |
| SmartBulbMode | smartBulbMode | Disabled, Smart Bulb Mode | можно менять |
| DoubleTapUpToParam55 | doubleTapUpToParam55 | Disabled, Enabled | можно менять |
| DoubleTapDownToParam56 | doubleTapDownToParam56 | Disabled, Enabled | можно менять |
| BrightnessLevelForDoubleTapUp | brightnessLevelForDoubleTapUp | 2…255 | можно менять |
| BrightnessLevelForDoubleTapDown | brightnessLevelForDoubleTapDown | 0…255 | можно менять |
| LedColorWhenOn | ledColorWhenOn | 0…255 | можно менять |
| LedColorWhenOff | ledColorWhenOff | 0…255 | можно менять |
| LedIntensityWhenOn | ledIntensityWhenOn | 0…100 | можно менять |
| LedIntensityWhenOff | ledIntensityWhenOff | 0…100 | можно менять |
| SingleTapBehavior | singleTapBehavior | Old Behavior, New Behavior, Down Always Off | можно менять |
| FanControlMode | fanControlMode | Disabled, Multi Tap, Cycle, Toggle | можно менять |
| LowLevelForFanControlMode | lowLevelForFanControlMode | 2…254 | можно менять |
| MediumLevelForFanControlMode | mediumLevelForFanControlMode | 2…254 | можно менять |
| HighLevelForFanControlMode | highLevelForFanControlMode | 2…254 | можно менять |
| LedColorForFanControlMode | ledColorForFanControlMode | 0…255 | можно менять |
| AuxSwitchUniqueScenes | auxSwitchUniqueScenes | Disabled, Enabled | можно менять |
| BindingOffToOnSyncLevel | bindingOffToOnSyncLevel | Disabled, Enabled | можно менять |
| LocalProtection | localProtection | Disabled, Enabled | можно менять |
| RemoteProtection | remoteProtection | Disabled, Enabled | только чтение |
| OnOffLedMode | onOffLedMode | All, One | можно менять |
| FirmwareUpdateInProgressIndicator | firmwareUpdateInProgressIndicator | Disabled, Enabled | можно менять |
| DefaultLed1ColorWhenOn | defaultLed1ColorWhenOn | 0…255 | можно менять |
| DefaultLed1ColorWhenOff | defaultLed1ColorWhenOff | 0…255 | можно менять |
| DefaultLed1IntensityWhenOn | defaultLed1IntensityWhenOn | 0…101 | можно менять |
| DefaultLed1IntensityWhenOff | defaultLed1IntensityWhenOff | 0…101 | можно менять |
| DefaultLed2ColorWhenOn | defaultLed2ColorWhenOn | 0…255 | можно менять |
| DefaultLed2ColorWhenOff | defaultLed2ColorWhenOff | 0…255 | можно менять |
| DefaultLed2IntensityWhenOn | defaultLed2IntensityWhenOn | 0…101 | можно менять |
| DefaultLed2IntensityWhenOff | defaultLed2IntensityWhenOff | 0…101 | можно менять |
| DefaultLed3ColorWhenOn | defaultLed3ColorWhenOn | 0…255 | можно менять |
| DefaultLed3ColorWhenOff | defaultLed3ColorWhenOff | 0…255 | можно менять |
| DefaultLed3IntensityWhenOn | defaultLed3IntensityWhenOn | 0…101 | можно менять |
| DefaultLed3IntensityWhenOff | defaultLed3IntensityWhenOff | 0…101 | можно менять |
| DefaultLed4ColorWhenOn | defaultLed4ColorWhenOn | 0…255 | можно менять |
| DefaultLed4ColorWhenOff | defaultLed4ColorWhenOff | 0…255 | можно менять |
| DefaultLed4IntensityWhenOn | defaultLed4IntensityWhenOn | 0…101 | можно менять |
| DefaultLed4IntensityWhenOff | defaultLed4IntensityWhenOff | 0…101 | можно менять |
| DefaultLed5ColorWhenOn | defaultLed5ColorWhenOn | 0…255 | можно менять |
| DefaultLed5ColorWhenOff | defaultLed5ColorWhenOff | 0…255 | можно менять |
| DefaultLed5IntensityWhenOn | defaultLed5IntensityWhenOn | 0…101 | можно менять |
| DefaultLed5IntensityWhenOff | defaultLed5IntensityWhenOff | 0…101 | можно менять |
| DefaultLed6ColorWhenOn | defaultLed6ColorWhenOn | 0…255 | можно менять |
| DefaultLed6ColorWhenOff | defaultLed6ColorWhenOff | 0…255 | можно менять |
| DefaultLed6IntensityWhenOn | defaultLed6IntensityWhenOn | 0…101 | можно менять |
| DefaultLed6IntensityWhenOff | defaultLed6IntensityWhenOff | 0…101 | можно менять |
| DefaultLed7ColorWhenOn | defaultLed7ColorWhenOn | 0…255 | можно менять |
| DefaultLed7ColorWhenOff | defaultLed7ColorWhenOff | 0…255 | можно менять |
| DefaultLed7IntensityWhenOn | defaultLed7IntensityWhenOn | 0…101 | можно менять |
| DefaultLed7IntensityWhenOff | defaultLed7IntensityWhenOff | 0…101 | можно менять |
| FanTimerMode | fanTimerMode | Disabled, Enabled | можно менять |
| DoubleTapClearNotifications | doubleTapClearNotifications | Enabled (Default), Disabled | можно менять |
| FanLedLevelType | fanLedLevelType | 0…10 | можно менять |
| LedBarScaling | ledBarScaling | Gen3 method (VZM-style), Gen2 method (LZW-style) | можно менять |
| ActivePowerReports | activePowerReports | 0…100 | можно менять |
| PeriodicPowerAndEnergyReports | periodicPowerAndEnergyReports | 0…32767 | можно менять |
| ActiveEnergyReports | activeEnergyReports | 0…32767 | можно менять |
| OutputMode | outputMode | Dimmer, On/Off | можно менять |
| Опознать (мигнуть) | identify | identify | можно менять |
| Energy reset | energy_reset | reset | можно менять |
| Мощность | power | W | только чтение |
| Напряжение | voltage | V | только чтение |
| Ток | current | A | только чтение |
| Энергия | energy | kWh | только чтение |
| Температура | temperature | °C | только чтение |
| Влажность | humidity | % | только чтение |
| Действие (нажатие кнопки) | action | down_single, up_single, config_single, down_release, up_release, config_release, down_held, up_held … | только чтение |
MQTT: состояние и команды
Zigbee2MQTT публикует состояние устройства в топик zigbee2mqtt/my_device (вместо my_device — имя, которое вы дали устройству). Пример сообщения:
{
"state": "ON",
"brightness": 180,
"notificationComplete": "LED_1",
"dimmingSpeedUpRemote": 64,
"dimmingSpeedUpLocal": 64,
"rampRateOffToOnRemote": 64,
"rampRateOffToOnLocal": 64,
"dimmingSpeedDownRemote": 64,
"dimmingSpeedDownLocal": 64,
"rampRateOnToOffRemote": 64,
"rampRateOnToOffLocal": 64,
"invertSwitch": "Yes",
"autoTimerOff": 16384,
"defaultLevelLocal": 128,
"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 '{"invertSwitch":"No"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"loadLevelIndicatorTimeout":"1 Second"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"switchType":"Aux Switch"}'
Проверить топики и сообщения прямо из браузера — 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-стика.