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

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

Редакторы

CoDeSys

CoDeSys V2.3 5-9

Если выбран тип данных ARRAY, то появиться диалог для ввода границ массива.

Диалог задания границ массива при автоматическом объявлении переменных

Для каждого из трех возможных индексов массива (столбец Разм. - Dim.) можно вводить началь-

ный (Start) и конечный (End) индекс соответствующего измерения массива. Тип элементов массива

вводится в поле “Тип” (Type). При этом удобно использовать Ассистент ввода (Input Assistant), ко-

торый вызывается при нажатии кнопки .

После закрытия этого диалога объявленная переменная появится в поле “Тип” (Type).

Пример: ARRAY [1..5, 1..3] OF INT.

В поле “Начальное значение” (Initial Value) вы можете задать начальное значение переменной.

Если переменная это массив или структура, вы можете открыть специальный диалог, нажав кнопку

или <F2>.

Для массива такой диалог представляет собой список элементов; при щелчке мышкой после надпи-

си “:=” появляется поле для ввода начального значения элемента.

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

каждого элемента находятся в скобках. При щелчке мышкой после надписи “:=” появляется поле

для ввода начального значения элемента. Если компонента структуры – массив, то, чтобы увидеть

его элементы, щелкните мышкой на знаке "плюс" перед именем массива. Теперь начальные значе-

ния элементов этого массива можно редактировать.

После закрытия диалога начальные значения элементов массива или структуры изображаются в

поле Initial value в соответствии со стандартом МЭК.

Пример: x:=5,field:=2,3,struct2:=(a:=2,b:=3)

В поле “Адрес” (Address) задается адрес переменной (объявление AT)

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

нажатием сочетания клавиш <Ctrl>+<Enter>.

После нажатия кнопки OK переменная будет объявлена в соответствующем разделе объявлений.

Примечание: Диалог объявления переменной можно также вызвать командой 'Правка' 'Авто объявление'

('Edit' 'Auto Declare'). Если в режиме Онлайн курсор стоит на имени переменной, то можно вызвать

окно Autodeclare <Shift><F2> для просмотра деталей объявления данной переменной.

Номера строк в редакторе объявлений.

В режиме оффлайн, щелкнув по номеру строки, можно выделить строку целиком.

Редакторы

CoDeSys

CoDeSys V2.3 5-10

В режиме Онлайн, щелкнув по номеру строки, можно установить новое значение переменной или,

если это сложная переменная, просмотреть ее поля.

Объявление переменных в виде таблицы

Если установлен флаг “Объявления таблицей” (Declarations as tables) в опциях проекта (катего-

рия Редактор - Editor) или в контекстном меню, во время работы в редакторе объявлений, то раз-

дел объявлений будет выглядеть как таблица. В таблице можно выбирать вкладки, отвечающие за

классы переменных (локальные, глобальные и т.д.), и редактировать переменные.

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

Name: Имя переменной

Address: Адрес переменной (объявление AT), если он нужен.

Type: Тип переменной. (При создании экземпляра функционального блока введите имя

функционального блока)

Initial: Начальное значение переменной (вводится после “:=”)

Comment: Комментарии

Оба типа редактора объявлений можно переключать без всяких проблем. В режиме Онлайн редак-

тор всегда выглядит как обычно.

Порядок сортировки объявлений в таблице:

Для изменения порядка сортировки объявлений в таблице установите курсор на левую колонку с

номерами строк и дайте соответствующую команду в контекстном меню:

“Сортировать по имени” (Sort by name): сортировка строк в алфавитном порядке по именам

идентификаторов в колонке ‘Name’.

“Сортировать по адресу” (Sort by address): сортировка строк в соответствии с адресами в колонке

‘Address’.

“Сортировать по типу” (Sort by type): сортировка строк в алфавитном порядке сгруппированных

по типам данных в колонке’Type’.

“В порядке ввода” (Original order): строки отображаются так, как они были введены.

Редактор объявлений в виде таблицы

“Вставка” “Новое объявление” (“Insert” ” New declaration”)

С помощью этой команды вы можете добавить новую переменную в таблицу редактора объявле-

ний. Если курсор находится в каком-либо поле таблицы, то новая переменная помещается в преды-

дущую строку, иначе новая переменная помещается в конец таблицы. Кроме того, вы можете доба-

