Как подключить Zigbee устройства к BARY: пошаговая инструкция

August 30, 2021

Быстрый ответ: Подключите Zigbee координатор (CC2652/CC2531) к USB-порту сервера, добавьте шлюз Zigbee2mqtt в BARY через Настройки → Устройства → Шлюзы, настройте порт и канал. Включите режим Permit Join, переведите устройства в режим сопряжения (обычно долгое нажатие кнопки). Датчики появятся в BARY автоматически.

Краткое описание протокола

Zigbee - беспроводная сеть, схожая по принципу работы на Wi-Fi или Bluetooth. От вышеупомянутых сетей отличается, прежде всего, высокой энергоэффективностью - устройства могут работать от одной батарейки год и более. Сеть поддерживает не только простые сети типа точка-точка, но и ячеистую (mesh). Существует три типа устройств в zigbee-сети:

Координатор - главное устройство сети, без которого невозможно взаимодействие пользователя с конечными устройствами;
Маршрутизатор - вспомогательное устройство, позволяющее передавать данные с конечных устройств на маршрутизатор. Маршрутизатором может выступать практически любое конечное устройство, работающее от постоянного источника питания;
Конечное устройство - непосредственно сами датчики, или исполнительные устройства. Если устройство питается от батареек, то большую часть времени оно находится в спящем режиме, за счет чего и достигается высокая энергоэффективность.

Сравнение популярных Zigbee координаторов

Модель	Чип	Макс. устройств	Дальность	Цена	Рекомендация
Sonoff Zigbee 3.0 Dongle Plus	CC2652P	200+	До 100м	~1,500₽	✅ Лучший выбор
JetHub Z4	EFR32MG21	200+	До 150м	~3,400₽	✅ +20dBm, внешняя антенна
Wiren Board WBE2R-R-ZIGBEE v.2	CC2652P	200+	До 100м	~3,600₽	✅ Для Wiren Board 6/7/8
CC2531 USB Stick	CC2531	50	До 30м	~500₽	⚠️ Устаревший, не рекомендуется
ConBee II	ConBee	200+	До 100м	~3,000₽	✅ Альтернатива (ZHA/deCONZ)
SLZB-06	CC2652P	200+	До 150м	~3,500₽	✅ PoE, сетевой координатор

Рекомендация: Для большинства пользователей оптимален Sonoff Zigbee 3.0 Dongle Plus — доступная цена, стабильная работа, поддержка 200+ устройств. JetHub Z4 — отличный выбор при необходимости максимальной дальности благодаря высокой мощности передатчика (+20dBm) и внешней антенне. Wiren Board WBE2R-R-ZIGBEE v.2 — модуль расширения для владельцев контроллеров Wiren Board 6/7/8.

Для работы с zigbee сетями мы используем сервис zigbee2mqtt.io, поэтому все его требования к поддерживаемым устройствам остаются актуальными и для BARY.

О выборе координатора и его прошивке можно прочитать тут. После того, как адаптер прошит можно, приступить к подключению.

Настройка BARY

Установка zigbee шлюза в BARY:

На главном экране нажмите Меню
Далее выберите Настройки
В открывшемся окне выберите Устройства и нажмите добавить
Откроется список устройств для добавления. Выберите Шлюзы и в раскрывающемся списке выберите zigbee2mqtt или воспользуйтесь поиском по устройствам:

Поиск по устройствам:

- Нажмите на кнопку поиска:

- И начните вводить "zigbee2mqtt"

Далее необходимо настроить параметры координатора zigbee. Для этого необходимо задать порт к которому подключен координатор zigbee, а так же PanID, канал и ключ сети.

Как узнать порт, к которому подключен адаптер Zigbee?

Вывести в терминал список портов можно командой:

  ls -l /dev/serial/by-id

Результат может быть таким:

  lrwxrwxrwx 1 root root 13 Sep  7 14:49 usb-1a86_USB_Serial-if00-port0 -> ../../ttyUSB0

Например для контроллера Jethub D1/D1+ порт к коротому подключен координатор: ttyAML2

Что такое Permit join?

Галочка Permit join означает, что адаптер будет постоянно в режиме добавления устройств. Рекомендуется поставить для первоначальной настройки, но отключить после подключения всех устройств.

Поле MQTT address указывает адрес MQTT сервера, рекомендуется оставить по умолчанию.

Что такое PanID?

PAN ID, или Personal Area Network ID. Он используется для логического отделения узлов одной сети ZigBee от узлов другой, если сети расположены на одной и той же территории либо работают на одном и том же канале. Используется шестнадцатиричный формат от 0х0000 до 0х1a62. Рекомендуется изменить это значение.

Как выбрать канал?

Допустимый диапазон каналов 11-26. Старайтесь выбирать канал таким образом, чтобы он наименее пересекался с каналами Wifi. Например, на рисунке наиболее оптимальными каналами будут 16, 20, 25-26. Однако, стоит иметь ввиду, что некоторые устройства не работают на других каналах, кроме 11.

Какой выбрать ключ сети?

Размер ключа сетевого шифрования составляет 128-bit по существу 16 десятичных значений между 0 и 255. Вы можете изменить некоторые числа в этой последовательности.

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

Что делать, если на модуле указан восклицательный знак?

Раздел в разработке

Добавление устройств

Для добавления zigbee устройств в сеть, координатор и устройство нужно перевести в режим сопряжения.

Включение режима сопряжения координатора:

На главном экране нажмите Меню
Далее выберите Настройки
В открывшемся окне выберите Устройства и нажмите добавить
В появившемся списке выберите Добавить Zigbee устройство

Что делать, если в появившемся списке отсутствует опция добавления zigbee устройства?

