Alpha.Community

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

Генерация событий

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

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

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

При получении от ядра уведомления об изменении значения сигнала, модуль проверяет состояние условия/подусловия:

  • удовлетворяет ли измененное значение сигнала заданному условию/подусловию;
  • имеется ли разрешение на генерацию события по данному условию/подусловию.

Если удовлетворяет и есть разрешение, модуль генерирует событие в соответствии с заданными условием и подусловием/подусловиями.

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

Типы условий генерации событий

Модуль OPC AE Сервер поддерживает генерацию событий по следующим типам условий:

Перечисление (Enumeration)

События по перечислению генерируются в соответствии с идентификатором события, получаемым от стороннего источника данных (под сторонним источником подразумеваются любые источники данных сервера, которые реализованы вне модуля событий – любые коммуникационные модули, модуль вычислений и т.п.). Идентификатор содержит код подусловия, которое активируется и по которому формируется событие. Применяются при работе с числовыми типами данных: uint1, int1, uint2, int2, uint4, int4, uint8, int8, float, double.

Если получено значение 3, то выдать сообщение – Значение в норме, со звуковым сигналом из файла on.wav. Если получено значение 2, то выдать сообщение – Значение не пришло, без звукового сигнала. Если получено значение 1, то выдать сообщение – Значение не верно, со звуковым сигналом из файла err.wav.

При настройке звука события необходимо в ссылке на звуковой файл указывать расширение *.wav.

Настройка условия Перечисление:

Дискретное (Discrete)

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

Если состояние параметра изменилось с True на False, то выдать сообщение – Отключение объекта, со звуковым сигналом. Если состояние параметра изменилось с False на True, то выдать сообщение – Включение объекта, со звуковым сигналом.

Настройка условия Дискретное:

Динамическое (Dynamic)

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

Если произошла смена пользователя, то выдать сообщение Смена диспетчера.

Настройка условия Динамическое:

Модуль OPC AE Сервер предоставляет возможность указать источники данных для генерации событий со стороны

  • OPC DA клиента;
  • OPC UA клиента;
  • компонента Alpha.HMI, откуда значения источников передаются по внутреннему протоколу Alpha.Link.

Источниками выступают строковые сигналы типа string.

Чтобы сгенерировать событие с типом условия Динамическое, нужно последовательно выполнить следующие действия:

  1. Настроить генерацию событий для строкового параметра (тип данных string), как указано в примере.
  2. В значение строкового параметра записать XML-конструкцию вида:

    <Subcondition Type="Dynamic" Message="DynMessage" Sound="snd.wav" Severity="100" Enabled="1" SoundEnabled="1" />

    Значения атрибутов, указанные в конструкции, переопределяют значения атрибутов событий, указанных в настройках Alpha.DevStudio. Для сохранения значений, указанных в настройках Alpha.DevStudio, достаточно исключить выбранные атрибуты из конструкции. Если требуется сохранить все настройки, включая текст сообщения, в значение строкового параметра следует записать пустую XML-конструкцию:

    <Subcondition />

По уровню (Level)

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

Применяются при работе с числовыми типами данных: uint1, int1, uint2, int2, uint4, int4, uint8, int8, float, double.

Значение параметра, который отвечает за уровень загрузки процессора, должен находиться в четырёх пределах. Все возможные значения параметров от устройства могут быть в диапазоне от 0 до 100: 0 - нормальное значение, 100 - аварийное значение. Это означает, что для генерации событий будут использоваться 4 типа подусловий типа Above. Сообщение пользователю будет генерироваться, только если полученное значение параметра попадет в один из указанных пределов. Однако, если от устройства придет повторное значение, не выходящее за текущий предел, то повторного сообщения клиентам не поступит. Например, если полученное значение изменилось с 55 до 65, то сообщения клиент не получит.

Настройка условия По уровню:

Отклонение (Deviation)

События с предельным отклонением содержат два независимых подусловия: Вверх и Вниз. Подусловия активируются при соответствующем изменении значения параметра. Применяются при работе с числовыми типами данных: uint1, int1, uint2, int2, uint4, int4, uint8, int8, float, double.

Если произошло резкое повышение текущего значения на 5, то выдать сообщение – Предельное отклонение вверх. Если произошло резкое понижение текущего значения на 10, то выдать сообщение – Предельное отклонение вниз.

Предельное отклонение считается от текущего значения, не от начального.

Настройка условия Отклонение:

Внешние события (BACnetEventState)

