Что умеет
| Функция | Свойство | Значения | Управление |
|---|---|---|---|
| Switch (buzzer) | state_buzzer | — | можно менять |
| Switch (heater) | state_heater | — | можно менять |
| Switch (led_red) | state_led_red | — | можно менять |
| Switch (led_green) | state_led_green | — | можно менять |
| Освещённость | illuminance | lx | только чтение |
| Температура | temperature | °C | только чтение |
| Влажность | humidity | % | только чтение |
| Движение | occupancy | — | только чтение |
| CO₂ | co2 | ppm | только чтение |
| Noise level | noise_level | dBA | только чтение |
| Noise | noise | — | только чтение |
| Noise threshold | noise_threshold | dBA · 0…150 | можно менять |
| Noise timeout | noise_timeout | s · 0…2000 | можно менять |
| Status led | status_led | — | можно менять |
| Connectivity | connectivity | offline, online, firmware_update, component_update | только чтение |
| Modbus slave id | modbus_slave_id | — | только чтение |
| Serial number | serial_number | — | только чтение |
| Fw version | fw_version | — | только чтение |
| Fw signature | fw_signature | — | только чтение |
| Boot version | boot_version | — | только чтение |
| Component version | component_version | — | только чтение |
| Component signature | component_signature | — | только чтение |
| Temperature offset | temperature_offset | °C · -10…10 | можно менять |
| Occupancy level | occupancy_level | — | только чтение |
| Occupancy sensitivity | occupancy_sensitivity | 0…2000 | можно менять |
| Occupancy timeout | occupancy_timeout | s · 0…2000 | можно менять |
| Летучие вещества (VOC) | voc | µg/m³ | только чтение |
| Ir rom id (ir) | ir_rom_id_ir | 0…79 | можно менять |
| Ir action (ir) | ir_action_ir | stop, learn_ram, learn_rom, play_ram, play_rom, clear_all_rom | можно менять |
MQTT: состояние и команды
Zigbee2MQTT публикует состояние устройства в топик zigbee2mqtt/my_device (вместо my_device — имя, которое вы дали устройству). Пример сообщения:
{
"state_buzzer": "ON",
"state_heater": "ON",
"state_led_red": "ON",
"state_led_green": "ON",
"illuminance": 120,
"temperature": 21.6,
"humidity": 46.2,
"occupancy": false,
"co2": 640,
"noise_level": 0,
"noise": false,
"noise_threshold": 75,
"noise_timeout": 1000,
"status_led": false,
"linkquality": 120
}
Команды отправляют в zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state_buzzer":"TOGGLE"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state_heater":"TOGGLE"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state_led_red":"TOGGLE"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state_led_green":"TOGGLE"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"status_led":true}'
Проверить топики и сообщения прямо из браузера — MQTT-клиент.
Пример автоматизации Home Assistant
Zigbee2MQTT создаёт объекты Home Assistant по имени устройства. Если назвать его my_device, автоматизация в automations.yaml может выглядеть так:
- alias: "Выключить на ночь"
mode: single
triggers:
- trigger: time
at: "23:30:00"
actions:
- action: switch.turn_off
target:
entity_id: switch.my_device_buzzer
Проверить YAML на ошибки — проверка YAML.
Как подключить
- В Zigbee2MQTT нажмите «Разрешить подключение» (Permit join).
- Переведите устройство в режим сопряжения: обычно — долгое нажатие кнопки сброса (5–10 секунд) до мигания индикатора; лампы — включить и выключить питание 5–6 раз подряд.
- Держите устройство рядом с координатором или ретранслятором, пока идёт сопряжение.
- Дайте устройству понятное имя — от него зависят топики MQTT и объекты в Home Assistant.
Точная процедура и особенности модели — страница устройства в документации Zigbee2MQTT. Нет координатора — подбор Zigbee-стика.