Что умеет
| Функция | Свойство | Значения | Управление |
|---|---|---|---|
| Действие (нажатие кнопки) | action | hold_switch_1, hold_switch_2, single_switch_1, single_switch_2, double_switch_1, double_switch_2 | только чтение |
| Switch (switch_1) | state_switch_1 | — | можно менять |
| (1) Power-on behavior (switch_1) | power_on_behavior_switch_1 | off, on, toggle, previous | можно менять |
| (1) Relay mode (switch_1) | relay_mode_switch_1 | control_relay, decoupled | можно менять |
| (1) Allow double clicks (switch_1) | allow_double_click_switch_1 | — | можно менять |
| (1) Identify (switch_1) | identify_switch_1 | identify | можно менять |
| (1) LED indication (switch_1) | led_indicator_on_enable_switch_1 | — | можно менять |
| (1) Hue (switch_1) | led_indicator_on_h_switch_1 | ° · 0…359 | можно менять |
| (1) Saturation (switch_1) | led_indicator_on_s_switch_1 | 0…254 | можно менять |
| (1) Brightness (switch_1) | led_indicator_on_b_switch_1 | 1…254 | можно менять |
| (1) LED indication (switch_1) | led_indicator_off_enable_switch_1 | — | можно менять |
| (1) Hue (switch_1) | led_indicator_off_h_switch_1 | ° · 0…359 | можно менять |
| (1) Saturation (switch_1) | led_indicator_off_s_switch_1 | 0…254 | можно менять |
| (1) Brightness (switch_1) | led_indicator_off_b_switch_1 | 1…254 | можно менять |
| Switch (switch_2) | state_switch_2 | — | можно менять |
| (2) Power-on behavior (switch_2) | power_on_behavior_switch_2 | off, on, toggle, previous | можно менять |
| (2) Relay mode (switch_2) | relay_mode_switch_2 | control_relay, decoupled | можно менять |
| (2) Allow double clicks (switch_2) | allow_double_click_switch_2 | — | можно менять |
| (2) Identify (switch_2) | identify_switch_2 | identify | можно менять |
| (2) LED indication (switch_2) | led_indicator_on_enable_switch_2 | — | можно менять |
| (2) Hue (switch_2) | led_indicator_on_h_switch_2 | ° · 0…359 | можно менять |
| (2) Saturation (switch_2) | led_indicator_on_s_switch_2 | 0…254 | можно менять |
| (2) Brightness (switch_2) | led_indicator_on_b_switch_2 | 1…254 | можно менять |
| (2) LED indication (switch_2) | led_indicator_off_enable_switch_2 | — | можно менять |
| (2) Hue (switch_2) | led_indicator_off_h_switch_2 | ° · 0…359 | можно менять |
| (2) Saturation (switch_2) | led_indicator_off_s_switch_2 | 0…254 | можно менять |
| (2) Brightness (switch_2) | led_indicator_off_b_switch_2 | 1…254 | можно менять |
| State (cover) | current_state_cover | OPEN, CLOSE, STOP | можно менять |
| Position (cover) | position_cover | % · 0…100 | можно менять |
| Cover mode (cover) | cover_mode_cover | — | только чтение |
| Calibration time (cover) | calibration_time_cover | s · 0…3600 | можно менять |
| Motor timeout (cover) | motor_timeout_cover | s · 0…3600 | можно менять |
| Buttons mode (cover) | buttons_mode_cover | normal, inverted | можно менять |
| Identify (cover) | identify_cover | identify | можно менять |
| LED indication (cover) | led_indicator_off_enable_cover | — | можно менять |
| Hue (cover) | led_indicator_off_h_cover | ° · 0…359 | можно менять |
| Saturation (cover) | led_indicator_off_s_cover | 0…254 | можно менять |
| Brightness (cover) | led_indicator_off_b_cover | 1…254 | можно менять |
| Защита от детей | child_lock | — | можно менять |
| Serial Number | serial_number | — | только чтение |
| Neutral presence | neutral_presence | — | только чтение |
| Power profile | power_profile | quick, af_250, af_500, af_750, af_1000, af_1250, af_1750, af_2000 … | можно менять |
| Led indication type | led_indication_type | continuous, flashes | можно менять |
| Resets count | resets_count | — | только чтение |
| Uptime | uptime | s | только чтение |
| Button clicks count 1 | button_clicks_count_1 | — | только чтение |
| Button clicks count 2 | button_clicks_count_2 | — | только чтение |
| Button clicks count 3 | button_clicks_count_3 | — | только чтение |
| Relay switches count 1 | relay_switches_count_1 | — | только чтение |
| Relay switches count 2 | relay_switches_count_2 | — | только чтение |
MQTT: состояние и команды
Zigbee2MQTT публикует состояние устройства в топик zigbee2mqtt/my_device (вместо my_device — имя, которое вы дали устройству). Пример сообщения:
{
"state_switch_1": "ON",
"power_on_behavior_switch_1": "off",
"relay_mode_switch_1": "control_relay",
"allow_double_click_switch_1": false,
"identify_switch_1": "identify",
"led_indicator_on_enable_switch_1": false,
"led_indicator_on_h_switch_1": 180,
"led_indicator_on_s_switch_1": 127,
"led_indicator_on_b_switch_1": 128,
"led_indicator_off_enable_switch_1": false,
"led_indicator_off_h_switch_1": 180,
"led_indicator_off_s_switch_1": 127,
"led_indicator_off_b_switch_1": 128,
"state_switch_2": "ON",
"linkquality": 120
}
Команды отправляют в zigbee2mqtt/my_device/set:
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state_switch_1":"TOGGLE"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"state_switch_2":"TOGGLE"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"power_on_behavior_switch_1":"on"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"relay_mode_switch_1":"decoupled"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"allow_double_click_switch_1":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_switch_1
Проверить YAML на ошибки — проверка YAML.
Как подключить
- В Zigbee2MQTT нажмите «Разрешить подключение» (Permit join).
- Переведите устройство в режим сопряжения: обычно — долгое нажатие кнопки сброса (5–10 секунд) до мигания индикатора; лампы — включить и выключить питание 5–6 раз подряд.
- Держите устройство рядом с координатором или ретранслятором, пока идёт сопряжение.
- Дайте устройству понятное имя — от него зависят топики MQTT и объекты в Home Assistant.
Точная процедура и особенности модели — страница устройства в документации Zigbee2MQTT. Нет координатора — подбор Zigbee-стика.