Перейти к содержанию

MQTT-интеграция

SCADA/BMS-платформа ГАУС интегрируется по шине MQTT: платформа подписывается на топики брокера и получает значения как теги, а при необходимости — публикует значения своих тегов обратно в топики. Типовой сценарий приёма — оборудование и шлюзы (например, промышленные контроллеры и IoT-устройства), которые публикуют свои данные в MQTT.

MQTT — двунаправленная интеграция: в отличие от разделения «полевой драйвер для приёма / интеграционный модуль для отдачи», по одной и той же шине MQTT ГАУС может и принимать, и отдавать данные.

Роль платформы на шине

ГАУС выступает MQTT-клиентом брокера. Сам брокер — внешний компонент (отдельный сервер сообщений); платформа подключается к нему как клиент и работает через две базовые операции:

  • подписка на топики — приём данных (значения из топиков становятся тегами);
  • публикация в топики — отдача данных (значения тегов уходят в топики).

Поскольку MQTT построен на модели «издатель — подписчик», платформе не нужно опрашивать источник: значения приходят по мере того, как издатель их публикует.

Подключение к брокеру возможно как по незашифрованному порту, так и по SSL/TLS — порт задаётся при настройке источника (см. «Как настроить подключение к брокеру»).

Подписка на топики (приём)

Значения, публикуемые в топики брокера, приходят в платформу и раскладываются в теги дерева проекта. Каждому тегу сопоставляется топик (или отдельный элемент разобранного payload, если в одном топике публикуется структура значений).

Сканирование дерева топиков. Чтобы не сопоставлять топики вручную, предусмотрено сканирование топиков брокера: платформа обходит доступные топики и предлагает их для создания тегов. Сканирование работает в двух режимах — плоский обход (все топики единым списком) и послойный (с раскрытием иерархии топиков уровень за уровнем). У операции сканирования есть настраиваемая длительность (окно, в течение которого драйвер собирает публикации, чтобы увидеть все активные топики) в диапазоне примерно от 1 до 60 секунд: чем реже издатели публикуют значения, тем больше окно нужно задать, чтобы «поймать» их топики.

Горячее добавление параметров. При добавлении нового параметра — в том числе созданного по результатам сканирования — подписка на соответствующий топик активируется сразу. Перезапускать драйвер или источник для этого не нужно.

Как получить теги сканированием дерева топиков

Предусловия: контроллер MQTT уже создан и подключён к брокеру (см. «Как настроить подключение к брокеру»), издатели активно публикуют значения в топики.

  1. Откройте свойства контроллера MQTT в дереве проекта и запустите операцию сканирования топиков.
  2. Выберите режим обхода:
  3. плоский — все топики единым списком (подходит, когда топиков немного или иерархия неглубокая);
  4. послойный — с раскрытием иерархии топиков уровень за уровнем (удобно при глубоком дереве топиков).
  5. Введите длительность сканирования — окно, в течение которого драйвер собирает публикации. Допустимый диапазон — примерно от 1 до 60 секунд. Чем реже издатели публикуют значения, тем больше окно нужно задать, чтобы «поймать» все активные топики.

  6. Запустите сканирование и дождитесь завершения окна. Драйвер соберёт доступные топики и предложит их для создания тегов.

  7. Выберите нужные топики и создайте по ним параметры (теги) в дереве проекта. Каждому тегу сопоставляется топик (или отдельный элемент разобранного payload, если в одном топике публикуется структура значений).

Проверка: созданные теги получают значения из своих топиков — подписка активируется сразу после создания параметра, перезапуск драйвера не нужен. Если значение не появилось, проверьте, что издатель действительно публикует в этот топик, и при редких публикациях увеличьте окно сканирования.

Как добавить тег вручную (без сканирования)

Предусловие: контроллер MQTT создан и подключён к брокеру.

  1. Вызовите контекстное меню на нужном узле дерева проекта под источником MQTT и выберите «Создать» → «Параметр». Параметр помещается в тот узел, в котором вызвано меню.
  2. Введите в свойствах параметра имя топика брокера. Имя топика чувствительно к регистру и к уровням иерархии — указывайте его точно.

  3. Сохраните параметр. Подписка на топик активируется сразу — перезапускать драйвер или источник не нужно.

Проверка: у тега появилось значение из топика. Если значения нет — сверьте точное имя топика и проверьте связь драйвера с брокером (см. Диагностика).

Публикация в топики (отдача)

ГАУС может публиковать значения своих тегов в топики брокера — это «отдающая» сторона MQTT-интеграции. Она применяется, когда данные платформы должны попасть во внешнюю систему или в другое оборудование через ту же шину сообщений (например, чтобы отдать вычисленное или агрегированное значение стороннему потребителю, подписанному на брокер).

Как настроить публикацию значений тегов в топики

Предусловия: контроллер MQTT создан и подключён к брокеру; определён потребитель, который подписан на брокер и должен получать значения платформы.

  1. Определите набор тегов платформы, значения которых нужно отдавать в шину (например, вычисленное или агрегированное значение для стороннего потребителя).
  2. Для каждого такого тега введите топик публикации на брокере, в который будут уходить его значения.
  3. Выберите условие публикации — по изменению значения либо периодически — если это предусмотрено настройками.
  4. Сохраните настройки.

