OpenSCADA

Библиотеки/Рецепты

This page is a translated version of the page Libs/Prescriptions and the translation is 100% complete.

English • ‎mRussian • ‎Українська
Название Версия Лицензия Источник Языки Автор Иконка Описание
Рецепты 1.1, 1.1 GPLv2

OscadaLibs.db (SQL, GZip) > DAQ.tmplb_PrescrTempl
vcaBase.db (SQL, GZip) > VCA.wlb_prescr

en, uk, ru Роман Савоченко LibPrescriptions.png Библиотека элементов сценариев технологических процессов — рецептов.
- перевести элементы графической части на полную работу через менеджер рецептов, для возможности удалённого разнесения частей.

Библиотека создаётся для предоставления среды исполнения сценариев технологических процессов — рецептов, и кадров пользовательского интерфейса около него, включая кадр создания/редактирования рецептов и два кадра контроля исполнения и отчётности — "Рецепт — исполнение" и "Рецепт — исполнение, простой". Строится библиотека на основе примитивов виджетов и языка внутреннего программирования JavaLikeCalc, включая для шаблонов и команд.

Названия элементов и их параметров доступны на языках: Английский, Украинский и mRussian. Их исходный код написан в языко(человеческий)-независимом режиме с вызовом функции перевода tr() и перевод этих сообщений также доступен Английским, Украинским и mRussian.

Contents

1 Концепция

Сценарий технологических операций — рецепт, представляет собой последовательный вызов блока функций — команды, принимающие до пяти аргументов и возвращающие строку результата с кодом завершения в начале: "Работа (0)", "Завершен (>0)" и "Ошибка (<0)". Вызов команды шага осуществляется циклически, пока возвращается результат "Работа (0)". Переход к следующему шагу осуществляется в случае результата "Завершен (>0)" и команды "Пропуск (2)". В случае ошибки, результат "Ошибка (<0)", выполнение рецепта прерывается.

Последовательность команд, пользователем конечного интерфейса, формируются на кадре создания/редактирования и осуществляется контроль их исполнения на кадре "Рецепт — исполнение" и "Рецепт — исполнение, простой", при этом, данные рецептов сохраняются в таблице БД програм-рецептов. Таблица рецептов-программ помещается в одну из БД, доступных в конкретной конфигурации OpenSCADA, например, на данный момент такая таблица помещается в БД этой библиотеки как "PrescrProgs = (name, prgTxt)", где:

XML-дерево рецепта-программы начинается с тега-контейнера "prg", который содержит конечные теги команд "com" с атрибутами:

Например, для рецепта с четырьмя шагами получим:

<prg>
  <com arg1="10" id="Таймер" />
  <com arg1="10" id="Вакуум" />
  <com arg1="20" id="Таймер" />
  <com arg1="34" id="Включить катушки" />
</prg>

Вычисление рецепта осуществляется через параметр менеджера рецептов, который поддерживает два способа исполнения команд рецепта:

Режим исполнения "команда-параметр"
Команды-параметры логического уровня формируются программистом SCADA-системы под реализуемую прикладную область в виде шаблонов параметров подсистемы "Сбор данных", которые затем используются в логическом контроллере рецептов, с рядом обязательных, служебных и внутренних атрибутов:

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

At.png Этот режим, на данное время, является основным и на основе него было реализовано много механизмов взаимодействия с кадрами визуализации и контроля, которые могут не работать, или работать ошибочно со старым "команда-макрос" режимом!

Режим выполнения "команда-макрос" (старый)
Команды-макросы, которые пользователь может выбирать при формировании рецепта-программы, формируются программистом SCADA-системы под реализуемую прикладную область, путём редактирования таблицы команд в OpenSCADA. Таблица команд помещается в одну из БД, доступных в конкретной конфигурации OpenSCADA, например, на данный момент такая таблица помещается в БД этой библиотеки как "PrescrComs = (name, proc, arg1, arg2, arg3, arg4, arg5)", где:

Пример текста программы для команды "Таймер", не зависящей от прикладной области:
JavaLikeCalc.JavaScript
if(f_start) tmp1 = arg1;
var curTm = tmp1.toReal();
if(curTm <= 0) { rez = "1:Время истекло для "+arg1+"с"; return; }
curTm -= 1/f_frq;
tmp1 = max(0, curTm);
rez = "0:Ожидание сейчас "+curTm+"с";

