Alpha.Community

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

Добавление вычислений

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

  • исполняемая процедура;
  • формула сигнала;
  • файл динамической библиотеки.

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

  • параметрам, значение которых не задается пользователем (например, в Alpha.HMI);
  • параметрам, качество которых не задается коммуникационными модулями и т.п..

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

Пример: в элементе Обработчик события значение выходного сигнала вычисляется на основе множества входных сигналов. Если хотя бы один входной сигнал имеет плохое качество, то качество выходного сигнала будет плохим (88 – Значение вычислено из множества значений и не все из них имеют качество GOOD).

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

Исполняемая процедура

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

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

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

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

Чтобы добавить исполняемую процедуру:

  1. В объект/тип добавьте экземпляр элемента Обработчик события.
  2. Добавьте исходный код исполняемой процедуры одним из способов:

    • в редакторе исходного кода: открывается при переходе в элемент Обработчик события;
    • в свойстве Код обработки;
    • в окне Формулы.

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

    • входные сигналы – сигналы, значения которых используются в вычислениях.
    • выходные сигналы – сигналы, значения которых вычисляются при исполнении процедуры.

  3. Добавьте условия исполнения процедуры:

При изменении значений сигнала

  1. Свяжите параметр, описывающий сигнал, с экземпляром элемента Обработчик события, протянув связь от параметра к обработчику. Добавленный обработчик выделен красным, поскольку в нем ещё нет кода.
  2. В свойствах связи в параметре События укажите условия, при которых должен исполняться код:
    • Изменение значения – при изменении значения или качества сигнала.
    • Обновление значения – даже при полном повторе значения, качества и метки времени сигнала.
    • Любое изменение – даже при изменении только метки времени сигнала.
    • Подготовка сообщения – при изменении значения, качества или метки времени сигнала. Код будет выполнен до генерации события.

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

По таймеру

  1. Добавьте элемент Таймер.
  2. В свойствах укажите период срабатывания таймера в миллисекундах.
  3. Свяжите Таймер и Обработчик события.

По расписанию

  1. Добавьте элемент Расписание.
  2. В свойствах укажите cron-выражение, определяющее периодичность исполнения кода.
  3. Свяжите Расписание и Обработчик события.

Cron-выражение – строка, состоящая из 6 полей, разделённых пробелами:

Поле Значения
Секунды 0 – 59
Минуты 0 – 59
Часы 0 – 23
Число месяца 1 – 31
Месяц

JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC

1 – 12

День недели

SUN, MON, TUE, WED, THU, FRI, SAT

0 – 7 (значения 0 и 7 соответствуют воскресенью)

В каждом поле можно указать:

  • Одно значение – условие будет выполняться только для указанного в поле значения. Например, если в поле Часы указать 12, то условие будет выполняться в 12 часов.
  • * – условие будет выполняться для каждого значения. Например, если в поле Месяц указать *, то условие будет выполняться в любой месяц.
  • Несколько значений через запятую – условие будет выполняться для каждого из значений. Например, если в поле День недели указать SAT,SUN, то условие будет выполняться в субботу и воскресенье.
  • Диапазон значений через дефис – условие будет выполняться для каждого значения из диапазона. Например, если в поле День недели указать MON-FRI, то условие будет выполняться с понедельника по пятницу.
  • Диапазон значений с интервалом (интервал указывается через / после диапазона) – условие будет выполняться для значений в указанном диапазоне с заданным интервалом. Например, если в поле Число месяца указать 1-20/5, то условие будет выполняться с 1 по 20 числа месяца каждые 5 дней: 1, 6, 11, 16. Вместо диапазона можно указать *: в этом случае условие будет выполнено для всего диапазона значений. Например, если в поле Часы указать */3, то условие будет выполнено каждые 3 часа
  • ? – может быть указан в поле Число месяца или День недели и только в одном из них. Означает, что поле не используется в выражении, вместо него используется значение, указанное во втором поле. Например, чтобы условие выполнялось каждое 10 число месяца и неважно, какой это будет день недели, нужно в поле Число месяца указать 10, а в поле День недели – ?

Каждый день в 12:00:

0 0 12 * * ?

Каждый день в 23:59:59:

59 59 23 ? * *

Каждую минуту с 0:00 до 0:59 каждый день:

0 * 0 * * ?

В 12:00 в субботу и воскресенье:

0 0 12 ? * 6,7

В 0:00 с понедельника по пятницу:

0 0 0 ? * MON-FRI

Раз в час с 0:00 до 6:00:

0 0 0-6 * * ?

В воскресенье каждые 4 часа:

0 0 */4 ? * SUN

Каждый день с 3:00 до 3:30 каждые 2 минуты:

0 0-30/2 3 * * ?

Каждый год 31 декабря в 23:59:59:

59 59 23 31 DEC ?

Формула сигнала

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

Формулу можно использовать только для следующих типов сигналов:

  • переменная;
  • выходной параметр (параметр, у которого в свойстве Направление указано значение Выход).

Чтобы добавить формулу:

  1. Выберите сигнал, значение которого должно вычисляться.
  2. В окне Формулы задайте формулу, по которой должно вычисляться значение элемента:

    • формула должна быть написана на языке Alpha.Om.

    • формула должна описывать выражение, результат вычисления которого будет присвоен сигналу в качестве значения.
    • результат вычисления должен быть того же типа, что и тип значения сигнала, или неявно к нему приводиться.
    • формула должна содержать хотя бы один сигнал без оператора read1Если в формуле указать read перед именем сигнала, она не будет пересчитываться при изменениях значений этого сигнала.: в противном случае формула не будет запущена никогда.
    • в формуле можно использовать значение самого сигнала, значение которого вычисляется: формула не будет пересчитываться при изменении значения этого сигнала.

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

Файл динамической библиотеки

Данный способ описания вычислений предназначен для добавления в решение процедур и функций, реализованных в файлах динамических библиотек.

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

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

  1. Добавьте в решение элемент Внешняя функция.
  2. В свойстве Имя файла укажите путь к файлу динамической библиотеки.
  3. В свойстве Имя функции укажите имя функции, описанной в динамической библиотеке.

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

  4. В свойстве Тип возвращаемого значения укажите тип значения, возвращаемого указанной функцией.
  5. На образе элемента добавьте параметры функции.

    Для каждого параметра функции настройте его свойства:

    • Тип значения – тип данных параметра функции;
    • Направление – направление передачи параметра;
    • Имя – название параметра.