Описание языка ST в AgavaSCADA/AgavaPLC - История изменений

TaushkanovKV: /* Ограничения */

2026-08-11T10:59:38Z
Ограничения
TaushkanovKV: /* Арифметические операторы */

2026-08-11T10:47:38Z
Арифметические операторы
TaushkanovKV в 10:46, 11 августа 2026

2026-08-11T10:46:29Z
TaushkanovKV: Новая страница: «Данное описание содержит базовое руководство по созданию программ на языке `Structured Text<...»`


2026-08-11T10:44:40Z
Новая страница: «Данное описание содержит базовое руководство по созданию программ на языке <code>Structured Text<...»
Новая страница
Данное описание содержит базовое руководство по созданию программ на языке <code>Structured Text</code> (ST, IEC 61131-3) и их использованию в [[Универсальная среда разработки|среде разработки Agava]].



== Дополнительные документы ==



* [[Standard - стандартная библиотека|Стандартная библиотека IEC (iecstdlib)]].

* [[Основы AgavaScript|Основы синтаксиса AgavaScript]].

* [[Описание базовых классов AgavaSCADA/AgavaPLC]].

* [[Объектная модель AgavaSCADA/AgavaPLC]].



Вы также можете ознакомиться с другими документами, размещенными в [[:Категория:AgavaSCADA/AgavaPLC|категории AgavaSCADA/AgavaPLC]].



== Основы синтаксиса ==

Программа на ST состоит из объявлений (типы, переменные, POU) и операторов. Операторы завершаются точкой с запятой. Присваивание выполняется оператором <code>:=</code>, сравнение на равенство — оператором <code>=</code>.



 iCounter := iCounter + 1;

 bOk := (iCounter = 10);



=== Комментарии ===

Поддерживаются три вида комментариев:



 (* IEC-комментарий *)

 /* C-style комментарий */

 // комментарий до конца строки



== Единицы организации программ (POU) ==



=== PROGRAM ===

Программа — единица, вызываемая задачей/хостом. Локальные переменные секции <code>VAR</code> сохраняют значения между вызовами (ретенция в рамках скана/повторных вызовов).



 PROGRAM PumpCtrl

 VAR

     iState : INT := 0;

 END_VAR

     iState := iState + 1;

 END_PROGRAM



=== FUNCTION ===

Функция — подпрограмма без собственного «состояния» между вызовами (кроме локальных экземпляров FB). Тип результата указывается после имени; результат записывается в переменную с именем функции.



 FUNCTION Add : INT

 VAR_INPUT

     a : INT;

     b : INT;

 END_VAR

     Add := a + b;

 END_FUNCTION



 FUNCTION main : BOOL

 VAR

     r : INT;

 END_VAR

     r := Add(a := 2, b := 3);

     main := (r = 5);

 END_FUNCTION



Если тип результата опущен, функция соответствует <code>void</code> (ничего не возвращает).



=== FUNCTION_BLOCK ===

Функциональный блок — экземплярный тип со входами/выходами и внутренним состоянием. Экземпляр объявляется в секции переменных и вызывается как процедура.



 FUNCTION_BLOCK FB_Inc

 VAR_INPUT

     IN : BOOL;

 END_VAR

 VAR_OUTPUT

     Q : BOOL;

 END_VAR

 VAR

     bPrev : BOOL := FALSE;

 END_VAR

     Q := IN AND NOT bPrev;

     bPrev := IN;

 END_FUNCTION_BLOCK



 FUNCTION main : BOOL

 VAR

     fb : FB_Inc;

 END_VAR

     fb(IN := TRUE);

     main := fb.Q;

 END_FUNCTION



Внутри FB поддерживаются методы Codesys-стиля <code>METHOD … END_METHOD</code>.



== Переменные ==

