Alpha.Community

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

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

Настройка обмена данными между Alpha.Server и контроллером TREI-5B по протоколу UNET выполняется в среде разработки Alpha.DevStudio. Чтобы настроить обмен данными:

  1. Добавьте в проект и настройте логические типы.
  2. В проект добавьте и настройте источник данных - контроллер TREI-5B, с которым будет выполняться обмен данными.
  3. В Alpha.Server добавьте и настройте клиент UNET.
  4. Примените конфигурацию Alpha.Server.

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

Далее приведено описание настройки обмена данными Alpha.Server с контроллером TREI-5B по протоколу UNET.

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

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

  2. Перейдите в добавленное Пространство имен и добавьте ещё два элемента Пространство имен. Каждому элементу задайте Имя, например, PlcTypes и ServerTypes. Это будут папки с логическими типами контроллера и Alpha.Server.

  3. Перейдите в добавленное Пространство имен для логических типов контроллера PlcTypes.
  4. Добавьте элемент Аспект и задайте Имя, например, PLC.

  5. Добавьте элемент Логический тип.

  6. Задайте Имя, например, Pump: добавленный Логический тип будет представлять тип Насосы.

  7. Укажите аспект - добавленный ранее аспект PLC.

  8. Перейдите в добавленный Логический тип и опишите его структуру. Например, пусть данный тип насосов имеет три сигнала. Добавьте в логический тип сигналы:

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

    Cmd

    int4 вход

    Failure

    bool выход

    Power

    float выход

    Логический тип контроллера описан.

  9. Вернитесь в Пространство имен Types и перейдите в Пространство имен для логических типов Alpha.Server ServerTypes.
  10. Добавьте элемент Аспект и задайте Имя, например, Server.

  11. Добавьте элемент Логический тип.

  12. Задайте Имя, например, PumpServer: добавленный Логический тип будет представлять описанный ранее тип Насосы, только со стороны Alpha.Server.

  13. Укажите аспект - добавленный ранее аспект Server.

  14. Укажите представляемый тип - ранее описанный логический тип контроллера Pump.

  15. Перейдите в логический тип PumpServer и добавьте элемент Ссылка. Задайте Имя, например, Reference_Plc.

  16. Добавленная ссылка будет связывать логический тип сервера с логическим типом контроллера. В свойстве Тип укажите ранее описанный логический тип контроллера.

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

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

Логический тип сервера описан.

Настройка источника данных

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

  2. Добавьте контроллер ТРЭИ.

  3. Соедините каждый Адаптер Ethernet добавленного контроллера с элементом Сеть Ethernet и укажите Адрес каждого адаптера.

  4. Перейдите в ТРЭИ.
  5. Если получать данные требуется с резервной пары контроллеров TREI-5B, то добавьте Резервный мастер-модуль. Укажите Мастер-модуль, а для каждого адаптера резервного контроллера – Адрес и Сеть.

  6. Перейдите в мастер-модуль контроллера и добавьте Приложение. Задайте Имя, например, PlcApp.

  7. Перейдите в Приложение. Здесь должны быть описаны объекты и сигналы контроллера, с которыми будет взаимодействовать модуль UNET Клиент. Пусть, например, контроллер содержит два объекта типа Насосы. Добавьте два экземпляра ранее описанного логического типа контроллера Pump. Для каждого экземпляра укажите Имя - имя объекта (например, Pump1 и Pump2).

  8. Добавьте в приложение элемент Карта адресов UNET.

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

  10. Перейдите в Карту адресов UNET. В ней отображаются все сигналы, ранее добавленные в приложение. Настройте параметры адреса для каждого сигнала:

    Поле Значение
    Привязка привязан.
    Размер Длина строки от 1 до 128 символов. Значение по умолчанию - 128. Указывается только для параметров типа string и направлением выход.
    Адрес Адрес сигнала.
    Архивация

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

    • Количество записей в буфере - количество значений сигнала, сохраняемых в буфере контроллера;
    • Время между сохранениями, сек - период времени, через который требуется сохранять значения в буфер контроллера.
    Категория данных имя категории данных, настроенной в модуле UNET Клиент. Имя категории данных в карте адресов прописывается вручную.

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

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

    После заполнения сохраните и закройте карту адресов.

  11. Вернитесь в мастер-модуль контроллера и настройте Сервер UNET. В свойстве Карта адресов укажите ранее добавленную Карту адресов UNET. Значения остальных свойств можно оставить по умолчанию.

    Свойства Сервер UNET:

    Свойство Описание
    Общие
    Карта адресов Расположение в проекте карты адресов с настройками сигналов.
    Имя Название сервера UNET в проекте.
    Параметры станции
    Номер TCP порта Порт, используемый для обмена данными. Значение по умолчанию 6000.