Для специальных целей зарезервировано несколько имён команд:

2 Часть обработки и исполнения

Раздел содержит DAQ-шаблоны менеджера рецептов и команд режима "команда-шаблон", которые предназначены к подключению в контроллере логического уровня, путём создания соответственно параметров менеджера рецептов и команд, доступных для выбора пользователем, которые и будут осуществлять там всю роботу с рецептами-програмами на предмет их обработки и исполнения.

Для подключения части библиотеки к проекту станции OpenSCADA Вы можете получить файл БД как:

wget http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/OscadaLibs.sql
sqlite3 -init OscadaLibs.sql OscadaLibs.db .exit

Этот загруженный файл Вы далее можете разместить в каталоге проекта станции и создать объект базы данных модуля БД "SQLite", зарегистрировав файл базы данных в конфигурации.


2.1 Менеджер рецептов (manager)

2.2 GPLv2 * en, uk, ru Роман Савоченко
Результат и оперативные настройки.

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

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

Функции

КАТЕГОРИЯ: определяет идентификатор пользовательского рецепта-программы ProgNM в формате "uprg{ProgNM}", где:
  • "uprg*" — типовой шаблон-признак пользовательского рецепта-программы, который может быть непосредственно использован в фильтре категории для определения чисто пользовательских рецептов-программ;
  • ProgNM — имя рецепта-программы.
ТЕКСТ: описание действия в формате "{ActDescr} "{ProgNM}" : {StartTm} : {ActTm}", где:
  • ActDescr — описание действия:
  • "Текущий узел отсутствует";
  • "Прерванный пользователем сеанс программы";
  • "Прерванный ошибкой сеанс программы";
  • "Успешный сеанс программы".
  • ProgNM — имя рецепта-программы;
  • StartTm — время запуска рецепта-программы, в формате "2020-03-14 16:05:01";
  • ActTm — время действия рецепта-программы, в формате "2020-03-14 16:05:52".

ВВ шаблона

Идентификатор Имя Тип Режим Атрибут Конфигурация Значение
dbDB БД: Имя БД с таблицами Строка Вход Только чтение Константа
dbComs БД: Таблица с командами Строка Вход Не атрибут Константа PrescrComs
dbProgs БД: Таблица с программами Строка Вход Только чтение Константа PrescrProgs
comsCntr Контроллер команд,

<пусто> - для команд в таблице,
'*' - этот параметр контроллер

Строка Вход Не атрибут Константа *
mode Режим Выбор целых чисел Вход Полный доступ Переменная -2

-2;-1;0;1;2;3 Завершение;Ошибка;Стоп;Исполнение;Пауза;Пропустить команду

curMode Текущий режим Выбор целых чисел Вход Только чтение Переменная -2

-2;-1;0;1;2;3 Завершение;Ошибка;Стоп;Исполнение;Пауза;Пропустить команду

prog Имя выбранной программы Строка Вход Полный доступ Переменная
startTm Время запуска, секунды Целый Вход Только чтение Переменная
curCom Текущая команда-шаг Строка Вход Только чтение Переменная
work Рабочая программа Объект Вход Только чтение Переменная
comLs Список команд Объект Вход Только чтение Переменная
clcCnt Счётчик циклов Целый Вход Не атрибут Переменная
this Объект Объект Вход Не атрибут Переменная
f_err Ошибка функции Строка Вход Не атрибут Переменная 0
f_frq Частота обсчёта функции, Гц Вещественный Вход Не атрибут Переменная 1000
f_start Флаг запуска функции Логический Вход Не атрибут Переменная 0
f_stop Флаг останова функции Логический Вход Не атрибут Переменная 0
Конфигурация.

Конфигурация и использование

1. Создать и запустить объект логического контроллера с необходимыми свойствами планирования.
2. Создать объект логического параметра и выбрать этот шаблон для него. Включить параметр.
  • [JavaLikeCalc] или выбрать этот шаблон для JavaLikeCalc контроллера; включить контроллер; создать параметр "manager" отражения репрезентативных атрибутов:
