Если Zigbee-устройство не подключается, сначала определите сценарий: оно никогда не появлялось в сети, раньше работало и пропало или перестало подключаться после удаления. Для этих случаев нужны разные действия. Бесконечные нажатия кнопки и повторное удаление записи обычно только стирают полезные признаки.
Быстрая таблица диагностики
| Симптом | Вероятная причина | Первая проверка |
|---|---|---|
| В логе нет реакции на reset | устройство не вошло в режим pairing, батарея разряжена | инструкция точной модели, новая батарея, попытка рядом с координатором |
| В логе началось interview, затем ошибка | слабая связь, устройство уснуло, модель поддерживается частично | разбудить батарейное устройство, приблизить его, проверить страницу модели |
| Устройство подключилось, но нет нужного поля | другая ревизия или неполная поддержка | model, manufacturer, список exposes |
Работало и стало offline |
питание, покрытие, роутер сети или радиопомеха | последнее сообщение, батарея, соседние роутеры, положение координатора |
| После удаления не находится | устройство помнит старую сеть | заводской reset, затем новый permit join |
Если устройство ещё ни разу не подключалось
- Запишите точную модель с корпуса и проверьте её в официальном списке устройств Zigbee2MQTT. Похожее название магазина не гарантирует одинаковую электронику.
- Поставьте заведомо исправную батарею или проверьте питание сетевого устройства.
- Поднесите устройство на 0,5–1 метр к координатору. Первое подключение на рабочем месте в дальней теплице усложняет диагностику.
- Откройте permit join на ограниченное время. В интерфейсе Zigbee2MQTT сеть открывается на 254 секунды; можно выбрать подключение через конкретный роутер.
- Выполните заводской reset строго по инструкции модели. Признак pairing — обычно отдельная последовательность мигания, а не просто включение светодиода.
- Смотрите лог. Успешное присоединение должно дойти до завершённого interview, после которого появляются модель и доступные свойства.
Официальный порядок описан в инструкции Allowing devices to join. Если interview начался, но батарейный датчик уснул, коротко активируйте его кнопкой во время опроса, не выполняя новый reset.
Если устройство работало и пропало
Не удаляйте его сразу. Сначала сохраните friendly name, модель, время последнего сообщения и состояние питания. Затем проверьте по порядку:
- работает ли сам Zigbee2MQTT и видит ли координатор другие устройства;
- есть ли питание у пропавшего устройства или свежая батарея;
- не был ли выключен сетевой роутер, через который шёл маршрут;
- не появился ли рядом Wi‑Fi-роутер, SSD, USB 3.0 или другой источник помех 2,4 ГГц;
- возвращается ли устройство после активации кнопкой или краткого снятия питания.
linkquality полезен как сравнительный признак, но одно число не доказывает качество маршрута. Гораздо важнее повторяемость сообщений в рабочем месте. Zigbee2MQTT рекомендует вынести USB-координатор от компьютера экранированным удлинителем и при необходимости добавить качественные сетевые роутеры: улучшение дальности и стабильности.
Если устройства пропали после отключения электричества
Сначала разделите проблему координатора, питаемых роутеров и батарейных датчиков:
- убедитесь, что Zigbee2MQTT запустился с прежней папкой
dataи той же базой сети; - проверьте, что координатор виден на прежнем USB-порту и
bridge/stateсталonline; - включите все сетевые розетки и реле, которые раньше строили mesh;
- дайте сети восстановить маршруты, затем один раз разбудите батарейный датчик штатной кнопкой;
- сравните
last_seenнескольких устройств — одновременная потеря целой ветки чаще указывает на выключенный роутер сети; - только после проверки питания и логов решайте, нужен ли повторный pairing.
Не создавайте новую Zigbee-сеть и не удаляйте каталог data ради быстрой проверки: изменившийся network key потребует заново подключать все устройства. Для компьютера с Windows дополнительно проверьте, не сменился ли COM-порт после перезагрузки.
Как правильно читать availability
При включённой функции Zigbee2MQTT публикует online или offline в топик доступности устройства. Активные сетевые устройства и спящие батарейные датчики проверяются по-разному: батарейный датчик не обязан отправлять данные каждые десять минут. Поэтому слишком короткий пользовательский таймаут создаёт ложные аварии.
Проверьте настройки и стандартное поведение в документации Device Availability. Для сценария полива дополнительно задавайте собственную допустимую свежесть конкретного измерения: старое значение влажности нельзя считать нормальным только потому, что устройство ещё не помечено offline.
После удаления из сети
Удаление записи в Zigbee2MQTT не всегда сбрасывает само устройство. Оно может продолжать помнить старую сеть. Последовательность такая:
- закройте старый permit join;
- выполните заводской reset устройства;
- откройте новый permit join;
- держите устройство рядом с координатором до завершения interview;
- проверьте реальные значения и только потом переносите его в рабочую зону.
После переноса подождите несколько обычных циклов обновления. Если датчик снова исчезает только в теплице, pairing исправен — проблема в покрытии или помехах.
Когда устройство нельзя включать в автоматизацию
Не связывайте его с насосом, светом или вентиляцией, если interview не завершается, нужное свойство иногда отсутствует, данные скачут без физической причины или availability не проверена. Сначала добейтесь стабильного мониторинга. Пример того, как GrowerHub показывает зоны и свежесть данных, есть на странице автоматизации мини-фермы.
Итоговый чек-лист
- точная модель поддерживается;
- питание исправно;
- reset выполнен по инструкции;
- permit join открыт на время подключения;
- interview завершён;
- реальные
exposesпроверены; - после переноса сообщения приходят стабильно;
- старые данные блокируют опасные сценарии.
Если пройти пункты в этом порядке, становится понятно, что именно сломано: подключение, поддержка модели или рабочая Zigbee-сеть.
Для нового контура начните с мягких рекомендаций по координаторам и датчикам. После входа GrowerHub откроет permit join на три минуты и автоматически покажет завершившие interview устройства.