Что умеет
| Функция | Свойство | Значения | Управление |
|---|---|---|---|
| Присутствие | presence | — | только чтение |
| Вкл / выкл | state | none, presence, move | только чтение |
| Освещённость | illuminance | lx | только чтение |
| Min distance | min_distance | m · 0…8.4 | можно менять |
| Max distance | max_distance | m · 0…8.4 | можно менять |
| Target distance | target_distance | m · 0…9.9 | только чтение |
| Gate enable 01 | gate_enable_01 | disable, enable | можно менять |
| Gate enable 02 | gate_enable_02 | disable, enable | можно менять |
| Gate enable 03 | gate_enable_03 | disable, enable | можно менять |
| Gate enable 04 | gate_enable_04 | disable, enable | можно менять |
| Gate enable 05 | gate_enable_05 | disable, enable | можно менять |
| Gate enable 06 | gate_enable_06 | disable, enable | можно менять |
| Gate enable 07 | gate_enable_07 | disable, enable | можно менять |
| Gate enable 08 | gate_enable_08 | disable, enable | можно менять |
| Gate enable 09 | gate_enable_09 | disable, enable | можно менять |
| Gate enable 10 | gate_enable_10 | disable, enable | можно менять |
| Gate enable 11 | gate_enable_11 | disable, enable | можно менять |
| Configuration gate | configuration_gate | 1…11 | можно менять |
| Move threshold | move_threshold | 0…99 | можно менять |
| Presence threshold | presence_threshold | 0…99 | можно менять |
| Nearest target gate | nearest_target_gate | 0…11 | только чтение |
| Target countdown | target_countdown | s · 0…3600 | только чтение |
| Target velocity | target_velocity | m/s · -9.99…9.99 | только чтение |
| Debug switch | debug_switch | — | можно менять |
| Led mode | led_mode | silence, status | можно менять |
| Delay time | delay_time | s · 5…3600 | можно менять |
| Block time | block_time | s · 0…10 | можно менять |
| Judge logic | judge_logic | large_move, small_move, custom_move | можно менять |
| Start noise collect | start_noise_collect | start | можно менять |
| Noise collect status | noise_collect_status | start, ongoing, complete | только чтение |
| Device control | device_control | no_action, restart, reset_param | можно менять |
| Presence sensitivity | presence_sensitivity | high, medium, low, custom | можно менять |
| Move sensitivity | move_sensitivity | high, medium, low, custom | можно менять |
| Scene mode | scene_mode | custom, toilet, kitchen, corridor, bedroom, living_room, meeting_room | можно менять |
| Illuminance report | illuminance_report | — | можно менять |
| Move detect | move_detect | — | можно менять |
| Distance report | distance_report | — | можно менять |
| Speed report | speed_report | — | можно менять |
MQTT: состояние и команды
Zigbee2MQTT публикует состояние устройства в топик zigbee2mqtt/my_device (вместо my_device — имя, которое вы дали устройству). Пример сообщения:
{
"presence": false,
"state": "none",
"illuminance": 120,
"min_distance": 4,
"max_distance": 4,
"target_distance": 5,
"gate_enable_01": "disable",
"gate_enable_02": "disable",
"gate_enable_03": "disable",
"gate_enable_04": "disable",
"gate_enable_05": "disable",
"gate_enable_06": "disable",
"gate_enable_07": "disable",
"gate_enable_08": "disable",
"linkquality": 120
}
Команды отправляют в zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"gate_enable_01":"enable"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"gate_enable_02":"enable"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"gate_enable_03":"enable"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"gate_enable_04":"enable"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"gate_enable_05":"enable"}'
Проверить топики и сообщения прямо из браузера — MQTT-клиент.
Пример автоматизации Home Assistant
Zigbee2MQTT создаёт объекты Home Assistant по имени устройства. Если назвать его my_device, автоматизация в automations.yaml может выглядеть так:
- alias: "Свет по движению"
mode: single
triggers:
- trigger: state
entity_id: binary_sensor.my_device_presence
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-стика.