вить новую переменную в конец таблицы, если нажмете TAB или клавишу «Направо» в последнем

поле таблицы.

По умолчанию вы получите переменную с именем “Name”, которое записано в поле Name, и с ти-

пом “Bool” в поле Type.

Редакторы

CoDeSys

CoDeSys V2.3 5-11

Вы должны поменять значение этих полей на те, которые вам нужны. Имя и тип переменной – это

все, что необходимо для объявления переменной.

Редактор раздела объявлений в режиме Онлайн

В режиме Онлайн редактор раздела объявлений превращается в окно монитора. В каждой строке

находится переменная и ее значение после знака “=”. Если значение переменной не определено, то

после знака “=” находятся 3 знака вопроса. Для функциональных блоков изображаются значения

только его открытых экземпляров (команда "Проект" "Просмотр экземпляра" - "Project" "View

instance").

Перед каждой составной переменной находится знак плюс. Если нажать <Enter> или дважды щелк-

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

ной. Переменная закрывается аналогичным образом.

Нажмите <Enter> или дважды щелкните мышкой на простой переменной. Появится диалоговое ок-

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

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

противоположное.

Новое значение переменной обозначается красным цветом. Записать измененные значения пере-

менных в контроллер можно, выбрав команду меню “Онлайн” “Записать значения” (“Online”

”Write values”). После этого переменная вновь будет обозначаться черным.

После использования команды “Онлайн” “Фиксировать значения” (“Online” “Force values”) все

выбранные переменные получат установленные значения и будут сохранять их вплоть до вызова

команды “Освободить фиксацию” (Release force). Фиксированные значения отображаются крас-

ным.

Директивы компилятора

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

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

Директива записывается в фигурных скобках, причем регистр букв здесь не важен:{<Директива >}

Если компилятор не понимает эту директиву, то она интерпретируется как обычный комментарий.

Однако появляется предупреждение: „Ignore compiler directive ‚<Instruction text>’!“

В зависимости от типа и параметров директивы она действует на строке, на которой она написана,

или на всех последующих строках до директивы, ее отменяющей. Если отменяющей директивы нет,

то она действует во всем разделе.

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

скобки должны находиться на одной строке.

В настоящее время CoDeSys принимает следующие директивы:

− {flag} инициализация, мониторинг и управление символьным файлом

− {bitaccess...} битовый доступ

− {link} принудительная линковка POU или DUT

Редакторы

CoDeSys

CoDeSys V2.3 5-12

− {parameter..}, {template...}, {instance...} создание вхождений для Менеджера параметров

− {library ...} управление отображением объявлений в библиотеках

− {nonpersistent} исключение данных из PERSISTENT

Директивы инициализации, мониторинга и управления символьным файлом

Синтаксис директивы:

{flag [<flags>] [off|on]}

<flag> - комбинация следующих флагов:

noinit Переменная не инициализируется

nowatch Не производится мониторинг переменной

noread Переменная экспортируется в символьный файл без разрешения чтения

nowrite Переменная экспортируется в символьный файл без разрешения записи

noread, nowrite

Переменная не экспортируется в символьный файл

С помощью модификатора “on”директива включается и действует на все последующие объявления

до ее отключения другой директивой или с помощью ”off” {flag off}. Без этих модификаторов ди-

ректива действует только на текущей строке.

Примеры:

Инициализация и мониторинг:

Переменная a не инициализируется и не просматривается. Переменная b не инициализируется:

VAR

a : INT {flag noinit, nowatch};

b : INT {flag noinit };

END_VAR

VAR

{flag noinit, nowatch on}

a : INT;

{flag noinit on}

b : INT;

{flag off}

END_VAR

Ни одна из переменных не инициализируется:

{flag noinit on}

VAR

a : INT;

b : INT;

END_VAR

{flag off}

VAR

{flag noinit on}

a : INT;

b : INT;

{flag off}

END_VAR

Размещение переменных в символьном файле:

Флаги “noread” и ”nowrite” используются для ограничения прав доступа к переменным. По умолча-

нию переменная обладает теми свойствами доступа, которые определены для POU, в котором она

Редакторы

CoDeSys

CoDeSys V2.3 5-13

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

не экспортируется.

Пример:

Если для POU установлено разрешение записи и чтения переменных, то переменная a экспортиру-

ется с разрешением записи, а переменная b не экспортируется вообще:

VAR

a : INT {flag noread};

b : INT {flag noread, nowrite};

END_VAR

VAR

{ flag noread on}

a : INT;

{ flag noread, nowrite on}

b : INT;

{flag off}

END_VAR

Ни переменная a, ни переменная b не экспортируются в символьный файл:

{ flag noread, nowrite on }

VAR

a : INT;

b : INT;

END_VAR

{flag off}

VAR

{ flag noread, nowrite on}

a : INT;

b : INT;

{flag off}

END_VAR

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

Пример: (Для всех POU установлено разрешение записи и чтения переменных)

a : afb;

...

FUNCTION_BLOCK afB

VAR

b : bfb {flag nowrite};

c : INT;

END_VAR

...

FUNCTION_BLOCK bfB

VAR

d : INT {flag noread};

e : INT {flag nowrite};

END_VAR

Переменные a, c экспортируются с разрешением чтения и записи.

Переменные b, e экспортируются без разрешения записи.

Переменная d экспортируется без разрешения чтения.

Директива битового доступа {bitaccess...}

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

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

интеллектуального ввода и разделах объявлений. Директива влияет на мониторинг переменной в

Редакторы

CoDeSys

CoDeSys V2.3 5-14

ввода и разделах объявлений. Директива влияет на мониторинг переменной в окне объявления со-

ответствующего POU. Используемая глобальная константа показывается под соответствующей

структурной переменной.

Данную директиву нужно вводить в отдельной строке объявления структуры. Точка с запятой в

конце этой строки не нужна.

Синтаксис:

{bitaccess <Global Constant> <Bitnumber> '<comment>'}

<Global

Constant>:

Идентификатор глобальной константы, которая должна быть определена в спи-

ске глобальных переменных.

<Bitnumber>: Значение глобальной константы.

<comment> Комментарий

Обратите внимание: опция 'Замена констант' - 'Replace constants' (категория ‘Генератор кода’ (Build)) должна

быть активна!

Пример применения данной директивы см. «Приложение В: Операнды в CoDeSys» раздел «Пере-

менные», «Доступ к битам в переменных».

Директива управления линковкой компонентов

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

компонент определения типа данных (DUT) которые не использованы в проекте, исключаются при

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

теки) должна загружаться в контроллер даже если она не вызывается в проекте явно (например,

функция контроля, вызываемая системой исполнения). В этом случае в любом месте раздела объяв-