dbDB
dbProgs
comLs
prog
mode
curMode
startTm
curCom
work
3. Во вкладке "Конфигурация шаблона" объекта логического параметра, или контроллера для [JavaLikeCalc], вы должны установить:
  • БД: Имя БД с таблицами — в БД, вроде "SQLite.vcaBase", где хранятся или должны храниться таблицы рецептов-программ. Пустое значение не разрешено и вызовет ошибку!
  • БД: Таблица с программами — в название таблицы рецептов-программ, по умолчанию это "PrescrProgs".
  • Контроллер команд — оставить в значении по умолчанию "*" для использования контроллера параметров также для команд. Вы должны изменить это поле в случае исполнения объекта контроллера менеджера в отдельном от команд логическом контроллере!
  • [JavaLikeCalc] или и дополнительно:
  • Контроллер команд — изменить это поле в отдельный логический контроллер для команд!
  • [Команда-макрос] или и дополнительно:
  • БД: Таблица с командами — в название таблицы команд, по умолчанию это "PrescrComs".
  • Контроллер команд — установить <пусто>.
4. Разместить необходимые параметры команд вместе с параметром менеджера.
  • [Команда-макрос] или подготовить необходимые команды в "БД: Таблица с командами" согласно концепции; пустая таблица команд должна быть создана автоматически после запуска объекта параметра, или контроллера для [JavaLikeCalc]!
5. РЕЗУЛЬТАТ: Запустив объект контроллера (где создан этот параметр) должны получить оперативные данные во вкладке "Атрибуты", для: перечень доступных команд, текущий режим, рабочая программа, текущая команда-шаг и время запуска.
  • [JavaLikeCalc] или непосредственно объект контроллера JavaLikeCalc.
6. В процессе работы, через вкладку оперативных данных "Атрибуты", кроме получения результата, можно осуществлять оперативную настройку и контроль на предмет:
  • Имя выбранной программы — установка названия выбранной программы в обработке менеджером;
  • Режим — установка режима менеджера, исполнения выбранного рецепта-программы: Завершение(-2); Ошибка(-1); Стоп(0); Исполнение(1); Пауза(2); Пропустить команду(3).

2.2 Шаблоны команд

2.2.1 Команда — Таймер (timer)

2.0 GPLv2 * en, uk, ru Роман Савоченко
Результат и оперативные настройки.

Шаблон команды типового таймера рецепта. Таймер разработан только для удержания времени между другими действенными шагами и для примера, т.е. он содержит только один атрибут, это "Время" в секундах.

ВВ шаблона

Идентификатор Имя Тип Режим Атрибут Конфигурация Значение
start Рецепт: старт Логический Вход Полный доступ Переменная 0
stop Рецепт: стоп Логический Вход Полный доступ Переменная 0
error Рецепт: ошибка Логический Вход Полный доступ Переменная 0
abort Рецепт: прерывание Логический Вход Полный доступ Переменная 0
run Команда: исполнение Логический Вход Полный доступ Переменная 0
pause Команда: пауза Логический Вход Полный доступ Переменная 0
rez Команда: результат Строка Вход Полный доступ Переменная 1
arg1 Время, секунд Вещественный Вход Полный доступ Переменная
tmp1 Временный 1 Вещественный Выход Не атрибут Переменная 0
f_stop Флаг останова функции Логический Вход Не атрибут Переменная 0
f_frq Частота обсчёта функции, Гц Вещественный Вход Не атрибут Переменная 1000
f_err Ошибка функции Строка Вход Не атрибут Переменная 0
f_start Флаг запуска функции Логический Вход Не атрибут Переменная 0

Конфигурация и использование

1. Создать и запустить объект логического контроллера с необходимыми свойствами планирования, или использовать созданный для менеджера рецепта.
2. Создать объект логического параметра и выбрать этот шаблон для него. Включить параметр.
5. РЕЗУЛЬТАТ: Запустив должны получить оперативные данные во вкладке "Атрибуты" для результата команды.
6. В процессе работы, через вкладку оперативных данных "Атрибуты", кроме получения результата, можно осуществлять оперативную настройку и контроль на предмет репрезентативных атрибутов команд рецепта и дополнительных:
  • Время — установка времени таймера, в секундах.


