Если Zigbee2MQTT не находит устройство, начните с Permit join, питания и режима сопряжения точной модели. При interview failed устройство уже обнаружено, но опрос не завершился. Если раньше работало и стало offline, проверьте последние сообщения и питание. Сброс всей сети для этих проверок не нужен.
Быстрая таблица диагностики
| Симптом | С чего начать |
|---|---|
| Нет реакции на reset | Проверьте Permit join, инструкцию модели и батарею. Повторите попытку рядом с координатором. |
| Interview началось и прервалось | Проверьте питание, разбудите батарейный датчик штатной кнопкой и приблизьте его к координатору. |
| Датчик появился, нужного поля нет | Сверьте модель и фактический список exposes с каталогом Zigbee2MQTT. |
Работало и стало offline |
Сравните последнее сообщение, питание датчика и сетевых роутеров. Проверьте, не появились ли помехи. |
| После удаления не находится | Устройство могло сохранить старую сеть. Выполните reset по инструкции модели, затем новый Permit join. |
Если устройство ещё ни разу не подключалось
- Запишите точную модель с корпуса и проверьте её в официальном списке устройств Zigbee2MQTT. Похожее название магазина не гарантирует одинаковую электронику.
- Поставьте заведомо исправную батарею или проверьте питание сетевого устройства.
- Поднесите устройство на 0,5–1 метр к координатору. Первое подключение на рабочем месте в дальней теплице усложняет диагностику.
- Откройте permit join на ограниченное время. В интерфейсе Zigbee2MQTT сеть открывается на 254 секунды; можно выбрать подключение через конкретный роутер.
- Выполните заводской reset строго по инструкции модели. Признак pairing — обычно отдельная последовательность мигания, а не просто включение светодиода.
- Смотрите лог. Успешное присоединение должно дойти до завершённого interview, после которого появляются модель и доступные свойства.
Официальный порядок описан в инструкции Allowing devices to join. Если interview начался, но батарейный датчик уснул, коротко активируйте его кнопкой во время опроса, не выполняя новый reset.
Interview failed: на каком шаге остановилось подключение
Проверьте батарею, повторите попытку рядом с координатором и поддерживайте устройство в бодрствующем состоянии штатным коротким нажатием, если это предусмотрено его инструкцией. Дополнительные варианты разобраны в официальном FAQ по ошибкам interview.
В записи вашего датчика из bridge/devices различайте два результата:
| Поле | Что оно подтверждает |
|---|---|
interview_state: SUCCESSFUL |
опрос устройства завершён |
supported: true и нужные свойства в definition.exposes |
Zigbee2MQTT знает модель и её возможности |
Успешный interview возможен и при supported: false, когда definition отсутствует. Тогда проверьте точный model_id и поддержку модели; ещё одно удаление не добавит конвертер. Формат полей приведён в MQTT API Zigbee2MQTT.
Если устройство работало и пропало
Не удаляйте его сразу. Сначала сохраните 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.
По умолчанию, если availability включена, для сетевых устройств используется интервал 10 минут с последующей проверкой связи, для батарейных — 25 часов без опроса. Это контроль присутствия устройства, а не обещание нового измерения с таким интервалом. Сначала сравните свои настройки с документацией availability, затем решайте, действительно ли датчик пропал.
Данные есть в Zigbee2MQTT, но отсутствуют в приложении
Если в Zigbee2MQTT приходят новые показания, следующим шагом проверьте доставку данных в нужное приложение:
- Home Assistant: включены MQTT-интеграция и
homeassistant.enabledв Zigbee2MQTT; discovery не отключён для конкретного устройства. Настройки описаны в руководстве интеграции и параметрах устройства. - GrowerHub: модуль связи подключён к вашему действующему Zigbee2MQTT, выбран верный локальный
base_topic, устройство появилось в настройках, а его датчики назначены слотам теплицы в Конструкторе. Для существующей сети используйте проверку MQTT-моста.
Повторное сопряжение работающего датчика не требуется для подключения GrowerHub к существующему Zigbee2MQTT. Проверяйте путь одного нового измерения: устройство → Zigbee2MQTT → MQTT → приложение.
После удаления из сети
Удаление записи в Zigbee2MQTT не всегда сбрасывает само устройство. Оно может продолжать помнить старую сеть. Последовательность такая:
- закройте старый permit join;
- выполните заводской reset устройства;
- откройте новый permit join;
- держите устройство рядом с координатором до завершения interview;
- проверьте реальные значения и только потом переносите его в рабочую зону.
После переноса подождите несколько обычных циклов обновления. Если датчик снова исчезает только в теплице, pairing исправен — проблема в покрытии или помехах.
Какие сведения сохранить для диагностики
Запишите модель датчика, версию Zigbee2MQTT и прошивки координатора, время одной неудачной попытки и несколько строк лога до и после ошибки. Укажите, работало ли устройство раньше и что изменилось перед сбоем.
Для подробного лога временно установите log_level: debug в разделе advanced конфигурации Zigbee2MQTT. По умолчанию сообщения уровня debug не передаются в MQTT и веб-интерфейс: смотрите настроенный файл лога или консоль процесса. После записи попытки верните прежний уровень. Варианты вывода описаны в официальной инструкции Logging. Перед публикацией фрагмента уберите пароли, токены и ключ сети.
Когда устройство нельзя включать в автоматизацию
Не связывайте его с насосом, светом или вентиляцией, если interview не завершается, нужное свойство иногда отсутствует, данные скачут без физической причины или availability не проверена. Сначала добейтесь стабильного мониторинга. Пример того, как GrowerHub показывает зоны и свежесть данных, есть на странице автоматизации мини-фермы.
Итоговый чек-лист
- точная модель поддерживается;
- питание исправно;
- reset выполнен по инструкции;
- permit join открыт на время подключения;
- interview завершён;
- реальные
exposesпроверены; - после переноса сообщения приходят стабильно;
- старые данные блокируют опасные сценарии.
Если пройти пункты в этом порядке, становится понятно, что именно сломано: подключение, поддержка модели или рабочая Zigbee-сеть.
Для нового контура начните с координаторов и датчиков. В пути нового подключения GrowerHub кнопка «Разрешить подключение на 3 минуты» открывает сопряжение после настройки связи с координатором. В пути подключения существующего Zigbee2MQTT приложение ждёт импорт уже подключённых устройств.
Чтобы посмотреть, как показания собираются по зонам, откройте демоферму без регистрации и нажмите на влажность почвы любой теплицы. Появится история виртуального датчика: можно оценить график и интерфейс до подключения своей сети.