Что умеет
| Функция | Свойство | Значения | Управление |
|---|---|---|---|
| Вкл / выкл | state | idle, ring, talk, open, drop | только чтение |
| Mode | mode | never, once, always, drop | можно менять |
| Sound | sound | — | можно менять |
| Time ring | time_ring | sec · 0…600 | можно менять |
| Time talk | time_talk | sec · 0…600 | можно менять |
| Time open | time_open | sec · 0…600 | можно менять |
| Time bell | time_bell | sec · 0…600 | можно менять |
| Time report | time_report | min · 0…1440 | можно менять |
| Заряд батареи | battery | % · 0…100 | только чтение |
MQTT: состояние и команды
Zigbee2MQTT публикует состояние устройства в топик zigbee2mqtt/my_device (вместо my_device — имя, которое вы дали устройству). Пример сообщения:
{
"state": "idle",
"mode": "never",
"sound": false,
"time_ring": 300,
"time_talk": 300,
"time_open": 300,
"time_bell": 300,
"time_report": 720,
"battery": 87,
"linkquality": 120
}
Команды отправляют в zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"mode":"once"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"sound":true}'
Проверить топики и сообщения прямо из браузера — MQTT-клиент.
Как подключить
- В Zigbee2MQTT нажмите «Разрешить подключение» (Permit join).
- Переведите устройство в режим сопряжения: обычно — долгое нажатие кнопки сброса (5–10 секунд) до мигания индикатора; лампы — включить и выключить питание 5–6 раз подряд.
- Держите устройство рядом с координатором или ретранслятором, пока идёт сопряжение.
- Дайте устройству понятное имя — от него зависят топики MQTT и объекты в Home Assistant.
Точная процедура и особенности модели — страница устройства в документации Zigbee2MQTT. Нет координатора — подбор Zigbee-стика.