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

Материал из Wiren Board
Строка 46: Строка 46:


== Формат MQTT сообщений ==
== Формат MQTT сообщений ==
Рассмотрим два примера сообщений, которые можно послать через wb-mqtt-knx:
Чтобы отправить групповую телеграмму в KNX необходимо отправить подготовленное сообщение в MQTT топик:
1) Индивидуальная телеграмма:
<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
/devices/knx/controls/data i:0/0/1 i:9/7/55 4 message</pre>
в данном примере:
* "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) Групповая телеграмма:<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 задаются также как и в индивидуальной телеграмме


Во втором сообщении также только одно изменение - адрес To: теперь групповой.
<pre>mosquitto_pub -t '/devices/knx/controls/data/on' -m "g:${DstAddr} ${APCI} ${Data}"</pre>


Групповой адрес может также содержать два элемента: g:5/55.
Чтобы отправить индивидуальную телеграмму в KNX необходимо отправить:


Подробнее про адресацию можно узнать в Serial Data Transmission and KNX Protocol
<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 "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 это групповой адрес.
Все сообщения из KNX будут доставлены в MQTT топик /devices/knx/controls/data в виде:


Входящее сообщение имеет формат:<pre>/devices/knx/controls/data "from_addr to_addr apci message"</pre>где from_addr - индивидуальный адрес источника сообщения, to_addr - групповой или индивидуальный адрес назначения.
<pre>i:${SrcAddr} [i,g]:${DstAddr} ${APCI} ${Data}</pre>
 
* SrcAddr, DstAddr - Адреса KNX устройств в формате "n/n/n" или "n/n".
* APCI - Тип сообщения, строка или 4х-битное число.
* Data - Сообщение в виде байт, разделенных пробелами. Первый байт сообщения должен иметь длину не более 6 бит.
 
Поддерживаемые типы сообщений(APCI):
 
* GroupValueRead
* GroupValueResponse
* GroupValueWrite
* IndividualAddrWrite
* IndividualAddrRequest
* IndividualAddrResponse
* AdcRead
* AdcResponse
* MemoryRead
* MemoryRead
* MemoryWrite
* UserMessage
* MaskVersionRead
* MaskVersionResponse
* Restart
* Escape
* любое 4х-битное числовое значение

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

Устройства, использующие протокол 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

Адреса в MQTT

Default MQTT topics are:

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

Input data:

/devices/knx/controls/data

Outgoing data:

/devices/knx/controls/data/on

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 GroupValueWrite 0b110111 0xcf 14 0xff"

/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 GroupValueWrite 0x37 0xcf 0x0e 0xff

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

/devices/knx/controls/data/on g:9/7/55 GroupValueRead
/devices/knx/controls/data i:0/0/0 g:9/7/55 GroupValueRead 0x00

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

Чтобы отправить групповую телеграмму в KNX необходимо отправить подготовленное сообщение в MQTT топик: 

mosquitto_pub -t '/devices/knx/controls/data/on' -m "g:${DstAddr} ${APCI} ${Data}"

Чтобы отправить индивидуальную телеграмму в KNX необходимо отправить: 

mosquitto_pub -t '/devices/knx/controls/data/on' -m "i:${SrcAddr}:${DstAddr} ${APCI} ${Data}"

Все сообщения из KNX будут доставлены в MQTT топик /devices/knx/controls/data в виде: 

i:${SrcAddr} [i,g]:${DstAddr} ${APCI} ${Data}
  • SrcAddr, DstAddr - Адреса KNX устройств в формате "n/n/n" или "n/n".
  • APCI - Тип сообщения, строка или 4х-битное число.
  • Data - Сообщение в виде байт, разделенных пробелами. Первый байт сообщения должен иметь длину не более 6 бит.

Поддерживаемые типы сообщений(APCI):

  • GroupValueRead
  • GroupValueResponse
  • GroupValueWrite
  • IndividualAddrWrite
  • IndividualAddrRequest
  • IndividualAddrResponse
  • AdcRead
  • AdcResponse
  • MemoryRead
  • MemoryRead
  • MemoryWrite
  • UserMessage
  • MaskVersionRead
  • MaskVersionResponse
  • Restart
  • Escape
  • любое 4х-битное числовое значение
Источник — https://wirenboard.com/wiki/index.php?title=MQTT_KNX_V.0.1.x&oldid=9713