Alpha.Community

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

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

Настройка обмена данными между TCP Сервер и TCP клиентом выполняется в среде разработки Alpha.DevStudio.

Чтобы настроить обмен данными с TCP клиентом:

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

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

Настройка TCP Сервер

  1. Перейдите в Alpha.Domain → Узел Alpha.Domain и укажите IP-адрес Адаптера Ethernet, соответствующий IP-адресу компьютера, на котором функционирует Alpha.Server.

  2. Перейдите в Alpha.Server. По умолчанию в конфигурации Alpha.Server присутствует модуль TCP Сервер. Если конфигурация ранее была изменена и модуль отсутствует, то добавьте TCP Сервер из папки Коммуникационные модули.

    Для свойств модуля можно оставить значения по умолчанию.

  3. Добавьте Приложение.

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

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

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

Параметр Описание
Таймаут очистки застоявшихся читателей, мин.

Период времени с момента последней операции в минутах, по истечении которого TCP Сервер закроет соединение с клиентом, который не проявляет активности. При значении 0 соединение с неактивным клиентом не закрывается.

Значение по умолчанию – 1.

Максимальный размер очереди сообщений, шт.

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

Максимальный размер очереди данных, шт.

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

Номер TCP порта

Порт, через который клиенты будут подключаться к Alpha.Server по внутреннему проприетарному TCP-протоколу Alpha.Link.

При заполнении очереди поступающие в неё данные начнут отбрасываться, а в журнал работы модуля начнут поступать сообщения о переполнении очереди.

Доступ к истории по TCP

Чтобы клиенты, подключившиеся к Alpha.Server по TCP, могли получать историю, в настройках модуля TCP Сервер в группе параметров Настройки доступа к истории укажите Номер TCP порта. Остальные параметры можно оставить по умолчанию.

Параметр Описание
Ограничение ожидающих сессий

Количество возможных одновременно удерживаемых сессий в режиме ожидания подключения.

Время удержания сессии

Время удержания ожидающей подключения сессии в секундах.

Значение по умолчанию – 10.

Номер TCP порта

Порт, через который клиенты будут получать историю. Можно указать любой свободный порт.

Добавление TCP клиента

В качестве клиентов TCP Сервер могут выступать: Alpha.AccessPoint, Alpha.HMI, модуль HUB в составе другого Alpha.Server. Далее в качестве TCP клиента описан модуль HUB в составе другого Alpha.Server. При описании других клиентов следует использовать элемент Потребитель Link: он предназначен для указания параметров взаимодействия TCP Сервер с потребителем, и размещается не в других экземплярах Alpha.Server, а в Исполняющем компоненте.

  1. Перейдите в Alpha.Domain и добавьте Узел Alpha.Domain. Задайте Имя.

  2. Соедините Адаптер Ethernet добавленного Узла Alpha.Domain с элементом Сеть Ethernet, а в свойстве Адрес укажите IP-адрес Alpha.Server, который будет выступать в качестве TCP клиента.

  3. Перейдите в добавленный Узел Alpha.Domain и добавьте Alpha.Server.

  4. Перейдите в Alpha.Server и добавьте HUB из папки Коммуникационные модули.

  5. На HUB нажмите кнопку и укажите ранее настроенный TCP Сервер.

  6. Добавьте Приложение.

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

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

Для настройки обмена данными между модулем TCP Сервер и TCP клиентом:

Настройка логических типов

  1. Добавьте в проект два элемента Пространство имен для логических типов Alpha.Server и TCP клиента. Каждому элементу задайте Имя, например, ServerTypes и ClientTypes.

  2. В каждое Пространство имен добавьте элемент Аспект.

    Задайте Имя каждому добавленному аспекту:

    • в пространстве имён ServerTypes – аспект Server;
    • в пространстве имён ClientTypes – аспект Client.

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

Чтобы настроить логические типы Alpha.Server:

  1. Перейдите в Пространство имен ServerTypes и добавьте Логический тип. В свойствах укажите:

    • Аспект – добавленный ранее аспект Server;
    • Имя – имя логического типа.
  2. Перейдите в Логический тип и опишите его структуру: добавьте сигналы необходимых типов, укажите им Имя и Направление.

