Что умеет
| Функция | Свойство | Значения | Управление |
|---|---|---|---|
| Climate | system_mode, current_heating_setpoint, local_temperature | режим, целевая температура, температура в комнате | можно менять |
| Sensor mode | sensor_mode | room_temperature, floor_temperature, room_with_floor_limit | можно менять |
| Adaptive start | adaptive_start | — | можно менять |
| Max temperature limit | max_temperature_limit | °C · 5…35 | можно менять |
| Min temperature limit | min_temperature_limit | °C · 1…5 | можно менять |
| Boost | boost | ON, OFF | можно менять |
| Display brightness | display_brightness | 0…100 | можно менять |
| Holiday start stop | holiday_start_stop | 0…99 | можно менять |
| Holiday temperature | holiday_temperature | °C · 5…35 | можно менять |
| Frost protection | frost_protection | — | можно менять |
| Switch delay | switch_delay | s · 10…90 | можно менять |
| Power rating | power_rating | W · 0…4500 | можно менять |
| Open window active | open_window_active | — | можно менять |
| Open window sensing time | open_window_sensing_time | minutes · 1…30 | можно менять |
| Open window drop limit | open_window_drop_limit | C · 2…4 | можно менять |
| Open window off time | open_window_off_time | minutes · 10…60 | можно менять |
MQTT: состояние и команды
Zigbee2MQTT публикует состояние устройства в топик zigbee2mqtt/my_device (вместо my_device — имя, которое вы дали устройству). Пример сообщения:
{
"current_heating_setpoint": 21,
"local_temperature": 20.5,
"system_mode": "heat",
"sensor_mode": "room_temperature",
"adaptive_start": false,
"max_temperature_limit": 20,
"min_temperature_limit": 3,
"boost": "ON",
"display_brightness": 50,
"holiday_start_stop": 50,
"holiday_temperature": 20,
"frost_protection": false,
"switch_delay": 50,
"power_rating": 2250,
"linkquality": 120
}
Команды отправляют в zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"current_heating_setpoint":21.5}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"system_mode":"heat"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"sensor_mode":"floor_temperature"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"adaptive_start":true}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"boost":"OFF"}'
Проверить топики и сообщения прямо из браузера — MQTT-клиент.
Пример автоматизации Home Assistant
Zigbee2MQTT создаёт объекты Home Assistant по имени устройства. Если назвать его my_device, автоматизация в automations.yaml может выглядеть так:
- alias: "Ночью прохладнее"
mode: single
triggers:
- trigger: time
at: "23:00:00"
actions:
- action: climate.set_temperature
target:
entity_id: climate.my_device
data:
temperature: 18
Проверить YAML на ошибки — проверка YAML.
Как подключить
- В Zigbee2MQTT нажмите «Разрешить подключение» (Permit join).
- Переведите устройство в режим сопряжения: обычно — долгое нажатие кнопки сброса (5–10 секунд) до мигания индикатора; лампы — включить и выключить питание 5–6 раз подряд.
- Держите устройство рядом с координатором или ретранслятором, пока идёт сопряжение.
- Дайте устройству понятное имя — от него зависят топики MQTT и объекты в Home Assistant.
Точная процедура и особенности модели — страница устройства в документации Zigbee2MQTT. Нет координатора — подбор Zigbee-стика.