Подключение Z-Wave устройств к контроллеру Wiren Board
Описание
Z-Wave — это беспроводной протокол для домашней и коммерческой автоматизации.
Для использования Z-Wave устройств с контроллером Wiren Board понадобится:
- Модуль расширения WBE2R-R-ZWAVE-ZWAY или USB-стик Z-Wave.Me UZB1
- Дополнительное ПО:
- z-way-server — Z-Way сервер, который работает с устройствами.
- Wiren Board MQTT Integration — интеграция, которая позволяет управлять Z-Way устройствами из основного веб-интерфейса контроллера Wiren Board.
Инструкции по установке смотрите ниже на этой странице.
Установка и настройка z-way-server
Описание
z-way-server — это комплексное программное обеспечение Z-Way, поддерживающее радиопротоколы Z-Wave и EnOcean, а также устройства на основе Wi-Fi, MQTT и HTTP. Пакет есть в репозитории контроллера Wiren Board.
Установка
- Обновите пакеты на контроллере:
apt update && apt upgrade
- Установите ПО для работы с Z-Wave:
apt install z-way-server
Веб-интерфейс сервера Z-Way будет доступен по адресу http://192.168.42.1:8083, где 192.168.42.1 — IP-адрес контроллера, укажите свой. При первом подключении сервер предложит задать пароль администратора — запомните его.
Настройка
Теперь нужно вставить в контроллер USB-стик или модуль расширения и указать порт в программном обеспечении:
- Вставьте в контроллер USB-стик или модуль расширения. Модуль расширения перед использованием нужно конфигурировать.
- Зайдите в веб-интерфейс Z-Way.
- Перейдите в Меню справа вверху → Apps → Z-Wave Network Access и в поле Serial port to Z-Wave dongle укажите одно из значений:
- USB-стик —
/dev/ttyUZB
; - модуль расширения —
/dev/ttyMODx
, где x — номер разъёма, куда вставлен модуль.
- USB-стик —
Теперь вы можете работать с устройствами Z-Wave из веб-интерфейса ПО Z-Way. Если вы хотите видеть Z-Wave устройства в стандартном веб-интерфейсе контроллера и использовать их в автоматизациях, установите интеграцию Wiren Board MQTT Integration.
Удалённый доступ
По умолчанию пакет, который организует удалённый доступ к веб-интерфейсу Z-Way не установлен, если он вам нужен, установите его командой:
apt install zbw
В конце установки будут сгенерированы User Id и Password — запишите их, чтобы не потерять.
Установка Wiren Board MQTT Integration
Описание
Чтобы упростить обработку данных с Z-Wave устройств и управление ими, мы написали модуль интеграции Wiren Board MQTT Integration, который преобразовывает данные Z-Way сервера в топики виртуального устройства, которое будет доступно в веб-интерфейсе контроллера на вкладке Devices.
После установки интеграции вы сможете управлять Z-Wave устройствами через стандартный веб-интерфейс контроллера, или настраивать автоматизации с помощью wb-rules.
У интеграции несколько версий:
- Wiren Board MQTT Integration Native (версия 2.x) — для контроллеров с релизом ПО wb-2304 (Debian Bullseye) и новее;
- Wiren Board MQTT Integration (версия 1.5.x) — для контроллеров с релизом ПО wb-2207 (Debian Stretch) и старее.
Если вам нужно отправить данные из топиков контроллера в софт Z-Way, то установите Wiren Board MQTT import.
Принцип работы
Преобразовывает описание настроенных в ПО Z-Way устройств в каналы устройства Z-Wave, которое находится в веб-интерфейса контроллера на вкладке Devices.
Можно получать с устройств данные и управлять ими.
Тип Z-Way | Тип Wiren Board | Описание |
---|---|---|
sensorBinary | switch | Значения с бинарных датчиков |
sensorMultilevel | value | Значения с датчиков температуры, влажности, освещенности и т.п. |
battery | value | Значение с датчиков уровня батареи |
doorlock | switch | Переключатель открытия/закрытия двери |
switchBinary | switch | Переключатель ON/OFF |
switchMultilevel | range | Переключатель с несколькими позициями |
thermostat | range | Установка значения температуры в термостате |
toggleButton | pushbutton | Нажатие на кнопку |
Установка интеграции
Установите модуль интеграции:
- Зайдите в интерфейс сервера Z-Way.
- Перейдите в Меню справа вверху → Apps → Online Apps .
- Введите в поиске Wiren Board MQTT Integration и установите найденное приложение.
- На этом этапе может потребоваться установить BaseModule, если это так, то в настройках модуля интеграции будет сообщение please install и кнопка Base Module — установите его нажатием на кнопку. Если сообщения нет — просто продолжайте настройку.
- Если вы настраиваете интерацию впервые и не знаете назначения настроек, то оставьте значения по умолчанию и нажмите внизу кнопку Save.
Если в процессе сохранения настроек модуля интеграции вы получите ошибку Something went wrong — перезапустите контроллер, найдите Wiren Board MQTT Integration теперь уже на вкладке Local Apps, нажмите на плюсик — откроется карточка с настройками интеграции, нажмите кнопку Save.
После этого во вкладке Devices веб-интерфейса контроллера Wiren Board будут появляться Z-Wave устройства, добавленные через интерфейс Z-Way.
Работа с Z-Wave устройствами
Добавление
Новое устройство добавляется в веб-интерфейсе Z-Way:
- Зайдите в интерфейс сервера Z-Way.
- Перейдите в Меню справа вверху → Devices
- Найдите в списке Z-Wave и нажмите кнопку Add new.
- Далее нажмите на кнопку Add new Z-Wave Device and identify it automatically
- Если вы добавляете новое устройство, то нажмите зелёную кнопку Start и активируйте режим сопряжения на устройстве, обычно, для этого нужно нажать три раза на кнопку сопряжения. Если устройство уже было сопряжено с другим сервером Z-Way, то перед выполнением сопряжения его нужно сбросить, для этого нажмите на кнопку Reset Device и включите на устройстве режим сопряжения. После сообщения об успешном сбросе, выполните инструкцию в начале этого пункта.
- После того, как устройство будет сопряжено, откроется страница, где можно задать устройству имя и настроить его. После этого нажмите кнопку Save.
Список добавленных устройств можно найти в разделе Elements, кнопка перехода к которому находится вверху окна. Так же устройства будут доступны в веб-интерфейсе контроллера Wiren Board на вкладке Devices в карточке Z-Way.
Управление
Устройствами можно управлять их веб-интерфейсов ПО Z-Wave и стандартного веб-интерфейса контроллера Wiren Board.
Кроме этого вы можете настраивать автоматизации с помощью правил wb-rules и стороннего ПО, которое работает с MQTT, например, Node-RED.
Удаление
Чтобы удалить Z-Wave устройство:
- Зайдите в интерфейс сервера Z-Way.
- Перейдите в Меню справа вверху → Devices
- Найдите в списке Z-Wave и нажмите кнопку Manage.
- Нажмите кнопку с красной корзинкой рядом с названием устройства, которое хотите удалить.
- Нажмите кнопку Reset and Remove, откроется всплывающее окно с инструкцией: вам нужно сделать на устройстве те же действия, которые включают режим сопряжения, например, три раза нажать на кнопку сопряжения.
- Устройство сброшено и удалено.
Из стандартного веб-интерфейса контроллера устройство будет удалено автоматически.
Полезные ссылки
- Официальный сайт программного обеспечения Z-Way
- Подключение реле Rubetek TZ78
- Подключение диммера Philio PAD07-RU
- Подключение термостата Heatit Z-TEMP2
- Подключение устройства управления кондиционером Philio PAR01-RU