Например, добавьте логический тип Valve со следующими сигналами:

Сигнал Тип Направление Описание
State

uint2

выход Состояние задвижки
Open

bool

вход Команда на открытие задвижки
Close

bool

вход Команда на закрытие задвижки

Логические типы TCP клиента

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

  1. Перейдите в Пространство имен ClientTypes и добавьте Логический тип. В свойствах укажите:

    • Аспект – добавленный ранее аспект Client;
    • Имя – имя логического типа;
    • Представляемый тип – описанный ранее логический тип Alpha.Server.

    Добавленный Логический тип будет представлять описанный ранее логический типы Alpha.Server, только со стороны TCP клиента.

  2. Перейдите в Логический тип и добавьте Ссылку. В свойствах добавленной ссылки укажите:

    • Имя – имя ссылки;
    • Тип – описанный ранее логический тип Alpha.Server.

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

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

Пример логического типа Valve_Client:

Структура логического типа Valve_Client:

Добавление типов в приложения Alpha.Server и TCP клиента

  1. Перейдите в приложение Alpha.Server и добавьте экземпляр логического типа Alpha.Server Valve.

  2. Перейдите в приложение TCP клиента :
    1. Вызовите контекстное меню и выполните команду Создать здесь представления объектов....

    2. Выберите объекты из приложения Alpha.Server, для которых требуется создать представления, и нажмите кнопку Далее.

    3. Проверьте список выбранных объектов и нажмите кнопку Далее.

  3. В качестве аспекта новых представлений укажите аспект Client и нажмите кнопку Готово.

    Представление выбранного объекта будет создано в приложении TCP клиента.

Запрет изменения значений сигналов клиентами

Чтобы запретить TCP-клиентам изменять значения сигналов Alpha.Server:

  1. В настройках модуля TCP Сервер установите общее правило для анонимных клиентов в параметре Разрешить изменения для анонимных клиентов:

    • Да – любые анонимные клиенты могу изменять значения сигналов;
    • Нет – анонимные клиенты не могу изменять значения сигналов.

  2. В настройках модуля HUB в параметре Разрешено изменять значения сигналов установите правило для TCP клиента:

    • Да – клиенту разрешено изменение значений сигналов;
    • Нет – клиенту запрещено изменение значений сигналов.

Требуется запретить изменять значения сигналов Alpha.Server всем анонимным TCP-клиентам, кроме модуля HUB.

  1. В настройках модуля TCP Сервер установите параметру Разрешить изменения для анонимных клиентов значение Нет.
  2. В настройках модуля HUB установите параметру Разрешено изменять значения сигналов значение Да.

Требуется разрешить изменять значения сигналов Alpha.Server всем анонимным TCP-клиентам, кроме модуля HUB.

  1. В настройках модуля TCP Сервер установите параметру Разрешить изменения для анонимных клиентов значение Да.
  2. В настройках модуля HUB установите параметру Разрешено изменять значения сигналов значение Нет.

Разрешение изменения значений сигналов только для аутентифицированных клиентов

Для TCP Сервер можно настроить разрешение записи значений только для известных клиентов, которые предоставят пароль аутентификации. Для настройки используется свойство модуля TCP СерверМетод аутентификации известных клиентов. Возможные значения:

  • Отсутствует – в таком случае запись разрешена всем клиентам (если иное не настроено в свойстве Разрешить изменения для анонимных клиентов);
  • Пароль – в таком случае в качестве метода аутентификации выбирается пароль, который необходимо указать в Параметрах взаимодействия с потребителем для каждого TCP клиента (модуля HUB или Потребителя Link).

    Это значение используется по умолчанию.

Передача данных через файловый интерфейс

Файловый интерфейс представляет собой безопасный метод передачи данных при обмене информацией между защищенными подсетями. Для передачи данных через файловый интерфейс модуль TCP Сервер в составе Alpha.Server циклически генерирует DAT-файлы, содержащие значения сигналов, а модуль HUB в составе другого Alpha.Server или Alpha.AccessPoint периодически считывает значения сигналов из DAT-файла.

