Руководство пользователя по программированию ПЛК в CoDeSys 2.3
Подождите немного. Документ загружается.
Приложение D: Библиотеки CoDeSys
CoDeSys V2.3 10-65
Системные библиотеки CoDeSys
Системные библиотеки дают доступ к специализированным и низкоуровневым функциям кон-
троллера. Набор доступных библиотек зависит от аппаратной платформы. Общий состав и назна-
чение системных библиотек приведено в документе SysLibs_Overview_RU.pdf. Подробно функции
каждой из системных библиотек описаны в соответствующих документах: SysLib…_RU.pdf.
Приложение E: Краткий справочник по операторам и компонентам библиотек
CoDeSys V2.3 10-66
Приложение E: Краткий справочник по операторам и
компонентам библиотек
Приведенные ниже таблицы кратко представляют операторы CoDeSys и компоненты библиотек
Standard.lib и Util.lib. Даны нотации для языков ST и IL. Для IL указаны допустимые модифика-
торы.
Обратите внимание, что для IL инструкций первый операнд должен быть загружен заранее (на-
пример, командой LD). Непосредственно в строке за «IL» командой вводятся второй и после-
дующие (если они есть) операнды.
Столбец «Мод.» содержит допустимые IL модификаторы:
C Команда выполняется только в случае, если результат предыдущей операции TRUE.
N для JMPC, CALC, RETC: Команда выполняется только в случае, если результат предыдущей
операции FALSE.
N прочие: отрицание операнда (не аккумулятора)
(
Скобки: операторы, заключенные в скобки, выполняются в первую очередь, затем продолжается
обычный порядок выполнения.
Детальные описания даны в соответствующих приложениях выше.
Операторы CoDeSys:
ST IL Мод.
Описание
' Разграничение строк (т.е. 'string1')
.. [ ] Задание индексов массива (т.е. ARRAY[0..3] OF INT)
: Разделитель операнда и типа при объявлении (т.е. var1 :
INT;)
; Конец инструкции (т.е. a:=var1;)
^ Обращение через указатель (т.е. pointer1^)
LD var1 N Загрузить значение var1 а аккумулятор
:= ST var1 N Записать в var1 значение аккумулятора
S boolvar Установка логического операнда boolvar в TRUE, если
значение аккумулятора TRUE
R boolvar Сброс логического операнда boolvar в FALSE, если
значение аккумулятора TRUE
JMP label CN Переход на метку label
<Program name> CAL prog1 CN Вызов программы prog1
<Instance name> CAL inst1 CN Вызов экземпляра функционального блока inst1
<Fctname>(vx, vy,..) <Fctname> vx, vy CN Вызов функции fctname передача параметров vx, vy
( Результат вычислений в скобках используется как опе-
ранд.
) Заканчивает вычисление в скобках.
AND AND N,( Битовое AND
OR OR N,( Битовое OR
XOR XOR N,( Битовое исключающее OR
NOT NOT Битовое NOT
+ ADD ( Сложение
- SUB ( Вычитание
* MUL ( Умножение
/ DIV ( Деление
> GT ( Больше, чем
>= GE ( Больше или равно
Приложение E: Краткий справочник по операторам и компонентам библиотек
CoDeSys V2.3 10-67
= EQ ( Равно
<> NE ( Неравно
<= LE ( Меньше или равно
< LT ( Меньше, чем
MOD(in) MOD Остаток целочисленного деления
INDEXOF(in) INDEXOF Внутренний индекс POU in; [INT]
SIZEOF(in) SIZEOF Число байт, занимаемых in
SHL(K,in) SHL Поразрядный сдвиг влево на K бит
SHR(K,in) SHR Поразрядный сдвиг вправо на K бит
ROL(K,in) ROL Циклический сдвиг влево на K бит
ROR(K,in) ROR Циклический сдвиг вправо на K бит
SEL(G,in0,in1) SEL Мультиплексор на 2 входа in0 (при G FALSE) и in1
(при G TRUE)
MAX(in0,in1) MAX Возвращает наибольшее из 2х значений in0 и in1
MIN(in0,in1) MIN Возвращает наименьшее из 2х значений in0 и in1
LIMIT(MIN,in,Max) LIMIT Ограничивает значение in в пределах от MIN до MAX
MUX(K,in0,...in_n) MUX Мультиплексор выбирает K-тое значение из группы (от
in0 до In_n)
ADR(in) ADR Адрес операнда в [DWORD]
ADRINST() ADRINST Адрес экземпляра функционального блока, из которого
вызывается ADRINST.
BITADR(in) BITADR Битовое смещение операнда в [DWORD]
BOOL_TO_<type>(in) BOOL_TO_<type> Преобразование типа из логического
<type>_TO_BOOL(in) <type>_TO_BOOL Преобразование типа в логический
INT_TO_<type>(in) INT_TO_<type> Преобразование значения операнда типа INT в другой
базовый тип
REAL_TO_<type>(in) REAL_TO_<type> Преобразование значения операнда типа REAL в дру-
гой базовый тип
LREAL_TO_<type>(in) LREAL_TO_<type> Преобразование значения операнда типа LREAL в дру-
гой базовый тип
TIME_TO_<type>(in) TIME_TO_<type> Преобразование значения операнда типа TIME
в другой
базовый тип
TOD_TO_<type>(in) TOD_TO__<type> Преобразование значения операнда типа TOD в другой
базовый тип
DATE_TO_<type>(in) DATE_TO_<type> Преобразование значения операнда типа DATE в дру-
гой базовый тип
DT_TO_<type>(in) DT_TO_<type> Преобразование значения операнда типа DT в другой
базовый тип
STRING_TO_<type>(in) STRING_TO_<type> Преобразование текста строки операнда в другой базо-
вый тип. Строка должна содержать соответствующий
текст
TRUNC(in) TRUNC Преобразование из REAL в INT
ABS(in) ABS Абсолютное значение in
SQRT(in) SQRT Квадратный корень из in
LN(in) LN Натуральный логарифм из in
LOG(in) LOG Десятичный логарифм из in
EXP(in) EXP E в степени in
SIN(in) SIN Синус in
COS(in) COS Косинус in
TAN(in) TAN Тангенс in
ASIN(in) ASIN Арксинус in
ACOS(in) ACOS Арккосинус in
Приложение E: Краткий справочник по операторам и компонентам библиотек
CoDeSys V2.3 10-68
ATAN(in) ATAN Арктангенс in
EXPT(in,expt) EXPT expt Возведение в степень expt
Компоненты Standard.lib:
ST IL Описание
LEN(in) LEN Длина строки in
LEFT(str,size) LEFT Левая значимая часть строки str из size символов
RIGHT(str,size) RIGHT Правая значимая часть строки str из size символов
MID(str,size,pos) MID Часть строки str с позиции pos из size символов
CONCAT('str1','str2') CONCAT 'str2' Конкатенация (склеивание) 2х строк
INSERT('str1','str2',pos) INSERT 'str2',p Вставить строку str1 в str2 с позиции pos
DELETE('str1',len,pos) DELETE len,pos Удалить часть строки, len символов, с позиции pos
REPLACE('str1','str2',len,pos)
REPLACE
'str2',len,pos
Заменить часть строки str1 с позиции pos на len символов из
str2
FIND('str1','str2') FIND 'str2' Поиск подстроки str2 в str1
SR SR FB: Переключатель с доминантой включения
RS RS FB: Переключатель с доминантой выключения
SEMA SEMA FB: Семафор (interruptable)
R_TRIG R_TRIG FB: детектор переднего фронта импульса
F_TRIG F_TRIG FB: детектор заднего фронта импульса
CTU CTU FB: Инкрементный счетчик
CTD CTD FB: Декрементный счетчик
CTUD CTUD FB: Реверсивный счетчик
TP TP FB: Триггер
TON TON FB: Таймер включения
TOF TOF FB: Таймер выключения
RTC RTC FB: Часы
Компоненты Util.lib:
Компонент Описание
BCD_TO_INT Преобразование значения операнда BCD в INT
INT_TO_BCD Преобразование байта INT в BCD
EXTRACT(in,n) Определяет значение n-го бита DWORD, результат типа BOOL
PACK Упаковка значений 8 бит в байт
PUTBIT Присвоить значение определенному биту в DWORD
UNPACK Распаковка байта в 8 логических переменных
DERIVATIVE Производная
INTEGRAL Интеграл
LIN_TRAFO Преобразование REAL значений
STATISTICS_INT Макс., Мин., Среднее значения в INT формате
STATISTICS_REAL
Макс., Мин., Среднее значения в REAL формате
VARIANCE Дисперсия
PD ПД регулятор
PID ПИД регулятор
BLINK Генератор импульсов
FREQ_MEASURE Частотомер
GEN Функциональный генератор
Приложение E: Краткий справочник по операторам и компонентам библиотек
CoDeSys V2.3 10-69
CHARCURVE Интерполятор
RAMP_INT Ограничитель скорости изменения сигнала (INT)
RAMP_REAL Ограничитель скорости изменения сигнала (REAL)
HYSTERESIS Гистерезис
LIMITALARM Компаратор
Приложение F: Командная строка / командный файл
CoDeSys V2.3 10-70
Приложение F: Командная строка / командный файл
Командная строка
Параметры, указанные в командной строке при запуске CoDeSys, определяют дополнительные
режимы работы программы. Все параметры начинаются символом „/“. Регистр знаков не учитыва-
ется. Команды выполняются слева направо.
/онлайн Непосредственно после запуска CoDeSys перейти в режим онлайн теку-
щего проекта.
/batch CoDeSys стартует без пользовательского интерфейса, выполняет ко-
мандный файл и немедленно завершает работу, возвращая результат
выполнения в формате HRESULT. Выполнение командного файла бу-
дет остановлено, если при выполнении очередной команды произойдет
ошибка. Предупреждения не прерывают выполнение. Если ошибок и
предупреждений не произошло, то возвращает значение S_OK.
/run После подключения автоматически запускает приложение.
Имеет смысыл только совместно с /онлайн
/show ...
/show hide
/show icon
/show max
/show normal
Вид окна при старте CoDeSys
Окно не показывается, нет индикатора в панели задач
Окно свернуто
Развернуто на весь экран
Размер окна равен размеру, установленному в предыдущем сеансе рабо-
ты.
/out <outfile> Все сообщения программы дополнительно записываются в файл
<outfile>.
/noinfo Не показывать заставку при запуске
/userlevel
<group>
Определение пользовательской группы (например, "/userlevel 0" для
группы 0)
/password
<password>
Прямой ввод пароля пользовательской группы (например, "/password
abc")
/openfromplc Будет загружен проект из целевой системы.
/visudownload
Если CoDeSys HMI запускается с проектом, не соответствующим при-
сутствующему в целевой системе, то будет дан диалог подтверждения
загрузки.
/notargetchange
Изменение целевой платформы может быть выполнено только через
командный файл (См. ниже описание команды "target...").
/cmd <cmdfile> После запуска выполнить команды из файла <cmdfile>
Формат командной строки:
"<Путь CoDeSys-exe>" "<Путь проекта>" /<команда1> /<c команда2> ....
Пример командной строки:
"D:\dir1\codesys" "C:\projects\ampel.pro" /show hide /cmd command.cmd
Приложение F: Командная строка / командный файл
CoDeSys V2.3 10-71
Открывается проект ampel.pro, все окна закрыты. Далее выполняются команды, указанные в
command.cmd. Путь указывается в кавычках!
Командный файл (cmdfile)
Приведенные ниже команды можно использовать в командном файле, который в свою очередь
вызывается из командной строки (см. выше). Регистр знаков не учитывается.
Командные строки показывается в окне сообщений и могут быть записаны в файл (за исключени-
ем команд, начинающихся с „@“). Часть строки после точки с запятой (;) игнорируется.
Команды управления выполнением:
onerror continue Последующие команды должны выполняться, даже если произошла
ошибка выполнения.
onerror break Последующие команды не должны выполняться, если произошла ошиб-
ка выполнения.
Команды меню Онлайн:
онлайн login Подключение и загрузка проекта ('Онлайн' 'Подключение' - 'Online'
'Login')
онлайн logout Отключение ('Онлайн' 'Отключение' - 'Online' 'Logout')
онлайн run Запуск приложения ('Онлайн' 'Старт' - 'Online' 'Run')
онлайн stop Останов приложения ('Онлайн' 'Стоп' - 'Online' 'Stop')
онлайн bootproject 'Онлайн' 'Создание загрузочного проекта' - 'Online' 'Create boot pro-
ject'
онлайн sourcecodedownload 'Онлайн' 'Загрузка' - 'Online' 'Sourcecode download'
онлайн sim Включить режим эмуляции ('Онлайн' 'Режим эмуляции' - 'Online'
'Simulation')
онлайн sim off Выключить режим эмуляции ('Онлайн' 'Режим эмуляции' - 'Online'
'Simulation')
Команды меню File:
file new Создать новый проект ('Файл' 'Создать' - 'File' 'New')
file open <projectfile>
Загрузить прект <projectfile> ('Файл' 'Открыть' - 'File' 'Open')
/readpwd:<readpassword> Задает пароль доступа на чтение, диалог ввода пароля не показывается.
/writepwd:<writepassword> Задает пароль полного доступа, диалог ввода пароля не показывается.
file close Закрыть проект ('Файл' 'Закрыть' - 'File' 'Close')
file save Сохранить проект ('Файл' 'Сохранить' - 'File' 'Save')
file saveas <projectfile>
опция: <type><version>
Сохранить проект под именем <projectfile> ('Файл' 'Сохранить как' -
'File' 'Save as')
По умолчанию: сохраняется файл проекта текущей версии CoDeSys
<projectfile>. Если вы хотите сохранить проект как внешнюю или внут-
реннюю библиотеку либо в формате ранних версий, добавьте команду:
"internallib" сохранить как внутреннюю библиотеку:
"externallib" сохранить как внешнюю библиотеку:
"pro" сохранить в формате ранних версий:
допустимые версии <Version>: 15, 20, 21, 22 (версии 1.5, 2.0, 2.1, 2.2)
Приложение F: Командная строка / командный файл
CoDeSys V2.3 10-72
Пример: "file save as lib_xy internallib22" -> проект "project xy.pro", со-
храняется как "lib_xy.lib" для V2.2.
file printersetup <filename>.dfr
опция:
pageperobject или
pagepersubject
Определяет dfr файл для печати ('Файл' 'Параметры печати' - 'File'
'Printer setup') и одну из возможных опций 'Новая страница на каж-
дый объект' (New page per object) или 'Новая страница на каждый
подобъект' (New page per subobject) (См. раздел Документация)
file archive <filename>.zip Архивация проекта в zip-файл с указанным именем ('Файл'
'Сохранить/Отправить архив' - 'File' 'Save/Mail Archive')
file quit Завершить работу CoDeSys ('Файл' 'Выход' - 'File' 'Exit')
Команды меню Project:
project build Инкрементальная компиляция текущего проекта ('Проект'
'Компилировать' - 'Project' 'Build')
project rebuild or
project compile
Полная компиляция текущего проекта ('Проект' 'Компилировать все' -
'Project' 'Rebuild all')
project clean Удалить информацию о компиляции и онлайн коррекции ('Проект'
'Очистить все' - 'Project' 'Clean All')
project check Контроль текущего проекта ('Проект' 'Контроль' - 'Project' 'Check')
project import <file1> ...
<fileN>
Файлы <file1> ... <fileN> импортируются в текущий проект ('Проект'
'Импорт' - 'Project' 'Import'). Внимание: можно использовать шаблоны,
например, "project import C:\projects\*.exp.
project export <expfile> Экспорт текущего проекта в файл <expfile> ('Проект' 'Экспорт' - 'Pro-
ject' 'Export')
project expmul Каждый объект текущего проекта экспортируется в отдельный файл,
получающий имя объекта.
project documentation Печать проекта (См. раздел Документация)
Команды управления файлом сообщений:
out open <msgfile> Открыть файл сообщений <msgfile>. Новые сообщения добавляются.
out close Закрыть текущий файл сообщений.
out clear Очистить файл сообщений.
Команды управления сообщениями:
echo on Отображать команды.
echo off Скрыть команды.
echo <text> Отобразить текст <text>.
Команды управления заменой (нужны при выполнении команд Импорт, Экспорт,
Копировать - import, export, copy):
replace yesall Заменять все (отвечает «да» на все запросы замены, диалог не отобра-
жается)
replace noall Запрет замены (отвечает «нет» на все запросы замены, диалог не ото-
бражается)
replace query Показывать диалог замены независимо от 'replace yesall' или 'replace
noall'
Команды, изменяющие параметры диалогов CoDeSys по умолчанию:
query on Отображать диалоги и ждать ввода пользователя
Приложение F: Командная строка / командный файл
CoDeSys V2.3 10-73
query off ok Для всех диалогов отвечать 'OK'
query off no Для всех диалогов отвечать 'No'
query off cancel Для всех диалогов отвечать 'Cancel'
Вызов вложенных командных файлов:
call <parameter1> ... <parame-
ter10>
Вызов файла команд. Допускается до 10 параметров:$0 - $9.
Задание директорий CoDeSys:
(Диалог опций проекта, категория 'Директории' - 'Directories', раздел 'Общие' - 'General'): Если в
нижеописанных командах нужно задать несколько директорий, то их определения должны быть
разделены точкой с запятой и пробелом. Определение директории нужно заключить в кавычки.
Например:
dir lib "D:\codesys\Libraries\Standard; D:\codesys\Libraries\NetVar"
dir lib <libdir> Задает <libdir> как директорию библиотек
dir compile <compiledir> Задает <compiledir> как директорию для компиляции
dir config <configdir> Задает <configdir> как директорию файлов конфигурации
dir upload <uploaddir> Задает <uploaddir> как директорию для загружаемых файлов
Задержка выполнения CMDFILE:
delay 5000 Пауза 5 секунд
Управление Менеджером рецептов (Watch and Recipe Manager):
watchlist load <file> Загрузить список (Watchlist) из файла <file> и открыть соответствую-
щее окно ('Дополнения' 'Открыть список просмотра' - 'Extras' 'Load
Watchlist')
watchlist save <file> Сохранить текущий список в файле <file> ('Дополнения' 'Сохранить
список просмотра' - 'Extras' 'Save Watchlist')
watchlist set <text> Присвоить загруженному списку имя <text> ('Дополнения'
'Переименовать список' - 'Extras' 'Rename Watchlist')
watchlist read Обновить значения в списке ('Дополнения' 'Считать значения' - 'Ex-
tras' 'Read Recipe')
watchlist write Установить значения переменных в соответствии с заданными в списке
('Дополнения' 'Записать значения' - 'Extras' 'Write Recipe')
Компоновка библиотек:
library add <library file1> <li-
brary file2> .. <library fileN>
Добавить в текущий проект. Если указан относительный путь, то в ка-
честве корневого, используется директория библиотек.
library delete [<library1> <li-
brary2> .. <libraryN>]
Удалить указанные или все (если не указано какие) библиотеки из со-
става текущего проекта.
Копирование объектов:
object copy <source project
file> <source path> <target
path>
Копирует объекты (source path) в указанные (target path) объекты теку-
щего проекта.
(source path) - это имя объекта. Если указана папка, берутся все ее объ-
екты. В этом случае копируется полная структура папки.
Если (target path) отсутствует, будет создан новый объект.
Приложение F: Командная строка / командный файл
CoDeSys V2.3 10-74
Доступ только для чтения к определенным объектам:
object setreadonly
<TRUE|FALSE> <object type>
| <object name>
Установить доступ только по чтению для заданного объекта. Кроме
конкретных идентификаторов, можно задать ограничение для всего
типа объектов.
Допустимые типы: pou, dut (data type), gvl (global variables list), vis
(visualization), cnc (CNC object), liblist (Libraries), targetsettings, toolin-
stanceobject (particular Tools instance), toolmanagerobject (all instances in
the Tools tree), customplconfig (PLC configuration), projectinfo (Project
information), taskconfig (task configuration), trace, watchentrylist (Watch-
and Recipe Manager), alarmconfig (Alarm configuration)
Пример: "object setreadonly TRUE pou plc_prg" задает для PLC_PRG
доступ только по чтению.
Ввод параметров коммуникации (gateway, device):
gateway local Использовать Gateway данного локального компьютера.
gateway tcpip <Address>
<Port>
Использовать Gateway указанного удаленного компьютера.
<Address>: TCP/IP адрес или имя в сети удаленного компьютера.
<Port>: TCP/IP порт удаленного шлюза.
Внимание: Доступны только удаленные шлюзы, не защищенные паро-
лем доступа!
device guid <guid>
Использовать коммуникационный интерфейс с указанным GUID.
Формат GUID (пример): {01234567-0123-0123-0123-0123456789ABC}
Скобки и позиции дефисов важны.
device instance <Instance
name>
Установить заданное имя для текущего коммуникационного интерфей-
са.
device parameter <Id> <Value>
Присвоить указанное значение определеннуму параметру (задается ID)
интерфейса.
Системный вызов:
system <command> Выполнить команду операционной системы.
Выбор целевой платформы:
target <Id> Установить целевую платформу для текущего проекта. Если CoDeSys
запущен с опцией командной строки (см . выше) "/notargetchange", то
это единственный способ выбора целевой платформы.
Запрос состояния:
state offline
Возвращает "S_OK" при отсутствии соединения с контроллером (режим
offline), иначе возвращает "HRESULT[0x800441f0)" (режим онлайн).
state онлайн
Возвращает "S_OK" при наличии соединения с контроллером (режим
онлайн), иначе возвращает "HRESULT[0x800441f0)" (режим offline).
Пароли для групп пользователей:
Если открывается проект, защищенный паролями для групп пользователей, то нижеследующие
команды позволят ввести необходимые пароли. Это позволяет открыть защищенный проект из
командного файла. Данные команды должны предшествовать команде "file open..."!