Версия 20:19, 17 декабря 2016

MQTT KNX Bridge

Устройства, использующие протокол KNX.

Пакет: wb-mqtt-knx. Исходный код: https://github.com/contactless/wb-mqtt-knx

wb-mqtt-knx пересылает KNX телеграммы из специализированного MQTT топика в KNX сеть и обратно. Для работы с KNX используется KNXD - https://github.com/knxd/knxd.

Установка

wb-mqtt-knx в wirenboard устанавливается через apt-get:

$ apt-get install wb-mqtt-knx

Настройка

На данный момент wb-mqtt-knx не имеет конфигурационного файла.

Информацию по настройке knxd можно найти в конфигурационном файле /etc/knxd.conf - https://github.com/knxd/knxd/blob/master/systemd/knxd.conf и в

$ knxd --help

Работа с wb-mqtt-knx

При инициализации wb-mqtt-knx подписывается на MQTT топик:

/devices/knx/controls/data/on

и открывает Busmonitor connection на стандартный сокет (ip:localhost:6720), создаваемый knxd по умолчанию. Все полученные из KNX телеграммы будут отправлены в MQTT топик:

/devices/knx/controls/data

Адреса в MQTT

Default MQTT topics are:

/devices/knx/meta/name wb-knx
/devices/knx/controls/data/meta/type data

Input data:

/devices/knx/controls/data

Example:

$ mosquitto_sub -t '/devices/knx/#' -v
/devices/knx/controls/data/meta/type data
/devices/knx/meta/name wb-knx

$ mosquitto_pub -t '/devices/knx/controls/data/on' -m "i:0/0/1:9/7/55 4 message

/devices/knx/controls/data/on i:0/0/1:9/7/55 4 message
/devices/knx/controls/data i:0/0/1 i:9/7/55 4 message

$ mosquitto_pub -t '/devices/knx/controls/data/on' -m "g:9/7/55 4 message

/devices/knx/controls/data/on g:9/7/55 4 message
/devices/knx/controls/data i:0/0/0 g:9/7/55 4 message

Формат MQTT сообщений

Рассмотрим два примера сообщений, которые можно послать через wb-mqtt-knx:

1) Индивидуальная телеграмма:

mosquitto_pub -t '/devices/knx/controls/data/on' -m "i:0/0/1:9/7/55 4 message"

в `mosquitto_sub -t '/devices/knx/controls/#'` придут следующие сообщения:

/devices/knx/controls/data/on i:0/0/1:9/7/55 4 message
/devices/knx/controls/data i:0/0/1 i:9/7/55 4 message

в данном примере:

"i:" обозначает индивидуальный адрес
"0/0/1" адрес источника сообщения (From:)
"9/7/55" адрес целевого устройстав (To:)
"4" тип KNX сообщения (ACPI)
"message" - полезная информация (payload)

во втором сообщении мы видим что из сети KNX пришло сообщение(которое мы только что отправили). Оно было отправлено от устройства с индивидуальным адресом 0/0/1 (i:0/0/1) к устройству с индивидуальным адресом 9/7/55 (i:9/7/55) с APCI "4" и payload "message"

2) Групповая телеграмма:

mosquitto_pub -t '/devices/knx/controls/data/on' -m "g:9/7/55 4 message"

в `mosquitto_sub -t '/devices/knx/controls/#'` придут следующие сообщения:

/devices/knx/controls/data/on g:9/7/55 4 message
/devices/knx/controls/data i:0/0/0 g:9/7/55 4 message

Видно что изменились только адреса:

"g:" обозначает групповой адрес. В случае группового адреса не задается адрес источника, поэтому
"9/7/55" групповой целевой адрес (Group To:)
тип сообщения и payload задаются также как и в индивидуальной телеграмме

Во втором сообщении также только одно изменение - адрес To: теперь групповой.

Групповой адрес может также содержать два элемента: g:5/55.

Подробнее про адресацию можно узнать в Serial Data Transmission and KNX Protocol

Формально исходящее сообщение имеет формат:

mosquitto_pub -t '/devices/knx/controls/data/on' -m "address apci message"

где address это либо

i:from_addr:to_addr

либо

g:to_group_addr

где from_addr и to_addr это индивидуальные KNX адреса, а to_group_addr это групповой адрес. Входящее сообщение имеет формат:

/devices/knx/controls/data "from_addr to_addr apci message"

