Wiren Board 6: Подключение устройств ZigBee
Статья в процессе редактирования. Информация может быть не точной.
Аппаратная часть
Для работы контроллера с ZigBee устройствами необходимо подключить специальный модуль. Есть несколько вариантовː
- WBE2R-R-ZIGBEE - Модуль расширения Zigbee
- USB Стик CC2531 (Можно приобрести на Aliexpress.com)
- Модуль СС2530 c переходником usb-uart. Подключениеː
| USB-Serial Adaper | CC2530 |
|---|---|
| 3V3 | VCC |
| GND | GND |
| TXD | P02 |
| RXD | P03 |
Прошивка
С завода модуль WBE2R-R-ZIGBEE уже прошит оптимизированной для WB и SprutHub прошивкой (Z-Stack 1.2). Однако если это необходимо, его можно перепрошить.
Для прошивки WBE2R-R-ZIGBEE или USB стика потребуется CC Debugger и загрузочный кабель. (Можно приобрести на Aliexpress.com) Перед прошивкой установите драйвер.
Подключите CC Debugger к WBE2R-R-ZIGBEE или к USB стику через загрузочный кабель. Подключите USB кабель CC Debugger(a) к компьютеру. Скачайте и установите приложение FLASH-PROGRAMMER ( обычную версию, не v2) c сайта TI. Устройство должно определиться в таблице. Укажите путь к файлу прошивки. В области "Actions" выберите "Erase, program and verify" и нажмите кнопку "Perform actions". Полезную информацию по прошивке вы так же можете найти на сайте zigbee2mqtt.
Файлы прошивок: Z-Stack-firmware Внимательно читайте описание к прошивкам. Для модуля WBE2R-R-ZIGBEE требуется прошивка "CC2530 + CC2592"
zigbee2mqtt
Описание
zigbee2mqtt - Это мост, позволяющий управлять Zigbee устройствами через MQTT. Работает на Node.js, позволяет легко интегрировать Zigbee устройства в различные системы автоматизации такие как Home Assistant, Node Red и тд. Вы найдете всю необходимую информацию на сайте zigbee2mqtt.
Установка
Запустите консоль и введите командуː
$ apt update && apt install -y zigbee2mqtt
Установка и сборка из исходников (альтернативный метод):
Настраиваем репозиторий Node JS
curl -sL https://deb.nodesource.com/setup_12.x | bash -
Устанавливаем необходимые компоненты
apt-get install -y nodejs git make g++ gcc
Копируем файлы из репозитория zigbee2mqtt
git clone https://github.com/Koenkk/zigbee2mqtt.git /mnt/data/root/zigbee2mqtt
Настраиваем права
chown -R root:root /mnt/data/root/zigbee2mqtt
Заходим в директорию и запускаем установку
cd /mnt/data/root/zigbee2mqtt npm ci
В процессе установки будет показано несколько предупреждений. Их можно игнорировать.
Оригинальная инструкция по установке zigbee2mqtt на официальном сайте zigbee2mqtt.io
Для автоматического запуска zigbee2mqtt необходимо создать сервис. Для этого зайдите в папку /etc/systemd/system/ и создайте файл zigbee2mqtt.service
Откройте файл и скопируйте в него следующий текстː
[Unit] Description=zigbee2mqtt After=network.target [Service] ExecStart=/usr/bin/npm start WorkingDirectory=/mnt/data/root/zigbee2mqtt StandardOutput=inherit StandardError=inherit Restart=always User=root [Install] WantedBy=multi-user.target
И сохраните файл. После этого для активации сервиса следует ввести в консоль команду
systemctl enable zigbee2mqtt.service
Полную инструкцию можно найти на сайте zigbee2mqtt.
Конфигурация
Если Вы используете модуль расширения WBE2R-R-ZIGBEE,то убедитесь, что правильно выставили модуль в Configs => Hardware Modules Configuration.
Далее в папке /mnt/data/root/zigbee2mqtt/data отредактируйте файл configuration.yaml ː
homeassistant: false permit_join: false mqtt: base_topic: zigbee2mqtt server: 'mqtt://localhost' serial: port: /dev/ttyMOD3 advanced: 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.
Более подробная информация на сайте zigbee2mqtt.
wb-zigbee2mqtt
Описание
wb-zigbee2mqtt - Это простой конвертер из zigbee2mqtt в Wiren Board MQTT Conventions. Конвертер написан на движке правил wb-rules>=2.6.0, скрипт устанавливается в папку с системными правилами wb-rules-system.
Принцип работы
В версии wb-rules 2.6.0 появилась возможность подписываться на произвольные mqtt топики. Конвертер wb-zigbee2mqtt запрашивает у zigbee2mqtt список всех подключенных устройств, подписывается на их топики. При получении данных от устройств конвертер парсит json, создает виртуальный девайс и посылает в него полученную информацию. Так же конвертер создает виртуальный девайс "zigbee2mqtt" и передает в него логи, версию, состояние (online\offline) моста zigbee2mqtt, Есть возможность включить и выключить режим добавления устройств. А так же там расположена кнопка "update devices". При нажатии на эту кнопку конвертер заново запрашивает у моста список добавленных девайсов и если появились какие-то новые устройства - так же подписывается на них.
Установка
Для установки откройте консоль и введите команду:
$ apt update && apt install wb-zigbee2mqtt
Добавление устройств
Для добавления нового устройства переведите контрол "Permit join" в положение "on". Далее следуйте инструкции к устройству. В основном требуется зажать кнопку "pair" на несколько секунд и дождаться "мигания" светодиода.
Управление устройствами
Управление устройствами через конвертер wb-zigbee2mqtt пока не реализовано. Но управлять устройствами можно стандартными инструментами zigbee2mqtt через wb-rules (функция publish)
Пример:
publish("zigbee2mqtt/0x00158d0001f3fc34/set", JSON.stringify({ state: "ON" }), 2, false);
publish("zigbee2mqtt/0x00158d0001f3fc34/set", JSON.stringify({ state: "OFF" }), 2, false);