2.2.2 Команда — Фоновый таймер (timer)

2.0 GPLv2 * en, uk, ru Роман Савоченко
Результат и оперативные настройки.

Шаблон команды фонового таймера рецепта. Таймер разработан только для удержания времени в фоне для примера, т.е. он содержит только один атрибут, это "Время" в секундах.

ВВ шаблона

Идентификатор Имя Тип Режим Атрибут Конфигурация Значение
start Рецепт: старт Логический Вход Полный доступ Переменная 0
stop Рецепт: стоп Логический Вход Полный доступ Переменная 0
error Рецепт: ошибка Логический Вход Полный доступ Переменная 0
abort Рецепт: прерывание Логический Вход Полный доступ Переменная 0
run Команда: исполнение Логический Вход Полный доступ Переменная 0
pause Команда: пауза Логический Вход Полный доступ Переменная 0
rez Команда: результат Строка Вход Полный доступ Переменная 1
arg1 Время, секунд Вещественный Вход Полный доступ Переменная
tmp1 Временный 1 Вещественный Выход Не атрибут Переменная 0
f_stop Флаг останова функции Логический Вход Не атрибут Переменная 0
f_frq Частота обсчёта функции, Гц Вещественный Вход Не атрибут Переменная 1000
f_err Ошибка функции Строка Вход Не атрибут Переменная 0
f_start Флаг запуска функции Логический Вход Не атрибут Переменная 0

Конфигурация и использование

1. Создать и запустить объект логического контроллера с необходимыми свойствами планирования, или использовать созданный для менеджера рецепта.
2. Создать объект логического параметра и выбрать этот шаблон для него. Включить параметр.
5. РЕЗУЛЬТАТ: Запустив должны получить оперативные данные во вкладке "Атрибуты" для результата команды.
6. В процессе работы, через вкладку оперативных данных "Атрибуты", кроме получения результата, можно осуществлять оперативную настройку и контроль на предмет репрезентативных атрибутов команд рецепта и дополнительных:
  • Время — установка времени таймера, в секундах.

3 Графическая часть

Содержит элементы-кадры рецептов конечного типа и элементы-виджеты, которые предназначены для размещения в разделе мнемосхем (вид отображения) дерева страниц проекта, построенного по концепции объектов сигнализации корневой страницы "RootPgSo" и для размещения на других комплексных кадрах. Однако, элементы-кадры могут быть размещены как отдельные сущности или в составе собственной концепции управления страницами, но тут нужно учитывать, что кадры часто ссылаются и вызывают панель документов!

Для подключения части библиотеки к проекту станции OpenSCADA Вы можете получить файл БД как:

wget http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/vcaBase.sql
sqlite3 -init vcaBase.sql vcaBase.db .exit

Этот полученный файл Вы далее можете разместить в каталоге проекта станции и создать объект базы данных модуля БД "SQLite", зарегистрировав файл базы данных в конфигурации.


3.1 Рецепт — редактирование (prescrEdit)

1.3 GPLv2 * en, uk, ru Роман Савоченко

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

Кадр содержит, слева на право:

Рис.3.1a. Кадр "Рецепт — редактирование" в режиме разработки.

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

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

Операции удаление сопровождаются появлением диалога-окна подтверждения.

Рис.3.1b. Кадр "Рецепт — редактирование" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон
dbDB БД: База данных Строка Входная связь Controller|dbDB
dbProgs БД: Таблица программ Строка Входная связь Controller|dbProgs
prExtComLs Список доступных команд рецепта Объект Входная связь Controller|comLs


3.2 Рецепт — исполнение (prescrRun)

1.3 GPLv2 * en, uk, ru Роман Савоченко

Кадр, представленный на рисунке 3.2, является одним из группы кадров работы с рецептами, который служит для контроля и наблюдения за исполнением программ-рецептов, ранее сформированных в кадре "Рецепт — редактирование". Кадр, в целом, использует и представляет представительскую структуру менеджера рецептов. Дополнительно к этому полноформатному кадру исполнения рецептов, предусмотрен упрощённый — "Рецепт — исполнение, простой", который позволяет компактно управлять и отслеживать исполнение рецептов в составе других кадров технологического процесса.

