Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Настройка обмена данными

Настройка модуля MQTT Клиент для обмена данными выполняется в Alpha.DevStudio.

Порядок создания проекта и добавление Alpha.Server в проект описаны в документации на Alpha.DevStudio (раздел Знакомство с Alpha.DevStudio руководства пользователя).

Далее приведено описание настройки обмена данными Alpha.Server по протоколу MQTT.

Чтобы настроить обмен данными по MQTT:

  1. Добавьте в проект ссылку на модуль MQTT.
  2. Добавьте в проект и заполните таблицу описания топиков подписки.
  3. Добавьте и опишите логические типы.
  4. Для настройки обмена данными с брокером:
    1. Добавьте в проект и настройте брокер.
    2. Добавьте в Alpha.Server и настройте клиента MQTT.
    3. Опишите объектную модель уровня Alpha.Server.
  5. Для настройки обмена данными между двумя клиентами через брокер:

    1. Опишите объектную модель Alpha.Server.
    2. В Alpha.Server добавьте и настройте клиента MQTT.
    3. Добавьте в проект и настройте брокер.
    4. Добавьте в проект и настройте второй Alpha.Server с модулем MQTT Клиент.
  6. Для настройки туннелирования через MQTT:
    1. Опишите объектную модель уровня передающего Alpha.Server.
    2. В передающий Alpha.Server добавьте и настройте клиента MQTT.
    3. Добавьте в проект и настройте диод данных.
    4. Добавьте в проект и настройте принимающий Alpha.Server с модулем MQTT Клиент.
  7. Примените конфигурации передающего и принимающего Alpha.Server.

Исходные данные для настройки

Для настройки обмена данными необходимы следующие исходные данные:

  1. Информация о брокере:

    • IP-адрес;
    • номер TCP порта;
    • версия протокола MQTT;
    • имя пользователя и пароль.
  2. Информация о данных, которые требуется получать от брокера или публиковать на брокер:

    • топик данных, по которому будет выполняться подписка;
    • тип данных.

Примеры для настройки обмена данными

Обмен данными с брокером

Требуется по MQTT обмениваться с брокером данными датчиков:

  • получать от брокера данные каждого датчика:
    • текущее значение параметра;
    • значение уставки.
  • отправлять в брокер данные для каждого датчика:
    • команду управления;
    • значение уставки.

Информация о брокере:

  • IP-адрес - 10.10.0.101;
  • номер TCP порта - 1884;
  • версия протокола MQTT - 3.1.1;
  • имя пользователя - user;
  • пароль - qwerty@123.

Информация о параметрах, значения которых требуется получать или отправлять:

Параметр Тип Топик Описание
Temperature.Value Float Temperature Значение температуры.
Temperature.Setpoint Uint2 Temperature Текущая уставка температуры.
Temperature.SetpointOut Uint2 Temperature Новое значение уставки температуры.
Temperature.Cmd Bool Temperature Команда управления.
Pressure.Value Float Pressure Значение давления.
Pressure.Setpoint Uint2 Pressure Текущая уставка давления.
Pressure.SetpointOut Uint2 Pressure Новое значение уставки давления.
Pressure.Cmd Bool Pressure Команда управления.

Туннелирование через MQTT

Требуется по MQTT передавать в Alpha.Server, расположенный в другой сети, следующие данные:

  • текущее значение параметра;
  • значение уставки.

Информация о брокерах диода данных:

  • IP-адреса - 10.10.0.100 и 10.20.0.100;
  • номера TCP портов - 1883 и 1884.

IP-адрес принимающего Alpha.Server - 10.20.0.1.

Информация о параметрах, значения которых требуется отправлять:

Параметр Тип Топик Описание
Temperature.Value Float Temperature Значение температуры.
Temperature.Setpoint Uint2 Temperature Текущая уставка температуры.
Pressure.Value Float Pressure Значение давления.
Pressure.Setpoint Uint2 Pressure Текущая уставка давления.

Добавление ссылки на модуль MQTT

Чтобы добавить в проект таблицу описания топиков подписки, необходимую для описания топиков, подписка на которые выполняется на брокере:

  1. Добавьте в проект ссылку на модуль MQTT.

  2. Нажмите кнопку (Обновить) на панели инструментов или клавишу F5 на клавиатуре. После чего в панели элементов отобразится таблица описания топиков подписки - TopicDescriptionTable.

Добавление и заполнение таблицы описания топиков подписки

Чтобы описать топики, подписка на которые выполняется на брокере, добавьте и заполните таблицу описания топиков подписки.

Таблицу описания топиков подписки можно заполнять как в Alpha.DevStudio, так и с помощью редакторов файлов формата *.csv.

