Что умеет
| Функция | Свойство | Значения | Управление |
|---|---|---|---|
| Опознать (мигнуть) | identify | identify | можно менять |
| Мощность | power | W | только чтение |
| Ток | current | A | только чтение |
| Энергия | energy | kWh | только чтение |
| Power failure mode | power_failure_mode | last_state, off, on, blink | можно менять |
| Actual order | actual_order | stop, frost_off, eco, confort_2, confort_1, confort, shortcut_error, temperature_error | только чтение |
| Order timer | order_timer | 0…4294967295 | можно менять |
| Pre order timer | pre_order_timer | 0…4294967295 | можно менять |
| Timer unit | timer_unit | second, minutes | можно менять |
| Led mode | led_mode | led_on, led_off | можно менять |
| Pilot wire relay mode | pilot_wire_relay_mode | relay_on, relay_off | можно менять |
| Order scrolling mode | order_scrolling_mode | forward, backward | можно менять |
| Order number supported | order_number_supported | four_orders, six_orders | можно менять |
| Fallback order | fallback_order | stop, frost_off, eco, confort_2, confort_1, confort | можно менять |
| Pilotwire set order | pilotwire_set_order | stop, frost_off, eco, confort_2, confort_1, confort | можно менять |
| Pilotwire toggle order | pilotwire_toggle_order | pilotwire_toggle_order | можно менять |
| Reset to factory settings | reset_to_factory_settings | factory_reset, configuration_reset, network_reset | можно менять |
| Relaunch ble advert | relaunch_ble_advert | relaunch_ble_advert | можно менять |
MQTT: состояние и команды
Zigbee2MQTT публикует состояние устройства в топик zigbee2mqtt/my_device (вместо my_device — имя, которое вы дали устройству). Пример сообщения:
{
"power": 12.4,
"current": 0.06,
"energy": 3.21,
"power_failure_mode": "last_state",
"actual_order": "stop",
"order_timer": 2147483648,
"pre_order_timer": 2147483648,
"timer_unit": "second",
"led_mode": "led_on",
"pilot_wire_relay_mode": "relay_on",
"order_scrolling_mode": "forward",
"order_number_supported": "four_orders",
"fallback_order": "stop",
"pilotwire_set_order": "stop",
"linkquality": 120
}
Команды отправляют в zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"power_failure_mode":"off"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"timer_unit":"minutes"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"led_mode":"led_off"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"pilot_wire_relay_mode":"relay_off"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"order_scrolling_mode":"backward"}'
Проверить топики и сообщения прямо из браузера — MQTT-клиент.
Как подключить
- В Zigbee2MQTT нажмите «Разрешить подключение» (Permit join).
- Переведите устройство в режим сопряжения: обычно — долгое нажатие кнопки сброса (5–10 секунд) до мигания индикатора; лампы — включить и выключить питание 5–6 раз подряд.
- Держите устройство рядом с координатором или ретранслятором, пока идёт сопряжение.
- Дайте устройству понятное имя — от него зависят топики MQTT и объекты в Home Assistant.
Точная процедура и особенности модели — страница устройства в документации Zigbee2MQTT. Нет координатора — подбор Zigbee-стика.