WBE2-I-KNX KNX Extension Module: различия между версиями

Материал из Wiren Board
(не показаны 44 промежуточные версии 7 участников)
Строка 1: Строка 1:
<languages/>
<languages/>
<translate>
<translate>
{{DISPLAYTITLE:Модуль расширения: KNX, WBE2-I-KNX}}
[[Файл:WBE2-I-KNX.png|thumb|300px|Модуль расширения WBE2-I-KNX]]
'''[https://wirenboard.com/ru/product/WBE2-I-KNX/ Купить в интернет-магазине]'''
== Распиновка == <!--T:1-->
[[Файл:WBE2-I-KNX.png|thumb|200px|Модуль расширения WBE2-I-KNX]]
== Описание модуля == <!--T:1-->
[[Image: KNX_connect_controller.png|300px|thumb|right| Подключение контроллера Wiren Board к шине [[KNX]] с помощью модуля '''WBE2-I-KNX''', установленного в разъём '''MOD1''']]


Модуль '''WBE2-I-KNX''' устанавливается внутрь контроллера Wiren Board и добавляет контроллеру порт для подключения устройств, использующих для связи протокол KNX.


Распиновка:
 
[[Файл:Knx conector.png|300px|Модуль расширения KNX]]
 
<!--T:3-->
<!--T:3-->
{| class="wikitable noclear"
{| class="wikitable"
!Клемма
!Клемма
!Функция
!Функция
|-
|-
|O1 (ранее - Red)
|O1 (Red)
|KNX (+)
|KNX (+)
|-
|-
Строка 21: Строка 19:
|n/a
|n/a
|-
|-
|O3 (ранее - Gray)
|O3 (Gray)
|KNX (-)
|KNX (-)
|}
|}


==Установка==
==Установка==
{{Wbincludes:Setup MOD}}
{{Wbincludes:Setup MOD}}
{{Wbincludes:Installation MOD WBE2 Interfaces}}
[[Файл:WBE2-I-KNX_Web.png|300px|настройка типа модуля]]
{{Wbincludes:Configuration MOD}}
{{Wbincludes:Configuration MOD}}


В папке /dev Появятся симлинки на устройства ttyKNX1 — для Internal slot 1 и ttyKNX2 — для Internal slot 2. Если выбрано всего Одно устройство KNX, то так же появитcя симлинк ttyKNX, при этом не важно в каком слоте из двух будет установлен модуль.
== Работа через iRidium Server == <!--T:8-->
 