где from_addr - индивидуальный адрес источника сообщения, to_addr - групповой или индивидуальный адрес назначения.

@@ Строка 1: / Строка 1: @@
-<languages/>
+= MQTT KNX Bridge =
-<translate>
+Устройства, использующие протокол KNX.
-== Описание ==
-{{note|note|Здесь описан сервис wb-mqtt-knx версии 0.1.x, которая устарела и больше не поддерживается. Описание актуальной версии смотрите на странице [[MQTT_KNX_V2]].}}
-<!--T:3-->
-wb-mqtt-knx пересылает KNX телеграммы из специализированного MQTT топика в KNX сеть и обратно. Для работы с KNX используется [[Knxd]]
+Пакет: wb-mqtt-knx. Исходный код: https://github.com/contactless/wb-mqtt-knx
-= Установка = <!--T:4-->
+wb-mqtt-knx пересылает KNX телеграммы из специализированного MQTT топика в KNX сеть и обратно. Для работы с KNX используется KNXD - https://github.com/knxd/knxd.
-Запустите консоль и введите командуː
-<pre>$ apt-get update && apt-get install wb-mqtt-knx</pre>
+== Установка ==
+wb-mqtt-knx в wirenboard устанавливается через apt-get:<pre>$ apt-get install wb-mqtt-knx</pre>
-= Настройка = <!--T:5-->
+== Настройка ==
 На данный момент wb-mqtt-knx не имеет конфигурационного файла.
-<!--T:6-->
+Информацию по настройке knxd можно найти в конфигурационном файле /etc/knxd.conf - https://github.com/knxd/knxd/blob/master/systemd/knxd.conf и в<pre>$ knxd --help</pre>
-Информацию по настройке knxd можно найти на странице [[Knxd]]
-= Адреса в MQTT = <!--T:7-->
+== Работа с wb-mqtt-knx ==
+При инициализации wb-mqtt-knx подписывается на MQTT топик:<pre>/devices/knx/controls/data/on</pre>и открывает Busmonitor connection на стандартный сокет (ip:localhost:6720), создаваемый knxd по умолчанию.
+Все полученные из KNX телеграммы будут отправлены в MQTT топик:<pre>/devices/knx/controls/data</pre>
+== Адреса в MQTT ==
 <pre>
 Default MQTT topics are:
-<!--T:8-->
 /devices/knx/meta/name wb-knx
 /devices/knx/controls/data/meta/type data
-<!--T:9-->
 Input data:
-<!--T:10-->
 /devices/knx/controls/data
-<!--T:11-->
-Outgoing data:
-<!--T:12-->
-/devices/knx/controls/data/on
-<!--T:13-->
 Example:
-<!--T:14-->
 $ mosquitto_sub -t '/devices/knx/#' -v
 /devices/knx/controls/data/meta/type data
 /devices/knx/meta/name wb-knx
-<!--T:15-->
+$ mosquitto_pub -t '/devices/knx/controls/data/on' -m "i:0/0/1:9/7/55 4 message
-$ mosquitto_pub -t '/devices/knx/controls/data/on' -m "i:0/0/1:9/7/55 GroupValueWrite 0b110111 0xcf 14 0xff"
-<!--T:16-->
+/devices/knx/controls/data/on i:0/0/1:9/7/55 4 message
-/devices/knx/controls/data/on i:0/0/1:9/7/55 GroupValueWrite 0b110111 0xcf 14 0xff
+/devices/knx/controls/data i:0/0/1 i:9/7/55 4 message
-/devices/knx/controls/data i:0/0/1 i:9/7/55 GroupValueWrite 0x37 0xcf 0x0e 0xff
-<!--T:17-->
+$ mosquitto_pub -t '/devices/knx/controls/data/on' -m "g:9/7/55 4 message
-$ mosquitto_pub -t '/devices/knx/controls/data/on' -m "g:9/7/55 GroupValueRead"
-<!--T:18-->
+/devices/knx/controls/data/on g:9/7/55 4 message
-/devices/knx/controls/data/on g:9/7/55 GroupValueRead
+/devices/knx/controls/data i:0/0/0 g:9/7/55 4 message
-/devices/knx/controls/data i:0/0/0 g:9/7/55 GroupValueRead 0x00
 </pre>