Переменные объявляются в секциях <code>VAR*</code> / <code>VAR_GLOBAL</code> в виде:



 имя {, имя} : тип [:= начальное_значение];



 VAR

     a, b : INT := 0;

     sMsg : STRING := 'готово';

 END_VAR



=== Секции переменных ===

{| class="wikitable"

!Секция

!Назначение

|-

|<code>VAR</code>

|Локальные переменные

|-

|<code>VAR_INPUT</code>

|Входные параметры

|-

|<code>VAR_OUTPUT</code>

|Выходные параметры

|-

|<code>VAR_IN_OUT</code>

|Параметры «вход-выход» (по ссылке)

|-

|<code>VAR_TEMP</code>

|Временные локали PROGRAM (не сохраняются между вызовами)

|-

|<code>VAR_GLOBAL</code>

|Глобальные переменные compilation unit

|-

|<code>VAR CONSTANT</code> / <code>VAR_GLOBAL CONSTANT</code>

|Константы

|}



Модификаторы <code>RETAIN</code> / <code>PERSISTENT</code> в текущей реализации не поддерживаются (выдаётся предупреждение; объявление обрабатывается как обычный <code>VAR</code>).



=== Типы данных ===

==== Логический тип ====

{| class="wikitable"

!Тип ST

!Тип AS

!Значения

|-

|BOOL

|bool

|FALSE (0), TRUE (1)

|}



==== Целочисленные типы ====

{| class="wikitable"

!Тип ST

!Тип AS

!Диапазон (кратко)

|-

|SINT

|int8

|−128 … 127

|-

|INT

|int16

|−32 768 … 32 767

|-

|DINT

|int

|−2 147 483 648 … 2 147 483 647

|-

|LINT

|int64

|64-битное знаковое

|-

|USINT / BYTE

|uint8

|0 … 255

|-

|UINT / WORD

|uint16

|0 … 65 535

|-

|UDINT / DWORD

|uint

|0 … 4 294 967 295

|-

|ULINT / LWORD

|uint64

|64-битное беззнаковое

|}



==== Вещественные типы ====

{| class="wikitable"

!Тип ST

!Тип AS

|-

|REAL

|float

|-

|LREAL

|double

|}



Нетипизированный вещественный литерал (<code>1.5</code>) трактуется как <code>REAL</code>. Для <code>LREAL</code> используйте явный литерал: <code>LREAL#3.14159</code>.



==== Строки ====

{| class="wikitable"

!Тип ST

!Описание

|-

|STRING / STRING(n) / STRING[n]

|Строка (UTF-8). С размером — ограничение длины при присваивании

|-

|WSTRING / WSTRING(n) / WSTRING[n]

|Широкая строка (UTF-16)

|}



Строковые литералы заключаются в одинарные или двойные кавычки. Удвоение кавычки внутри строки экранирует её. Также поддерживаются escapes через <code>$</code> (например <code>$N</code>).



Функции работы со строками (<code>LEN</code>, <code>LEFT</code>, <code>RIGHT</code>, <code>MID</code>, <code>CONCAT</code>, <code>FIND</code> и др.) описаны в документе [[Standard - стандартная библиотека]].



==== Время и дата ====

Типы <code>TIME</code>, <code>TOD</code> (<code>TIME_OF_DAY</code>), <code>DATE</code>, <code>DT</code> (<code>DATE_AND_TIME</code>) и L-варианты представляются как <code>int64</code> (семантика OSCAT: TIME/TOD — миллисекунды; DATE/DT — секунды).



Литералы:

 T#50ms

 T#1h30m

 DATE#2025-01-01

 TOD#14:03:30

 DT#2025-11-19-14:03:30



==== Массивы ====

Объявление:



 ARR : ARRAY [0..9] OF INT;

 MATRIX : ARRAY [0..2, 0..2] OF REAL;



Индексация с учётом нижней границы объявления. Литерал инициализации:



 A : ARRAY [0..2] OF INT := [10, 20, 30];