Кадр содержит, слева на право:

Рис.3.2a. Кадр "Рецепт — исполнение" в режиме разработки.

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

At.png Для возможности архивирования завершённых сеансов, пока оператор переключается по другим кадрам, необходимо, для этого полноформатного кадра в дереве проекта, установить параметр "Стр.: обрабатывать не открытой".

По завершению рецепта-программы происходит генерация менеджером рецептов сообщений с параметрами сеанса, а также архивирование документа сеанса. Сообщения с параметрами сеанса могут быть использованы или просто для просмотра истории сеансов, или-же для формирования списка сеансов, например, в группе графиков для перехода к истории на время сеанса. По умолчанию архив отчётов настроен на глубину 10 документов, что вы можете изменить установкой атрибута "Размер архиву (n)" виджета документа.

Использование — исполнение
В режиме исполнения пользователь может выбрать нужный рецепт-программу и запустить его на исполнение, после чего отслеживать процесс исполнения или перейти к другим кадрам. Исполняемую программу пользователь может приостановить путём нажатия кнопки "Пауза" в месте кнопки "Запуск" или прервать путём нажатия кнопки "Останов". Кроме этого, пользователь может пропустит исполнение текущего шага, нажав кнопку "Пропустить". Также пользователь может пересмотреть или распечатать отчёты ранее исполняемых рецептов этого полноформатного кадра, для чего нужно нажать левой клавишей мыши на поле документа и полистать по архиву исполняемых рецептов, на появившейся справа панели навигации.

Рис.3.2b. Кадр "Рецепт — исполнение" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон
dbDB БД: База данных Строка Входная связь Controller|dbDB
dbProgs БД: Таблица программ Строка Входная связь Controller|dbProgs
prExtCurCom Контроллер: текущая команда Входная связь Controller|curCom
prExtMode Контроллер: режим Целый Полная связь Controller|mode
prExtProg Контроллер: программа Строка Полная связь Controller|prog
prExtStartTm Контроллер: время запуска Целый Входная связь Controller|startTm
prExtWork Контроллер: рабочая Объект Входная связь Controller|work


3.3 Рецепт — исполнение, простой (prescrRunSimple)

1.3 GPLv2 * en, uk, ru Роман Савоченко

Виджет, представленный на рисунке 3.3, это упрощённый вариант кадра "Рецепт — исполнение", который разработан для размещения как виджет мнемосхем и он в основном и работает дополнением кадра "Рецепт — исполнение". Кадр, в целом, использует и представляет представительскую структуру менеджера рецептов.

Виджет содержит, слева направа и вниз:

Рис.3.3. Кадр "Рецепт — исполнение, простой" в режиме разработки и исполнения.

Использование — разработка
Этот виджет может быть использован разработчиком при создании мнемосхем с отображением активности исполнения рецептов и быстрого контроля ними. Для использования нужно добавить данный виджет на мнемосхему, подстроить горизонтальный, вертикальный размер масштабом и подключит один параметр менеджера рецептов, путём установки связей.

Использование — исполнение
В режиме исполнения пользователь может выбрать нужный рецепт-программу, в диалоге выбора программы в дереве который появляется при нажатии кнопки рецепта, и запустить его на исполнение, после чего отслеживать процесс исполнения или перейти к другим кадрам. Исполняемую программу пользователь может приостановить путём нажатия кнопки "Пауза" в месте кнопки "Запуск" или прервать путём нажатия кнопки "Останов". Кроме этого, пользователь может пропустит исполнение текущего шага, нажав кнопку "Пропустить".

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон
dbDB БД: База данных Строка Входная связь Controller|dbDB
dbProgs БД: Таблица программ Строка Входная связь Controller|dbProgs
prExtCurCom Контроллер: текущая команда Строка Входная связь Controller|curCom
prExtMode Контроллер: режим Целый Полная связь Controller|mode
prExtProg Контроллер: программа Строка Полная связь Controller|prog
prExtStartTm Контроллер: время запуска Целый Входная связь Controller|startTm
prExtWork Контроллер: рабочая Объект Входная связь Controller|work
Libs/Prescriptions/ru - GFDLMarch 2024OpenSCADA 0.9.7