<!--T:9-->
Скачайте свежую версию установочного deb - пакета с названием '''iRidium server для Raspbian Jessie with the PIXEL и WB 0 (gen 6)''' отсюда [https://iridi.com/ru/download/software/v3/ Загрузки iRidium Pro]
 
<!--T:10-->
[[Файл:iridium_server_download_link_screenshot.png|Файл:iridium_server_download_link_screenshot.png]]
 
<!--T:11-->
скопируйте файл на контроллер [https://wirenboard.com/wiki/index.php/%D0%9F%D1%80%D0%BE%D1%81%D0%BC%D0%BE%D1%82%D1%80_%D1%84%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2_%D0%BA%D0%BE%D0%BD%D1%82%D1%80%D0%BE%D0%BB%D0%BB%D0%B5%D1%80%D0%B0_%D1%81_%D0%BA%D0%BE%D0%BC%D0%BF%D1%8C%D1%8E%D1%82%D0%B5%D1%80%D0%B0 (подробное описание как копировать файлы на контроллер)] и установите его, выполнив команду
 
<!--T:12-->
'''dpkg -i iridiumserver_1.3.0-15590_RPI.deb'''
 
<!--T:13-->
Зайдите на web-интерфейс iRidium Server по ссылке '''''адрес_вашего_wirenboard:8888''''' и авторизуйтесь на сервере.
 
<!--T:14-->
Далее, при создании проекта добавте драйвер KNX Serial (UMC) и настройте его как показано ниже
 
<!--T:15-->
[[Файл:iridium_server_knx_serial_driver_settings.jpg|Файл:iridium_server_knx_serial_driver_settings.jpg]]
 
<!--T:16-->
ипользуйте '''''/dev/ttyMOD2''''', если модуль установлен во второй слот расширения
 
==  Работа через MQTT  == <!--T:17-->
 
<!--T:18-->
Необходимо зайти в консоль и установить пакеты [https://contactless.ru/wiki/index.php/MQTT_KNX_Bridge wb-mqtt-knx (MQTT KNX Bridge)], knxd, knxd-tools:
 
<!--T:19-->
'''apt-get update'''
 
<!--T:20-->
'''apt-get install knxd knxd-tools wb-mqtt-knx'''
 
<!--T:21-->
После установки необходимо отредактировать 2 файла:
 
<!--T:26-->
В файле '''/etc/knxd.conf''' вторую строку заменить на:


==Работа==
Основную информацию по сетям KNX можно найти [https://www.ixbt.com/home/knx-intro.shtml в статье на сайте IXBT] и на странице [[KNX]].


=== Предустановленное ПО ===
'''KNXD_OPTS="-t 0xffe -f 9 -e 1.1.255 -E 1.1.10:30 -b ncn5120:/dev/ttyMOD1 -D -T -R -S"'''


Мы рекомендуем использовать сервис [[MQTT_KNX | wb-mqtt-knx]], который транслирует KNX-телеграммы в MQTT-топики и наоборот. С KNX-шиной он общается через роутер [[Knxd]].


Для отладки удобно использовать программу [[KnxTool]].
<!--T:27-->
В файле '''/lib/systemd/system/knxd.service''' удалить следующие строки:


=== Альтернативное ПО ===
'''User=knxd'''


Так же на контроллеры Wiren Board для работы с KNX можно установить ПО [[IRidium Server]], которое может работать с шиной KNX как на прямую или через роутер knxd.
'''Group=knxd'''
 
<!--T:28-->
После этого желательно перезагрузить контроллер.


== Примеры ==
* [[KNX_Quick_start | Быстрый старт по KNX]]
* [[KNX demo-stand]], статья описывает работу сервиса wb-mqtt-knx в режиме Сетевой мост, который устарел и не поддерживается.


== Известные неисправности ==
[[WBE2-I-KNX:_Errata |Список известных неисправностей]]


== Ревизии устройства == <!--T:20-->
<!--T:29-->
{{Wbincludes:Revision}}
Расшифровка ключей:
{| class="wikitable"
!Ключ
!Функция
|-
| -d /var/log/knxd.log
| уйти в фон и писать в лог.
|-
| -e 1.1.255
|назначает KNX-адрес knxd равным 1.1.255, как IP-шлюзу.
|-
| -E 1.1.10:30
|указывает knxd выдавать KNX-адреса узлам из IP-сети в диапазоне 1.1.10..1.1.30
|-
|-
|2.5
| -u /var/run/knx
|v2.5B - ...
|открываем локальный Unix-сокет
|01.2024 - ...
|
*На чипе NCN5121
|-
|-
|2.5
| -t 0xffe
|v2.5A
|задаём маску вывода отладочных сообщений.
|10.2023
|
*Больше вырез в контуре платы, для совместимости с WB7.4.
|-
|-
|2.4
| -f 9
|v2.4E, v2.4F
|задать макс. verbosity level
|05.2023 - 10.2023
|
*На чипе NCN5120
|-
|-
|2.4
| -i
|v2.4A, v2.4B, v2.4C, v2.4D - ...
|указываем слушать TCP-порт (по умолчанию 6720). Можно прописывать -i 6721 или другой порт. Не исключающая альтернатива -u
|01.2022 - ...
|
*Изменена геометрия платы для совместимости с WB7
|-
|-
|2.3
| -b ncn5120:/dev/ttyMOD1
|v2.3A - v2.3E
|активируем ncn5120-драйвер на порту для MOD1 (при установке модуля в слот расширения MOD 2 следует указать ttyMOD2)
|04.2020 - 01.2022
|
*На чипе NCN5121 (исправлена ERRKNX220001)
|-
|-
|2.2
| -T -R
|v2.2A
|активируем режим шлюза, туннеля (нужно для работы с ETS)
|09.2019 - 04.2020
|
*Изменена геометрия платы (увеличен крепежный выступ)
|-
|-
|2.1
| -D
|
|говорит knxd оповещать о себе (Discovery) в сети
|конец 2017 - 08.2019
|
*Первая версия
|-
|-
| -S
|запускаем сервер (который отвечает на мультикасты)
|}
|}
<!--T:30-->
Подробнее:
<!--T:31-->
knxd --help
==  Работа == <!--T:32-->
<!--T:33-->
Для запуска KNXd, необходимо прописать строку в консоль:
'''service knxd start'''
<!--T:34-->
При необходимости перезапуска:
'''service knxd restart'''
<!--T:35-->
Для проверки статуса:
'''service knxd status'''
<!--T:36-->
Все логи хранятся в файле '''/var/log/knxd.log'''
<!--T:37-->
При получении сообщения от KNX устройства данные публикуются в MQTT топик '''/devices/knx/controls/data''' на WirenBoard.
<!--T:38-->
Для управления устройствами KNX необходимо отправлять команды в MQTT топик '''/devices/knx/controls/data/on''' .
<!--T:39-->
Пример команды:
<!--T:40-->
mosquitto_pub -h 192.168.0.10 -p 1883 -t /devices/knx/controls/data/on -m "g:0/0/1 GroupValueWrite 0x01"
<!--T:41-->
Где:
<!--T:42-->
-h 192.168.0.10 - IP-адрес контроллера с KNX
<!--T:43-->
-p 1883 - порт MQTT
<!--T:44-->
-t /devices/knx/controls/data/on - MQTT топик для выгрузки информации
<!--T:45-->
-m "g:0/0/1 GroupValueWrite 0x01" - сообщение для KNX устройства
<!--T:46-->
Подробнее о работе с данными KNX: [https://contactless.ru/wiki/index.php/MQTT_KNX_Bridge wb-mqtt-knx (MQTT KNX Bridge)]
<!--T:47-->
Скрипт для [https://contactless.ru/wiki/index.php/%D0%94%D0%B2%D0%B8%D0%B6%D0%BE%D0%BA_%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB_wb-rules wb-rules] упрощающий обработку телеграмм: [https://gist.github.com/Yanni66/bc7604bb8646d52c9c864b4ca40c63b6 knx_group_addresses.js]
<!--T:48-->
При работе с ETS '''Важно''': в “interfaces” ETS надо выбирать сам интерфейс ПК, через который происходит общение. Обращение с knxd  по юникасту (ip-адресу хоста с демоном) не даёт запрограммировать устройства. На иллюстрации стрелкой отмечено, какой способ взаимодействия с ETS работает:
<!--T:49-->
[[Файл:EtsInterface.png|500px|Интерфейсы]]
<!--T:50-->
Также если вы пользователь Windows 8, 10, советуем отключить антивирусы и брандмауэр, так как они могут мешать работе ETS.
== Известные неисправности ==
[[WBE2-I-KNX:_Errata |Список известных неисправностей]]


</translate>
</translate>

Версия 22:00, 12 мая 2020

Другие языки:
Модуль расширения WBE2-I-KNX

Распиновка

Модуль расширения KNX

Клемма Функция
O1 (Red) KNX (+)
O2 (n/a) n/a
O3 (Gray) KNX (-)


Установка

При заказе модулей в комплекте с контроллером Wiren Board, мы устанавливаем их на производстве — вам нужно только настроить модули в веб-интерфейсе контроллера.

Если вы купили модули отдельно, установите их самостоятельно:

  1. Разберите корпус контроллера.
  2. Вставьте модуль, соблюдая полярность: выступ на нем должен попасть в паз на плате контроллера.

настройка типа модуля

Конфигурирование

Смена уровня доступа

Уровень «Администратор»

Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе Настройки → Права доступа.

После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.

Настройка

Подключение модулей расширения в веб-интерфейсе контроллера Wiren Board

После физического подключения модуля его нужно добавить в конфигурацию контроллера:

  1. В веб-интерфейсе перейдите в раздел Настройки → Конфигурационные файлы → Модули расширения и порты , выберите тот Внутренний слот, куда установлен модуль расширения.
  2. В раскрывающемся списке Тип модуля выберите название установленного модуля.
  3. Нажмите кнопку Сохранить. Контроллер включит нужные для работы модуля порты.

Для удаления модуля выберите тип Не установлен.

Работа через iRidium Server

Скачайте свежую версию установочного deb - пакета с названием iRidium server для Raspbian Jessie with the PIXEL и WB 0 (gen 6) отсюда Загрузки iRidium Pro

Файл:iridium_server_download_link_screenshot.png

скопируйте файл на контроллер (подробное описание как копировать файлы на контроллер) и установите его, выполнив команду

dpkg -i iridiumserver_1.3.0-15590_RPI.deb

Зайдите на web-интерфейс iRidium Server по ссылке адрес_вашего_wirenboard:8888 и авторизуйтесь на сервере.

Далее, при создании проекта добавте драйвер KNX Serial (UMC) и настройте его как показано ниже

Файл:iridium_server_knx_serial_driver_settings.jpg

ипользуйте /dev/ttyMOD2, если модуль установлен во второй слот расширения

Работа через MQTT

Необходимо зайти в консоль и установить пакеты wb-mqtt-knx (MQTT KNX Bridge), knxd, knxd-tools:

apt-get update

apt-get install knxd knxd-tools wb-mqtt-knx

После установки необходимо отредактировать 2 файла:

В файле /etc/knxd.conf вторую строку заменить на:


KNXD_OPTS="-t 0xffe -f 9 -e 1.1.255 -E 1.1.10:30 -b ncn5120:/dev/ttyMOD1 -D -T -R -S"


В файле /lib/systemd/system/knxd.service удалить следующие строки:

User=knxd

Group=knxd

После этого желательно перезагрузить контроллер.


Расшифровка ключей:

Ключ Функция
-d /var/log/knxd.log уйти в фон и писать в лог.
-e 1.1.255 назначает KNX-адрес knxd равным 1.1.255, как IP-шлюзу.
-E 1.1.10:30 указывает knxd выдавать KNX-адреса узлам из IP-сети в диапазоне 1.1.10..1.1.30
-u /var/run/knx открываем локальный Unix-сокет
-t 0xffe задаём маску вывода отладочных сообщений.
-f 9 задать макс. verbosity level
-i указываем слушать TCP-порт (по умолчанию 6720). Можно прописывать -i 6721 или другой порт. Не исключающая альтернатива -u
-b ncn5120:/dev/ttyMOD1 активируем ncn5120-драйвер на порту для MOD1 (при установке модуля в слот расширения MOD 2 следует указать ttyMOD2)
-T -R активируем режим шлюза, туннеля (нужно для работы с ETS)
-D говорит knxd оповещать о себе (Discovery) в сети
-S запускаем сервер (который отвечает на мультикасты)

Подробнее:

knxd --help

Работа

Для запуска KNXd, необходимо прописать строку в консоль: service knxd start

При необходимости перезапуска: service knxd restart

Для проверки статуса: service knxd status


Все логи хранятся в файле /var/log/knxd.log

При получении сообщения от KNX устройства данные публикуются в MQTT топик /devices/knx/controls/data на WirenBoard.

Для управления устройствами KNX необходимо отправлять команды в MQTT топик /devices/knx/controls/data/on .

Пример команды:

mosquitto_pub -h 192.168.0.10 -p 1883 -t /devices/knx/controls/data/on -m "g:0/0/1 GroupValueWrite 0x01"

Где:

-h 192.168.0.10 - IP-адрес контроллера с KNX

-p 1883 - порт MQTT

-t /devices/knx/controls/data/on - MQTT топик для выгрузки информации

-m "g:0/0/1 GroupValueWrite 0x01" - сообщение для KNX устройства

Подробнее о работе с данными KNX: wb-mqtt-knx (MQTT KNX Bridge)


Скрипт для wb-rules упрощающий обработку телеграмм: knx_group_addresses.js


При работе с ETS Важно: в “interfaces” ETS надо выбирать сам интерфейс ПК, через который происходит общение. Обращение с knxd по юникасту (ip-адресу хоста с демоном) не даёт запрограммировать устройства. На иллюстрации стрелкой отмечено, какой способ взаимодействия с ETS работает:


Интерфейсы

Также если вы пользователь Windows 8, 10, советуем отключить антивирусы и брандмауэр, так как они могут мешать работе ETS.

Известные неисправности

Список известных неисправностей

Источник — https://wirenboard.com/wiki/index.php?title=WBE2-I-KNX_KNX_Extension_Module&oldid=39398