UniSet: Реализация MQTT издателя

Общее описание MQTTPublisher

MQTT - это..

Данная реализация построена на использованиие библиотеки mosquitto. Издатель публикует события по каждому изменению датчика в указанном топике.

Настройка MQTTPublisher

Топик для публикации событий имеет вид: TOPIC

TOPIC - заданный topic.

Топик можно задать при помощи аргумента комадной строки --prefix-mqtt-topic или в настроечной секции topic="..". По умолчанию берётся ROOTPROJECT/sensors/sensorname, где ROOTPROJECT - это название корневой uniset-секции заданное в configure.xml (RootSection="..")

События по каким датчикам "публиковать" можно задавать при помощи filter-field и filter-value параметров. --prefix-filter-field - задаёт фильтрующее поле для датчиков --prefix-filter-value - задаётзначение фильтрующего поля для датчиков. Необязательнй параметр.

Либо можно указать в настроечной секции: filterField=".." filterValue=".."

По умолчанию загружаются и публикуются ВСЕ датчики из секции <sensors> конфигурационного файла.

Сервер для публикации указывается параметрами: --prefix-mqtt-host ip|hostname - По умолчаню "localhost" --prefix-mqtt-port num - По умолчанию: 1883 (mosquitto)

Но можно задать и в настроечной секции: mqttHost=".." и mqttPort=".."

Помимо этого можно задать время проверки соединения, параметром --prefix-mqtt-keepalive sec - По умолчанию: 60 или и в настроечной секции: mqttKeepAlive=".."

Для запуска издателя, неоходимо наличие в configure.xml секции: <ObjectName name="ObjectName" ...параметры">.

Генерирование текстовых сообщений

Имеется возможность сопоставлять значения датчиков текстовым сообщениям, посылаемым на сервер. Для этого необходимо в настроечной секции для датчика создать подсекцию <mqtt>. Пример:

    <item id="10" name="MySensor1" filter_field="filter_value"...>
        <mqtt subtopic="myevent">
            <msg value="12" text="My text for value %v"/>
            <msg value="13" text="My text for value %v"/>
            <msg value="14" text="My text for value %v"/>
            <range min="10" max="20" text="My text for range %r. %n = %v"/>
        <mqtt>
    </item>

range - задаёт диапазон включающий [min,max]
subtopic - задаёт подраздел в корневом топике (см. topicsensors). Т.е. полный топик для публикации текстовых сообщений будет иметь вид ROOTPROJECT/topicsensors/sensorname/textevent или если задано поле то события будут опубликованы в ROOTPROJECT/topicsensors/subtopic

При этом в тексте можно применять следующие "подстановки":

v - текущее значение (value)
n - name
t - textname
i - ID
r - заданный диапазон (range). Заменяется на "[min:max]"
rmin - минимальное значение диапазона (range min)
rmax - максимальное значение диапазона (range max)

Заметки:: Если заданные "одиночные" значения совпадают с диапазоном, то будет сгенерировано несколько сообщений. Т.е. диапазоны могут пересекатся.