Не спариваются Zigbee‑устройства в Home Assistant: быстрый план исправления
Если устройство не находится при Pairing / Add device / Permit join, почти всегда причина одна из четырёх: сеть не открыта для присоединения, устройство не в factory reset, координатор занят другим стеком (ZHA/Zigbee2MQTT), либо мешают связь/сон батарейного датчика. Ниже — короткий чек‑лист и точечные решения.
Правильный порядок: сначала Permit Join → сразу переводите устройство в pairing. Иначе окно присоединения может закончиться, а батарейный девайс — “уснуть”.
Оглавление
Что такое Permit Join и почему без него не подключится
Permit Join — временное разрешение вашей Zigbee‑сети принимать новые устройства. По умолчанию сеть закрыта (это нормально и безопаснее). Важно: разрешение действует ограниченное время (часто 1–4 минуты), а устройство должно быть сброшено и действительно находиться в режиме добавления.
Проверка за 2 минуты: 9 пунктов
- Permit Join включён сейчас, а не “включал минуту назад”.
- Таймер join ещё не истёк — откройте join заново.
- Устройство сделано factory reset (не путать с “моргает/пищит”).
- Устройство не осталось в старой Zigbee‑сети (старый хаб/координатор).
- На одном координаторе запущен только один стек: или ZHA, или Zigbee2MQTT.
- Выбран верный serial‑порт координатора (после перезагрузок порты могут меняться).
- Координатор вынесен на USB‑удлинитель и не торчит рядом с источниками помех.
- На время добавления расстояние 0,5–2 м до координатора (или стабильного Zigbee‑роутера).
- Для батарейных устройств: не “засыпает” ли устройство — держите его активным кнопкой.
Симптомы и решения
Быстрая таблица диагностики
| Симптом | Что это обычно значит | Что сделать |
|---|---|---|
| Включили join, но в логах вообще нет событий | Устройство не в pairing/не сброшено | Повторите factory reset и сразу запускайте pairing |
| Устройство находится, но зависает на добавлении (timeout) | Сон/слабый сигнал/помехи | Поднести ближе, убрать USB3‑помехи, “будить” устройство кнопкой |
| В ZHA добавляется, в Zigbee2MQTT — нет (или наоборот) | Конфликт доступа к координатору/не тот порт | Оставьте один стек, проверьте порт и перезапустите интеграцию/аддон |
| После смены координатора ничего не добавляется | Устройства “помнят” старую сеть | Удалить из старой системы (если возможно) + factory reset + добавить заново |
ZHA: настройка Permit Join и конфликты
В ZHA открывайте сеть через добавление устройства в интерфейсе или через действие zha.permit (удобно для контроля времени):
duration: 120
Если join не работает “как будто вообще”, проверьте главное: координатор не должен одновременно использоваться другим приложением/аддоном. Любые ошибки вида “порт занят/не удалось открыть” почти всегда указывают на конфликт или неверный serial.
ZHA и Zigbee2MQTT нельзя одновременно подключить к одному и тому же координатору. Выберите один вариант и отключите второй.
Zigbee2MQTT: где ломается joining
В Zigbee2MQTT убедитесь, что вы включили Permit join именно сейчас и сразу запускаете pairing на устройстве. Если поведение странное, часто помогает простой цикл: закрыть join → открыть join снова, затем сразу переводить девайс в режим добавления.
Если “ничего не видит”, а координатор точно подключён:
- проверьте, что ZHA не использует этот же координатор;
- перепроверьте serial‑настройки и перезапустите аддон после изменений;
- если устройство находится, но интервью срывается — это чаще связь/сон, а не “настройки”.
Радиопомехи, расстояние и «сон» батарейных датчиков
Zigbee работает на 2,4 ГГц, поэтому очень влияет расположение координатора и шум от техники.
Что помогает чаще всего:
- поставить координатор на USB‑удлинитель 0,5–1,5 м;
- убрать от USB3‑портов/хабов, SSD/дисков, Wi‑Fi‑роутера, плотных металлических корпусов;
- добавлять устройство сначала рядом, а потом переносить на место;
- батарейные датчики во время интервью держать активными (нажимать кнопку/выполнять действие раз в 20–30 секунд, пока идёт добавление).
Тест “на столе”: если устройство стабильно добавляется рядом с координатором, а на месте — нет, проблема почти точно в связи/помехах/недостатке Zigbee‑роутеров, а не в Permit Join.
Частые ошибки
- Включают pairing на устройстве, а Permit Join включают позже.
- Путают “режим добавления” с factory reset (без сброса устройство ищет старую сеть).
- Держат координатор прямо в USB‑порту рядом с шумными устройствами.
- Пытаются управлять одним координатором сразу через ZHA и Zigbee2MQTT.
- Добавляют батарейный датчик далеко от сети и не дают ему завершить интервью (он “уснул”).
FAQ
Сколько держать Permit Join включённым?
Обычно достаточно 60–180 секунд. Если устройство добавляется медленно (или батарейное), поставьте 120–300 секунд и держите девайс активным.
Можно ли добавить устройство без сброса?
Редко. В большинстве случаев нужен factory reset, иначе устройство будет пытаться вернуться в прежнюю сеть.
Почему устройство добавилось, но работает нестабильно?
Чаще всего слабый сигнал: вынесите координатор, добавьте питаемые Zigbee‑роутеры (розетки/реле/лампы), дайте сети 10–30 минут “устояться”, затем переподключите проблемный датчик ближе к стабильному узлу.