MQTT KNX V2: различия между версиями

Строка 36: Строка 36:


=== Контроллер групповых объектов ===
=== Контроллер групповых объектов ===
Это рекомендуемый режим работы, так как он удобный и постоянно развивается.


В этом режиме для группового KNX-адреса создаётся контрол MQTT-устройства, тип которого связан с типом группового адреса. Далее вы работаете контролом, как с групповым адресом: отправляете и принимаете данные, например: биты, целые знаковые и беззнаковые числа, числа с плавающей точкой.
В общем случае в KNX принята такая иерархия:
* Каждое KNX-устройство состоит из элементов, которые называются Точками данных (Data Point): реле переключателя, кнопка выключателя, сенсор в датчике и т.п.
* Эти точки данных называются Групповыми объектами (Group Object) и к ним привязаны групповые адреса.
* Каждый групповой адрес имеет определённый логический тип данных, который содержит как минимум одно поле данных.


Несколько групповых адресов можно объединять в одно или несколько произвольных MQTT-устройств.
Чтобы представить групповой адрес в веб-интерфейсе контроллера Wiren Board, нужно создать контрол MQTT устройства с таким же типом, как и сам адрес. После этого вы сможете работать с групповым адресом как с обычным контролом виртуального устройства: писать и читать из него текст, биты, целые знаковые и беззнаковые числа, числа с плавающей точкой.
 
Таким образом несколько групповых адресов можно объединять в одно или несколько произвольных MQTT устройств.


Каждый контрол может работать в двух режимах:
Каждый контрол может работать в двух режимах:
# ''MQTT'' — данные представляются в виде готовых к обработке значений согласно [https://github.com/wirenboard/conventions/blob/main/README.md Wiren Board MQTT Conventions].
# ''MQTT'' — данные представляются в виде готовых к обработке значений согласно [https://github.com/wirenboard/conventions/blob/main/README.md Wiren Board MQTT Conventions]. [https://github.com/wirenboard/wb-mqtt-knx/blob/master/datapointformat.md Доступные типы данных].
# ''JSON'' — данные преобразовываются в JSON-сообщения, которые в виде текста помещаются в контрол.
# ''JSON'' — данные преобразовываются в JSON-сообщения, которые в виде текста помещаются в контрол. [https://github.com/wirenboard/wb-mqtt-knx/blob/master/jsondatapoint.md Как работать с JSON-собщениями].


Мы рекомендуем использовать первый режим, но он не поддерживает некоторые специфичные типы групповых адресов, применяемых в KNX. Если вы столкнулись с такими типами, используйте режим JSON, так вы сможете разбирать сообщения с помощью [[wb-rules]], обрабатывать их и отправлять обратно групповому адресу.
Мы рекомендуем использовать первый режим, но он не поддерживает некоторые специфичные типы групповых адресов, применяемых в KNX. Если вы столкнулись с таким, используйте режим JSON, так вы сможете разбирать сообщения с помощью [[wb-rules]], обрабатывать их и отправлять обратно.


== Настройка ==
== Настройка ==