MQTT KNX V.0.1.x: различия между версиями
(Новая страница: «= MQTT KNX Bridge = Устройства, использующие протокол KNX. Пакет: wb-mqtt-knx. Исходный код: https://github.com/con…») |
м (A.Degtyarev переименовал страницу MQTT KNX в MQTT KNX V.0.1.x без оставления перенаправления: Часть переводимой страницы MQTT KNX.) |
||
(не показано 12 промежуточных версий 6 участников) | |||
Строка 1: | Строка 1: | ||
= | <languages/> | ||
<translate> | |||
== Описание == | |||
{{note|note|Здесь описан сервис wb-mqtt-knx версии 0.1.x, которая устарела и больше не поддерживается. Описание актуальной версии смотрите на странице [[MQTT_KNX_V2]].}} | |||
<!--T:3--> | |||
wb-mqtt-knx пересылает KNX телеграммы из специализированного MQTT топика в KNX сеть и обратно. Для работы с KNX используется [[Knxd]] | |||
= Установка = <!--T:4--> | |||
Запустите консоль и введите командуː | |||
<pre>$ apt-get update && apt-get install wb-mqtt-knx</pre> | |||
= Настройка = <!--T:5--> | |||
На данный момент wb-mqtt-knx не имеет конфигурационного файла. | На данный момент wb-mqtt-knx не имеет конфигурационного файла. | ||
Информацию по настройке knxd можно найти | <!--T:6--> | ||
Информацию по настройке knxd можно найти на странице [[Knxd]] | |||
== | = Адреса в MQTT = <!--T:7--> | ||
<pre> | <pre> | ||
Default MQTT topics are: | Default MQTT topics are: | ||
<!--T:8--> | |||
/devices/knx/meta/name wb-knx | /devices/knx/meta/name wb-knx | ||
/devices/knx/controls/data/meta/type data | /devices/knx/controls/data/meta/type data | ||
<!--T:9--> | |||
Input data: | Input data: | ||
<!--T:10--> | |||
/devices/knx/controls/data | /devices/knx/controls/data | ||
<!--T:11--> | |||
Outgoing data: | |||
<!--T:12--> | |||
/devices/knx/controls/data/on | |||
<!--T:13--> | |||
Example: | Example: | ||
<!--T:14--> | |||
$ mosquitto_sub -t '/devices/knx/#' -v | $ mosquitto_sub -t '/devices/knx/#' -v | ||
/devices/knx/controls/data/meta/type data | /devices/knx/controls/data/meta/type data | ||
/devices/knx/meta/name wb-knx | /devices/knx/meta/name wb-knx | ||
$ mosquitto_pub -t '/devices/knx/controls/data/on' -m "i:0/0/1:9/7/55 | <!--T:15--> | ||
$ 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 | <!--T:16--> | ||
/devices/knx/controls/data i:0/0/1 i:9/7/55 | /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 | <!--T:17--> | ||
$ mosquitto_pub -t '/devices/knx/controls/data/on' -m "g:9/7/55 GroupValueRead" | |||
/devices/knx/controls/data/on g:9/7/55 | <!--T:18--> | ||
/devices/knx/controls/data i:0/0/0 g:9/7/55 | /devices/knx/controls/data/on g:9/7/55 GroupValueRead | ||
/devices/knx/controls/data i:0/0/0 g:9/7/55 GroupValueRead 0x00 | |||
</pre> | </pre> | ||
== Формат MQTT сообщений == | == Формат MQTT сообщений == <!--T:19--> | ||
Чтобы отправить групповую телеграмму в KNX необходимо отправить подготовленное сообщение в MQTT топик: | |||
<!--T:20--> | |||
<pre>mosquitto_pub -t '/devices/knx/controls/data/on' -m "g:${DstAddr} ${APCI} ${Data}"</pre> | |||
<!--T:21--> | |||
Чтобы отправить индивидуальную телеграмму в KNX необходимо отправить: | |||
<!--T:22--> | |||
<pre>mosquitto_pub -t '/devices/knx/controls/data/on' -m "i:${SrcAddr}:${DstAddr} ${APCI} ${Data}"</pre> | |||
<!--T:23--> | |||
Все сообщения из KNX будут доставлены в MQTT топик /devices/knx/controls/data в виде: | |||
<!--T:24--> | |||
<pre>i:${SrcAddr} [i,g]:${DstAddr} ${APCI} ${Data}</pre> | |||
<!--T:25--> | |||
* SrcAddr, DstAddr - Адреса KNX устройств в формате "n/n/n" или "n/n". | |||
* APCI - Тип сообщения: строка или 4х-битное число. | |||
* Data - Сообщение в виде байт, разделенных пробелами. Первый байт сообщения должен иметь длину не более 6 бит. | |||
<!--T:26--> | |||
Поддерживаемые типы сообщений(APCI): | |||
<!--T:27--> | |||
* GroupValueRead | |||
* GroupValueResponse | |||
* GroupValueWrite | |||
* IndividualAddrWrite | |||
* IndividualAddrRequest | |||
* IndividualAddrResponse | |||
* AdcRead | |||
* AdcResponse | |||
* MemoryRead | |||
* MemoryRead | |||
* MemoryWrite | |||
* UserMessage | |||
* MaskVersionRead | |||
* MaskVersionResponse | |||
* Restart | |||
* Escape | |||
* любое 4х-битное числовое значение | |||
</translate> |
Текущая версия на 20:00, 8 апреля 2022
Описание
Здесь описан сервис wb-mqtt-knx версии 0.1.x, которая устарела и больше не поддерживается. Описание актуальной версии смотрите на странице MQTT_KNX_V2.
wb-mqtt-knx пересылает KNX телеграммы из специализированного MQTT топика в KNX сеть и обратно. Для работы с KNX используется Knxd
Установка
Запустите консоль и введите командуː
$ apt-get update && apt-get install wb-mqtt-knx
Настройка
На данный момент wb-mqtt-knx не имеет конфигурационного файла.
Информацию по настройке knxd можно найти на странице Knxd
Адреса в 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х-битное числовое значение