Wiren Board 6: Подключение устройств Zigbee
Внимание! Страница на стадии заполнения.
Аппаратная часть
Для работы контроллера с Zigee устройствами необходимо подключить специальный модуль. Есть несколько вариантовː
WBE2R-R-ZIGBEE - Модуль расширения Zigbee
USB Стик CC2531 (Можно приобрести на Aliexpress.com)
Модуль СС2530 c переходником usb-uart. Подключениеː
USB-Serial Adaper | CC2530 |
---|---|
3V3 | VCC |
GND | GND |
TXD | P02 |
RXD | P03 |
Прошивка
Для корректной работы модуля рекомендуется прошивка Z-Stack.
zigbee2mqtt
zigbee2mqtt - Это мост, позволяющий управлять Zigbee устройствами через MQTT. Работает на Node.js, позволяет легко интегрировать Zigbee устройства в различные системы автоматизации такие как Home Assistant, Node Red и тд. По ссылке Вы найдете всю необходимую информацию о zigbee2mqtt.
zigbee2mqtt версия для WB
Мы немного изменили код zigbee2mqtt для поддержки Wiren Board MQTT Conventions. Измененную версию вы можете найти в нашем репозитории на GitHub
Установка
# Настраиваем репозиторий Node JS curl -sL https://deb.nodesource.com/setup_10.x | bash - # Устанавливаем необходимые компоненты apt-get install -y nodejs git make g++ gcc # Если хотите установить версию c поддержкой Wiren Board MQTT Conventions git clone https://github.com/contactless/zigbee2mqtt /opt/zigbee2mqtt # Либо если хотите установить оригинальную версию git clone https://github.com/Koenkk/zigbee2mqtt.git /opt/zigbee2mqtt # Настраиваем права chown -R root:root /opt/zigbee2mqtt # Заходим в директорию и запускаем установку cd /opt/zigbee2mqtt npm install
В процессе установки будет показано несколько предупреждений. Их можно игнорировать. Для автоматического запуска zigbee2mqtt необходимо создать сервис. Для этого зайдите в папку /etc/systemd/system/ и создайте файл zigbee2mqtt.service
Откройте файл и скопируйте в него следующий текстː
[Unit] Description=zigbee2mqtt After=network.target [Service] ExecStart=/usr/bin/npm start WorkingDirectory=/opt/zigbee2mqtt StandardOutput=inherit StandardError=inherit Restart=always User=root [Install] WantedBy=multi-user.target
И сохраните файл. После этого для активации сервиса следует ввести в консоль команду
systemctl enable zigbee2mqtt.service
Полную инструкцию можно найти на сайте zigbee2mqtt.
Конфигурация
После установки нужно настроить контроллер.
Если Вы используете WBE2R-R-ZIGBEE - Модуль расширения Zigbee - убедитесь, что правильно выставили модуль в Configs => Hardware Modules Configuration.
Зайдите в папку /opt/zigbee2mqtt/data и отредактируйте файл configuration.yaml ː
# Настройка для интеграции с homeassistant homeassistant: false # Разрешение на добавление новых устройств (Измените этот параметр на falsе после добавления всех необходимых устройств) permit_join: true # Настройки MQTT сервера mqtt: server: 'mqtt://localhost' # Настройка порта serial: port: /dev/ttyMOD3 advanced: # Если вы используете CC2530. (удалите этот параметр, если используете USB стик CC2531) rtscts: false # штамп времени last_seen: epoch
Полное описание настроек можно найти на сайте zigbee2mqtt.
После изменения настроек введите команду
service zigbee2mqtt restart
Запуск
Для запуска, остановки и перезапуска сервиса используйте команды
service zigbee2mqtt start service zigbee2mqtt stop service zigbee2mqtt restart
Добавление устройств
Что бы добавить Zigbee устройство убедитесь, что в настройках моста включен параметр "permit_join" :
permit_join: true
Далее следуйте инструкции к устройству. В основном требуется зажать кнопку "pair" на несколько секунд и дождаться "мигания" светодиода. После этого устройство должно передать информацию о себе на контроллер. Иногда требуется дополнительно нажимать на кнопку каждую секунду, что бы устройство не "уснуло". После успешного добавления устройство автоматически появится во вкладке Devices.