Что умеет
| Функция | Свойство | Значения | Управление |
|---|---|---|---|
| Заряд батареи | battery | % · 0…100 | только чтение |
| Min level (1) | min_level_1 | 1…255 | можно менять |
| Min level (2) | min_level_2 | 1…255 | можно менять |
| Min level (3) | min_level_3 | 1…255 | можно менять |
| Min level (4) | min_level_4 | 1…255 | можно менять |
| Min level (5) | min_level_5 | 1…255 | можно менять |
| Min level (6) | min_level_6 | 1…255 | можно менять |
| Min level (7) | min_level_7 | 1…255 | можно менять |
| Min level (8) | min_level_8 | 1…255 | можно менять |
| Max level (1) | max_level_1 | 1…255 | можно менять |
| Max level (2) | max_level_2 | 1…255 | можно менять |
| Max level (3) | max_level_3 | 1…255 | можно менять |
| Max level (4) | max_level_4 | 1…255 | можно менять |
| Max level (5) | max_level_5 | 1…255 | можно менять |
| Max level (6) | max_level_6 | 1…255 | можно менять |
| Max level (7) | max_level_7 | 1…255 | можно менять |
| Max level (8) | max_level_8 | 1…255 | можно менять |
| Night level (1) | night_level_1 | 1…20 | можно менять |
| Night level (2) | night_level_2 | 1…20 | можно менять |
| Night level (3) | night_level_3 | 1…20 | можно менять |
| Night level (4) | night_level_4 | 1…20 | можно менять |
| Night level (5) | night_level_5 | 1…20 | можно менять |
| Night level (6) | night_level_6 | 1…20 | можно менять |
| Night level (7) | night_level_7 | 1…20 | можно менять |
| Night level (8) | night_level_8 | 1…20 | можно менять |
| Действие (нажатие кнопки) | action | on_1, on_2, on_3, on_4, on_5, on_6, on_7, on_8 … | только чтение |
MQTT: состояние и команды
Zigbee2MQTT публикует состояние устройства в топик zigbee2mqtt/my_device (вместо my_device — имя, которое вы дали устройству). Пример сообщения:
{
"battery": 87,
"min_level_1": 128,
"min_level_2": 128,
"min_level_3": 128,
"min_level_4": 128,
"min_level_5": 128,
"min_level_6": 128,
"min_level_7": 128,
"min_level_8": 128,
"max_level_1": 128,
"max_level_2": 128,
"max_level_3": 128,
"max_level_4": 128,
"max_level_5": 128,
"linkquality": 120
}
Устройство только передаёт данные — команд у него нет.
Проверить топики и сообщения прямо из браузера — MQTT-клиент.
Пример автоматизации Home Assistant
Zigbee2MQTT создаёт объекты Home Assistant по имени устройства. Если назвать его my_device, автоматизация в automations.yaml может выглядеть так:
- alias: "Кнопка"
mode: single
triggers:
- trigger: mqtt
topic: zigbee2mqtt/my_device
value_template: "{{ value_json.action }}"
payload: "on_1"
actions:
- action: light.toggle
target:
entity_id: light.living_room
Проверить YAML на ошибки — проверка YAML.
Как подключить
- В Zigbee2MQTT нажмите «Разрешить подключение» (Permit join).
- Переведите устройство в режим сопряжения: обычно — долгое нажатие кнопки сброса (5–10 секунд) до мигания индикатора; лампы — включить и выключить питание 5–6 раз подряд.
- Держите устройство рядом с координатором или ретранслятором, пока идёт сопряжение.
- Дайте устройству понятное имя — от него зависят топики MQTT и объекты в Home Assistant.
Точная процедура и особенности модели — страница устройства в документации Zigbee2MQTT. Нет координатора — подбор Zigbee-стика.