Сопряжение Zigbee-устройств

Откройте сеть

Пока сеть закрыта, новое устройство в неё не войдёт. Откройте её на время сопряжения:

cd /opt/rocket-home
make permit-join-on TIME=254

То же самое делает пункт «Permit join» в меню rocket.

Примечание

В кабинете есть кнопка «Разрешить сопряжение» (Радар), но для первого устройства она не годится: пока в сети хаба нет ни одного устройства, Радар показывает «Координаторы не найдены» — координатор сам по себе карточку не создаёт. Первое устройство заводите командой выше или из меню rocket; дальше появится и кнопка.

Сеть закроется сама через TIME секунд. Держать её открытой постоянно не нужно: в это время к ней может подключиться и чужое устройство.

Смотрите, что происходит

Откройте лог ZigBee2MQTT — по нему видно, как идёт сопряжение:

cd /opt/rocket-home
make logs SERVICE=zigbee2mqtt FOLLOW=1

Примечание

Если хаб ещё не запущен, поднимите стек: make up, затем проверьте make status.

Сопряжение

Совет

У каждого устройства свой способ сопряжения, но чаще всего это удержание кнопки 3–5 секунд до мигания светодиода. Если кнопки нет — смотрите инструкцию к устройству.

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

Тот же ход событий, но короче и независимо от уровня лога, печатает make pair-watch: открытие и закрытие окна, вход устройства в сеть, начало и итог интервью. Удобно держать во втором терминале, пока нажимаете кнопку на устройстве.

Устройство мигает, но не появляется

Окно открыто, устройство мигает в режиме сопряжения, а ни в логе, ни в make pair-watch про него ни строчки. Значит, его сигнал не доходит ни до координатора, ни до роутеров сети — хаб тут ни при чём, и чинить нужно связь. Проверяйте по порядку:

  1. Режим сопряжения. Признак готовности — частое мигание. У части устройств есть второй жест (например, пять быстрых нажатий и одно долгое), а войти в режим удаётся не с первой попытки: повторите 3–5 раз, не закрывая окно.

  2. Питание. Выключатель без нейтрали питается через лампу. С маломощной светодиодной нагрузкой индикатор мигает, а на радио мощности не хватает: подключите на время лампу помощнее или байпас-конденсатор.

  3. Расстояние. Устройство в подрозетнике или за стеной может не слышать координатор. Поставьте рядом с ним уже сопряжённый роутер (розетку или другое устройство с питанием от сети) — окно сопряжения открывается и на роутерах — либо на время поднесите устройство к хабу.

  4. Мощность передатчика. Заводских 9 дБм у координатора CC2652 не хватает до устройства на краю покрытия. Установщик с версии 0.3.0 ставит 20 дБм в новых конфигах; на уже настроенном хабе:

    cd /opt/rocket-home
make z2m-tx-power DBM=20
make z2m-restart

  5. Чёрный список. Устройство, удалённое из сети с опцией «Занести в чёрный список», обратно не пустят. Список виден в Радаре, снять запрет можно там же или командой make z2m-unblock IEEE=0x… (IEEE=all — всех), затем make z2m-restart.

Нужны подробности от самого ZigBee2MQTT — ответы устройства, шаги интервью, ошибки координатора: make z2m-log LEVEL=debug включает подробный лог без перезапуска. После разбора верните прежний уровень (make z2m-log LEVEL=info): на debug лог растёт быстро.

Как называется устройство

После сопряжения у устройства появляется имя — friendly_name. Его можно взять:

  • из лога ZigBee2MQTT;

  • в веб-интерфейсе ZigBee2MQTT (список Devices), адрес и токен входа показывает make status;

  • в кабинете Рокет Хоум: Настройки → Радар (см. Поиск устройств: Радар).

Сохраните friendly_name — он понадобится, чтобы завести устройство в кабинете.

Закройте сеть

Если все устройства добавлены, а таймер ещё идёт — закройте сеть досрочно:

cd /opt/rocket-home
make permit-join-off

Совет

Устройство сопряглось, но в кабинете не появилось — это нормально: облако не заводит устройства само. Добавьте его вручную или через Радар. Если устройство не находится вовсе — диагностика.

Что дальше

См. также

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