Источник данных настроен.

Настройка UNET клиента

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

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

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

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

    Свойства UNET Клиент:

    Свойство Описание
    Параметры модуля
    Путь до архивных файлов

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

    Путь указывается абсолютный или относительный. Значение параметра по умолчанию ./UNETClient.

    Выставлять метку времени при изменении качества

    Устанавливать текущую метку времени Alpha.Server в качестве метки времени источника при установлении сигналам плохого качества (Bad, BadCommFailure, BadNotConnected, BadLastKnown). Значение по умолчанию - Нет.

    Не изменять качество при архивном чтении

    Устанавливает запрет на изменение качества сигналов при архивном чтении с любым типом восстановления в случае разрыва соединения с контроллером:

    • Да - не изменять качество сигналов на значения Bad, BadCommFailure, BadNotConnected, BadLastKnown;
    • Нет - качество может изменяться.

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

    Активность

    Активность модуля при запуске/перезапуске Alpha.Server:

    • Да – модуль запущен;
    • Нет – модуль остановлен.

    Управляется служебным сигналом Active.Set.

    Отображаемое имя

    Название модуля, которое отображается в тегах служебных сигналов.

    Параметры журналирования

    Вести журнал работы модуля

    Ведение записи сообщений о работе модуля в журнал работы:

    • Да – вести журнал работы;
    • Нет – журнал работы не ведётся.

    Управляется служебным сигналом FrameLogEnable.Set.

    Размер журнала работы модуля, МБ

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

    Количество дополнительных журналов работы

    Количество файлов заполненных журналов работы модуля:

    • минимальное количество – 1;
    • максимальное количество – 255.

    Уровень трассировки в журнал приложений

    Типы сообщений, которые выводятся в журнал приложений:

    • Предупреждения и аварийные сообщения – логические ошибки и ошибки работы модуля. Предупреждения содержат некритичные ошибки. Аварийные сообщения информируют об ошибках, которые влияют на работоспособность сервера;
    • Информационные сообщения – предупреждения и аварийные сообщения, а также основная информация о работе модуля;
    • Отладочные сообщения – предупреждения и аварийные сообщения, основная и детальная информация о работе модуля.

    Управляется служебным сигналом SystemLogTraceLevel.Set.

    Общие

    Имя

    Идентификатор модуля в конфигурации Alpha.Server, значение сервисного сигнала Id.

  4. На элементе UNET Клиент нажмите кнопку и укажите ранее настроенный источник данных Сервер UNET.

  5. Чтобы перейти к настройкам параметров связи модуля UNET Клиент с сервером UNET, выделите добавленный Сервер UNET.

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

    Свойство Описание
    UNET Сервер Расположение в проекте источника данных - сервера UNET.
    Режим работы в резерве

    Опрос источников при переходе модуля в РЕЗЕРВ:

    • Поддерживать соединения – модуль прекращает чтение и запись значений переменных, выполняется только сервисный опрос состояния. Соединения с контроллерами не закрываются;
    • Вести опрос – модуль продолжает чтение значений переменных и опрос состояния контроллера. Запись значений в контроллер не ведется;
    • Закрывать соединения – модуль закрывает соединения с контроллерами. При переходе в режим РАБОТА модуль восстанавливает соединения и возобновляет чтение и запись значений переменных.

    Значение по умолчанию Поддерживать соединения.

    Время ожидания ответа, мс Время, в течение которого модуль ждет ответа от контроллера. Если ответ не получен, модуль отключается от устройства. Значение по умолчанию 1000 мс.
    Поведение записи при отсутствии связи

    Действия, выполняемые для команд, полученных модулем до и во время отключения от контроллера:

    • Отбрасывать все значения – отбрасываются значения, которые уже были в очереди до отключения контроллера, и новые значения;
    • Сохранять последнее изменение значения – сохраняются только последние значения и отправляются в контроллер при восстановлении связи.

    Значение по умолчанию - Отбрасывать все значения.

    Включать граничные значения при чтении из архива

    При подключении получать граничные значения переменных при их чтении из архива контроллера:

    • Да - первый архивный запрос модуль выполнит с получением граничных значений. Если в запрашиваемом промежутке значения отсутствуют, то будет получено последнее значение, которое есть в архиве;
    • Нет - не получать граничные значения.

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

  6. Перейдите в UNET Клиент и добавьте требуемое количество категорий данных. Для каждой категории данных установите значения свойств:

    Свойство Описание
    Вид данных Режим чтения данных контроллера.
    Интервал опроса, мс Период, через который необходимо запрашивать оперативные или архивные данные из контроллера.
    Период обновления в контроллере, мс Период изменения значений переменных в контроллере. Используется для расчёта задач планировщика запросов.

    Значения остальных параметров можно установить по необходимости или оставить значения по умолчанию.

    Свойство Описание
    Вид данных

    Режим чтения данных:

    • Оперативные данные - чтение оперативных данных с контроллера;
    • Архивные данные - чтение данных из архива контроллера;
    • Архивные данные с восстановлением - чтение данных из архива контроллера, при этом данные за время отсутствия связи с контроллером будут восстановлены и записаны в сигналы Alpha.Server;
    • Архивные данные с фоновым восстановлением - чтение данных из архива контроллера, при этом данные за время отсутствия связи с контроллером будут восстановлены и записаны только в историю, в сигналы Alpha.Server такие данные записаны не будут.

      Для получения архивных данных с фоновым восстановлением требуется выполнить дополнительные настройки конфигурации:

      • Alpha.Server должен быть запущен в транзакционной модели исполнения;
      • сохранение истории должно выполняться в БД Alpha.Historian нового формата.

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

    Период обновления в контроллере, мс

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

    Значение по умолчанию - 100 миллисекунд.

    Интервал опроса, мс

    Период, через который необходимо запрашивать оперативные или архивные данные из контроллера.

    Значение по умолчанию - 100 миллисекунд.

    Репликация состояния чтения

    Синхронизация состояния чтения групп архивных данных между резервной парой Alpha.Server:

    • Да - синхронизировать состояния чтения групп. Устанавливается только если параметру Вид данных установлено значение Архивные данные с восстановлением.
    • Нет - не синхронизировать.

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

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

    Имя

    Название категории данных, которое указывается в карте адресов.

  7. Вернитесь в Alpha.Server и добавьте Приложение.

  8. Перейдите в Приложение и добавьте Логический объект. Данный Логический объект будет объединять в себе другие логические объекты - Насосы. Задайте Имя логического объекта, например, Pumps. Задайте значения свойств:

    Свойство Значение
    Аспект Ранее описанный аспект сервера (Server).
    Представляемый объект Ранее описанное приложение контроллера PlcApp.

  9. Перейдите в Логический объект и добавьте два экземпляра ранее описанного логического типа контроллера PumpServer. Каждому экземпляру укажите Имя, например, PumpServer_1 и PumpServer_2.

  10. Для каждого экземпляра укажите Представляемый объект - объект, описанный в приложении контроллера (Pump1 и Pump2 соответственно).

  11. На данном этапе добавленные логические объекты содержат ошибку. Для устранения ошибки необходима инициализация ссылок:

    1. Вызовите контекстное меню в свободном поле логического объекта Pumps и выполните команду Инициализировать все ссылки.
    2. Нажмите кнопку на панели инструментов или клавишу F5 на клавиатуре.

    После инициализации ошибка исчезнет. Перейдите в любой из объектов и убедитесь, что Ссылка Reference_Plc теперь ведёт к объекту, указанному в свойстве Представляемый объект.

