Поиск устройств: Радар

Настройки → Радар находит координаторы (сетевые мосты) вашей локации и показывает их устройства: что уже заведено в кабинете, а что можно добавить. Раздел доступен только владельцу локации.

Координаторы бывают четырёх типов:

  • zigbee2mqtt — Zigbee-сеть вашего хаба;

  • Milafire — шлюз каминов Milafire, список устройств присылает сам шлюз;

  • Generic MQTT — собственные и самодельные устройства, которые публикуют данные напрямую в облако по топикам generic/{токен}, без отдельного моста;

  • Amethyst — контроллеры печей «Пар Жар». В их строках показаны уже заведённые устройства, поэтому кнопок «Добавить» и «Открыть» там нет.

Для первых трёх типов у локации должна быть учётная запись MQTT в Рокет Хоум, а мост — публиковать данные в облако.

Как найти и добавить устройство

  1. Откройте Настройки → Радар. Поиск координаторов начнётся сам, найденные появятся карточками с числом устройств. Повторить поиск можно кнопкой «Пересканировать». Если показано «Координаторы не найдены», проверьте, что мост включён и подключён к облаку.

  2. Нажмите на карточку координатора, затем «Сканировать устройства». Координатор zigbee2mqtt должен ответить за 8 секунд, иначе Радар покажет ошибку. У Generic MQTT retained-сообщения видны сразу, остальные устройства появляются, пока идёт сканирование.

  3. У нужного устройства нажмите «Добавить»: откроется короткая форма с полями «Название», «Комната» и «Приоритетное устройство». Тип и умения меняются в «Полной форме», подробнее — Подключение устройства. У заведённого устройства вместо этой кнопки стоит «Открыть».

Чекбокс «Скрыть уже подключённые устройства» оставляет только незаведённые устройства, а надпись «Показано: N» сообщает, сколько строк в списке.

Радар запоминает список: после перезагрузки строки появляются сразу с пометкой «По последним данным», а живые сообщения из сети их обновляют. Устройство, которого не было в сети 30 дней, из списка пропадает. Если связи с брокером нет, Радар показывает это над списком и предлагает кнопку «Переподключиться».

Совет

Пример с Generic MQTT — DIY-измеритель CO₂ на ESPHome: устройство публикует данные в generic/{токен}, Радар его находит, и оно добавляется парой кликов.

Zigbee: сопряжение и чёрный список

Кнопка «Разрешить сопряжение» у координатора zigbee2mqtt открывает окно примерно на 4 минуты: в это время можно подключать новые Zigbee-устройства. Окно закрывается само или повторным нажатием кнопки. Когда устройство входит в сеть, Радар пишет «Устройство подключается…».

Если окно закрылось само, а ни одно устройство так и не ответило, Радар выводит предупреждение. Причины и что делать — в разделе Устройство мигает, но не появляется. После закрытия окна кнопкой предупреждения нет.

Под кнопкой есть блок «В чёрном списке»: туда попадают устройства, удалённые с опцией «Занести в чёрный список». Координатор не пустит их обратно в сеть, сколько ни сбрасывай. Кнопка «Убрать из чёрного списка» снимает запрет, но zigbee2mqtt может потребовать перезапуска — Радар об этом предупредит.

Рядом показаны версия координатора и канал (z2m … · канал …). Если мост пропал со связи, появляется надпись «Координатор z2m офлайн», и его устройства недоступны.

Что показано в карточке устройства

  • Индикатор активности — кружок перед названием. Он кратко загорается зелёным, когда от устройства выбранного координатора приходит сообщение.

  • Модель, питание («От сети» или «От батареи») и версия прошивки — по данным координатора. Картинка показывается только для модели из каталога оборудования, у которой есть изображение, и может отличаться от вашего экземпляра.

  • Связь (zigbee2mqtt): уровень сигнала (LQI), заряд батареи, статус «На связи» или «Нет связи» и время последней активности. Если устройство давно молчит, показания бледнеют: данные могли устареть. Что делать при «Нет связи», описано в разделе «Нет связи» в Радаре.

  • Предупреждения: «Отключено в z2m», «Не опознано: интервью не завершено», «Модель не поддерживается z2m». Координатор видит такое устройство, но работать с ним полноценно не может. Нажмите на предупреждение или на знак вопроса, чтобы открыть разбор (см. Устройство не опознано: что делать).

