Перейти к содержанию

Навигация

Z-Wave: различия между версиями

Z-Wave (просмотреть исходный код)

Версия 09:59, 29 января 2024

5358 байт добавлено ,  3 месяца назад
→‎Описание
 
(не показано 87 промежуточных версий 5 участников)
Строка 1: Строка 1:
<languages/>
<languages/>
<translate>
<translate>
[[File:UZB1_stick.png |400px|thumb|right|USB-стик Z-Wave.Me UZB1]]
{{DISPLAYTITLE: Подключение Z-Wave устройств к контроллеру Wiren Board}}
Для использования устройств Z-Wave с контроллером Wiren Board понадобится:
[[File:Z-Wave Devices in Wiren Board WebUI Full.png|400px|thumb|right|Представление Z-Wave устройств в веб-интерфейсе контроллера Wiren Board]]
# USB-стик Z-Wave.Me UZB1. [https://wirenboard.com/ru/product/z-wave/ Купить в интернет-магазине]
# Установить дополнительное ПО [https://z-wave.me/z-way/ Z-Way].
== Установка ПО == <!--T:1-->
=== Установка ПО на Wiren Board 6 (новый способ) ===
# Обновите пакеты на контроллере:<syntaxhighlight lang="bash">apt update; apt upgrade</syntaxhighlight>Внимательно читайте сообщения, особенно если запрашивается разрешение на удаление пакетов или замену конфигурационных файлов.
# Установите требуемые пакеты:<syntaxhighlight lang="bash">apt install libarchive13 sharutils gawk libavahi-compat-libdnssd-dev</syntaxhighlight>
# Скачайте и установите Z-Way:<syntaxhighlight lang="bash">
wget https://storage.z-wave.me/z-way-server/z-way-2.3.8__armhf.deb
dpkg -i z-way-2.3.8__armhf.deb</syntaxhighlight>(текущая стабильная версия; ссылки на более новые сборки можно найти здесь: https://z-wave.me/z-way/download-z-way/ https://oldrazberry.z-wave.me/z-way-server/?C=M;O=D)
# Зайдите в интерфейс Z-Way. Чтобы туда попасть, нужно зайти на IP-адрес контроллера, но в конце добавить порт 8083, например, ''192.168.0.103:8083''. При первом подключении сервер предложит задать пароль администратора - запомните его.
# Вставьте USB-стик в контроллер. В интерфейсе Z-Way измените порт для работы со стиком Z-Wave на ''/dev/ttyUZB'': ''кнопка меню справа вверху'' - ''Apps'' - ''Z-Wave Network Access'' - ''Serial port to Z-Wave dongle''.


=== Интеграция Z-Waу с основным интерфейсом Wiren Board (новый способ) === <!--T:2-->
== Описание ==
[[Image: Z-Wave Logo.png |200px|thumb|right| Логотип Z-Wave]]


<!--T:3-->
Z-Wave — это беспроводной протокол для домашней и коммерческой автоматизации.
Выполните инструкцию внизу страницы https://github.com/contactless/wb-mqtt-zway-plugin.
 
Для использования Z-Wave устройств с контроллером [[Wiren Board]] понадобится:
# Модуль расширения [[WBE2R-R-ZWAVE-ZWAY Z-Wave Extension Module | WBE2R-R-ZWAVE-ZWAY]] или [https://wirenboard.com/ru/product/z-wave/ USB-стик Z-Wave.Me UZB1]
# Дополнительное ПО:
#* [[#Установка и настройка z-way-server |z-way-server]] — Z-Way сервер, который работает с устройствами.
#* [[#Установка Wiren Board MQTT Integration | Wiren Board MQTT Integration]] — интеграция, которая позволяет управлять Z-Way устройствами из основного веб-интерфейса контроллера Wiren Board.
 
Инструкции по установке смотрите ниже на этой странице.
 
== Установка и настройка z-way-server == <!--T:1-->
=== Описание ===
''z-way-server'' — это комплексное программное обеспечение [https://z-wave.me/z-way/ Z-Way], поддерживающее радиопротоколы Z-Wave и EnOcean, а также устройства на основе Wi-Fi, MQTT и HTTP. Пакет есть в репозитории контроллера Wiren Board.
 
=== Установка===
# Обновите пакеты на контроллере:
#:<syntaxhighlight lang="bash">
apt update && apt upgrade
</syntaxhighlight>
# Установите ПО для работы с Z-Wave:
#:<syntaxhighlight lang="bash">
apt install z-way-server
</syntaxhighlight>
 
Веб-интерфейс сервера 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-стик — <code>/dev/ttyUZB</code>;
#* модуль расширения — <code>/dev/ttyMODx</code>, где x — номер разъёма, куда вставлен модуль.
Теперь вы можете работать с устройствами Z-Wave из веб-интерфейса ПО Z-Way. Если вы хотите видеть Z-Wave устройства в стандартном веб-интерфейсе контроллера и использовать их в автоматизациях, установите интеграцию ''Wiren Board MQTT Integration''.
 
<gallery mode="packed" widths="200px" caption="Настройка порта">
Image: Z-Wave Network Access-1.png | Вызов меню и переход в раздел Apps
Image: Z-Wave Network Access-2.png | Поиск Z-Wave Network Access
Image: Z-Wave Network Access-3.png | Настройки Z-Wave Network Access, порт
Image: Z-Wave Network Access-4.png | Настройки Z-Wave Network Access
</gallery>
 
=== Удалённый доступ ===
По умолчанию пакет, который организует удалённый доступ к веб-интерфейсу Z-Way не установлен, если он вам нужен, установите его командой:
<syntaxhighlight lang="bash">
apt install zbw
</syntaxhighlight>
 
В конце установки будут сгенерированы User Id и Password — запишите их, чтобы не потерять.
 
== Установка Wiren Board MQTT Integration == <!--T:2-->
[[Image: WebUI Z-Way.png |300px|thumb|right| Представление устройств Z-Wave в веб-интерфейсе контроллера Wiren Board ]]
=== Описание ===
Чтобы упростить обработку данных с Z-Wave устройств и управление ими, мы написали модуль интеграции ''Wiren Board MQTT Integration'', который преобразовывает данные Z-Way сервера в топики виртуального устройства, которое будет доступно в [[Wiren Board Web Interface |веб-интерфейсе]] контроллера на вкладке ''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) и старее.


При возникновении проблем, опишите их здесь: https://support.wirenboard.com/t/novyj-sposob-podderzhki-z-wave-ustrojstv/3071
Если вам нужно отправить данные из топиков контроллера в софт Z-Way, то установите Wiren Board MQTT import.


=== Установка ПО на Wiren Board 6 (устаревший способ) === <!--T:4-->
=== Принцип работы ===
Преобразовывает описание настроенных в ПО Z-Way устройств в каналы устройства Z-Wave, которое находится в веб-интерфейса контроллера на вкладке '''Devices'''.


<!--T:5-->
Можно получать с устройств данные и управлять ими.
# Скачиваем сервер Z-way для работы с устройствами Z-wave командой <pre>wget http://razberry.z-wave.me/z-way-server/z-way-server-RaspberryPiXTools-v2.3.7-rc1.tgz</pre>
# Распаковываем скачанный архив в папку /opt: <pre>tar -xvzf z-way-server-RaspberryPiXTools-v2.3.7-rc1.tgz --directory /opt/</pre>
# Устанавливаем нужные для работы библиотеки:<pre>apt-get update</pre><pre>apt-get install libssl1.0.0 libarchive13 libavahi-compat-libdnssd1</pre>
# Трёх необходимых пакетов нет в репозитории для версии Debian, используемой в Wiren Board, - Debian 9 "Stretch". Поэтому скачиваем эти пакеты из репозиториев для предыдущих версий Debian, выбирая архитектуру armhf, и устанавливаем вручную:<pre>wget http://ftp.us.debian.org/debian/pool/main/libj/libjsoncpp/libjsoncpp0_0.6.0~rc2-3.1_armhf.deb; dpkg -i libjsoncpp0_0.6.0~rc2-3.1_armhf.deb</pre><pre>wget http://ftp.us.debian.org/debian/pool/main/n/nettle/libnettle4_2.7.1-5+deb8u2_armhf.deb; dpkg -i libnettle4_2.7.1-5+deb8u2_armhf.deb</pre><pre>wget http://archive.debian.org/debian-security/pool/updates/main/liba/libarchive/libarchive12_3.0.4-3+wheezy6+deb7u1_armhf.deb; dpkg -i libarchive12_3.0.4-3+wheezy6+deb7u1_armhf.deb</pre>
# Устанавливаем пакеты для отображения в веб-интерфейсе Wiren Board (имеют в зависимостях z-way-server, но мы установим его потом вручную, поэтому скачиваем пакеты и принудительно их устанавливаем): <pre>apt-get download wb-mqtt-zway</pre><pre>dpkg -i --force-all wb-mqtt-zway_1.0.3+wb2_armhf.deb</pre>
# Выполняем тестовый запуск сервера, указав ему путь до библиотек:  <pre>cd /opt/z-way-server/</pre><pre>LD_LIBRARY_PATH=/opt/z-way-server/libs:/usr/lib/arm-linux-gnueabihf:$LD_LIBRARY_PATH /opt/z-way-server/z-way-server</pre>
# После установки wb-mqtt-zway в веб-интерфейсе Wiren Board в разделе Configs появляются настройки интеграции с Z-Way. При этом настройка Z-Wave устройств выполняется через отдельный собственный интерфейс Z-Way. Чтобы туда попасть, нужно зайти на IP-адрес контроллера, но в конце добавить порт 8083, например, <pre>192.168.0.103:8083</pre>
# В интерфейсе Z-Way изменяем порт для работы со стиком Z-Wave с /dev/ttyAMA0 на (в версии без 3G модема) /dev/ttyACM0 или (в версии с 3G модемом) /dev/ttyACM7: ''кнопка меню справа вверху'' - ''Apps'' - ''Z-Wave Network Access'' - ''Serial port to Z-Wave dongle''.
# Настроим автоматический запуск сервера Z-Way. Скачиваем https://github.com/contactless/z-way-server-debian/blob/master/debian/z-way-server.init и сохраняем как /etc/init.d/z-way-server: <pre>wget -O /etc/init.d/z-way-server https://raw.githubusercontent.com/contactless/z-way-server-debian/master/debian/z-way-server.init</pre>
# Выставляем права на исполнение: <pre>chmod +x /etc/init.d/z-way-server</pre>
# Проверяем, что появился сервис z-way-server: <pre>systemctl daemon-reload</pre><pre>service z-way-server start</pre>
# Добавляем сервис в автозагрузку <pre>update-rc.d z-way-server defaults</pre>
# В файле /opt/z-way-server/config.xml укажите порт для отладки или удалите строку  <pre><debug-port></debug-port></pre>


=== Установка ПО на Wiren Board 5 === <!--T:6-->
{|  border="1" class="wikitable noclear"
|+ Поддерживаемые типы устройств
! Тип Z-Way || Тип Wiren Board || Описание
|-
| sensorBinary || switch || Значения с бинарных датчиков
|-
| sensorMultilevel || value || Значения с датчиков температуры, влажности, освещенности и т.п.
|-
| battery || value || Значение с датчиков уровня батареи
|-
| doorlock || switch || Переключатель открытия/закрытия двери
|-
| switchBinary || switch || Переключатель ON/OFF
|-
| switchMultilevel || range || Переключатель с несколькими позициями
|-
| thermostat || range || Установка значения температуры в термостате
|-
| toggleButton || pushbutton || Нажатие на кнопку
|-
|}


<!--T:7-->
=== Установка интеграции ===
Обновляем список программного обеспечения на контроллере командой и устанавливаем необходимое ПО (сервер z-way, mqtt-адаптер, вспомогательные библиотеки):
<!--T:3-->
<pre>
apt-get update
apt-get install libarchive12 libarchive13 libavahi-compat-libdnssd1 wb-mqtt-zway wb-homa-zway
</pre>


<!--T:8-->
Установите модуль интеграции:
Если при установке возникает ошибка "E: Unable to locate package libarchive12" (такое может случится на контроллере с последней версией прошивки на базе Debian Stretch), установку выполняем следующей командой:
# Зайдите в интерфейс сервера Z-Way.
<pre>
# Перейдите в '''Меню справа вверху''' → '''Apps''' → '''Online Apps '''.
apt-get update
# Введите в поиске '''Wiren Board MQTT Integration''' и установите найденное приложение.
apt-get install libarchive13 libavahi-compat-libdnssd1 wb-mqtt-zway wb-homa-zway
# На этом этапе может потребоваться установить '''BaseModule''', если это так, то в настройках модуля интеграции будет сообщение '''please install''' и кнопка '''Base Module''' — установите его нажатием на кнопку. Если сообщения нет — просто продолжайте настройку.
</pre>
# Если вы настраиваете интерацию впервые и не знаете назначения настроек, то оставьте значения по умолчанию и нажмите внизу кнопку '''Save'''.


<!--T:9-->
Если в процессе сохранения настроек модуля интеграции вы получите ошибку ''Something went wrong'' — перезапустите контроллер, найдите ''Wiren Board MQTT Integration'' теперь уже на вкладке '''Local Apps''', нажмите на плюсик — откроется карточка с настройками интеграции, нажмите кнопку '''Save'''.
<pre>Do you want to continue? [Y/n] Y</pre>


<!--T:10-->
После этого во вкладке ''Devices'' веб-интерфейса контроллера Wiren Board будут появляться Z-Wave устройства, добавленные через интерфейс Z-Way.
Далее настраиваем сервер Z-Way.
<gallery mode="packed" heights="200" caption="Установка интеграции для работы с Wiren Board">
Image: Wiren Board MQTT Integration-1.png | Вызов меню и переход в раздел ''Apps''
Image: Wiren Board MQTT Integration-2.png | Поиск и выбор ''Wiren Board MQTT Integration''
Image: Wiren Board MQTT Integration-3.png | Установка ''Wiren Board MQTT Integration''
Image: Wiren Board MQTT Integration-4.png | Запрос на установку ''BaseModule'', будет только при первой установке интеграции
Image: Wiren Board MQTT Integration-5.png | Настройка доступа к MQTT-брокеру
Image: Wiren Board MQTT Integration-6.png | Сохранение настроек
</gallery>


<!--T:11-->
== Работа с Z-Wave устройствами == <!--T:18-->
Вставляем USB-стик в USB-порт контроллера, и переходим на страницу настройки сервера: http://''ip_адрес_контроллера'':8083
=== Добавление ===
Новое устройство добавляется в веб-интерфейсе Z-Way:
# Зайдите в интерфейс сервера Z-Way.
# Перейдите в '''Меню справа вверху''' → '''Devices'''
# Найдите в списке '''Z-Wave ''' и нажмите кнопку '''Add new'''.
# Далее нажмите на кнопку '''Add new Z-Wave Device and identify it automatically'''
# Если вы добавляете новое устройство, то нажмите зелёную кнопку '''Start''' и активируйте режим сопряжения на устройстве, обычно, для этого нужно нажать три раза на кнопку сопряжения. Если устройство уже было сопряжено с другим сервером Z-Way, то перед выполнением сопряжения его нужно сбросить, для этого нажмите на кнопку '''Reset Device''' и включите на устройстве режим сопряжения. После сообщения об успешном сбросе, выполните инструкцию в начале этого пункта.
# После того, как устройство будет сопряжено, откроется страница, где можно задать устройству имя и настроить его. После этого нажмите кнопку '''Save'''.
<gallery mode="packed" widths ="260px" caption="Добавление нового Z-Wave устройства">
Image: ZB_Configure.png | Вызов меню и переход в раздел ''Devices''
Image: ZB_Add_Device.png | Добавление устройства типа Z-Wave
Image: ZB_Add_New_Device.png | Переход с процедуре сопряжения устройств
Image: ZB_Add_New_Device Progress 1.png | Запуск сопряжения
Image: ZB_Add_New_Device Progress 2.png | Сопряжение с устройством
Image: ZB_Add_New_Device Progress 3.png | Настройка сопряжённого устройства
</gallery>


<!--T:12-->
Список добавленных устройств можно найти в разделе ''Elements'', кнопка перехода к которому находится вверху окна. Так же устройства будут доступны в веб-интерфейсе контроллера Wiren Board на вкладке ''Devices'' в карточке Z-Way.
При первом подключении сервер предложит задать пароль администратора. Запомните его.
<gallery mode="packed" widths ="360px" caption="Представление Z-Wave устройства">
Image: ZB_Discovered.png | Устройство в веб-интерфейсе Z-Way
Image: Z-Wave Devices in Wiren Board WebUI.png | Устройство в карточке Z-Wave в веб-интерфейсе контроллера Wiren Board
</gallery>


<!--T:13-->
=== Управление ===
Щелкните на кнопке Submit.
Устройствами можно управлять их веб-интерфейсов ПО Z-Wave и стандартного веб-интерфейса контроллера Wiren Board.  


<!--T:14-->
Кроме этого вы можете настраивать автоматизации с помощью правил [[wb-rules]] и стороннего ПО, которое работает с MQTT, например, [[Node-RED]].
После этого вы попадете на страницу настройки сети Z-Wave.


=== Интеграция Z-Waу с основным интерфейсом Wiren Board (старый способ) === <!--T:15-->
=== Удаление ===
Чтобы удалить Z-Wave устройство:
# Зайдите в интерфейс сервера Z-Way.
# Перейдите в '''Меню справа вверху''' → '''Devices'''
# Найдите в списке '''Z-Wave ''' и нажмите кнопку '''Manage'''.
# Нажмите '''кнопку с красной корзинкой''' рядом с названием устройства, которое хотите удалить.
# Нажмите кнопку '''Reset and Remove''', откроется всплывающее окно с инструкцией: вам нужно сделать на устройстве те же действия, которые включают режим сопряжения, например, три раза нажать на кнопку сопряжения.
# Устройство сброшено и удалено.


<!--T:16-->
Из стандартного веб-интерфейса контроллера устройство будет удалено автоматически.
Теперь в Web-интерфейсе контроллера необходимо настроить подключение к серверу Z-Way.


В '''Configs -> Bridge to WB-MQTT for Z-Way software''' укажите имя пользователя сервера Z-Way и пароль, заданный при конфигурировании сервера.[[File:ZB_MQTT_Setup.png|thumb|center|500 px|Укажите имя пользователя сервера Z-Way и пароль]]
<gallery mode="packed" heights="100px" caption="Удаление Z-Wave устройства">
После этого на вкладке Devices появится новое устройство.[[File:ZB_Device_WB.png|thumb|center|500 px|Новое устройство Z-Wave в интерфейсе Wiren Board]]
Image: Del device-1.png| Вызов меню и переход в раздел ''Devices''
Image: Del device-2.png | Переход к управлению Z-Wave устройствами, кнопка ''Manage''
Image: Del device-3.png | Список Z-Wave устройств и кнопка удаления одного из них
Image: Del device-4.png | Кнопка ''Reset and Remove'', которая сбрасывает устройство и удаляет его из ПО
</gallery>


== Как добавить устройство в интерфейсе Z-Way == <!--T:18-->
== Полезные ссылки ==
* [https://z-wave.me/z-way/ Официальный сайт программного обеспечения Z-Way]
* [[Rubetek TZ78 Z-Wave Relay | Подключение реле Rubetek TZ78]]
* [[Philio PAD07-RU Z-Wave Dimmer | Подключение диммера Philio PAD07-RU]]
* [[Heatit Z-TEMP2 Z-Wave Thermostat | Подключение термостата Heatit Z-TEMP2]]
* [[Philio PAR01-RU Z-Wave AC IR Control | Подключение устройства управления кондиционером Philio PAR01-RU]]


# При первом входе в интерфейс Z-Way нужно будет задать пароль администратора.[[File:New_ZW_Password.png|thumb|center|500 px|Задайте пароль администратора]]
{{Wbincludes:Device Page Footer}}
# Нажмите на значок в виде шестеренки.[[File:ZB_Configure.png|500px|thumb|center|Нажмите на значок в виде шестеренки]]
# В разделе Devices нажмите на кнопку "Add New".[[File:ZB_Add_Device.png|500px|thumb|center|Добавление нового устройства]]
# Запустите процедуру добавления нового устройства, нажав на кнопку "Add new Z-Wave Device and identify it automatically".[[File:ZB_Add_New_Device.png|500px|thumb|center|Запустите процедуру добавления нового устройства]]
# Нажмите на кнопку "Start inclusion" и начните добавление устройства Z-Wave согласно инструкции к этому устройству (например, для обнаружения устройства вам потребуется нажать на нем кнопку включения несколько раз подряд).
# После успешного добавления устройство будет видимо в списке "Elements"[[File:ZB_Discovered.png|500px|thumb|center|Найденные устройства]]
</translate>
</translate>
Источник — https://wirenboard.com/wiki/Служебная:Сравнение_версий/41171...78953