Клиент UNET настроен.

Дополнительные настройки конфигурации

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

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

Для получения архивных данных с фоновым восстановлением (параметру Вид данных установлено значение Архивные данные с фоновым восстановлением) необходимо выполнить дополнительные настройки конфигурации Alpha.Server:

  1. Настройте запуск Alpha.Server в транзакционной модели исполнения. Для этого в файле конфигурации Alpha.Server.xml добавьте элемент Dispatch с атрибутом Model и значением Transactional.

    <?xml version="1.0" encoding="windows-1251"?>
    <configuration>
      <install ServiceName="Alpha.Server" ExeName="Alpha.Server.exe">
      </install>
      <Storage Filename="AlphaServer.cfg" />
      <Connection Port="4572" />
      <Backup Path="..\Backups" Time="00:00" StorageDepth="30" />
      <Log Path="..\Logs" />
      <Instance ID="E4F24B41-513B-41C1-B3C2-211306D85678" />
      <Culture LangID="ru-RU" />
      <Dispatch Model="Transactional"/>
    </configuration>
  2. В настройках Alpha.Historian включите новый формат БД. Для этого в файле конфигурации Alpha.Historian.Server.xml в описание БД добавьте строку:

    <?xml version="1.0" encoding="utf-8"?>
    <Alpha.Historian.Server StatPort="3388" DefaultPrimaryDir="C:\Alpha.Historian\Databases">
      <tcp-server default-port=4949 idle-sessions-count=1 idle-sessions-timeout=15>
        <server-endpoint host="0.0.0.0" />
      </tcp-server>
      <Bases>
        <Base Alias="default" >
          <deferred-writes enable="1" chunk-size="1" chunk-group-size="128" threads="4" flush-period="60" />
        </Base>
      </Bases>
    </Alpha.Historian.Server>
  3. Перезапустите службы Alpha.Server и Alpha.Historian.Server.

