Zigbee

Zigbee-устройства живут в сети Zigbee2MQTT (z2m). Homer открывает сеть, показывает, что в ней есть, переименовывает устройства и привязывает кнопки. Голосом — через колонку: Новое Zigbee-устройство голосом.

Где это

	Где
Приложение	Настройки → Устройства → Zigbee-устройства → «Добавить устройство» или «+» в шапке плана → Zigbee
Веб	Меню → Состояние дома и лента событий → Zigbee

Сетью распоряжаются владелец и мастер. Если мост Zigbee2MQTT не подключён к HA через MQTT, экран так и скажет: «Мост Zigbee2MQTT не найден в Home Assistant».

Добавить устройство

1. Откройте экран добавления и нажмите «Открыть сеть» (в вебе — «Открыть сеть на 2 мин»). Сам «+» в шапке сеть не открывает: случайное касание настенного планшета не должно пускать в дом кого попало.
2. Переведите устройство в режим сопряжения — обычно удержание кнопки 5–10 секунд или вставленная батарейка. Таблица по видам устройств — в голосовом добавлении.
3. Устройство появится в списке «Устройства сети» с меткой «новое», когда мост его опросит.
4. Нажмите на строку и выберите комнату — см. Как устройство попадает на план.

В приложении сеть закрывается сама, когда вы уходите с экрана. В вебе — по истечении двух минут или кнопкой «Закрыть сеть».

Список устройств сети

В списке — ровно то, что мост считает своим. Сверху подключившееся при открытом экране, за ним то, что ещё не на плане, потом уже расставленное.

У каждой строки видна связь — linkquality от моста:

Подпись	Что значит
«связь 120» и зелёная точка	Хорошо
Жёлтая точка	Средне
Красная точка	Слабо: команды будут теряться. Перенесите устройство или поставьте рядом роутер сейчас, пока стоите рядом, а не через неделю, когда свет начнёт «иногда не включаться»
«связь не измерена»	Устройство ещё ничего не сказало
«молчит»	Мерка есть, показаний нет — худший исход сопряжения

Если строка не нажимается, под ней сказано почему:

• «мост ещё не опросил устройство» — разбудите его: нажмите кнопку и подержите несколько секунд. Батарейные кнопки засыпают посреди опроса.
• «мост не знает, что это за устройство» — у Zigbee2MQTT нет конвертера. Обновите мост или опишите устройство внешним конвертером.
• «кнопка или пульт» — на план не ставится, см. Кнопки.

Действия с устройством

Кнопка	Что делает
Переопросить	Мост заново знакомится с устройством. Батарейное разбудите кнопкой
Перепривязать	Заново настраивает привязки и отчёты устройства
Прошивка / Проверить прошивку	Есть ли новая. Обновление идёт до получаса, всё это время устройство может не отвечать. Итог — в журнале и ленте событий
Переименовать…	См. ниже
Убрать из сети…	Мост просит устройство уйти. Не ответило — появится «Забыть принудительно…»: мост забудет его у себя, а само устройство останется в старой сети, его надо сбросить руками

Все действия пишутся в журнал дома.

Переименовать

«Переименовать…» у строки устройства. Имя — до 80 знаков, без #, +, /.

Новое имя получает устройство в мосте, а с ним — его сущности в Home Assistant и ссылки в планах домов. После переименования показывается отчёт:

• какие сущности переименованы и какие пропущены (с причиной);
• какие планы обновлены;
• «Проверьте вручную: в YAML ещё стоит старый id» — файл и строка;
• в каких автоматизациях, скриптах, сценах, зонах и группах упоминается устройство.

WARNING

Ссылки в YAML-пакетах Home Assistant сами не правятся. Если отчёт показал файл — поправьте его, иначе пакет молча перестанет работать.

Кнопки и их нажатия

Кнопку или пульт на план не ставят — у строки вместо «на план» стоит «нажатия» (в вебе — «Нажатия…», только владельцу).

1. Откройте нажатия кнопки. Homer спросит дом, что кнопка делает сейчас.
2. Каждому нажатию — одно нажатие, двойное, долгое и т. д., что умеет кнопка — выберите лампу или реле с плана. «Ничего не делает» — отвязать.
3. «Сохранить».

Привязка записывается в Home Assistant автоматизацией homer_btn_<имя кнопки>. Она работает сама: при выключенном планшете, закрытом приложении и браузере. Если в доме уже есть правило для этой кнопки, написанное не в Homer, сохранение заменит его — об этом предупредят.