-== Формат MQTT сообщений == <!--T:19-->
+== Формат MQTT сообщений ==
-Чтобы отправить групповую телеграмму в KNX необходимо отправить подготовленное сообщение в MQTT топик:
+Рассмотрим два примера сообщений, которые можно послать через wb-mqtt-knx:
+) Индивидуальная телеграмма:<pre>mosquitto_pub -t '/devices/knx/controls/data/on' -m "i:0/0/1:9/7/55 4 message"</pre>в `mosquitto_sub -t '/devices/knx/controls/#'` придут следующие сообщения:<pre>/devices/knx/controls/data/on i:0/0/1:9/7/55 4 message
-<!--T:20-->
+/devices/knx/controls/data i:0/0/1 i:9/7/55 4 message</pre>в данном примере:
-<pre>mosquitto_pub -t '/devices/knx/controls/data/on' -m "g:${DstAddr} ${APCI} ${Data}"</pre>
+* "i:" обозначает индивидуальный адрес
+* "0/0/1" адрес источника сообщения (From:)
-<!--T:21-->
+* "9/7/55" адрес целевого устройстав (To:)
-Чтобы отправить индивидуальную телеграмму в KNX необходимо отправить:
+* "4" тип KNX сообщения (ACPI)
+* "message" - полезная информация (payload)
-<!--T:22-->
+во втором сообщении мы видим что из сети KNX пришло сообщение(которое мы только что отправили). Оно было отправлено от устройства с индивидуальным адресом 0/0/1 (i:0/0/1) к устройству с индивидуальным адресом 9/7/55 (i:9/7/55) с APCI "4" и payload "message"
-<pre>mosquitto_pub -t '/devices/knx/controls/data/on' -m "i:${SrcAddr}:${DstAddr} ${APCI} ${Data}"</pre>
+) Групповая телеграмма:<pre>mosquitto_pub -t '/devices/knx/controls/data/on' -m "g:9/7/55 4 message"</pre>в `mosquitto_sub -t '/devices/knx/controls/#'` придут следующие сообщения:<pre>/devices/knx/controls/data/on g:9/7/55 4 message
+/devices/knx/controls/data i:0/0/0 g:9/7/55 4 message</pre>Видно что изменились только адреса:
+* "g:" обозначает групповой адрес. В случае группового адреса не задается адрес источника, поэтому
+* "9/7/55" групповой целевой адрес (Group To:)
+* тип сообщения и payload задаются также как и в индивидуальной телеграмме
-<!--T:23-->
+Во втором сообщении также только одно изменение - адрес To: теперь групповой.
-Все сообщения из KNX будут доставлены в MQTT топик /devices/knx/controls/data в виде:
-<!--T:24-->
+Групповой адрес может также содержать два элемента: g:5/55.
-<pre>i:${SrcAddr} [i,g]:${DstAddr} ${APCI} ${Data}</pre>
-<!--T:25-->
+Подробнее про адресацию можно узнать в Serial Data Transmission and KNX Protocol
-* SrcAddr, DstAddr - Адреса KNX устройств в формате "n/n/n" или "n/n".
-* APCI - Тип сообщения: строка или 4х-битное число.
-* Data - Сообщение в виде байт, разделенных пробелами. Первый байт сообщения должен иметь длину не более 6 бит.
-<!--T:26-->
+Формально исходящее сообщение имеет формат:<pre>mosquitto_pub -t '/devices/knx/controls/data/on' -m "address apci message"</pre>где address это либо<pre>i:from_addr:to_addr</pre>либо<pre>g:to_group_addr</pre>где from_addr и to_addr это индивидуальные KNX адреса, а to_group_addr это групповой адрес.
-Поддерживаемые типы сообщений(APCI):
-<!--T:27-->
+Входящее сообщение имеет формат:<pre>/devices/knx/controls/data "from_addr to_addr apci message"</pre>где from_addr - индивидуальный адрес источника сообщения, to_addr - групповой или индивидуальный адрес назначения.
-* GroupValueRead
-* GroupValueResponse
-* GroupValueWrite
-* IndividualAddrWrite
-* IndividualAddrRequest
-* IndividualAddrResponse
-* AdcRead
-* AdcResponse
-* MemoryRead
-* MemoryRead
-* MemoryWrite
-* UserMessage
-* MaskVersionRead
-* MaskVersionResponse
-* Restart
-* Escape
-* любое 4х-битное числовое значение
-</translate>

Навигация

MQTT KNX V.0.1.x: различия между версиями