==== Структуры ====

 TYPE Person :

 STRUCT

     name   : STRING;

     age    : INT;

     height : REAL;

 END_STRUCT

 END_TYPE



 VAR

     p1 : Person := (name := 'John', age := 30, height := 1.85);

 END_VAR



 p1.age := 31;



==== Перечисления ====

 TYPE TrafficLight : (Red := 1, Yellow := 2, Green := 3);

 END_TYPE



 VAR

     light : TrafficLight := TrafficLight#Red;

 END_VAR



Перечисление компилируется как целочисленный тип; доступ к значениям — через <code>Type#Enumerator</code>.



== Операторы ==



=== Присваивание и сравнение ===

{| class="wikitable"

!Оператор

!Символ

!Пример

!Операция

|-

|Присваивание

|:=

|x := y

|Присвоить y переменной x

|-

|Равно

|=

|x = y

|TRUE, если x равно y

|-

|Не равно

|&lt;&gt;

|x &lt;&gt; y

|TRUE, если x не равно y

|-

|Меньше

|&lt;

|x &lt; y

|TRUE, если x меньше y

|-

|Больше

|&gt;

|x &gt; y

|TRUE, если x больше y

|-

|Меньше или равно

|&lt;=

|x &lt;= y

|TRUE, если x ≤ y

|-

|Больше или равно

|&gt;=

|x &gt;= y

|TRUE, если x ≥ y

|}



=== Арифметические операторы ===

{| class="wikitable"

!Оператор

!Символ

!Пример

|-

|Сложение

|+

|x + y

|-

|Вычитание

|-

|x − y

|-

|Умножение

|*

|x * y

|-

|Деление

|/

|x / y

|-

|Остаток

|MOD

|x MOD y

|}



=== Логические и побитовые операторы ===

{| class="wikitable"

!Оператор

!Символ

!Примечание

|-

|НЕ

|NOT

|Для BOOL — логическое; для целых — побитовое

|-

|И

|AND / &amp;

|Для BOOL — логическое; для целых — побитовое

|-

|ИЛИ

|OR / |

|Для BOOL — логическое; для целых — побитовое

|-

|ИСКЛ. ИЛИ

|XOR

|Для BOOL — логическое; для целых — побитовое

|}



Сдвиги и ротации — стандартные функции IEC: <code>SHL</code>, <code>SHR</code>, <code>ROL</code>, <code>ROR</code> (см. [[Standard - стандартная библиотека]]).



=== Литералы ===

* Целые и вещественные: <code>42</code>, <code>3.14</code>, <code>1e-3</code>; допускается разделитель <code>_</code> в числах.

* Базированные: <code>2#1010</code>, <code>8#77</code>, <code>16#FF</code>.

* Типизированные: <code>DINT#0</code>, <code>REAL#1.5</code>, <code>BYTE#255</code>.

* BOOL: <code>TRUE</code>, <code>FALSE</code>.

* Доступ к биту: <code>dwordVar.3</code>.



== Условия ==



=== IF / ELSIF / ELSE ===

 IF iState = 0 THEN

     iState := 1;

 ELSIF iState = 1 THEN

     iState := 2;

 ELSE

     iState := 0;

 END_IF



=== CASE ===

 CASE selector OF

     0:

         result := 10;

     1, 3:

         result := 20;

     4..7:

         result := 30;

 ELSE

     result := 0;

 END_CASE



Ветки без «проваливания» (fall-through). При пересечении диапазонов выбирается первая подходящая ветка.



== Циклы ==



=== WHILE ===

 i := 0;

 WHILE i < 5 DO

     i := i + 1;

 END_WHILE



=== REPEAT ===

 i := 0;

 REPEAT

     i := i + 1;

 UNTIL i >= 5

 END_REPEAT



Тело <code>REPEAT</code> выполняется хотя бы один раз.



=== FOR ===

 FOR i := 0 TO 10 BY 2 DO

     sum := sum + i;

 END_FOR