Управление Zigbee-устройством

Для этих действий мост локации должен быть на связи.

  • «Переопросить устройство» — координатор опрашивает устройство заново. Помогает, если интервью не завершилось или функции определились неверно.

  • «Удалить из сети» отвязывает устройство от координатора, Радар спрашивает подтверждение. Если устройство заведено в кабинете, удалится и его запись. Для устройства, которое не отвечает, включите «Принудительно». Опция «Занести в чёрный список» не пустит устройство обратно в сеть (см. блок «В чёрном списке» выше).

Устройство не опознано: что делать

«Не опознано» значит, что координатор подключил устройство, но не дочитал его описание: интервью не завершено. До тех пор zigbee2mqtt не знает ни модели, ни умений, поэтому завести устройство и управлять им нельзя. Чаще всего так выглядит спящее устройство на батарейке: оно выходит на связь только в короткие моменты пробуждения.

В окне разбора есть причина, а под ссылкой «Показать подробности» — исходный текст ошибки от zigbee2mqtt. Что делать:

  1. Нажмите «Ждать пробуждения» и разбудите устройство: нажмите на нём кнопку, откройте крышку датчика или пройдите мимо. Пока страница открыта, координатор опрашивает его примерно раз в полторы минуты в течение 10 минут. Результат появится в той же строке: «Опознано: <модель>» или «Не дождались». Ждать можно только одно устройство за раз, и ожидание прекращается, если уйти со страницы.

  2. На время опроса поднесите устройство ближе к координатору.

  3. Проверьте батарейку: почти разряженная даёт именно такую картину.

  4. Удалите устройство из сети и подключите заново: нажмите «Разрешить сопряжение» и переведите устройство в режим сопряжения. При новом подключении координатор сам опрашивает устройство, и это самый надёжный способ.

  5. Если не хотите возиться, нажмите «Отключить в z2m». Координатор перестанет опрашивать устройство, а строка останется в списке с пометкой. Включить обратно можно в любой момент. Настройка заработает только после перезапуска zigbee2mqtt: кнопки перезапуска в Радаре нет намеренно, потому что при перезапуске перестаёт работать вся Zigbee-сеть.

«Модель не поддерживается z2m» — интервью прошло, но этой модели нет в справочнике zigbee2mqtt. Переопрос не поможет: нужно обновить zigbee2mqtt на мосте.

Прямая ссылка на координатор

На наклейку, упаковку или QR-код устройства можно поместить ссылку:

https://<адрес кабинета>/settings/radar/generic

Последний сегмент — тип координатора: zigbee2mqtt, milafire, generic или amethyst. По ссылке Радар сам находит координаторы, выбирает нужный и сканирует его устройства. Вам остаётся найти устройство и нажать «Добавить». Когда вы выбираете карточку координатора, адрес в браузере меняется на такую ссылку, и её можно скопировать.

  • Если вы не вошли в кабинет, сначала откроется вход, а затем ссылка.

  • Ссылка работает в текущей локации. Если устройство в другой локации, переключитесь на неё и откройте ссылку снова.

  • Ссылка указывает на тип координатора, а не на устройство. Если координаторов Amethyst несколько, выбирается первый по алфавиту. Если координатора такого типа нет, Радар сообщит об этом: проверьте локацию и питание моста, затем нажмите «Пересканировать».

См. также

Нашли ошибку на странице или не получилось? Напишите нам: rocket-home-ru@yandex.ru или в Telegram-группу https://t.me/RocketHome — укажите адрес страницы и что пошло не так.