| Название | Версия | Лицензия | Источник | Языки | Автор | Описание |
|---|---|---|---|---|---|---|
| Рецепты | 1.1, 1.1 | GPLv2 |
OscadaLibs.db (SQL, GZip) > DAQ.tmplb_PrescrTempl |
en, uk, ru | Роман Савоченко | Библиотека элементов сценариев технологических процессов — рецептов.
|
Библиотека создаётся для предоставления среды исполнения сценариев технологических процессов — рецептов, и кадров пользовательского интерфейса около него, включая кадр создания/редактирования рецептов и два кадра контроля исполнения и отчётности — "Рецепт — исполнение" и "Рецепт — исполнение, простой". Строится библиотека на основе примитивов виджетов и языка внутреннего программирования JavaLikeCalc, включая для шаблонов и команд.
Названия элементов и их параметров доступны на языках: Английский, Украинский и Российский. Их исходный код написан в языко(человеческий)-независимом режиме с вызовом функции перевода tr() и перевод этих сообщений также доступен Английским, Украинским и Российским.
Сценарий технологических операций — рецепт, представляет собой последовательный вызов блока функций — команды, принимающие до пяти аргументов и возвращающие строку результата с кодом завершения в начале: "Работа (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-системы под реализуемую прикладную область в виде шаблонов параметров подсистемы "Сбор данных", которые затем используются в логическом контроллере рецептов, с рядом обязательных, служебных и внутренних атрибутов:
Особенностью использования команд-параметров является независимое их исполнение и возможность оставить исполнение ряда команд в фоне, например, регуляторы. Эти команды, также, можно прямо подключать к источнику данных с помощью связей, или даже реализовывать их обоих в одном шаблоне-параметре.
Этот режим, на данное время, является основным и на основе него было реализовано много механизмов взаимодействия с кадрами визуализации и контроля, которые могут не работать, или работать ошибочно со старым "команда-макрос" режимом!
Режим выполнения "команда-макрос" (старый)
Команды-макросы, которые пользователь может выбирать при формировании рецепта-программы, формируются программистом 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+"с";
Для специальных целей зарезервировано несколько имён команд:
Раздел содержит 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 | Роман Савоченко |
Основной, представительский и унифицированный шаблон менеджера и контроллера рецептов, их обработки и прямого исполнения в режиме "команда-макрос". Шаблон формирует структуру параметра менеджера рецептов, который может быть легко подключен ко всем кадрам этой библиотеки.
Представительской структурой менеджера рецептов является:
Функции
ВВ шаблона
| Идентификатор | Имя | Тип | Режим | Атрибут | Конфигурация | Значение |
|---|---|---|---|---|---|---|
| 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 |
Конфигурация и использование
dbDB dbProgs comLs prog mode curMode startTm curCom work
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 |
Конфигурация и использование
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 |
Конфигурация и использование
Содержит элементы-кадры рецептов конечного типа и элементы-виджеты, которые предназначены для размещения в разделе мнемосхем (вид отображения) дерева страниц проекта, построенного по концепции объектов сигнализации корневой страницы "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, является одним из группы кадров работы с рецептами, который служит для пользовательского редактирования рецептов-программ. Кадр, в целом, использует и представляет представительскую структуру менеджера рецептов.
Кадр содержит, слева на право:
Использование — разработка
Кадр предназначен для выполнения роли страницы, а, следовательно, он должен непосредственно помещаться в дерево проекта. К кадру может быть подключен один параметр менеджера рецептов, путём установки связей.
Использование — исполнение
В режиме исполнения пользователь может добавлять новые рецепты-программы, удалять, копировать и экспортировать существующие, а также импортировать рецепты других станций OpenSCADA. В выбранном рецепте-программе пользователь может выполнить: добавление или вставку нового шага, удаление или изменение положения выбранного шага. Для выбранного шага рецепта-программы пользователь может установить команду и ввести имя, описание, флаг фонового исполнения и значения доступных аргументов выбранной команды, после чего сохранить изменения шага.
Операции удаление сопровождаются появлением диалога-окна подтверждения.
Свойства связывания и конфигурации
| Идентификатор | Имя | Тип | Конфигурация | Конфигурационный шаблон |
|---|---|---|---|---|
| dbDB | БД: База данных | Строка | Входная связь | Controller|dbDB |
| dbProgs | БД: Таблица программ | Строка | Входная связь | Controller|dbProgs |
| prExtComLs | Список доступных команд рецепта | Объект | Входная связь | Controller|comLs |
3.2 Рецепт — исполнение (prescrRun) |
1.3 | GPLv2 | * | en, uk, ru | Роман Савоченко |
Кадр, представленный на рисунке 3.2, является одним из группы кадров работы с рецептами, который служит для контроля и наблюдения за исполнением программ-рецептов, ранее сформированных в кадре "Рецепт — редактирование". Кадр, в целом, использует и представляет представительскую структуру менеджера рецептов. Дополнительно к этому полноформатному кадру исполнения рецептов, предусмотрен упрощённый — "Рецепт — исполнение, простой", который позволяет компактно управлять и отслеживать исполнение рецептов в составе других кадров технологического процесса.
Кадр содержит, слева на право:
Использование — разработка
Кадр предназначен для выполнения роли страницы, а, следовательно, он должен непосредственно помещаться в дерево проекта. К кадру может быть подключен один параметр менеджера рецептов, путём установки связей.
Для возможности архивирования завершённых сеансов, пока оператор переключается по другим кадрам, необходимо, для этого полноформатного кадра в дереве проекта, установить параметр "Стр.: обрабатывать не открытой".
По завершению рецепта-программы происходит генерация менеджером рецептов сообщений с параметрами сеанса, а также архивирование документа сеанса. Сообщения с параметрами сеанса могут быть использованы или просто для просмотра истории сеансов, или-же для формирования списка сеансов, например, в группе графиков для перехода к истории на время сеанса. По умолчанию архив отчётов настроен на глубину 10 документов, что вы можете изменить установкой атрибута "Размер архиву (n)" виджета документа.
Использование — исполнение
В режиме исполнения пользователь может выбрать нужный рецепт-программу и запустить его на исполнение, после чего отслеживать процесс исполнения или перейти к другим кадрам. Исполняемую программу пользователь может приостановить путём нажатия кнопки "Пауза" в месте кнопки "Запуск" или прервать путём нажатия кнопки "Останов". Кроме этого, пользователь может пропустит исполнение текущего шага, нажав кнопку "Пропустить". Также пользователь может пересмотреть или распечатать отчёты ранее исполняемых рецептов этого полноформатного кадра, для чего нужно нажать левой клавишей мыши на поле документа и полистать по архиву исполняемых рецептов, на появившейся справа панели навигации.
Свойства связывания и конфигурации
| Идентификатор | Имя | Тип | Конфигурация | Конфигурационный шаблон |
|---|---|---|---|---|
| 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, это упрощённый вариант кадра "Рецепт — исполнение", который разработан для размещения как виджет мнемосхем и он в основном и работает дополнением кадра "Рецепт — исполнение". Кадр, в целом, использует и представляет представительскую структуру менеджера рецептов.
Виджет содержит, слева направа и вниз:
Использование — разработка
Этот виджет может быть использован разработчиком при создании мнемосхем с отображением активности исполнения рецептов и быстрого контроля ними. Для использования нужно добавить данный виджет на мнемосхему, подстроить горизонтальный, вертикальный размер масштабом и подключит один параметр менеджера рецептов, путём установки связей.
Использование — исполнение
В режиме исполнения пользователь может выбрать нужный рецепт-программу, в диалоге выбора программы в дереве который появляется при нажатии кнопки рецепта, и запустить его на исполнение, после чего отслеживать процесс исполнения или перейти к другим кадрам. Исполняемую программу пользователь может приостановить путём нажатия кнопки "Пауза" в месте кнопки "Запуск" или прервать путём нажатия кнопки "Останов". Кроме этого, пользователь может пропустит исполнение текущего шага, нажав кнопку "Пропустить".
Свойства связывания и конфигурации
| Идентификатор | Имя | Тип | Конфигурация | Конфигурационный шаблон |
|---|---|---|---|---|
| dbDB | БД: База данных | Строка | Входная связь | Controller|dbDB |
| dbProgs | БД: Таблица программ | Строка | Входная связь | Controller|dbProgs |
| prExtCurCom | Контроллер: текущая команда | Строка | Входная связь | Controller|curCom |
| prExtMode | Контроллер: режим | Целый | Полная связь | Controller|mode |
| prExtProg | Контроллер: программа | Строка | Полная связь | Controller|prog |
| prExtStartTm | Контроллер: время запуска | Целый | Входная связь | Controller|startTm |
| prExtWork | Контроллер: рабочая | Объект | Входная связь | Controller|work |
| Libs/Prescriptions/ru - GFDL | February 2022 | OpenSCADA 1+r2802 |