Радар (обнаружение устройств)

В разделе Настройки есть таб «Радар». Он показывает координаторы (сетевые мосты): Zigbee2MQTT, Generic MQTT, Milafire, Amethyst (в т.ч. по данным из приложения) и помогает увидеть список устройств выбранной сети.

  • выбрать мост (карточка координатора);

  • по кнопке загрузить или обновить список устройств для выбранной сети;

  • для уже известных Amethyst в локации — подтянуть строки устройств из базы;

  • для новой «комнаты Amethyst» без записи в базе — указать тип, MQTT-имя и название комнаты (на бэкенде при необходимости создаётся аккаунт Amethyst и полный набор устройств).

Карточки всех типовых координаторов отображаются всегда; список обнаруженных устройств наполняется только после выбора координатора и «Сканировать устройства» (для MQTT-сетей возможен короткий приём сообщений). Подключение к MQTT по-прежнему используется для индикаторов активности на карточках.

Как пользоваться

  1. Убедитесь, что нужные мосты публикуют данные в вашем MQTT (и что у локации есть учётная запись MQTT в Rocket Home).

  2. Откройте Настройки → Радар.

  3. Нажмите на карточку координатора (zigbee2mqtt, generic, префиксы Milafire, Amethyst или «Новая комната Amethyst»).

  4. Для обычных мостов нажмите «Сканировать устройства».

    • Для zigbee2mqtt отправляется MQTT-запрос списка устройств координатора; при отсутствии ответа около 8 секунд показывается ошибка.

    • Для Amethyst данные подгружаются с API (устройства уже заведённые в этой локации).

    • Для Milafire (прошивка milafire-k3 со спецификацией bridge/devices) список устройств берётся из retained {base_topic}/bridge/devices и по кнопке сканирования отправляется запрос {base_topic}/bridge/devices/get; интеграция Rocket home не использует Home Assistant discovery для этого списка.

    • Для generic полезен трафик по соответствующим топикам; при скане включается короткое окно приёма сообщений.

  5. Обогащение списка (каталог железа, привязка к уже добавленному устройству, комната) выполняется на бэкенде тем же пайплайном локатора, что и раньше.

Индикатор активности

Перед заголовком устройства отображается серый кружок. Когда по MQTT приходит сообщение по топику, связанному с выбранным координатором, кружок кратко подсвечивается зелёным.

Amethyst на радаре

  • Известные координаторы Amethyst — строки из таблицы amethyst, если либо у записи привязан MQTT-аккаунт этой локации, либо в локации уже есть устройства драйвера amethyst с тем же MQTT-именем (friendly_name).

  • Сценарий «Новая комната Amethyst» доступен всегда: можно задать тип (One / Two), MQTT-имя и название комнаты. Если устройства с таким MQTT-именем в локации уже есть, потребуется явное подтверждение пересоздания.

  • Комнаты Amethyst, созданные через радар («Новая комната Amethyst» или «Добавить группу в комнату»), в реестре помечаются флагом DIY (в интерфейсе отображается метка на карточке координатора и в списке устройств); массовая регистрация вне этого сценария остаётся без этой отметки.

Изображения устройств

Картинка показывается, только если устройство сопоставлено с каталогом оборудования и для данной модели загружено изображение. В некоторых случаях изображение может не совпадать с тем, как устройство выглядит на самом деле.