Чтобы описать топики подписки:

  1. Добавьте в проект таблицу TopicDescriptionTable.

  2. На элементе TopicDescriptionTable:

    1. Нажмите кнопку .
    2. Укажите место хранения таблицы описания топиков подписки на диске.
    3. Задайте имя таблицы описания топиков подписки.
    4. Нажмите кнопку Открыть.

    Таблица описания топиков подписки в формате *.csv будет создана. Если требуется открыть существующую таблицу описания топиков подписки, то выберите файл таблицы описания топиков подписки на диске и нажмите кнопку Открыть.

  3. Перейдите в таблицу описания топиков подписки.

  4. Для каждого топика подписки брокера заполните поля таблицы:

    Поле Значение
    Идентификатор Уникальный строковый идентификатор топика в таблице. Укажите произвольный идентификатор. В дальнейшем идентификатор будет использоваться при конфигурировании брокера.
    Описание Вспомогательный столбец, в который можно вносить любую информацию о топике. Не используется модулем.
    Топик Tопик, на который будет выполняться подписка.
    Качество обслуживания

    Качество обслуживания, устанавливаемое публикациям:

    • At most once (QoS = 0) - брокер получит сообщение максимум один раз - доставка сообщения не гарантируется.
    • At least once (QoS = 1) - брокер получит сообщение минимум один раз - сообщения будут посылаться брокеру, пока MQTT Клиент не получит подтверждения доставки.
    • Exactly once (QoS = 2) - брокер получит сообщение гарантировано один раз.

Пример заполненной таблицы описания топиков подписки:

Описание логических типов

Логические типы брокера и Alpha.Server

Для настройки обмена данными между модулем MQTT Клиент и брокером опишите логические типы брокера и Alpha.Server.

Чтобы описать логические типы:

  1. Добавьте в проект Пространство имен и задайте Имя, например, Types. Это будет папка с логическими типами.

  2. Перейдите в добавленное Пространство имен и добавьте два элемента Аспект. Задайте им имена Broker и Server. Это будут аспекты брокера и Alpha.Server.

  3. В это же Пространство имен добавьте два Логических типа. Задайте им имена Sensor и Sensor_IOS и укажите аспекты Broker и Server. Это будут логические типы брокера и Alpha.Server.

  4. Перейдите в логический тип брокера и опишите его структуру: добавьте сигналы необходимых типов, укажите им Имя и Направление:

    Сигнал Тип Направление Описание
    Value Float выход Значение параметра
    Cmd Bool вход Команда управления
    Setpoint Uint2 вход Текущее значение уставки
    SetpointOut Uint2 выход Новое значение уставки

    Если требуется упростить дальнейшее заполнение карты адресов, то в логическом типе брокера для параметров добавьте атрибуты:

    Свойство Значение
    Протокольный тип MQTT Протокольный тип данных.
    Топик MQTT Топик данных

    В Карте адресов MQTT сигналам будут подставлены значения соответствующих атрибутов.

  5. Перейдите в логический тип Alpha.Server:
    1. В свойстве Представляемый тип укажите описанный ранее логический тип брокера Sensor.
    2. Добавьте Ссылку и в её свойстве Тип укажите логический тип брокера Sensor. После этого в Ссылке отобразится структура указанного логического типа брокера. Добавленная ссылка будет связывать логический тип Alpha.Server с логическим типом брокера.
    3. В контекстном меню ссылки выполните команду Экспонировать входы и выходы, в результате чего в логическом типе будут созданы сигналы с теми же именами и типами, что и в логическом типе Alpha.Server, а также прорисованы связи.

Логические типы передающего и принимающего Alpha.Server

Для настройки туннелирования через MQTT опишите логические типы передающего и принимающего Alpha.Server.

Чтобы описать логические типы:

  1. В пространство имён добавьте два Логических типа. Задайте им имена Sensor_Low и Sensor_Up. Это будут логические типы передающего (Low) и принимающего (Up) Alpha.Server.

  2. Перейдите в логический тип передающего Alpha.Server и опишите такую же структуру, как у логического типа брокера:

    Сигнал Тип Направление Описание
    Value Float выход Значение параметра
    Cmd Bool вход Команда управления
    Setpoint Uint2 вход Текущее значение уставки
    SetpointOut Uint2 выход Новое значение уставки

  3. Перейдите в логический тип принимающего Alpha.Server:
    1. В свойстве Представляемый тип укажите описанный выше логический тип передающего Alpha.Server Sensor_Low.
    2. Добавьте Ссылку и укажите значения её свойств:

      СвойствоЗначение
      ТипЛогический тип передающего Alpha.Server - Sensor_Low.
      Только чтениеДа.
      АспектнаяДа.

      После этого в Ссылке отобразится структура указанного логического типа передающего Alpha.Server. Добавленная ссылка будет связывать логический тип принимающего Alpha.Server с логическим типом передающего Alpha.Server.

    3. В контекстном меню ссылки выполните команду Экспонировать входы и выходы, в результате чего в логическом типе будут созданы сигналы с теми же именами и типами, что и в логическом типе передающего Alpha.Server, а также прорисованы связи.