Снять все нажатия — значит удалить автоматизацию; перед этим спросят.

Такая кнопка работает через Home Assistant: нажатие → мост → HA → лампа. Если HA или мост лежат, она не сработает. Чтобы свет работал и тогда, нужна прямая привязка.

Прямая привязка пульта

Прямая привязка (bind) — пульт шлёт команду лампе или группе сам, по Zigbee, мимо координатора и HA. Свет переключается, даже когда дом не отвечает.

Где: в вебе — Состояние дома → Zigbee → Прямая привязка, в приложении — внизу экрана Добавить устройство (через сайдкар, владельцу и мастеру).

1. Выберите пульт, при нескольких выходах — выход.
2. Выберите, что он включает: лампу или группу (например, нативную группу гостиной).
3. Отметьте команды: вкл/выкл, яркость, цвет.
4. Нажмите любую кнопку пульта — он на батарейке и спит — и сразу «Привязать».

Если мост ответит, что часть команд не легла, разбудите пульт и повторите. Готовые привязки видны списком над формой, у каждой — «Отвязать».

Привязать можно только пульт, который умеет слать команды свету: у него в описании моста есть исходящие кластеры genOnOff или genLevelCtrl. Подходят IKEA RODRET, STYRBAR и подобные. Простые кнопки вроде IH-K663 (TS0041) этого не умеют и в списке пультов не появятся.

Память ламп

Память ламп откатывает изменения, пришедшие мимо HA. Лампы под прямой привязкой сайдкар записывает в input_text.homer_bound_lamps, и откат их не трогает. Перевзвод яркости для выключателя у них остаётся.

Карта связи на плане

Качество связи можно увидеть на самом плане — чтобы понять, куда ставить ретранслятор.

1. Настройки → Отладка → Демо и отладка → «Режим отладки». Вокруг каждого устройства появится ореол: зелёный — связь хорошая, красный — команды теряются или ползут. Чем хуже связь, тем больше пятно.
2. «Обновить карту связей» — мост обходит сеть заново. Кто не ответил — перечислено поимённо в строке «не ответили: …».

Оценка — худшая из двух мерок: linkquality моста (как громко координатор слышит устройство) и задержка отклика (весь путь от нажатия до отчёта).

TIP

Сразу после перезапуска Zigbee2MQTT показаний нет ни у кого, и минуту весь дом будет «молчит». Это не поломка.

Ещё одна подсказка — кнопка «Покрытие датчиков и Zigbee» в шапке плана: конусы датчиков движения и слабые Zigbee-устройства с подсказкой, куда бы роутер.

Availability: мёртвое устройство видно мёртвым

В Zigbee2MQTT включён availability. Без него мост помнит последнее состояние ушедшего из сети устройства: лампа, которой уже нет, числится горящей.

Так 10.10.2026 лампа «Санузел» ушла из сети, а z2m помнил ей «включено». HA считал горящим весь дом, тумблер «Свет во всём доме» залипал. Теперь такая лампа — «недоступно», а карточка дома называет 1–2 горящие лампы, чтобы такую было видно сразу.

Если Zigbee2MQTT лежит целиком, поднимается тревога «zigbee2mqtt лежит».

Нативные группы z2m

Светильник «весь дом» — это семь отдельных команд по радио: лампы гаснут волной, а мёртвая лампа тормозит остальных. Групповая команда Zigbee — одна посылка, лампы срабатывают разом. Поэтому лестница света шлёт полную команду группе z2m.

Группа	id	Лампы
homer_house_zigbee	902	Пять ламп гостиной, коридор, санузел
homer_living_zigbee	903	Пять ламп гостиной

Состав групп описан в tools/ha-package/zigbee-groups.json. Сами группы в z2m держит tools/z2m-groups.py:

python tools/z2m-groups.py          # сверить и показать, чего не хватает
python tools/z2m-groups.py apply    # создать группы и добавить участников

Скрипт только добавляет: лишних участников и чужие группы не трогает, только сообщает о них. Добавление участника свет не меняет.

WARNING

id 901 не использовать: под ним в z2m живёт default_bind_group, и группа с этим id публикуется под его именем.

Состав группы меняется правкой zigbee-groups.json и прогоном apply. Скрипт ходит в mosquitto сервера дома по SSH; адрес задаётся переменной HOMER_SSH, например HOMER_SSH="ssh root@192.168.1.10".