Вероятно, Zigbee координатор не работает или не запущен. ... Раздел в разработке

После чего координатор перейдет в режим сопряжения. Теперь переведите ваше Zigbee-устройство так же в режим сопряжения.

Как перевести zigbee-устройство в режим сопряжения?

Для перевода zigbee-устройства в режим сопряжения, воспользуйтесь инструцкией с вашему zigbee-устройству. Это может быть длительное удержание клавиши сопряжения на устройства или троекратное нажатие и т.п. ... Раздел в разработке

Если всё сделали правильно, будет получено сообщение об обмене данными с добавляемым устройством:
После успешного обмена данными вы получите сообщение о новом устройстве, где вам будет предложено указать комнату и иные параметры, либо пропустить этот шаг и настроить устройство позднее.
Когда устройству будет назначена комната, оно будет отображено с имеющимися возможностями. В данном примере датчик открытия двери имеет возможность передачи информаиции о своем состоянии, времени срабатывания, а так же состояния батареи и качества связи (0-255).
Для вашего устройства набор возможностей может быть другим.

Просмотр карты сети ZigBee

Вы можете строить и просматривать карту сети Zigbee. Это бывает необходимо для диагностики и локалзации проблем связи узла или отдельных устройств. Для этого необходимо открыть окно шлюза ZigBee и нажать Refresh network map:
Далее будет получено сообщение о построении карты сети.В течение некоторого времени координатор опросит все устройства и построит карту сети Zigbee, где вы можете увидеть конечные устройства, маршрутизаторы, координатор, а так же линии связи.
Карта сети ZigBee. Её можно увеличить/уменьшить, нажав соответствующие кнопки, а так же развернуть на весь экран, нажав на неё. Для выхода из полноэкранного режима необходимо нажать на клавиатуре ESC.
Пример карты сети из нескольких устройств:

Удаление устройства ZigBee

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

Как перевести zigbee-устройство в режим удаления?

Для перевода zigbee-устройства в режим удаления, воспользуйтесь инструцкией с вашему zigbee-устройству. Это может быть длительное удержание клавиши сопряжения на устройства или троекратное нажатие и т.п.

После удаления устройства, оно сразу добавляется вновь, почему?

Вероятно, установлен режим сопряжения в координаторе. Отключите режим сопряжения координатора (Permit join) в дополнительных настройках.

Откроется список устройств для добавления. Выберите Шлюзы и в раскрывающемся списке выберите zigbee2mqtt или воспользуйтесь поиском по устройствам:

Координатор переводится в режим сопряжения либо галочкой Permit join в настройках устройства, либо нажатием соответствующей кнопки в интерфейсе устройства.

Для перехода в интерфейс устройства нажмите Главная, далее выберите комнату, которую вы выбрали в настройках zigbee2mqtt

Рис. Выбор комнаты

Затем выберите zigbee2mqtt:

Рис. Выбор zigbee2mqtt

Вы попадете в интерфейс zigbee2mqtt, в котором можно посмотреть статус всех подключенных устройств, а также активировать режим сопряжения кнопкой Include device

Рис. Интерфейс zigbee2mqtt

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

Соединение устройства с сетью;
Начало опроса устройства;
Окончание опроса устройства.

Рис. Успешное окончание опроса устройства

После успешного сопряжения устройство автоматически попадает в группу нераспределенные устройства. Если сообщения об успешном интервью нет, то повторите сопряжение.

Рис. Нераспределенные устройства

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

❓ Часто задаваемые вопросы о Zigbee

Что такое Zigbee координатор и зачем он нужен?

Zigbee координатор — это USB-устройство, которое создает беспроводную Zigbee-сеть и управляет всеми подключенными датчиками, лампами и розетками. Без координатора невозможно взаимодействие с Zigbee-устройствами. Координатор подключается к серверу BARY через USB-порт.

Какие Zigbee координаторы поддерживает BARY?

BARY поддерживает все координаторы, совместимые с Zigbee2mqtt, на базе чипов CC2652, CC2531, CC2538. Рекомендуем Sonoff Zigbee 3.0 USB Dongle Plus (CC2652P) или JetHub Z1 для стабильной работы и поддержки большого количества устройств.

Сколько устройств можно подключить к Zigbee координатору?

Координатор поддерживает до 50 устройств напрямую. С использованием Zigbee-роутеров (лампы, розетки, работающие от сети 220В) можно создать mesh-сеть на 200+ устройств. Роутеры ретранслируют сигнал и расширяют зону покрытия.

Какой Zigbee канал выбрать чтобы избежать помех Wi-Fi?

Выбирайте каналы 15-16, 20, 25-26 — они минимально пересекаются с Wi-Fi. Допустимый диапазон: 11-26. Проверьте загруженность Wi-Fi каналов анализатором и выберите наименее занятый Zigbee канал. Внимание: некоторые устройства работают только на канале 11.

Почему Zigbee устройства работают от батарейки так долго?

Zigbee-устройства на батарейках (датчики движения, геркон, температуры) большую часть времени находятся в спящем режиме, потребляя микротоки. Они просыпаются только для передачи данных (например, при срабатывании датчика движения), затем снова засыпают. Это обеспечивает работу 1-2 года от одной батарейки CR2032.

Что такое Permit Join в настройках Zigbee?

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

Какие устройства можно подключить по Zigbee к BARY?

По Zigbee подключаются: умные лампы (Philips Hue, IKEA TRADFRI, Yeelight), розетки, датчики (движения, открытия, температуры, влажности, протечки), выключатели и кнопки Xiaomi, Aqara, Tuya. Полный список 1000+ моделей на сайте zigbee2mqtt.io.