Синхронизация состояния чтения групп архивных данных между резервной парой Alpha.Server

Если для категории данных включена синхронизация состояния чтения групп архивных данных между резервной парой Alpha.Server (свойству Вид данных установлено значение Архивные данные с восстановлением, а свойству Репликация состояния чтения установлено значение Да), то необходимо выполнить дополнительные настройки конфигурации Alpha.Server:

  1. Настройте запуск Alpha.Server в транзакционной модели. Для этого в файле конфигурации Alpha.Server.xml добавьте элемент Dispatch с атрибутом Model и значением Transactional.

    <?xml version="1.0" encoding="windows-1251"?>
    <configuration>
      <install ServiceName="Alpha.Server" ExeName="Alpha.Server.exe">
      </install>
      <Storage Filename="AlphaServer.cfg" />
      <Connection Port="4572" />
      <Backup Path="..\Backups" Time="00:00" StorageDepth="30" />
      <Log Path="..\Logs" />
      <Instance ID="E4F24B41-513B-41C1-B3C2-211306D85678" />
      <Culture LangID="ru-RU" />
      <Dispatch Model="Transactional"/>
    </configuration>
  2. Если в проекте не настроено резервирование Alpha.Server, то добавьте в проект Резервный Alpha.Server и выполните настройку резервной пары серверов. Настройка резервной пары серверов описана в документации на Alpha.DevStudio (раздел Повышение надёжности проекта автоматизации руководства пользователя).

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

    Свойство Значение
    Имя Название папки сервисных сигналов - Service.
    Тип Тип логического объекта - сервисные сигналы unit.Server.Service.

  4. В объекте Service создайте иерархию логических объектов:

    Service.Modules.<Имя модуля>.ArchivePoll.Replication

    Для этого перейдите в Логический объект Service:

    1. Добавьте Логический объект с именем Modules.
    2. В объект Modules добавьте Логический объект с именем модуля UNET Client.
    3. В объект UNET Client добавьте Логический объект с именем ArchivePoll.
    4. В объект ArchivePoll добавьте Логический объект с именем Replication.
  5. Перейдите в Логический объект Replication и добавьте сигналы типа uint8, через которые будет выполняться синхронизация:

    • LastRequestHash1
    • LastRequestHash2
    • LastRequestNextLowerBound
    • LastMasterTxId

  6. Вернитесь в Логический объект с именем модуля UNET Client:
    1. Логическому объекту с именем ArchivePoll добавьте атрибут Реплицировать;

    2. Логическому объекту ArchivePoll установите значение Да атрибуту Реплицировать.

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

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

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

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

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