Zigbee

Внимание! Страница на стадии заполнения.

Аппаратная часть

Лицевая сторона модуля WBE2R-R-ZIGBEE

Обратная сторона модуля WBE2R-R-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.