Что умеет
| Функция | Свойство | Значения | Управление |
|---|---|---|---|
| Движение | occupancy | — | только чтение |
| O sensitivity | o_sensitivity | sensitive, normal, cautious | можно менять |
| V sensitivity | v_sensitivity | speed_priority, normal_priority, accuracy_priority | можно менять |
| Led status | led_status | ON, OFF | можно менять |
| Vacancy delay | vacancy_delay | sec · 0…1000 | можно менять |
| Light on luminance prefer | light_on_luminance_prefer | 0…10000 | можно менять |
| Light off luminance prefer | light_off_luminance_prefer | 0…10000 | можно менять |
| Mode | mode | general_model, temporaty_stay, basic_detection, sensor_test | можно менять |
| Luminance level | luminance_level | — | только чтение |
| Reference luminance | reference_luminance | — | только чтение |
| Vacant confirm time | vacant_confirm_time | — | только чтение |
MQTT: состояние и команды
Zigbee2MQTT публикует состояние устройства в топик zigbee2mqtt/my_device (вместо my_device — имя, которое вы дали устройству). Пример сообщения:
{
"occupancy": false,
"o_sensitivity": "sensitive",
"v_sensitivity": "speed_priority",
"led_status": "ON",
"vacancy_delay": 500,
"light_on_luminance_prefer": 5000,
"light_off_luminance_prefer": 5000,
"mode": "general_model",
"luminance_level": 0,
"reference_luminance": 0,
"vacant_confirm_time": 0,
"linkquality": 120
}
Команды отправляют в zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"o_sensitivity":"normal"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"v_sensitivity":"normal_priority"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"led_status":"OFF"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"mode":"temporaty_stay"}'
Проверить топики и сообщения прямо из браузера — MQTT-клиент.
Пример автоматизации Home Assistant
Zigbee2MQTT создаёт объекты Home Assistant по имени устройства. Если назвать его my_device, автоматизация в automations.yaml может выглядеть так:
- alias: "Свет по движению"
mode: single
triggers:
- trigger: state
entity_id: binary_sensor.my_device_occupancy
to: "on"
conditions:
- condition: sun
after: sunset
actions:
- action: light.turn_on
target:
entity_id: light.hallway
Проверить YAML на ошибки — проверка YAML.
Как подключить
- В Zigbee2MQTT нажмите «Разрешить подключение» (Permit join).
- Переведите устройство в режим сопряжения: обычно — долгое нажатие кнопки сброса (5–10 секунд) до мигания индикатора; лампы — включить и выключить питание 5–6 раз подряд.
- Держите устройство рядом с координатором или ретранслятором, пока идёт сопряжение.
- Дайте устройству понятное имя — от него зависят топики MQTT и объекты в Home Assistant.
Точная процедура и особенности модели — страница устройства в документации Zigbee2MQTT. Нет координатора — подбор Zigbee-стика.