лений POU или в DUT нужно поместить директиву {link} которая вынудит линковщик включить

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

Директивы управления отображением объявлений в библиотеках

В процессе создания библиотеки в CoDeSys, вы можете управлять тем, какие части раздела объяв-

лений должны быть видны или не видны в Менеджере Библиотек при включении данной библиоте-

ки в проект. Данные директивы не влияют на отображение при редактировании библиотеки. Их

цель – скрыть от пользователя определенные детали реализации. Директивы {library private} и {li-

brary public} действуют на все строки ниже и взаимно отменяют одна другую.

Синтаксис директив:

{library public} :отображать нижеследующие элементы в Менеджере Библиотек.

{library private} :не отображать нижеследующие элементы.

Пример: ниже дан фрагмент раздела объявлений библиотеки. Комментарий "(* видно всем*)" бу-

дет виден в Менеджере Библиотек, а комментарий "(* это не для всех*)" не будет отображаться.

Переменные local и in3 также не будут отображаться:

{library public}(*видно всем *) {library private} (*это не для всех*)

{library public}

FUNCTION afun : BOOL

VAR_INPUT

in: BOOL;

END_VAR

{library private}

Редакторы

CoDeSys

CoDeSys V2.3 5-15

VAR

local: BOOL;

END_VAR

{library public}

VAR_INPUT

in2: BOOL;

{library private}

in3: BOOL;

{library public}

END_VAR

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

Включение таких директив в объявление переменных позволяет добавлять элементы списка управ-

ляемого Менеджером параметров (Parameter Manager). Наличие Менеджера параметров в среде

программирования CoDeSys определяется целевой платформой. Поддержка Менеджера параметров

включается специальным флагом на страничке “Сетевая функциональность” (Networkfunctional-

ity) в настройках целевой платформы.

Синтаксис:

• Директива заключена в фигурные скобки, регистр ввода не учитывается: { <Инструкция>}. Ес-