Далее приведена настройка передачи данных через файловый интерфейс между модулями TCP Сервер и HUB для двух вариантов расположения модулей:

TCP Сервер и HUB в одном Alpha.Domain

Пример проекта, в котором настроена передача данных между модулями TCP Сервер и HUB:

Для настройки передачи данных через файловый интерфейс между модулями TCP Сервер и HUB, расположенными в одном Alpha.Domain:

  1. Перейдите в Узел Alpha.Domain, в котором расположен Alpha.Server с модулем TCP Сервер (в примере это host), и добавьте Папку обмена.

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

    Модуль TCP Сервер не создаёт указанную папку. Следует указывать существующую папку на диске.

    Если DAT-файлы требуется генерировать в папку другого сетевого компьютера (например по сетевому пути: \\NetworkComputer\SharedFolder\), то для данной папки должна быть разрешена запись Alpha.Server, в составе которого работает TCP Сервер. Доступ на запись настраивается стандартными способами операционной системы.

  3. Соедините модуль TCP Сервер с Папкой обмена.

  4. Настройки файлового интерфейса можно оставить по умолчанию.

    Если требуется изменение настроек файлового интерфейса, то перейдите в Alpha.Server и в свойствах модуля TCP Сервер укажите требуемые значения параметров группы Настройки файлового интерфейса:

    Параметр Описание
    Период записи всех данных, сек.

    Период времени, через который выполняется запись всех данных в файл, вне зависимости от того, изменились ли значения сигналов.

    Значение по умолчанию – 60.

    Максимальное количество изменений в файле

    Максимальное число изменений, которое может быть записано в DAT-файл. При превышении указанного количества изменений будет создан дополнительный DAT-файл.

    Значение по умолчанию – 10000.

    Период генерации файлов, мс

    Период времени, через который будут генерироваться DAT-файлы.

    Значение по умолчанию – 5000.

  5. Перейдите в Alpha.Domain и добавьте Файловый обмен.

  6. Удалите связь между Адаптером Ethernet и Сетью Ethernet, а затем соедините Папку обмена с Файловым обменом.

  7. Теперь перейдите в Узел Alpha.Domain, в котором расположен Alpha.Server с модулем HUB (в примере это hub), и добавьте Папку обмена.

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

    Должна быть указана папка, в которую модуль TCP Сервер генерирует файлы данных.

    Если DAT-файлы требуется читать из папки другого сетевого компьютера (например по сетевому пути: \\NetworkComputer\SharedFolder\), то для данной папки должно быть разрешено чтение Alpha.Server, в составе которого работает модуль HUB. Доступ на чтение настраивается стандартными способами операционной системы.

  9. Соедините модуль HUB с Папкой обмена.

  10. Вернитесь в Alpha.Domain и удалите связь между Адаптером Ethernet и Сетью Ethernet, а затем соедините Папку обмена с Файловым обменом.

Настройка передачи данных через файловый интерфейс между модулями TCP Сервер и HUB, расположенными в одном Alpha.Domain, выполнена.

TCP Сервер и HUB в разных Alpha.Domain

Пример проекта, в котором модули TCP Сервер и HUB находятся в разных Alpha.Domain:

Для настройки передачи данных через файловый интерфейс между модулями TCP Сервер и HUB, расположенными в разных Alpha.Domain:

  1. Перейдите в Alpha.Domain , в котором расположен Alpha.Server с модулем TCP Сервер (в примере это Domain_TCPServer).

  2. Перейдите в Узел Alpha.Domain и добавьте Папку обмена.

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

    Модуль TCP Сервер не создаёт указанную папку. Следует указывать существующую папку на диске.

    Если DAT-файлы требуется генерировать в папку другого сетевого компьютера (например по сетевому пути: \\NetworkComputer\SharedFolder\), то для данной папки должна быть разрешена запись Alpha.Server, в составе которого работает TCP Сервер. Доступ на запись настраивается стандартными способами операционной системы.

  4. Соедините модуль TCP Сервер с Папкой обмена.

  5. Настройки файлового интерфейса можно оставить по умолчанию.

    Если требуется изменение настроек файлового интерфейса, то перейдите в Alpha.Server и в свойствах модуля TCP Сервер укажите требуемые значения параметров группы Настройки файлового интерфейса.

  6. Перейдите в Alpha.Domain и добавьте Файловый обмен.

  7. Соедините Папку обмена с Файловым обменом.

  8. Теперь перейдите в Alpha.Domain, в котором расположен Alpha.Server с модулем HUB (в примере это Domain_HUB).

  9. Перейдите в Узел Alpha.Domain и добавьте Папку обмена.

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

    Должна быть указана папка, в которую модуль TCP Сервер генерирует файлы данных.

    Если DAT-файлы требуется читать из папки другого сетевого компьютера (например по сетевому пути: \\NetworkComputer\SharedFolder\), то для данной папки должно быть разрешено чтение Alpha.Server, в составе которого работает модуль HUB. Доступ на чтение настраивается стандартными способами операционной системы.

  11. Соедините модуль HUB с Папкой обмена.

  12. Вернитесь в Alpha.Domain и добавьте Ссылку на Alpha.Domain.

  13. В свойстве Alpha.Domain укажите Alpha.Domain, в котором находится Alpha.Server с модулем TCP Сервер.

  14. Соедините Папку обмена со Ссылкой на Alpha.Domain.

  15. Снова перейдите в Узел Alpha.Domain, а затем в Alpha.Server.

  16. На HUB нажмите кнопку и укажите Alpha.Server с модулем TCP Сервер в ссылке на Alpha.Domain.

Настройка передачи данных через файловый интерфейс между модулями TCP Сервер и HUB, расположенными в разных Alpha.Domain, выполнена.

Разворот инициации соединения между модулями TCP Сервер и HUB

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

Далее приведена настройка разворота инициации соединения между модулями TCP Сервер и HUB для двух вариантов расположения модулей:

TCP Сервер и HUB в одном проекте

Пример проекта, в котором настроена передача данных между модулями TCP Сервер и HUB:

Для настройки разворота инициации соединения между модулями TCP Сервер и HUB, расположенными в одном проекте:

  1. Перейдите в Alpha.Server, в составе которого работает модуль TCP Сервер (расположение Alpha.Domain → Узел Alpha.Domain → Alpha.Server).

  2. На TCP Сервер нажмите кнопку и укажите модуль HUB составе другого Alpha.Server, к которому будет подключаться TCP Сервер.

  3. В параметрах взаимодействия с потребителем можно оставить значения по умолчанию. Если требуется изменить порт подключения к модулю HUB, то укажите его в параметре Номер TCP порта.

  4. Перейдите в Alpha.Server, в составе которого работает модуль HUB (расположение Alpha.Domain → Узел Alpha.Domain → Alpha.Server2).
  5. На HUB выделите источник данных (если источник был настроен ранее) и нажмите кнопку . HUB не должен содержать источников данных. При развороте инициации соединения TCP Сервер будет сам подключаться к модулю HUB.

Настройка разворота инициации соединения между модулями TCP Сервер и HUB, расположенными в одном проекте, выполнена.

TCP Сервер и HUB в разных проектах

Модули TCP Сервер и HUB могут располагаться в разных проектах в случае, если объект автоматизации имеет несколько уровней. Например, Alpha.Server в проекте "нижнего" уровня собирает данные с измерительных приборов и с помощью модуля TCP Сервер предоставляет собранные данные в проект "верхнего" уровня. В проекте "верхнего" уровня Alpha.Server с помощью модуля HUB собирает данные с нескольких подобных проектов "нижнего" уровня и выполняет дальнейшую обработку данных.

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

Пример проекта "верхнего" уровня с модулем HUB:

