Alpha.Community

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

Возможности языка Alpha.Om в сигнальной модели

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

Относительная адресация в сигнальной модели

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

  • me – указатель на текущий сигнал;
  • @N – обращение к N-му уровню дерева выше текущего сигнала:

    • @0 – аналогично me, т.е. текущий сигнал
    • @1 – родительский узел дерева
    • @2 – родитель родителя

Пусть в дереве существует сигнал. Его полный тег: AK.DMN.LU1.NPS1.TANK1.SW1.State. Тогда:

  • me – сам сигнал: AK.DMN.LU1.NPS1.TANK1.SW1.State
  • @1 – родительский узел дерева: AK.DMN.LU1.NPS1.TANK1.SW1
  • @2 – "прыжок" на два уровня вверх (родитель родителя): AK.DMN.LU1.NPS1.TANK1
  • @3 – "прыжок" на три уровня вверх: AK.DMN.LU1.NPS1.

$ - символ «доллар» применяется в ситуациях, когда тег сигнала противоречит стандартным правилам написания (наличие пробелов или запрещенных символов). Символ "$" указывает компилятору, что написанная после него строка (заключенная в двойные кавычки) является путем до сигнала в иерархии дерева.

//В теге сигнала содержатся пробелы, нужно использовать $
X: uint1 = $"Уровень 1.Уровень 2.Уровень 3.Статус задвижки";

Работа с сигнальными свойствами

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

  • по имени:

    AKM.Signal.Description
  • по номеру:

    AKM.Signal.$"101"
  • Свойство должно существовать
  • Обращение по имени доступно только для именованных свойств
  • Для записи доступны только свойства из диапазона 5100-5108

Использование свойства Description (101) в качестве аргумента функции:

Str.SubString(sig.$"101", 2)

Влияние различных операций на сопутствующую информацию

Каждый сигнал дерева в модуле вычислений представлен объектом с сопутствующей информацией:

  • Value – значение
  • Quality – качество
  • Timestamp – метка времени

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

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

    • 200 (OPC_QUALITY_CALCULATED) – если качество всех аргументов достоверное (>=192) и не возникло переполнений;
    • 88 (OPC_QUALITY_SUBNORMAL) – если качество хотя бы одного из аргументов недостоверное (<192) и не возникло переполнений;
    • 84 (OPC_QUALITY_EGU_EXCEEDED) – если в результате операции зафиксировано переполнение
  • Правила вычисления метки времени:

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

VQT-функции

VQT-функции изменяют значение (Value), качество (Quality) и метку времени (Timestamp):

  • VQ

    Изменяет значение и качество сигнала, метка времени не изменяется

    <Путь до сигнала> = VQ(Value, Quality)
  • VT

    Изменяет значение и метку времени сигнала, качество не изменяется

    <Путь до сигнала> = VT(Value, Timestamp)
  • VQT

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

    <Путь до сигнала> = VQT(Value, Quality, Timestamp)

Параметры:

Параметр Тип Описание
Value Тип параметра должен совпадать с типом сигнала или неявно к нему приводиться Новое значение сигнала
Quality uint4 Новое качество сигнала
Timestamp uint8 Новая метка времени сигнала

Установить значение и качество

Level1.Level2.Signal = VQ(65536,192);

Установить значение и качество логического сигнала

Level1.Level2.Enabled = VQ(true, 192);

Установить значение и метку времени

Level1.Level2.Signal = VT(50, 130004837290000000);

Установить значение и метку времени строкового сигнала

Level1.Level2.Str = VT("Message", 130004837290000000);

Установить сигналу значение, метку времени и качество

Level1.Level2.Signal = VQT(90,145,131207739510000000);

Оператор commit

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

Синтаксис оператора в общем виде:

<Блок обработки сигналов>
commit X=Y

Где X=Y – финальная операция присваивания и фиксации в ядро, выполняемая в последнюю очередь.

Без оператора commit:

AK.DMN.Counter1 = 0; //присваиваем значение сигналу
while(AK.DMN.Counter1<10)
{
  AK.DMN.Counter1 += 1;  //увеличиваем значение сигнала
}
//Цикл сделает 10 итераций
//Но в сигнал AK.DMN.Counter1 запишется только финальное значение = 10

C оператором commit:

AK.DMN.Counter2 = 0; //присваиваем значение сигналу
while(AK.DMN.Counter2<10)
{
  commit AK.DMN.Counter2 += 1; //увеличиваем значение сигнала и фиксируем в ядро
}
//За время работы цикла значение сигнала будет изменено 10 раз (от 1 до 10)