ли она включена в «нормальное» объявление переменной, то должна стоять до заверщающей точки

с запятой.

• Директивы, использующие интерфейс VAR_CONFIG, должны вводиться отдельной строкой,

без точки с запятой.

• Описание ключей записывается через пробел, внутри фигурных скобок.

• <name>: имя списка параметров. Если указанный список отсутствует, он будет создан.

• <key>: ключ или имя атрибута, т.е. название столбца в списке параметров ("Name", "Value",

"Accesslevel" и т.д.). Ключи зависят от типа списка. Определение ключей записывается через про-

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

включения элементов массивов, структур или функциональных блоков (см. 3, ниже).

• <value>: значение атрибута, заданное <key>. Если значение <value> имеет пробелы, то его не-

обходимо заключить в двойные кавычки. Например: accessright="read only".

Обратите внимание: директивы компиляции «срабатывают» только при предварительном анализе текста, ко-

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

ввода сообщаются только при полной компиляции.

Директивы определяют следующие вхождения:

1. Вхождения в списки типа 'Variables'

(a) из раздела объявлений программ и списков глобальных переменных:

Вхождение в список типа 'Variables' для переменной из объявлений PROGRAM или VAR_GLOBAL

задается следующим образом:

{parameter list=<name> [ <key>=<value> <key>=<value> ...прочие ключи ] }

Пример: Переменная bvar объявлена в программе. Она должна входить в список параметров

parlist1 (типа 'Variables') с именем bvar1, значением 102, индексом 16#1200 и подиндексом 16#2l.

VAR

Редакторы

CoDeSys

CoDeSys V2.3 5-16

bvar:INT{parameter list=parlist1 [name=bvar1 value=102 in-

dex=16#1200

subindex=16#1 ] };

END_VAR

(б) из объявления интерфейса VAR_CONFIG:

Вхождение в список типа 'Variables' для переменной из окна VAR_CONFIG (вне зависимости от оп-

ределения конфигурационной переменной) задается следующим образом:

{parameter list=<name> path=<path> [ <key>=<value> <key>=<value> ... прочие ключи ] }

<path> путь к переменной, например, "PLC_PRG.act1.var_x"

Пример: Для переменной var_x an создается вхождение в список "varlist1", символьное имя –

"xvar".

VAR_CONFIG

{parameter list=varlist1 path=PLC_PRG.act1.var_x [ name=xvar ] }

END_VAR

2. Вхождения в списки типа 'Template' через функциональные блоки и структуры

Директива в объявлениях функциональных блоков или структур позволяет создавать вхождения в

списки типа: 'Template':

{template list=<name> [ <key>=<value> <key>=<value> ... прочие ключи ] }

Пример: переменная strvar, являющаяся элементом структуры "stru1", должна входить в список

"templ1" типа 'Template'; символьное имя "struvar1", уровень доступа "low":

TYPE stru :

STRUCT

ivar:INT;

strvar:STRING{template list=vorl1 [member=struvar1 accesslevel=low]

};

END_STRUCT

END_TYPE

3. Вхождения в списки типа ' Instance' (для массивов переменных структуры или функционально-

го блока)

(a) из раздела объявлений программ и списков глобальных переменных:

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

дение в список типа 'Instance':

{instance list=<name> template=<template> baseindex=<index> basesubindex=<subindex> [

<key>=<значение первого элемента> <key>=< значение первого элемента> ...прочие ключи

первого элемента ] | [ <key>=<значение второго элемента> <key>=< значение второго элемента > ..

прочие ключи второго элемента ] | [ключи последующих элементов]}<key>=<value> <key>=<value>

...следующие ключи ] }

Для массивов ключ "template" будет определен автоматически с помощью неявного шаблона "AR-

RAY". Для структур и функциональных блоков соответствующий шаблон должен быть создан в

Менеджере параметров и должен быть частью заданного здесь определения.

Для каждого отдельного элемента структуры, массива или функционального блока может быть

предопределено собственное индивидуальное вхождение в список параметров. Например: вместо

единого определения "name" можно указать собственное определение [name=<имя_элемента>] для

каждого элемента.

Определение ключей для каждого отдельного элемента (заключается в квадратные скобки) выпол-

няется в строке, разделенной пробелами. Элементы такого пакета определений автоматически по-

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

Редакторы

CoDeSys

