Подключение Z-Wave устройств к контроллеру Wiren Board

Материал из Wiren Board
Это утверждённая версия страницы. Она же — наиболее свежая версия.
Другие языки:
Представление Z-Wave устройств в веб-интерфейсе контроллера Wiren Board

Описание

Логотип Z-Wave

Z-Wave — это беспроводной протокол для домашней и коммерческой автоматизации.

Для использования Z-Wave устройств с контроллером Wiren Board понадобится:

  1. Модуль расширения WBE2R-R-ZWAVE-ZWAY или USB-стик Z-Wave.Me UZB1
  2. Дополнительное ПО:
    • 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.

Установка

  1. Обновите пакеты на контроллере:
    apt update && apt upgrade
    
  2. Установите ПО для работы с Z-Wave:
    apt install z-way-server
    

Веб-интерфейс сервера Z-Way будет доступен по адресу http://192.168.42.1:8083, где 192.168.42.1 — IP-адрес контроллера, укажите свой. При первом подключении сервер предложит задать пароль администратора — запомните его.

Настройка

Теперь нужно вставить в контроллер USB-стик или модуль расширения и указать порт в программном обеспечении:

  1. Вставьте в контроллер USB-стик или модуль расширения. Модуль расширения перед использованием нужно конфигурировать.
  2. Зайдите в веб-интерфейс Z-Way.
  3. Перейдите в Меню справа вверхуAppsZ-Wave Network Access и в поле Serial port to Z-Wave dongle укажите одно из значений:
    • USB-стик — /dev/ttyUZB;
    • модуль расширения — /dev/ttyMODx, где x — номер разъёма, куда вставлен модуль.

Теперь вы можете работать с устройствами 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

Описание

Чтобы упростить обработку данных с 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 Нажатие на кнопку

Установка интеграции

Установите модуль интеграции:

  1. Зайдите в интерфейс сервера Z-Way.
  2. Перейдите в Меню справа вверхуAppsOnline Apps .
  3. Введите в поиске Wiren Board MQTT Integration и установите найденное приложение.
  4. На этом этапе может потребоваться установить BaseModule, если это так, то в настройках модуля интеграции будет сообщение please install и кнопка Base Module — установите его нажатием на кнопку. Если сообщения нет — просто продолжайте настройку.
  5. Если вы настраиваете интерацию впервые и не знаете назначения настроек, то оставьте значения по умолчанию и нажмите внизу кнопку Save.

Если в процессе сохранения настроек модуля интеграции вы получите ошибку Something went wrong — перезапустите контроллер, найдите Wiren Board MQTT Integration теперь уже на вкладке Local Apps, нажмите на плюсик — откроется карточка с настройками интеграции, нажмите кнопку Save.

После этого во вкладке Devices веб-интерфейса контроллера Wiren Board будут появляться Z-Wave устройства, добавленные через интерфейс Z-Way.

Работа с Z-Wave устройствами

Добавление

Новое устройство добавляется в веб-интерфейсе Z-Way:

  1. Зайдите в интерфейс сервера Z-Way.
  2. Перейдите в Меню справа вверхуDevices
  3. Найдите в списке Z-Wave и нажмите кнопку Add new.
  4. Далее нажмите на кнопку Add new Z-Wave Device and identify it automatically
  5. Если вы добавляете новое устройство, то нажмите зелёную кнопку Start и активируйте режим сопряжения на устройстве, обычно, для этого нужно нажать три раза на кнопку сопряжения. Если устройство уже было сопряжено с другим сервером Z-Way, то перед выполнением сопряжения его нужно сбросить, для этого нажмите на кнопку Reset Device и включите на устройстве режим сопряжения. После сообщения об успешном сбросе, выполните инструкцию в начале этого пункта.
  6. После того, как устройство будет сопряжено, откроется страница, где можно задать устройству имя и настроить его. После этого нажмите кнопку Save.

Список добавленных устройств можно найти в разделе Elements, кнопка перехода к которому находится вверху окна. Так же устройства будут доступны в веб-интерфейсе контроллера Wiren Board на вкладке Devices в карточке Z-Way.

Управление

Устройствами можно управлять их веб-интерфейсов ПО Z-Wave и стандартного веб-интерфейса контроллера Wiren Board.

Кроме этого вы можете настраивать автоматизации с помощью правил wb-rules и стороннего ПО, которое работает с MQTT, например, Node-RED.

Удаление

Чтобы удалить Z-Wave устройство:

  1. Зайдите в интерфейс сервера Z-Way.
  2. Перейдите в Меню справа вверхуDevices
  3. Найдите в списке Z-Wave и нажмите кнопку Manage.
  4. Нажмите кнопку с красной корзинкой рядом с названием устройства, которое хотите удалить.
  5. Нажмите кнопку Reset and Remove, откроется всплывающее окно с инструкцией: вам нужно сделать на устройстве те же действия, которые включают режим сопряжения, например, три раза нажать на кнопку сопряжения.
  6. Устройство сброшено и удалено.

Из стандартного веб-интерфейса контроллера устройство будет удалено автоматически.

Полезные ссылки


