Подключение устройства

Устройство появляется в кабинете одним из двух способов. Основной — через Радар: он сам находит устройство и подставляет готовый шаблон. Ручная настройка нужна, когда Радар устройство не видит или шаблона для модели нет.

Через Радар (рекомендуется)

  1. Сначала сопрягите устройство с координатором: Сопряжение Zigbee-устройств. Для самодельного устройства по MQTT этот шаг не нужен.

  2. Откройте Настройки → Радар — поиск координаторов начнётся сам.

  3. Выберите координатор, нажмите «Сканировать устройства», найдите устройство в списке и нажмите «Добавить» (кнопка видна владельцу локации).

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

    Чтобы поправить тип или умения, нажмите в окне «Открыть в редакторе устройств»: введённое перенесётся в полный редактор, вернуться к короткой форме будет нельзя. Если для модели нет готового шаблона, Радар сразу откроет полный редактор.

Вы должны увидеть устройство на главном экране «Устройства» в выбранной комнате.

Подробнее о статусах и действиях Радара — Поиск устройств: Радар.

Вручную

  1. В разделе «Устройства» нажмите «+» в правом нижнем углу и выберите «Устройство».

  2. «Название» — если будете управлять голосом через Алису, пишите по-русски, кириллицей: например, «Верхний свет».

  3. «Тип» — что это за устройство: свет, розетка, датчик и т. д. Список предлагает редактор.

  4. «Возможности» — кнопкой «+» добавьте умения: включение, яркость, цвет и т. д.

    Совет

    Какие умения подходят вашему устройству — в примерах.

    «Раздельное включение/выключение» — чтобы управлять отдельными кнопками включения и выключения. «Обратная связь» — чтобы кабинет и Алиса могли запросить текущее состояние устройства.

  5. «Датчики» — добавьте, если устройство что-то измеряет: температуру, влажность, заряд батареи, движение, контакт. Если нет — пропустите.

  6. «Метаданные» — добавьте две пары ключ : значение:

    • driver : zigbee2mqtt — устройство подключено через Zigbee2MQTT;

    • friendly_name : 0x0000000000000000 — его имя в Zigbee2MQTT. Удобнее всего взять его в Радаре, запасной способ — логи Zigbee2MQTT.

  7. Выберите «Комнату» и сохраните.

Совет

Подключаете собственное или самодельное устройство напрямую по MQTT (без Zigbee-моста)? Укажите driver : generic, а в friendly_name — стабильный идентификатор устройства (его MQTT-топик будет generic/{friendly_name}). Пример «от железа до панели» — DIY-измеритель CO₂ на ESPHome.

Если устройство не отвечает

Что дальше

См. также

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