CoDeSys V2.3 5-17

элементов массива, структуры или функционального блока, то оставшиеся элементы получат зна-

чения от последнего описанного индивидуального элемента (исключение для ключа "name" описа-

но выше)! (см. пример 1b).

Автоматизация ключа "name" при включении массивов в список параметров:

− Если вы не определили имя элемента массива в директиве, то этот и все последующие элемен-

ты автоматически получат имена:

<Имя POU>_<Имя переменной массива>_<соответствующий числовой индекс массива >.

Пример: Переменная ARRVAR [1..8] типа массив INT в PLC_PRG включается в список дирек-

тивой pragma. Если ключ "name" не определен в директиве, то элементы массива в списке пара-

метров автоматически получают имена от "PLC_PRG_arrvar_1" до "PLC_PRG_arrvar_8".

− Если вы определяете директивой некоторое имя "<имя>_<первый числовой индекс массива>"

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

“<имя>_<соответствующий числовой индекс>”.

Пример: Переменная ARRVAR [1..8] типа массив INT включается в список посредством ди-

рективы pragma. Директива указывает [name=xyz_1]“ только для первого элемента массива.

Последующие элементы автоматически получают имена от "xyz_2" до "xyz_8".

Внимание: Не нужно задавать значения для ключа "Member"; данная колонка заполняется автоматически,

при помощи значений индексов массива.

Примеры:

Пример 1а:

Массив "arr_1" включает список "arrinst" типа 'Instance'; все элементы массива в этом списке полу-

чают символическое имя "xname_<index number>" (может быть изменено в Менеджере параметров),

подиндекс увеличивается на единицу для каждого элемента, начиная с 0. Accesslevel=low будет

применен ко всем элементам.

arr_1: ARRAY [1..8] OF INT{instance list=arrinst template=ARRAY basein-

dex=16#0

basesubindex=16#0 [name=xname_1 accesslevel=low ] };

Пример 1б:

Для массива arr_1 только имена для элементов с 1 по 4 определяются директивой, элементы с 5 по 8

получают имена автоматически на основе определения для элемента 4, то есть "xname_5" и т.д. до

"xname_8".

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

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

элементов:

arr_1: ARRAY [1..8] OF INT{instance list=arrinst template=ARRAY

baseindex=16#0 basesubindex=16#0 [name=aname accesslevel=high]

[name=bname] [name=cname] [name=xname accesslevel=medium]};

Пример 1:Вхождения для массива в списке instance

Редакторы

CoDeSys

CoDeSys V2.3 5-18

Пример 2:

Элементы структуры типа "stru1" (состоящей из переменных a,b,c) входят в список типа

'Instance',базирующийся на шаблоне "strulist_temp"; список включает вхождения a,b,c, символиче-

ские имена не присваиваются, уровень доступа "high" и значение каждого индекса определяется по

шаблону, через 2. Убедитесь, что определенный в директиве шаблон доступен Менеджеру парамет-

ров:

struvar:stru1{instance list=strulist template=strulist_templ baseindex=16#2

basesubindex=16#0 [accesslevel=high] };

Пример 2: Вхождения для структуры в Template

(б) из объявления интерфейса VAR_CONFIG:

Вы можете определить вхождения определяемых переменных в список Instance' непосредственно в

окне VAR_CONFIG (вне зависимости от других определений конфигурационных переменных).

Убедитесь, что определенный в директиве шаблон доступен Менеджеру параметров:

{instance list=<name> path=<path> template=<template> baseindex=<index>

basesubindex=<subindex>[ <key>=<value> <key>=<value> ...further keys ] }

<path> путь к переменной, например "PLC_PRG. fb1", где fb1 функциональный блок

Пример: Следующая директива в окне VAR_CONFIG будет создавать вхождения для всех пере-

менных для функционального блока "fb1" в списке экземпляров "varinst1" по шаблону "fb1_templ".

Для каждого вхождения индекс в соответствии с шаблоном увеличивается на 2 (baseindex), подин-

декс не изменяется (basesubindex). Каждое вхождение получает символьное имя "fb1var", которое

вы можете изменить в Менеджере параметров:

VAR_CONFIG

{instance list=varinst1 path=PLC_PRG.fb1 template=fb1_templ baseindex=16#2

basesubindex=16#0 [ name=fb1var ]}

END_VAR