Руководство пользователя по программированию ПЛК в CoDeSys 2.3

Подождите немного. Документ загружается.

Приложение С: Типы данных CoDeSys

CoDeSys V2.3 10-35

Пример инициализации части массива:

arr1 : ARRAY [1..10] OF INT := 1,2;

Не инициализированные явно элементы массива принимают значения по умолчанию. Так, в данном

примере оставшиеся элементы примут значение 0.

Доступ к элементам массива:

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

<Имя_массива>[Индекс1,Индекс2]

Пример:

Card_game [9,2]

Примечание: Если определить в проекте функцию с именем CheckBounds, вы сможете контролировать нарушение

диапазона индексов массивов в проекте.

Функция CheckBounds

Определив в проекте функцию с именем CheckBounds, вы сможете использовать её для контроля за со-

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

Пример функции CheckBounds:

FUNCTION CheckBounds : DINT

VAR_INPUT

index, lower, upper: DINT;

END_VAR

IF index < lower THEN

CheckBounds := lower;

ELSIF index > upper THEN

CheckBounds := upper;

ELSE CheckBounds := index;

END_IF

В этом примере CheckBounds ограничивает индекс массива заданными границами. Если запрашивается

элемент, отсутствующий в массиве, функция CheckBounds возвращает ближайший элемент.

Проверка работы функции CheckBounds:

PROGRAM PLC_PRG

VAR

a: ARRAY[0..7] OF BOOL;

b: INT:=10;

END_VAR

a[b] := TRUE;

Приложение С: Типы данных CoDeSys

CoDeSys V2.3 10-36

Внимание: Функция CheckBounds, содержащаяся в библиотеке Check.Lib, представляет собой пример реализации.

Прежде чем использовать эту библиотеку, убедитесь, что данная функция работает так, как нужно в

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

Указатели

Указатели позволяют работать с адресами переменных или функциональных блоков.

Синтаксис:

<Имя_указателя>: POINTER TO <Тип данных/Функциональный блок>;

Указатели применимы для всех базовых типов данных или функциональных блоков, включая опреде-

ляемые пользователем.

Адреса переменных и функциональных блоков можно получить во время исполнения программы при

помощи оператора ADR. Для обращения через указатель необходимо добавить оператор "^" (content)

после его имени.

Обратите внимание: Указатели инкрементируются побайтно! Для увеличения указателя, как это принято в C-

компиляторах, используйте инструкцию p=p+SIZEOF(p^);.

Пример:

pt:POINTER TO INT;

var_int1:INT := 5;

var_int2:INT;

pt := ADR(var_int1);

var_int2 := pt^; (* var_int2 теперь равна 5 *)

Функция CheckPointer:

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

Если определена функция CheckPointer, то она будет автоматически вызываться при любом обращении

через указатель. Функция должна быть определена в проекте (непосредственно или в библиотеке). Ее

имя (CheckPointer) изменять нельзя. Функция имеет следующие параметры:

Приложение С: Типы данных CoDeSys

CoDeSys V2.3 10-37

Для систем с 32-х битными указателями:

FUNCTION CheckPointer : DWORD

VAR_INPUT

dwAddress : DWORD;

iSize : INT;

bWrite: BOOL;

END_VAR

Для систем с 16-и битными указателями:

FUNCTION CheckPointer : WORD

VAR_INPUT

dwAddress : WORD;

iSize : INT;

bWrite: BOOL;

END_VAR

Приложение С: Типы данных CoDeSys

CoDeSys V2.3 10-38

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

будет входной параметр – dwAddress.

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

Перечисление - это определяемый пользователем тип данных, задающий несколько строковых

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

локальном его объявлении внутри POU. Поэтому наиболее разумно создавать все перечисления на

вкладке “Типы данных” (Data types) Организатора Объектов (Object Organizer). Объявление

должно начинаться с ключевого слова TYPE и заканчиваться строкой END_TYPE.

Синтаксис:

TYPE <Имя_перечисления>:(<Элемент_0> ,< Элемент _1>, ...< Элемент _n>);

END_TYPE

Переменная типа <Имя_перечисления> может принимать только перечисленные значения. При

инициализации переменная получает первое из списка значение. Если числовые значения элемен-

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

чиная с 0. Фактически элемент перечисления - это число типа INT и работать с ними можно точно

также. Можно напрямую присвоить число переменной типа перечисление.

Пример:

TYPE TRAFFIC_SIGNAL: (Red, Yellow, Green:=10); (*Каждому цвету

соответствует свое значение, для red - это 0, для yellow - 1 и для green - 10

END_TYPE

TRAFFIC_SIGNAL1 : TRAFFIC_SIGNAL;

TRAFFIC_SIGNAL1:=0; (*Переменная получила значение red*)

FOR i:= Red TO Green DO

i := i + 1;

END_FOR

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

Пример:

TRAFFIC_SIGNAL: (red, yellow, green);

COLOR: (blue, white, red);

Ошибка: попытка повторного использования элемента TRAFFIC_SIGNAL red в COLOR.

Структуры

Структуры создаются на вкладке “Типы данных” (Data types) Организатора Объектов (Object

Organizer). Объявление должно начинаться с ключевых слов TYPE и STRUCT и заканчиваться

строками END_STRUCT и END_TYPE.

Синтаксис:

TYPE <Имя _структуры>:

STRUCT

<Объявление переменной 1>

<Объявление переменной n>

END_STRUCT

Приложение С: Типы данных CoDeSys

CoDeSys V2.3 10-39

END_TYPE

<Имя _структуры> образует новый тип данных, который может быть использован в любой части

проекта наряду с базовыми типами.

Вложенные структуры допускаются. Единственное ограничение заключается в запрете размеще-

ния элементов структуры по прямым адресам (AT объявления недопустимы!).

Пример объявления структуры по имени Polygонлайн:

TYPE Polygонлайн:

STRUCT

Start:ARRAY [1..2] OF INT;

Point1:ARRAY [1..2] OF INT;

Point2:ARRAY [1..2] OF INT;

Point3:ARRAY [1..2] OF INT;

Point4:ARRAY [1..2] OF INT;

End:ARRAY [1..2] OF INT;

END_STRUCT

END_TYPE

Пример инициализации структуры:

Poly_1:polygонлайн := ( Start:=3,3, Point1 =5,2, Point2:=7,3, Point3:=8,5,

Point4:=5,7, End := 3,5);

Для доступа к элементам структуры используется следующий синтаксис:

<Имя_структуры>.<Имя_компонента>

Например, структура "Week" содержит компонент "Monday", обращение к которому будет выгля-

деть так:

Week.Monday

Псевдонимы типов

Псевдонимы типов нужны для создания альтернативных пользовательских наименований типов

данных. Это удобно при работе с большим числом однотипных констант, переменных и функцио-

нальных блоков.

Псевдонимы типов определены на вкладке “Типы данных” (Data types) Организатора Объектов

(Object Organizer). Объявление должно начинаться с ключевого слова TYPE и заканчиваться

строкой END_TYPE.

Синтаксис:

TYPE <Имя псевдонима>: <Исходное имя>;

END_TYPE

Пример:

TYPE message: STRING[50];

END_TYPE;

Ограничение диапазона значений

Ограничение диапазона позволяет объявить переменную, значения которой ограничены в опреде-

ленных пределах. Существует возможность создать в проекте новые типы данных с ограниченным

диапазоном значений либо задать диапазон непосредственно при объявлении переменной.

Приложение С: Типы данных CoDeSys

CoDeSys V2.3 10-40

Создание нового типа выглядит так:

TYPE < Имя > : < Целый тип > (<от>..<до>) END_TYPE;

< Имя> любой допустимый МЭК идентификатор,

<Целый тип> один из типов SINT, USINT, INT, UINT, DINT, UDINT, BYTE, WORD,

DWORD (LINT, ULINT, LWORD).

< от> константа, определяющая начало диапазона значений включительно.

< до> константа, определяющая конец диапазона значений включительно.

Пример:

TYPE

SubInt : INT (-4095..4095);

END_TYPE

Ограничение диапазона при объявлении переменной:

VAR

i : INT (-4095..4095);

ui : UINT (0..10000);

END_VAR

При попытке присвоить переменной с ограниченным диапазоном константы, не попадающей в за-

данный диапазон (например i := 5000;), CoDeSys даст сообщение об ошибке.

Для контроля значений «ограниченных» переменных в процессе исполнения применяются функ-

ции CheckRangeSigned или CheckRangeUnsigned. Они позволяют обрабатывать ошибки произ-

вольным образом. Например, ограничить присваиваемое значение или сформировать флаги ошиб-

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

(unsigned). Изменять идентификаторы этих функций нельзя.

Пример:

Здесь применяется функция CheckRangeSigned, контролирующая переменные со знаком (как, на-

пример, объявленная выше i). Функция «обрезает» присваиваемые значения по границам диапазо-

на.

FUNCTION CheckRangeSigned : DINT

VAR_INPUT

value, lower, upper: DINT;

END_VAR

IF (value < lower) THEN

CheckRangeSigned := lower;

ELSIF(value > upper) THEN

CheckRangeSigned := upper;

ELSE

CheckRangeSigned := value;

END_IF

Приложение С: Типы данных CoDeSys

CoDeSys V2.3 10-41

Функция вызывается автоматически при соответствующих операциях присваивания. Она получает

три параметра: присваиваемое значение (value) и обе границы диапазона (lower, upper).

Фактически присваивается возвращаемое CheckRangeSigned значение.

Например, при присваивании i:=10*y происходит неявный вызов:

i := CheckRangeSigned(10*y, -4095, 4095);

В результате, даже если y > 1000, i не получит значение более 4095.

Аналогично объявляется и функция CheckRangeUnsigned:

FUNCTION CheckRangeUnsigned : UDINT

VAR_INPUT

value, lower, upper: UDINT;

END_VAR

Замечание: Если функции CheckRangeSigned или CheckRangeUnsigned не включены в проект, ограничение

границ диапазонов во время исполнения работать не будет.

Внимание: Если функции «обрезают» значения, как в вышеописанном примере существует опасность

получить бесконечный цикл. Это может случиться, если условие окончания итераций цикла не

достигается из-за искусственного ограничения значений переменной!

Пример. Переменная ui не превысит 10000, и цикл FOR ни когда не закончится:

VAR

ui : UINT (0..10000);

END_VAR

FOR ui:=0 TO 10000 DO

...

END_FOR

Внимание: Функции CheckRange…, содержащащиеся в библиотеке Check.Lib, представляют собой пример

реализации. Прежде чем использовать эту библиотеку, убедитесь, что данные функции работает

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

проекте.

Приложение D: Библиотеки CoDeSys

CoDeSys V2.3 10-42

Приложение D: Библиотеки CoDeSys

Стандартная библиотека Standard.lib

Строковые функции

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

При одновременном вызове одной и той же строковой функции из нескольких параллельных

процессов возможно нарушение ее работы (перекрытие данных).

LEN

Возвращает длину строки.

Аргумент STR типа STRING, возвращаемое значение типа INT.

Пример IL:

LD 'SUSI'

LEN

ST VarINT1 (* Результат: 4 *)

Пример FBD:

Пример ST:

VarSTRING1 := LEN (‘SUSI’);

LEFT

Возвращает левую значимую часть строки заданной длины.

Входная строка STR типа STRING, размер SIZE типа INT, возвращаемое значение STRING.

LEFT (STR, SIZE) означает: взять первых SIZE символов от строки STR.

Пример IL:

LD 'SUSI'

LEFT 3

ST VarSTRING1 (* Результат ‘SUS’ *)

Пример FBD:

Пример ST:

VarSTRING1 := LEFT (‘SUSI’,3);

RIGHT

Возвращает правую значимую часть строки заданной длины.

Входная строка STR типа STRING, размер SIZE типа INT, возвращаемое значение STRING.

Приложение D: Библиотеки CoDeSys

CoDeSys V2.3 10-43

RIGHT (STR, SIZE) означает: взять последних SIZE символов от строки STR

Пример IL:

LD 'SUSI'

RIGHT 3

ST VarSTRING1 (*Результат: ‘USI’ *)

Пример FBD:

Пример ST:

VarSTRING1 := RIGHT (‘SUSI’,3);

MID

Возвращает часть строки с указанной позиции указанной длины.

Входная строка STR типа STRING, размер LEN и POS типа INT, возвращаемое значение STRING.

MID (STR, LEN, POS) означает: вырезать LEN символов из STR строки, начиная с POS.

Пример IL:

LD 'SUSI'

RIGHT 2,2

ST VarSTRING1 (* Результат: ‘US’ *)

Пример FBD:

Пример ST:

VarSTRING1 := MID (‘SUSI’,2,2);

CONCAT

Конкатенация (объединение) двух строк.

Обе входных строки STR1 и STR2 как и результат типа STRING.

Пример IL:

LD 'SUSI'

CONCAT ‘WILLI’

ST VarSTRING1 (* Результат: ‘SUSIWILLI’ *)

Пример FBD:

Пример ST:

VarSTRING1 := CONCAT (‘SUSI’,’WILLI’);

Приложение D: Библиотеки CoDeSys

CoDeSys V2.3 10-44

Обратите внимание: Функция CONCAT не работает при более чем 5 вложениях.

INSERT

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

Входные переменные STR1 и STR2 - типа STRING, POS - типа INT, возвращаемое значение -

строка STRING.

INSERT(STR1, STR2, POS) означает: вставить STR2 в STR1 в позиции POS.

Пример IL:

LD 'SUSI'

INSERT ‘XY’,2

ST VarSTRING1 (* Результат: ‘SUXYSI’ *)

Пример FBD:

Пример ST:

VarSTRING1 := INSERT (‘SUSI’,’XY’,2);

DELETE

DELETE удаляет часть строки с указанной позиции.

Входные переменные STR типа STRING, LEN и POS типа INT, возвращаемое значение строка

STRING.

DELETE(STR, L, P) означает: удалить L символов из STR, начиная с позиции P.

Пример IL:

LD 'SUXYSI'

DELETE 2,23

ST Var1 (* Результат: ‘SUSI’ *)

Пример FBD:

Пример ST:

Var1 := DELETE (‘SUXYSI’,2,3);

REPLACE

REPLACE заменяет часть строки другой строкой с указанной позиции заданной длины.

Входные переменные STR1 и STR2 типа STRING, LEN и POS типа INT, возвращаемое значение

строка STRING.