Для внешних событий используются три типа подусловий – Normal, Fault, Offnormal:

  • Normal – подусловие, которое выполняется, если состояние объекта – нормальное. При этом Normal – деактивирующее подусловие (подусловие, переход в которое вызывает псевдоактивацию – активацию и сразу деактивацию). Если текущее состояние внешнего объекта-источника событий – Normal, то при запросе текущего состояния объекта состояние по нему получено не будет;
  • Fault – подусловие, которое выполняется, если состояние объекта – аварийное;
  • Offnormal – подусловие, которое выполняется, если состояние объекта – не в норме.

Текст сообщения и важность (приоритет) – опциональные настройки: если они заданы в конфигурации, то будут использованы при формировании события по подусловию. Если не заданы, то используются текст сообщения и важность, полученные от устройства.

Применяется при работе с любым типом данных: bool, uint1, int1, uint2, int2, uint4, int4, uint8, int8, float, double, string.

Если состояние объекта во внешней модели изменилось на не в норме или аварийное, то выдать соответствующие сообщения, сконфигурированные в устройстве BACnet.

Настройка условия Внешние события:

Состояния условий/ подусловий

Существуют следующие состояния условий/подусловий генерации событий:

  1. По наличию разрешения на генерацию события по данному условию/ подусловию:

    • включено: генерация события разрешена (переход в данное условие/подусловие возможен);
    • выключено: генерация события не разрешена (переход в данное условие/подусловие невозможен).

    Включить/выключить генерацию по условию у параметра можно как на уровне параметра, так и на уровне объекта, которому принадлежит параметр.

    Включить/выключить генерацию для подусловия у параметра можно только на уровне параметра.

  2. По характеру уведомления об изменении значения сигнала;

    • активное: значение сигнала удовлетворяет некоторому подусловию;
    • не активное: значение сигнала не удовлетворяет ни одному из подусловий.

    Переход условия в состояние активное происходит, если очередное изменение значение сигнала удовлетворяет хотя бы одному из подусловий данного условия (подусловие активируется). OPC AE клиент в этом случае получает сообщение о событии активации.

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

    Переход подусловия в состояние не активное может происходить принудительно при активации следующего подусловия, если в настройках модуля OPC AE Сервер параметр Использовать расширения OPC AE имеет значение Да.

  3. По состоянию подтверждения получения сообщения о событии от клиента:

    • квитированное: подтверждение выполнено;
    • не квитированное: подтверждение не выполнено.

    Переход условия/подусловия в состояние квитированное происходит при ручном квитировании сообщения о событии на стороне клиента или при автоматическом квитировании события на стороне сервера.

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

Атрибуты условий и подусловий генерации событий

При настройке условий генерации событий с помощью Alpha.DevStudio значения параметров настройки записываются в атрибуты события для сигнала-источника. Значения атрибутов определяют то, каким будет поведение сервера при возникновении события и какие значения примут параметры генерируемого сообщения о событии. Атрибуты события имеют вид json-представления.

Cобытия, генерируемые модулем OPC AE Сервер.

Внешние события, полученные от устройств BACnet.

В структуре json-представления присутствуют следующие обязательные записи:

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

Атрибуты условий генерации событий

Атрибут Тип данных Описание Обязательность

IsEnabled

bool

Разрешение генерации сообщений по условию:

  • true – генерация разрешена;
  • false – генерация запрещена.
Обязательный атрибут.
Type string

Тип условия генерации событий:

  • Enumeration – для типа условия Перечисление;
  • Discrete – для типа условия Дискретное;
  • Dynamic – для типа условия Динамическое;
  • Level – для типа условия По уровню;
  • Deviation – для типа условия Отклонение;
  • BACnetEventState – для типа условия Внешние события.
Обязательный атрибут.

Атрибуты подусловий генерации событий

Атрибут Тип данных Описание Обязательность

AckRequired

variant

Режим квитирования, определяющий необходимость ручного квитирования и поведение сервера при наличии событий в активном состоянии:

  • 0 – квитирование не требуется, событие квитируется сервером автоматически;
  • 1 – требуется ручное квитирование;
  • 2 – последнее активное подусловие будет квитировано автоматически при активации нового подусловия, если на момент активации нового подусловия оно не было квитировано вручную.

Подусловие AckRequired в json-представлении атрибутов события имеет наименование AckStrategy. Однако при настройке динамических событий следует использовать наименование AckRequired.

Необязательный атрибут. Если атрибут отсутствует, используется значение по умолчанию 1.
AckTimeout uint64

Ограничение времени квитирования подусловия генерации сообщения о событии в секундах.

Игнорируется, если атрибут AckRequired имеет значение 0 (квитирование не требуется).

Учитывается, если атрибут AckRequired отсутствует или имеет значение 1 или 2. При этом, чтобы работал механизм квитирования с ограничением по времени, атрибут AckTimeout не должен иметь отрицательное значение или 0.

Необязательный атрибут. Если атрибут отсутствует и при этом не требуется ручное квитирование, то работает режим квитирования без ограничения по времени.
GenerationDelay uint64

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

