Zigbee: различия между версиями

Материал из Wiren Board
Строка 65: Строка 65:
== Установка == <!--T:15-->
== Установка == <!--T:15-->


Настраиваем репозиторий Node JS
<pre>
<pre>
# Настраиваем репозиторий Node JS
curl -sL https://deb.nodesource.com/setup_10.x | bash -
curl -sL https://deb.nodesource.com/setup_10.x | bash -
</pre>


# Устанавливаем необходимые компоненты
Устанавливаем необходимые компоненты
<pre>
apt-get install -y nodejs git make g++ gcc
apt-get install -y nodejs git make g++ gcc
</pre>
</pre>




''Если хотите установить версию c поддержкой Wiren Board MQTT Conventions''
''Если хотите установить версию c поддержкой Wiren Board MQTT Conventions''
<pre>
<pre>
git clone https://github.com/contactless/zigbee2mqtt /opt/zigbee2mqtt
git clone https://github.com/contactless/zigbee2mqtt /opt/zigbee2mqtt
Строка 88: Строка 90:




Далее
Настраиваем права
<pre>
<pre>
# Настраиваем права
chown -R root:root /opt/zigbee2mqtt
chown -R root:root /opt/zigbee2mqtt
</pre>


# Заходим в директорию и запускаем установку
 
Заходим в директорию и запускаем установку
<pre>
cd /opt/zigbee2mqtt
cd /opt/zigbee2mqtt
npm install
npm install
</pre>  
</pre>  
В процессе установки будет показано несколько предупреждений. Их можно игнорировать.
В процессе установки будет показано несколько предупреждений. Их можно игнорировать.
<!--T:16-->
<!--T:16-->
Для автоматического запуска zigbee2mqtt необходимо создать сервис. Для этого зайдите в папку /etc/systemd/system/ и создайте файл zigbee2mqtt.service
Для автоматического запуска zigbee2mqtt необходимо создать сервис. Для этого зайдите в папку /etc/systemd/system/ и создайте файл zigbee2mqtt.service

Версия 10:38, 10 июня 2019



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




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

Лицевая сторона модуля 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.

Более подробная информация на сайте zigbee2mqtt.