<code>BY</code> опционален (по умолчанию +1). Для обратного счёта: <code>BY -1</code>.



=== EXIT и RETURN ===

* <code>EXIT;</code> — выход из ближайшего цикла.

* <code>RETURN;</code> / <code>RETURN expr;</code> — выход из функции (без выражения в FUNCTION возвращается переменная результата).



Оператор <code>CONTINUE</code> как statement не поддерживается; пропуск итерации оформляйте через <code>IF</code>.



== Вызовы функций и функциональных блоков ==



Позиционные и именованные аргументы:



 r := Add(2, 3);

 r := Add(a := 2, b := 3);



Для выходов FB/функций используется <code>=></code>:



 TestOUT(in1 := 15, iOut => intVal, bOut => boolVal);



Вызов экземпляра FB:



 ton1 : TON;

 ton1(IN := TRUE, PT := T#50ms);

 ton1();   (* повторный опрос с сохранённым состоянием *)



Опущенные входы FB сохраняют предыдущие значения экземпляра (поведение IEC / CoDeSys).



Стандартные FB (<code>TON</code>, <code>TOF</code>, <code>TP</code>, <code>RS</code>, <code>SR</code>, <code>CTU</code>, …) и функции IEC описаны в [[Standard - стандартная библиотека]].



== Связь с AgavaScript ==

{| class="wikitable"

!Тема

!Поведение

|-

|Файлы <code>.st</code>

|Компилируются ST-frontend

|-

|Имена IEC-функций

|В ST обычно в UPPER (<code>SIN</code>, <code>ABS</code>); в движке — lowercase (<code>sin</code>, <code>abs</code>)

|-

|Поля стандартных FB

|В UPPER (<code>IN</code>, <code>Q</code>, <code>PT</code>)

|-

|Host API Agava

|Доступен из ST без учёта регистра (<code>GetNodeValueAsFloat</code>, <code>StoreMessage</code>, …)

|-

|PROGRAM

|Локальный <code>VAR</code> сохраняется между вызовами

|}



== Ограничения ==

* Указатели (<code>POINTER TO</code>, <code>ADR</code>, оператор <code>^</code>) не поддерживаются.

* <code>RETAIN</code> / <code>PERSISTENT</code> — не поддерживаются (warning).

* <code>CONTINUE</code> как оператор цикла — не поддерживается.

* Нельзя переопределить зарегистрированную IEC-функцию с той же сигнатурой.

* <code>PROGRAM</code> нельзя использовать как экземплярный FB из другого POU.



== Пример ==

 FUNCTION_BLOCK FB_Counter

 VAR_INPUT

     CU : BOOL;

     R  : BOOL;

 END_VAR

 VAR_OUTPUT

     CV : INT;

     Q  : BOOL;

 END_VAR

     IF R THEN

         CV := 0;

     ELSIF CU THEN

         CV := CV + 1;

     END_IF

     Q := (CV >= 10);

 END_FUNCTION_BLOCK



 FUNCTION main : BOOL

 VAR

     fb : FB_Counter;

     i  : INT;

 END_VAR

     FOR i := 1 TO 10 DO

         fb(CU := TRUE, R := FALSE);

         fb(CU := FALSE, R := FALSE);

     END_FOR

     main := fb.Q AND (fb.CV = 10);

 END_FUNCTION



[[Категория:AgavaSCADA/AgavaPLC]]
Описание языка ST в AgavaSCADA/AgavaPLC - История изменений

TaushkanovKV: /* Ограничения */

TaushkanovKV: /* Арифметические операторы */

TaushkanovKV в 10:46, 11 августа 2026

TaushkanovKV: Новая страница: «Данное описание содержит базовое руководство по созданию программ на языке Structured Text<...»

TaushkanovKV: Новая страница: «Данное описание содержит базовое руководство по созданию программ на языке `Structured Text<...»`