Проверка: потребитель, подписанный на брокер, получает публикуемые значения по заданным топикам. При отсутствии данных проверьте связь драйвера с брокером и точность имён топиков (см. Диагностика).

Качество (достоверность) значения

Данные тега сопровождаются признаком достоверности: значение может быть помечено как OK (достоверное) или BAD (недостоверное). Это важно для корректной интерпретации показаний.

Характерный случай — когда источник перестаёт публиковать значение и топик очищается (в MQTT это выражается публикацией «пустого» retained-сообщения). В такой ситуации платформа помечает значение как недостоверное (BAD), а не продолжает показывать «зависшее» последнее известное число. Это защищает оператора от ложного ощущения, что данные актуальны, хотя источник давно молчит.

Как признак достоверности виден пользователю:

  • В трендах признак качества отражается последовательно — история хранит метку достоверности каждого значения.
  • В отображении в реальном времени поведение может отличаться, поэтому при разборе спорных значений полезно сверяться и с историей тренда: там видно, когда именно значение стало недостоверным.

Настройка подключения

Источник MQTT настраивается как контроллер в дереве проекта (как и любой другой драйвер — см. Обзор драйверов). В настройках подключения задаются параметры соединения с брокером и правила сопоставления топиков с тегами. Затем теги можно добавить вручную или получить их через сканирование дерева топиков (см. выше).

Источник MQTT описывается следующими полями:

Поле Что задаёт Значение по умолчанию
«Наименование» имя элемента в дереве проекта MQTT
«Адрес» IP-адрес или доменное имя брокера 127.0.0.1
«Порт» порт подключения к брокеру 1883
«Логин» имя пользователя для авторизации на брокере —
«Пароль» пароль пользователя для авторизации на брокере —

Поля «Наименование», «Адрес» и «Порт» обязательны к заполнению. Порт 1883 — стандартный незашифрованный порт MQTT; для подключения по SSL/TLS используется порт 8883. Поля «Логин» и «Пароль» заполняются, только если брокер требует авторизацию.

Созданные источники данных собираются в папке «Источники данных» дерева проекта и разложены там по вкладкам протоколов — источники MQTT видны на вкладке «MQTT».

Как настроить подключение к брокеру

Предусловие: у вас есть адрес и параметры доступа к внешнему брокеру MQTT (сам брокер — отдельный сервер сообщений, в состав платформы не входит).

  1. Откройте дерево проекта.
  2. Вызовите контекстное меню на «Структура» и выберите «Создать» → «Источник данных» → «MQTT».
  3. В поле «Наименование» введите имя источника — под ним он будет отображаться в дереве проекта.
  4. В поле «Адрес» введите IP-адрес или доменное имя брокера.
  5. В поле «Порт» введите порт подключения к брокеру: 1883 — стандартный незашифрованный порт MQTT, 8883 — порт для подключения по SSL/TLS.
  6. Если брокер требует авторизацию, в полях «Логин» и «Пароль» введите имя пользователя и пароль для авторизации на брокере.
  7. Нажмите «Создать». Платформа подключится к брокеру как MQTT-клиент.
  8. Добавьте теги: вручную (см. «Как добавить тег вручную») или через сканирование дерева топиков (см. «Как получить теги сканированием дерева топиков»).

Проверка: на странице источника данных отображается состояние «В сети», а раскрытый в дереве проекта источник показывает теги с поступающими значениями. Если значений нет — проверьте доступность брокера и корректность параметров подключения (см. Диагностика).

Контекстное меню создания источника данных: «Создать» → «Источник данных» со
списком поддерживаемых протоколов, среди них
«MQTT»

Диагностика

Если значения не приходят, проверяйте по цепочке — две независимые связи:

  1. Связь драйвера с платформой. Через неё выполняются подписка, сканирование и создание тегов. Если сканирование топиков и создание параметров проходят, но значения не идут, — этот канал, скорее всего, в порядке, а проблема в следующем звене.
  2. Связь драйвера с брокером. Проверьте доступность брокера, корректность имён топиков, учётных данных и параметров подключения.

Частая причина «нет значений» — оборвавшееся или устаревшее подключение драйвера (например, драйвер потерял связь и не переподключился). Диагностику состояния компонентов и связей удобно вести через Супервизор.

См. Диагностика и Супервизор.

Частые вопросы и подводные камни

  • «Создал тег, но значение не появляется». Убедитесь, что издатель действительно публикует в этот топик (при редких публикациях увеличьте окно сканирования). Проверьте связь драйвера с брокером и точное имя топика — оно чувствительно к регистру и уровням иерархии.
  • «Значение "зависло" на старом числе». Проверьте, публикует ли источник до сих пор. Если источник замолчал и топик очистился, платформа должна пометить значение как недостоверное (BAD); при разборе сверяйтесь с трендом — там видна точка, где значение перестало обновляться.
  • «Добавил параметр — нужно ли перезапускать драйвер?» Нет. Подписка на топик активируется сразу после создания параметра.
  • «Сканирование не находит топик». Если издатель публикует редко, увеличьте длительность сканирования; при глубокой иерархии топиков используйте послойный режим.

Смежные разделы