Alpha.Community

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

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

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

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

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

Чтобы настроить обмен данными с устройством:

  1. Добавьте в проект ссылку на универсальный модуль.
  2. Добавьте в проект и заполните таблицы команд и данных.
  3. Добавьте и опишите тип устройства.
  4. Заполните карту адресов.
  5. Добавьте в проект и настройте устройство.
  6. Добавьте в Alpha.Server и настройте опросчик.
  7. Опишите объектную модель уровня Alpha.Server.
  8. Настройте канал для обмена данными между Alpha.Server и устройством.
  9. Примените конфигурацию Alpha.Server.

Объектная модель настройки обмена данными с устройством:

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

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

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

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

Добавление и заполнение таблиц

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

  1. Добавьте и заполните таблицу команд.
  2. Добавьте и заполните таблицу данных.

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

Таблица команд

В таблице команд описываются:

  • команды, которые устройство может принимать от Alpha.Server;
  • ответы, которые устройство может отправлять в Alpha.Server.

Чтобы описать команды и ответы устройства:

  1. Добавьте в проект таблицу команд CommandTable.

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

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

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

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

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

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

    Определяет направление команды:

    • send - исходящая команда - запрос к устройству, может быть как запросом чтения, так и запросом на запись;
    • receive - ответ на команду, приходящий от устройства.
    Постоянная часть команды Постоянная часть команды (в соответствии со спецификацией используемого устройства), которая не изменяется в зависимости от данных.
    Количество данных в команде Количество данных (в символах, шт), которое передаётся в команде. Для команд-триггеров, которые не содержат данные, укажите значение 0.
    Идентификатор команды положительного ответа

    Указывается только для исходящих команд с направлением send. Идентификатор команды в этой же таблице, которая соответствует положительному ответу.

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

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

Таблица данных

В таблице данных описываются данные, получаемые или отправляемые на устройство с помощью команд.

Чтобы описать данные устройства:

  1. Добавьте в проект таблицу данных DataTable.

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

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

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

  3. Перейдите в таблицу данных.

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

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

    Определяет направление передачи данных:

    • send - данные, отправляемые на устройство;
    • receive - данные, получаемые от устройства.
    Идентификатор команды Идентификатор команды, с помощью которой выполняется получение или отправка данных.
    Номер данных команды

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

    Фиксированная длина данных

    Определяет, имеют ли данные фиксированную длину:

    • Да - данные имеют фиксированную длину;
    • Нет - длинна данных может меняться в зависимости от формата данных.

    Для формата Device длинна данных зависит от выбранного для устройства формата, поэтому указывается Нет.

    Длина данных команды Длинна данных команды при фиксированной длине. Для команд переменной длинны и команд, не имеющих данные, указывается 0.
    Формат данных

    Формат передаваемых данных:

    • Device - формат, заданный в конфигурации устройства;
    • ASCII - формат символов;
    • HEX - шестнадцатеричный формат.

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

Пример заполненной таблицы данных для счётчика Меркурий:

Описание типа устройства

Описанный тип устройства позволяет добавлять в проект большое количество одинаковых устройств, не конфигурируя каждое устройство в отдельности.

Чтобы описать тип устройства:

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

  2. Перейдите в Пространство имен и добавьте Тип устройства. Задайте Имя добавленному типу устройства.

  3. Перейдите в Тип устройства и добавьте Приложение.

  4. Перейдите в Приложение и добавьте:

    • параметры соответствующих типов с Направлением вход для отправки данных на устройство;
    • параметры соответствующих типов с Направлением выход для получения данных с устройства.

    При необходимости для описания структуры Типа устройства используйте Логические типы и Сокеты.

  5. В это же Приложение добавьте Универсальную карту адресов.

  6. На элементе Универсальная карта адресов:

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

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

Пример содержимого приложения в составе типа устройства DCON:

Пример содержимого приложения в составе типа устройства Меркурий:

Заполнение карты адресов

Чтобы заполнить карту адресов:

  1. Перейдите в Приложение в Типе устройства.
  2. В свойствах Универсальной карты адресов укажите таблицы команд и данных, на основании которых будет заполняться карта адресов.

  3. Перейдите в Универсальную карту адресов и настройте параметры адреса для каждого сигнала:

    Поле Значение
    Привязка привязан.
    Идентификатор данных

    Задаётся для сигналов. Укажите идентификатор данных из таблицы данных:

    • Для данных, которые отправляются на устройство и имеют направление вход, укажите идентификаторы данных нулевой длинны с направлением send.
    • Для данных, получаемых с устройства и имеющих направление выход, укажите идентификаторы данных ненулевой длины с направлением receive.

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

Пример заполненной карты адресов Меркурий:

Настройка устройства

Чтобы настроить устройство, с которым требуется обмениваться данными:

  1. Перейдите в Alpha.Domain.

  2. Добавьте одно или несколько устройств ранее описанного типа.

  3. Перейдите в добавленное устройство и добавьте Последовательный порт. Укажите Имя последовательного порта, соответствующее настройкам опрашиваемого устройства.

  4. Добавьте адаптер используемого протокола - Адаптер DCON или Адаптер Меркурий.

  5. В настройках адаптера укажите:

    Свойство Значение
    Карта адресов Карта адресов, добавленная в Приложении типа устройства.
    Номер устройства Номер устройства, используемый в командах.

    Для Адаптера DCON возможна настройка дополнительных параметров:

    Свойство Значение
    Формат данных Формат данных, возвращаемых устройством (в соответствии со спецификацией опрашиваемого устройства).
    Использовать контрольную сумму Использование контрольной суммы (в соответствии со спецификацией опрашиваемого устройства).

    Пример настройки Адаптера DCON:

    Пример настройки Адаптера Меркурий:

Настройка опросчика

Чтобы настроить опросчик:

  1. Перейдите в Узел Alpha.Domain → Alpha.Server.
  2. Из папки Коммуникационные модули добавьте опросчик используемого протокола - DCON Опросчик (Универсальный модуль) или Меркурий Опросчик (Универсальный модуль).

  3. На Опросчике нажмите кнопку и укажите ранее добавленный Адаптер соответствующего протокола.

  4. Чтобы настроить параметры взаимодействия Опросчика и Адаптера, выделите добавленный Адаптер.

  5. Настройте параметры взаимодействия:

    Свойство Значение
    Интервал между циклами опроса, мс Период времени, через которой повторятся опрос устройства. Значение по умолчанию 1000 миллисекунд.
    Таймаут ожидания ответа на запрос, мс Время ожидания получения ответа на запрос, по истечении которого отправленный запрос считается неуспешным. Значение по умолчанию 2000 миллисекунд.
    Локальный UDP порт Порт для данного устройства на стороне Alpha.Server. Настраивается только для DCON Опросчик (Универсальный модуль). По умолчанию порт не задан.

    Пример настройки параметров взаимодействия DCON Опросчика (Универсальный модуль) и Адаптера DCON:

    Пример настройки параметров взаимодействия Меркурий Опросчика (Универсальный модуль) и Адаптера Меркурий:

Настройка объектной модели уровня Alpha.Server

Чтобы настроить объектную модель Alpha.Server:

  1. Перейдите в Alpha.Server и добавьте Приложение.

  2. Перейдите в добавленное Приложение и добавьте Логический объект. Задайте Имя объекта.

  3. Перейдите в добавленный Логический объект и добавьте Объектную ссылку.

  4. В свойстве Объект укажите приложение устройства, на которое будет указывать данная Объектная ссылка.

    После этого в Объектной ссылке отобразится логическая структура устройства.

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

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

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

  • последовательный интерфейс RS-485;
  • шлюз Ethernet/COM.

COM-соединение и соединение посредством шлюза и для Меркурия и DCON настраиваются аналогичным образом.

Последовательный интерфейс RS-485

Чтобы настроить обмен данными с устройством по последовательному интерфейсу RS-485:

  1. Перейдите в Alpha.Domain и удалите элемент Сеть Ethernet. Вместо него добавьте элемент Последовательная шина.

  2. В свойствах Последовательной шины укажите параметры передачи данных, если они отличаются от значений, указанных по умолчанию.

    Свойство Описание
    Передача данных
    Скорость бит/с

    Скорость обмена данными между Alpha.Server и устройством.

    Значение по умолчанию - 9600 бит/с.

    Чётность

    Выбор способа контроля четности для обнаружения ошибок при обмене данными:

    • Нет – контроль четности не ведется, проверки ошибок нет;
    • Чет – проверка на четность;
    • Нечет – проверка на нечетность.

    Значение по умолчанию - Нет.

    Стоповые биты

    Количество стоповых битов, необходимых для правильного распознавания конца байта. Выбирается из выпадающего списка – Один или Два стоповых бита.

    Значение по умолчанию - Один.

    Управление потоком

    Выбор режима управления потоком передаваемых данных:

    • Нет – управление потоком выключено;
    • Аппаратное – аппаратная синхронизация, передатчик останавливает передачу данных, если приемник не готов к приему. Обеспечивает быструю реакцию на состояние приемника;
    • Xon/Xoff – программная синхронизация, приемник посылает сигнал о неготовности передатчику, после чего передатчик останавливает посылку данных. Необходим двунаправленный канал связи.

    Значение по умолчанию - Нет.

    Общие

    Имя

    Имя последовательной шины в проекте.

  3. Перейдите в Узел Alpha.Domain и удалите Адаптер Ethernet. Вместо него добавьте Последовательный порт.

  4. В свойствах Последовательного порта укажите:

    Свойство Значение
    Шина Добавленная ранее Последовательная шина.
    Имя Системное имя СОМ-порта на компьютере с Alpha.Server.

  5. Вернитесь в Alpha.Domain и соедините COM-порт устройства с Последовательной шиной.

Шлюз Ethernet/COM

Чтобы настроить обмен данными с устройством через шлюз Ethernet/COM:

  1. Перейдите в Alpha.Domain и добавьте элементы:

    • Последовательная шина;
    • Шлюз Ethernet к последовательной шине.

  2. В свойствах Последовательной шины укажите параметры передачи данных, если они отличаются от значений, указанных по умолчанию.
  3. В свойствах Шлюза Ethernet к последовательной шине укажите:

    Свойство Значение
    Сеть Ethernet Существующая сеть Ethernet.
    IP адрес IP-адрес шлюза в сети Ethernet.

  4. Чтобы добавить порт к последовательной шине, нажмите кнопку на Шлюзе Ethernet к последовательной шине.

  5. Выделите добавленный порт и укажите:

    Свойство Значение
    SerialBus Добавленная Последовательная шина.
    IP порт Порт шлюза в сети Ethernet.

  6. Соедините COM-порт устройства с Последовательной шиной.

Применение конфигурации Alpha.Server

  1. Постройте решение. Конфигурация Alpha.Server будет построена.

  2. Перейдите в Мастер развёртывания.

    Для успешного применения построенных конфигураций должен быть настроен Alpha.Domain. Описание настройки приведено в документации на Alpha.Domain (см. раздел Конфигурирование руководства администратора).

  3. Примените конфигурацию к Alpha.Server.