В режиме резервирования при использовании в Alpha.Server модели исполнения по умолчанию специальной синхронизации состояния таймера задержки для резервной пары не выполняется. Поэтому при переходе резервного сервера в режим РАБОТА в период работы таймера задержки возможно незначительное смещение времени генерации события относительно запланированного.

Задержка генерации события не может быть настроена для внешних событий.

Необязательный атрибут. Если атрибут отсутствует, то используется значение по умолчанию 0 и события генерируются без задержки.
IsDeactivation bool

Признак деактивирующего подусловия:

  • 0 – активирующее подусловие (значение по умолчанию);
  • 1 – деактивирующее подусловие.

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

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

Необязательный атрибут. Если атрибут отсутствует, то используется значение по умолчанию 0 и подусловие работает как активирующее.
IsEnabled bool

Разрешение генерации сообщений по подусловию:

  • true – генерация разрешена;
  • false – генерация запрещена.

Если флаг имеет значение false, то при наступлении события от технологического объекта модуль не генерирует сообщение о событии, но для предыдущего активного подусловия записывает время деактивации (заполняется атрибут DeactivationTime в последнем сообщении о событии по подусловию).

Обязательный атрибут.
IsGenerateEqualSubcondition bool

Разрешение повторной генерации сообщения о событии по активному подусловию:

  • true – повторная генерация разрешена;
  • false – повторная генерация не разрешена.

Если повторная генерация разрешена, то при переходе сервера из состояния Резерв в активное состояние выполняется повторная генерация сообщения о событии для данного активного подусловия.

Значение по умолчанию для этого атрибута зависит от принадлежности подусловия к условию:

  • для условия типа Перечисление – true;

  • для условия типа Дискретное – false;

  • для условия типа Динамическое – true;
  • для условия типа По уровню – false;

  • для условия типа Отклонение – true;

  • для условия типа Внешние события – true.

Значения по умолчанию можно изменить для следующих типов условий:

  • Перечисление;
  • Дискретное;
  • По уровню;
  • Отклонение.

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

  • Перечисление;
  • Дискретное;
  • По уровню;
  • Отклонение.

Message

string

Сообщение, содержащее информацию о событии, с указанием конкретного экземпляра оборудования и/или действия, с которым связано событие.

Если у объекта, в котором сконфигурировано подусловие, есть родительские объекты и для родительских объектов задано описание, то текст атрибута Message, заданный на уровне подусловия, конкатенируется (объединяется) с описаниями родительских объектов.

Правила формирования значения атрибута Message.

Конфигурация сервера содержит объекты Valves, Valve_1 и сигнал положения задвижки ValvePosition:

  • Valves
    • Valve_1
      • ValvePosition

Cписок условий, подусловий и сообщений настроен для ValvePosition.

Если описание объекта Valves - Положение задвижки: , описание объекта Valve_1 - Задвижка 1: , а атрибут Message для ValvePosition содержит текст --в движении, то текст сообщения в данном случае следующий:

Положение задвижки: Задвижка 1: --в движении.

В случае, когда для подусловия используется тип квитирования с ограничением по времени (атрибут AckTimeout указан и имеет значение больше 0) и событие переходит в состояние не квитированное по истечении заданного таймаута, к значению атрибута Message в сообщении вновь сгенерированного события добавляется текст повторное.

Обязательный атрибут.
Severity uint64 Важность (приоритет) события.

Возможны значения от 1 до 1000. Распределение уровня важности по диапазону значений приведено в таблице ниже. С увеличением значения уровень важности подусловия повышается.

ВажностьДиапазон значений
Высокаяот 801 до 1000
Умеренно высокаяот 601 до 800
Средняяот 401 до 600
Умеренно низкаяот 201 до 400
Низкаяот 1 до 200
Обязательный атрибут.
Sound string

Звуковой файл, исполняемый при выполнении подусловия. Файл должен иметь расширение *.wav и располагаться в папке с конфигурационными файлами того ОРС AE клиента (например, Alpha.HMI.Alarms), которым предполагается просматривать сообщения о событиях . Допускается указывать несколько звуковых файлов через запятую для последовательного воспроизведения. В ссылке на звуковой файл необходимо указывать расширение. Допускается оставить значение пустым, если предполагается генерация сообщения о событии без звукового сопровождения.

