Alpha.Community

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

Добавление сигналов

В Alpha.DevStudio есть следующие элементы для описания сигналов:

  • параметры;
  • события.

Параметры описывают характеристики объекта в любой момент времени. Могут быть постоянны на всём протяжении существования объекта. События изменяют состояние объекта и существуют только в момент возникновения (например, передаваемые команды: Открыть, Включить). Таким образом отличие между параметром и событием заключается в том, что параметр обладает определенным состоянием, а событие – нет. Событие само по себе может служить триггером для выполнения какого-нибудь обработчика, а у параметра таким триггером будет изменение его значения.

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

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

Значения и у параметров, и у событий могут являться массивами. Обработка массивов значений на данный момент поддерживается по протоколам OPC UA и Alpha.Link.

И параметры, и события могут быть сгруппированы в сокеты.

У параметров, событий и сокетов нужно указывать направление. Направление может иметь значение:

  • вход;
  • выход;
  • вход/выход;
  • отсутствует.

Если выбрано значение отсутствует, это будет означать, что переменная, событие или сокет не предназначены для передачи данных между объектами.

Чтобы добавить сигнал:

  1. Добавьте элемент нужного типа:

    • Параметр
    • Событие

  2. Укажите значения свойств для добавленного элемента.

    Например, в свойстве Тип можно указать тип значений, в свойстве направление – является ли сигнал входным или выходным для объекта.

После развертывания решения свойства и другие настройки, примененные к параметру/событию, будут храниться в сервере в виде свойств сигнала со специальными номерами. Так, например, свойство номер 1 – CDT (Канонический тип данных), номер 3 – качество и т.д.. Подробнее об этом – в документации на Alpha.Server → Приложения → Приложение A: Свойства сигналов Alpha.Server. Кроме того, сигналам можно добавлять пользовательские свойства: это свойства с номерами в диапазоне от 1000000 до 2000000, тип и значения которых вы можете определить сами.

Массивы значений

Чтобы указать, что значение сигнала является массивом, укажите для описывающего его параметра или события значение свойства Размер массива. При применении конфигурации значение сигнала будет представлять собой массив, содержащий указанное количество элементов (нумерация элементов начинается с 0).

Массив значений, созданный таким образом, имеет следующие особенности:

  • количество элементов массива указывается в свойстве Размер массива, однако по факту массив динамический – размер массива может быть изменен, например, коммуникационным модулем при записи значения в сигнал;
  • размер динамического массива ограничен значением свойства Максимальный размер массива;
  • элементы массива имеют такой тип значения, который указан для самого параметра или события;
  • метка времени – одна для всего массива;
  • качество – одно для всего массива;
  • изменение любого элемента массива означает изменение всего сигнала.

Если массив значений сигнала участвует в вычислениях, добавьте описывающему его параметру или событию атрибут Начальное значение. Указанное здесь значение при применении конфигурации будет присвоено всем элементам массива.

Чтобы обратиться к конкретному элементу массива, следует использовать конструкцию Parameter[i], где Parameter – параметр или событие, значение которого является массивом, i – индекс элемента массива (нумерация элементов начинается с "0").

Сокеты

Для описания сигналов, чьи значения передаются из одного объекта в другой, рекомендуется использовать сокеты. Сокет – это группа сигналов. При использовании сокетов связь добавляется не между отдельными сигналами, а между сокетами: входящие в них сигналы связываются автоматически.

Чтобы создать сокет:

  1. Добавьте Сокет.

    В свойстве Направление укажите, является ли сокет входным или выходным для объекта.

  2. Перейдите в добавленный Сокет и добавьте в него сигналы нужного типа:
    • Параметр
    • Событие
  3. Каждому сигналу в свойствах укажите его тип значений.

    Помимо сигналов, в сокет можно добавлять вложенные сокеты.

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

Чтобы использовать сокет в нескольких объектах/типах, можно создать тип сокета. Использование типа сокета позволяет описывать сигналы в одном месте: при добавлении сигнала в тип сокета, этот сигнал появится у каждого сокета этого типа.

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

  1. Создайте тип сокета:

    1. Перейдите в Пространство имён, в котором хотите описать тип сокета.

      Типы сокетов можно описывать также внутри других элементов, однако мы рекомендуем этого не делать, чтобы не создавать путанницы. Будет казаться, что в элементе находятся сигналы, описанные в типе сокета, хотя на самом деле тип сокета – это только описание, поэтому в элементе этих данных не будет.

    2. Добавьте Тип сокета.

    3. В Тип сокета добавьте сигналы: выполняется так же, как при добавлении сигналов в сокет.
  2. В объект/тип добавьте сокет созданного типа:

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

    2. В свойстве Направление укажите направление сокета:

      • Вход
      • Выход

Пользовательские свойства сигналов

Чтобы создать собственное свойство сигнала, называемое пользовательским, выполните следующие действия.

  1. Создайте собственный тип атрибута, как описано в разделе Создание пользовательских атрибутов. Это – будущее свойство сигнала, укажите его имя, заголовок и тип значения.
  2. Добавьте созданному типу атрибут Свойство конфигурации. В качестве значения добавленного атрибута укажите значение в диапазоне от 1000000 до 2000000 – это и будет номер свойства сигнала в конфигурации сервера.

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

При построении конфигурации сигналу будет добавлено созданное свойство с указанным номером и значением.

Дерево сигналов

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

При построении дерева учитывается вложенность объектов. По умолчанию дерево сигналов сервера строится на основе имен элементов, а тег сигнала формируется на основе наименований узлов высших уровней иерархии. Менять правила построения дерева настоятельно не рекомендуется, однако, если это необходимо, добавьте элементам дерева атрибут Имя узла в OPC. При изменении значений добавленных атрибутов будут меняться правила построения дерева сигналов.

Дерево имен сигналов, скорректированное с помощью атрибута Имя узла в OPC, используется для идентификации элементов.

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

Изменение значения атрибута Имя узла в OPC влияет на дерево сигналов следующим образом.

  • Переименование элемента. В качестве значения атрибута можно указать новое имя элемента. Однако мы не рекомендуем такой способ переименования элементов: лучше переименуйте сам элемент.
  • Группировка сигналов. Если в качестве значения атрибута, добавленного параметру, указать составное имя, разделенное точками, то последняя часть этого составного имени станет именем сигнала, а в дереве будут созданы папки, вложенность и имена которых будут соответствовать остальным частям указанного значения. Указав для нескольких параметров составное значение атрибута с одинаковым началом, можно сгруппировать сигналы этих параметров в папки.
  • Игнорирование имени сокета в дереве сигналов. Укажите пустое значение атрибута: так сигналы, описанные параметрами внутри этого сокета, окажутся непосредственно в папке объекта.
  • Сигнал как корневой узел объекта. Для того, чтобы дерево сигналов объекта начиналось не с папки, а с сигнала, нужно для параметра, описывающего этот сигнал, задать атрибут Имя узла в OPC со значением "." (точка).