Для настройки передачи данных и разворота инициации соединения между модулями TCP Сервер и HUB, расположенными в разных проектах:

  1. В проект "нижнего" уровня добавьте Alpha.Domain. Это будет абстрактное представление "верхнего" уровня с модулем HUB.

  2. Перейдите в добавленный Alpha.Domain и добавьте Компьютер.

  3. Перейдите в Компьютер и для Адаптера Ethernet в параметре Адрес укажите IP-адрес Alpha.Server с модулем HUB из проекта "верхнего" уровня.

  4. В Компьютер добавьте Исполняющий компонент.

  5. Перейдите в Исполняющий компонент и добавьте Потребитель Link из папки Link.

  6. Укажите значения свойств Потребителя Link:

    Параметр Описание
    Идентификатор клиента Идентификатор модуля HUB, по которому будет подключаться модуль TCP Сервер.
    Разрешено изменять значения сигналов

    Правило для модуля HUB:

    • Да – разрешено изменение значений сигналов;
    • Нет – запрещено изменение значений сигналов.
  7. Вернитесь в Alpha.Domain и соедините Адаптер Ethernet с Сетью Ethernet.

  8. Теперь перейдите в Alpha.Domain, в котором находится Alpha.Server с модулем TCP Сервер, и добавьте Ссылку на Alpha.Domain.

  9. В свойстве Alpha.Domain укажите добавленный ранее Alpha.Domain – абстрактное представление "верхнего" уровня с модулем HUB.

  10. Соедините Сеть Ethernet со Ссылкой на Alpha.Domain.

  11. Перейдите в Узел Alpha.Domain → Alpha.Server и для TCP Сервер укажите Потребителя Link из ссылки на абстрактное представление "верхнего" уровня с модулем HUB.

  12. Выполните компиляцию решения нажав кнопку (Компилировать решение) на панели инструментов или клавишу F7 на клавиатуре.
  13. Теперь скомпилированный проект "нижнего" уровня нужно сконвертировать в бинарный файл для дальнейшего использования в проекте "верхнего" уровня. Для этого в Обозревателе решений вызовите контекстное меню проекта и выполните команду Опубликовать модули....

  14. Укажите место на диске для сохранения бинарного файла и нажмите кнопку Готово. Проект будет сохранён в виде файлов *.binom и *.index.

  15. Перейдите в проект "верхнего" уровня и подключите сконвертированный проект "нижнего" уровня. Для этого в Обозревателе решений вызовите контекстное меню решения и выполните команду Добавить → Модуль....

  16. Выберите ранее сохраненный файл *.binom на диске и нажмите кнопку Открыть. Проект "нижнего" уровня будет добавлен в решение. Внесение изменений в этот проект невозможно.

  17. В проект "верхнего" уровня добавьте Ссылку на модуль.

  18. В свойстве Модуль в выпадающем списке выберите добавленный проект "нижнего" уровня.

  19. Перейдите в Alpha.Domain и добавьте Ссылку на Alpha.Domain.

  20. В свойстве Alpha.Domain укажите домен "нижнего" уровня, на который ссылается добавленная на предыдущем шаге ссылка.

  21. Соедините Сеть Ethernet с добавленной Ссылкой на Alpha.Domain.

  22. Перейдите в Узел Alpha.Domain → Alpha.Server и в свойствах модуля HUB для свойства Идентификатор клиента укажите тот же идентификатор, который был указан в свойствах Потребителя Link в проекте "нижнего" уровня.

Настройка разворота инициации соединения между модулями TCP Сервер и HUB, расположенными в разных проектах, выполнена.

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

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

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

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

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

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

  • Ошибка с текстом "Для взаимодействия <идентификатор TCP Сервер> с <идентификатор клиента> необходимо указать пароль аутентификации в соответствии с текущим методом аутентификации известных клиентов" возникает в случае, если в качестве метода аутентификации известных клиентов выбран пароль, но не указан для конкретного клиента в параметрах взаимодействия с ним, см. Выбор метода аутентификации известных клиентов.
  • Предупреждение с текстом "Для <идентификатор клиента> указан пароль аутентификации известного клиента, который не будет использован в соответствии с текущим методом аутентификации известных клиентов" возникает в случае, если метод аутентификации известных клиентов не выбран, но пароль для конкретного клиента указан в параметрах взаимодействия с ним, см. Выбор метода аутентификации известных клиентов.