Поддерживаемые контроллером Wiren Board системы верхнего уровня, приложения, способы программирования, протоколы и устройства
Протоколы
Опрос датчиков и работа с устройствами (в базовой комплектации) 1-WireDLMS/COSEM Modbus RTU/TCP Master ГОСТ МЭК 61107 СПОДЭС (ГОСТ Р 58940-2020)
Опрос датчиков и работа с устройствами (с помощью модулей расширения) KNXeBUSOpenThermZ-WaveZigbee
Опрос контроллера из систем верхнего уровня и с других устройств KNX Modbus RTU/TCP SlaveMQTTOPC UASNMPZabbix МЭК 104SmartWeb (Гидролого)
Системы верхнего уровня
Системы мониторинга и SCADA GrafanaHome Assistant IntraHouse IntraSCADASprut.hubMasterSCADANagiosSimpLight SCADARapid SCADASAYMONZabbix iRidium Server
Приложения
Управление с телефона MQTT DashiRidiumHome Assistant Apple HomeДом с АлисойСалют! Умный дом
Голосовые помощники Siri Салют Алиса
Способы программирования
Языки программирования ПЛК FBD, ST, LD, SFC (МЭК 61131-3)
Визуальное программирование Node-RED
Упрощённый текстовый движок правил wb-rules
Стандартное программирование Python C++ Go Node.js
Протестированные устройства сторонних производителей
Адаптеры протоколов ECODim DALI GW2 HDL KNX-DALI Gateway M/DALI.1 Arlight DALI-LOGIC-LITE-PS-x1
Аудиоресиверы сетевые URRI A1
Датчики климата DS18B20 и клоныKvadro 1WIRE-RS485 RLDA NL-3DPAS-M RLDA NL-1S111Wellpro WP3066ADAMДаджет MT8057/MT8057SРД MSU21РД MSU24РД MSU34+TLPРД MSU34+THLPЭксис ИВТМ-7 М 3
Датчики уровня ЭСКОРТ ДБ-2
Универсальные датчики TESLiOT (BLE)
Диммеры DALI Philio PAD07-RU Uniel UCH-M131RC/0808 Uniel UCH-M141RC/0808 РД DDL04R РД DDL24 РД DDL84R-V РД DDM845R
Домофоны VIZIT (ВИЗИТ), Элтис, Цифрал, Техком, Метаком, Beward и другие координатного типа
Конвекторы Varmann QTherm
Кондиционеры Haier YCJ-A002 Z-Wave ИК-передатчик PAR01-RUGREE (ONOKOM-AIR-GR-1-MB-B) AUX (ONOKOM-AIR-AUX-1-MB-B) Mitsubishi Electric (ONOKOM-AIR-ME-1-MB-B) Daikin (ONOKOM-AIR-DK-1-MB-B) Hisense (ONOKOM-AIR-HS-3-MB-B) Haier (ONOKOM-AIR-HR-1-MB-B)
Рекуператоры / вентиляция Рекуператор VAKIO Base Smart ПВУ Royal Clima Soffio Primo RCS-350-PВентиляционная установка KomfoventRoyal Clima VENTO
Контроллеры вентиляции и климата Mautomatics JL204C5 (Breezart 550 Lux) GTC (General Thermo Controllers) Syberia 5.0 SystemAir VR 300Тепломаш КЭВ-БЛОК-МК
Контроллеры холодильного оборудования Carel BASIC(PYEZ)/EASY(PJEZ) Danfoss EKC 204A1/AK-CC 210 Danfoss EKC 202B Danfoss EKC 202D Danfoss ERC 211/ERC 213/ERC 214 Eliwell IDPlus 974
Метеостанции Netatmo Urban Weather Station Сокол-М
Модули ввода-вывода Wellpro WP8026ADAM Wellpro WP8027ADAM Wellpro WP8028ADAM Wellpro WP9038ADAM
Модули реле РД DRB88 Rubetek TZ78 ICP DAS tM-P3R3 ICP DAS LC-103 Uniel UCH-M111RX/0808 Uniel UCH-M121RX/0808
Моторы для штор/Электрокарнизы Akko AM82 Dooya DM35EQ Dooya DT82 WinDeco Somfy SDN SunFlower KT82TV Somfy RS485 RTS transmitter Беспроводные Dooya/Somfy
Панели управления Cityron ПУ-3 (Modbus) Sonoff NSPanel (fw NXPanel) EKF PRO-Screen Skirell Panel
Счётчики воды Пульсар Пульсар-М Элехант СВД-15 Элехант СВД-20 Счётчики с импульсным выходом
Счётчики тепла Пульсар
Счётчики электроэнергии CSQ PD561Z-9SY Peacefair PZEM-016 Eastron SDM120M Eastron SDM220M Меркурий 200 Меркурий 201 Меркурий 203.2T Меркурий 204 Меркурий 206 Меркурий 208 Меркурий 230 Меркурий 231 Меркурий 234 Меркурий 236 Меркурий 238 Милур 104 Милур 105 Милур 107 Милур 305 Милур 307 Нева МТ 113 Нева МТ 123 Нева МТ 124 Нева МТ 323 Нева МТ 324 Энергомера CE301 Энергомера CE102M Энергомера CE303 Энергомера CE308
Термостаты BAC-002ALN BAC-6000ALN BAC-6000ELNW BHT-6000 Series Heatit Z-TEMP2 Hessway Siemens RDF302 Ridan Greencon-R
Увлажнители CAREL Humisonic
Управление двигателями (преобразователи частоты) Vacon/Danfoss 10 Danfoss VLT Microdrive FC51 T13-400W-12-H/T13-750W-12-H
Прочее DIYShelly UNITasmotaESPHome
Устройства с аналоговым или цифровым выходом
Низковольтная нагрузка Реле с управляющим напряжением 12–24 В Светодиоды Низковольтные вентиляторы Низковольтные сигнальные лампы
Датчики с аналоговым выходом Датчики температуры, давления и другие, имеющие на выходе ток или напряжение
Счётчики с импульсным выходом Счётчики электроэнергии, воды, тепла и другие с импульсным выходом
Устройства с выходом «открытый коллектор» Устройства с выходом «открытый коллектор»
Устройства с питанием 220 В Лампы Контакторы и другое оборудование с питанием от 220 В