Радар (обнаружение устройств)¶
В разделе Настройки есть таб «Радар». Он находит координаторы (сетевые мосты) вашей локации — Zigbee2MQTT, Milafire, Generic MQTT — и показывает список устройств выбранной сети: что уже заведено в кабинете, а что можно добавить.
Как пользоваться¶
Убедитесь, что нужные мосты публикуют данные в вашем MQTT (и что у локации есть учётная запись MQTT в Рокет Хоум).
Откройте Настройки → Радар и нажмите «Сканировать». Радар опросит MQTT и покажет найденные координаторы карточками; на карточке видно, сколько устройств за ней числится. Повторный поиск — кнопка «Пересканировать». Если ничего не нашлось, показывается «Координаторы не найдены»: проверьте, что мост подключён к облаку и публикует свои служебные топики.
Нажмите на карточку координатора и нажмите «Сканировать устройства».
Для zigbee2mqtt отправляется MQTT-запрос списка устройств координатора; при отсутствии ответа около 8 секунд показывается ошибка.
Для Milafire (прошивка milafire-k3 со спецификацией
bridge/devices) список устройств берётся из retained{base_topic}/bridge/devices, а по кнопке сканирования отправляется запрос{base_topic}/bridge/devices/get; интеграция Rocket home не использует Home Assistant discovery для этого списка.Для generic список собирается из трафика по топикам
generic/{токен}: retained-сообщения видны сразу, для остальных при скане включается короткое окно приёма.generic— это открытый способ подключить к облаку собственное или самодельное устройство напрямую по MQTT, без выделенного моста.
Чекбокс «Скрыть уже подключённые устройства» оставляет в списке только то, что ещё не заведено в кабинете; под кнопками показано, сколько строк отображается.
Обогащение списка (каталог железа, привязка к уже добавленному устройству, комната) выполняется на бэкенде автоматически. Кнопка «Добавить» заводит устройство в кабинете, «Открыть» — переходит к уже заведённому. Участникам локации без прав владельца кнопки не показываются: строка помечается только отметкой ✓ (заведено) или — (нет).
Найденный список сохраняется до конца сеанса работы в кабинете: можно уйти на другую вкладку настроек и вернуться — сканировать заново не нужно.
Совет
Хотите увидеть координатор «Generic MQTT» в действии? В разделе DIY-измеритель CO₂ на ESPHome показан сквозной пример: устройство публикует состояние в топик generic/{токен}, находится в Радаре и добавляется парой кликов.
Прямая ссылка на драйвер¶
Чтобы не объяснять на словах путь «Настройки → Радар → Сканировать → выбрать координатор → Сканировать устройства», на устройство (наклейку, упаковку, QR-код) можно нанести прямую ссылку вида:
https://<адрес кабинета>/settings/radar/generic
Последний сегмент — тип координатора: zigbee2mqtt, milafire, generic или amethyst. При открытии такой ссылки Радар сам обнаруживает координаторы (если это ещё не сделано в текущем сеансе), выбирает координатор указанного типа и запускает сканирование его устройств — остаётся найти своё устройство в списке и нажать «Добавить».
Что важно знать:
Если вы ещё не вошли в кабинет, сначала откроется страница входа, а после входа — та самая ссылка.
Ссылка не содержит локацию: она работает в текущей выбранной локации. Если устройство стоит в другой локации, переключите её и откройте ссылку снова.
Ссылка адресует тип координатора, а не конкретное устройство. Для Amethyst, если координаторов несколько, выбирается первый по алфавиту — остальные доступны карточками рядом.
Координатор указанного типа не найден — Радар покажет об этом сообщение: проверьте локацию и питание моста, затем нажмите «Пересканировать».
Раздел «Радар» доступен только владельцу локации. Участник локации по такой ссылке попадёт на вкладку «Локации».
Обратно ссылка тоже собирается сама: когда вы выбираете карточку координатора, адрес в строке браузера меняется на соответствующий — его можно скопировать.
Zigbee-координатор: подключение новых устройств¶
Для координатора zigbee2mqtt владельцу локации доступна кнопка «Разрешить сопряжение». Она открывает на координаторе окно подключения новых Zigbee-устройств (около 4 минут): в это время можно перевести устройство в режим сопряжения. Окно закроется само по истечении времени или по повторному нажатию кнопки; пока идёт подключение, показывается «Устройство подключается…».
Рядом Радар показывает состояние самого координатора: версию и Zigbee-канал (z2m … · канал …), а если мост ушёл со связи — предупреждение «Координатор z2m офлайн», при котором устройства недоступны.
Что показано в карточке устройства¶
Индикатор активности — серый кружок перед названием. Когда по MQTT приходит сообщение по топику, связанному с выбранным координатором, кружок кратко подсвечивается зелёным.
Описание модели, тип питания (от сети или от батареи) и версия прошивки — по данным координатора.
Живая диагностика (zigbee2mqtt): уровень сигнала (LQI), заряд батареи, статус «На связи» / «Нет связи» и время последней активности. Если устройство давно не отвечало, показания приглушаются с подсказкой, что данные могли устареть.
Предупреждения: «Отключено в z2m», «Не поддерживается z2m», «Интервью не завершено» — такое устройство координатор видит, но полноценно работать с ним не может.
Статус шаблона («Подготовка шаблона…», «Ожидание шаблона») — для устройств, у которых набор функций подтягивается автоматически (например, Milafire K3). Если шаблон не готов, повторите сканирование.
Управление Zigbee-устройством¶
Владельцу локации в строке устройства zigbee2mqtt доступны две операции:
«Переопросить устройство» — координатор заново опрашивает устройство (полезно, если интервью не завершилось и функции определены неверно).
«Удалить из сети» — устройство отвязывается от Zigbee-координатора. Действие деструктивное и требует подтверждения. Если устройство уже заведено в кабинете, вместе с отвязкой удаляется и его запись в системе — об этом предупреждает диалог. Для устройства, которое не отвечает, включите в диалоге опцию «Принудительно»: тогда запись удалят из таблицы координатора без ответа самого устройства.
Обе операции требуют, чтобы мост локации был на связи.
Изображения устройств¶
Картинка показывается, только если устройство сопоставлено с каталогом оборудования и для данной модели загружено изображение. В некоторых случаях изображение может не совпадать с тем, как устройство выглядит на самом деле.