Необязательный атрибут.
Type string

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

  1. Для условия типа Перечисление (Enumeration): Enumeration.

  2. Для условия типа Дискретное (Discrete):

    • On;
    • Off.
  3. Для условия типа Динамическое (Dynamic): Dynamic.
  4. Для условия типа По уровню (Level):

    • Above – подусловие, которое выполняется, если значение параметра больше или равно указанному значению;
    • Below – подусловие, которое выполняется, если значение параметра меньше или равно указанному значению;
    • Normal – подусловие, которое выполняется, если не активно ни одно из подусловий типов Above, Below.
  5. Для условия типа Отклонение (Deviation):

    • Up;
    • Down.
  6. Для условия типа Внешние события (BACnetEventState):

    • Normal – подусловие, которое выполняется, если состояние объекта нормальное. Деактивирующее подусловие;
    • Fault – подусловие, которое выполняется, если состояние объекта аварийное;
    • Offnormal – подусловие, которое выполняется, если состояние объекта не в норме.
Обязательный атрибут.
Value int64

Значение сигнала, необходимое для выполнения подусловия.

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

  • Перечисление;
  • По уровню;
  • Отклонение.

Атрибуты сообщений о событиях

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

Стандартные атрибуты

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

  • Source – полное имя тега объекта-источника события;
  • Time – время генерации сообщения о событии;
  • EventCategory – категория события – коды категорий событий:
    • 0 – Discrete;
    • 1 – Enumeration;
    • 2 – Dynamic;
    • 3 – Level;
    • 4 – Deviation;
    • 7 – Foreign.
  • Type– тип события. Существуют следующие типы событий:
    • Discrete;
    • Enumeration;
    • Dynamic;
    • Level;
    • Deviation;
    • BACNetEventState.
  • Severity – приоритет (важность) данного события;
  • Message – сообщение - текст, который описывает событие;
  • ConditionName – имя условия генерации события;
  • SubConditionName – имя подусловия генерации события;
  • ChangeMask – побитовая маска изменений – значение, которое указывает на то, какие свойства условия генерации событий изменились и, тем самым, вызвали сервер для отправки сообщения о событии. При изменении одного из свойств атрибут имеет следующие значения:

    • 1 – активация события (для новых событий всегда устанавливается только это значение);
    • 2 – квитирование события;
    • 4 – изменение состояния разрешения генерации события;
    • 8 – изменение качества значения;
    • 16 – изменение важности события;
    • 32 – изменение подусловия;
    • 64 – изменение сообщения;
    • 128 – изменение атрибута события.
  • NewState – индикатор нового состояния условия. Отражает новые значения свойств условий: состояния активности, состояния разрешения и состояния квитирования. В зависимости от значений свойств условий атрибут принимает следующие значения:

    • 1 – событие неактивно и неквитировано;
    • 3 – событие активно и неквитировано;
    • 5 – событие неактивно и квитировано;
    • 7 – событие активно и квитировано.
  • ConditionQuality – качество условия, показывает качество основных элементов данных, на которых это условие основывается;
  • AckRequired – требование квитирования – параметр, определяющий требуется ли подтверждение от клиента о получении сообщения о событии:

    • 0 – не требуется;
    • 1 – требуется;
    • 2 – требуется, но если событие не было подтверждено клиентом на момент наступления следующего события по новому подусловию, то оно подтверждается автоматически.
  • ActiveTime – время перехода состояния события в активное;
  • Cookie – служебная информация о событии, часть идентификатора сообщения о событии;
  • ActorID – идентификатор ОРС клиента, который квитирует событие. В случае автоматического квитирования модулем атрибут содержит значение System.

Типы атрибутов соответствуют спецификации OPC AE (Alarms & Events).

Дополнительные атрибуты

Дополнительные атрибуты, которые доступны для просмотра в ОРС АЕ клиенте:

  • ValueAttribute – признак блокирования событий:

    • false – блокирование отсутствует;
    • true – блокирование активно.
  • Sound – имя звукового файла, исполняемого при выполнении подусловия генерации события;
  • AckComment – комментарий, автоматически генерируемый сервером при квитировании. Если квитирование не требуется (AckRequired = 0), то при автоматическом квитировании атрибут содержит значение Сообщение квитировано системой. При использовании режима квитирования с ограничением по времени (AckTimeout > 0 и требуется ручное квитирование) атрибут содержит сообщение о сбросе квитирования - Время квитирования истекло.
  • AreaPath – зона, которой принадлежит источник события;
  • ObjectID – идентификатор объекта, которому принадлежит источник события;
  • SuppressedAttribute - признак подавления событий:

    • false – подавление отсутствует;
    • true – подавление активно, бессрочно;
    • число в формате uint64_t – подавление активно до соответствующей метки времени.
  • ObjectName – имя объекта, которому принадлежит источник события;
  • PrevActivationTime – время активации (перехода в активное состояние) предыдущего подусловия на стороне источника события;
  • DeactivationTime – время деактивации (перехода в неактивное состояние) подусловия на стороне источника события.

Типы атрибутов соответствуют спецификации OPC AE (Alarms & Events).