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

Название	Версия	Лицензия	Источник	Языки	Автор	Иконка	Описание
Рецепты	1.1, 1.1	GPLv2	OscadaLibs.db (SQL, GZip) > DAQ.tmplb_PrescrTempl vcaBase.db (SQL, GZip) > VCA.wlb_prescr	en, uk, ru	Роман Савоченко		Библиотека элементов сценариев технологических процессов — рецептов. Основано: Сентябрь 2011 Спонсировано: Василий Григорьев, Лаборатория Вакуумных Технологий Спонсировано, на предмет шаблонизации контроллера: Магомед, SAVTECH Изначально создано, для кадров: в старой Wiki Использовано: Автоматизированная система управления вакуумной технологической установкой Задачи (To Do): - перевести элементы графической части на полную работу через менеджер рецептов, для возможности удалённого разнесения частей.

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

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

1 Концепция

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

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

• name — имя рецепта-программы;
• prgTxt — текст программы в виде XML-дерева.

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

• id — идентификатор-имя-тип команды в основе шага;
• name — персональное название шага, может отсутствовать;
• descr — персональное описание шага, берётся из соответствующего поля команды и может отсутствовать;
• backgrnd — признак исполнения шага в фоне, или последовательной группой шагов с этим признаком;
• arg{N} — определённые пользователем значения аргументов от 1 до 5.

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

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

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

• команда-параметр — размещённые в виде параметров контроллера логического уровня и с учётом их контекста, если в менеджере рецептов указан логический контроллер;
• команда-макрос — непосредственно в объекте менеджера рецептов по командам, хранимым в таблице "PrescrComs".

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

• rez — команда: результат исполнения; команда должна возвращать строку вида "{rezCode}:{TextMess}", где rezCode имеет состояния:
  • <0 — ошибка;
  • =0 — исполнение;
  • >0 — исполнение завершено;
  • =10 — исполнение в фоне с указанием обновлять статус исполнения.
• run — команда: исполнение;
• pause — команда: пауза, может быть приостановлена от себя установкой этого атрибута в TRUE;
• start — рецепт: запуск;
• stop — рецепт: корректное завершение;
• error — рецепт: завершение по ошибке;
• abort — рецепт: прерывание исполнения оператором;
• arg{1...5} — аргументы 1...5, в имени аргумента возможно указание минимальной и максимальной границы числового значения аргумента в виде "{имя}|{мин}|{макс}".

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

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

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

• name — имя команды;
• proc — текст процедуры команды, в первой строке содержит имя языка программы, на данный момент это "JavaLikeCalc.JavaScript", и текст программы непосредственно за языком; в процедуре команды доступны следующие контекстные параметры:
  • rez — результат выполнения команды, по умолчанию возвращает "Работа" ("0:Ожидание сейчас ...");
  • f_start — признак первого запуска процедуры;
  • f_frq — частота периодических вызовов процедуры;
  • arg{1...5} — значение аргумента 1...5;
  • tmp{1...10} — значение временного параметра (контекст вычисления) 1...10;

Пример текста программы для команды "Таймер", не зависящей от прикладной области:

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+"с";

• arg{1...5} — метка аргумента 1...5, только аргументы с меткой будут отображаться при редактировании шага рецепта; в метке возможно указание минимальной и максимальной границы числового значения аргумента в виде "{имя}|{мин}|{макс}".

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

• "Error" — вызывается после возникновения ошибки при выполнении шага рецепта;
• "Stop" — вызывается при останове рецепта, при нормальном завершении рецепта и принудительном останове пользователем.

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

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

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

• такой что поставляется с готовым и соответствующим пакетом дистрибутива Linux вроде "openscada-libdb-main", "openscada-LibDB.Main";
• наиболее актуальный и непосредственно полученный из репозитория subversion, преобразованный в файл БД SQLite путём:

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

• загрузка прикреплённого тут.

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

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

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

• "БД: Имя БД с таблицами" — БД, вроде "SQLite.vcaBase", где хранятся или должны храниться таблицы рецептов-программ.
• "БД: Таблица с программами" — название таблицы рецептов-программ, типично "PrescrProgs".
• "Список команд (comLs)" — перечень команд доступных для использования.
• "Имя выбранной программы (prog)" — состояние и установка названия выбранной программы в обработке менеджером.
• "Режим (mode)", "Текущий режим (curMode)" — установка и текущий режим менеджера, исполнения выбранного рецепта-программы: Завершение(-2); Ошибка(-1); Стоп(0); Исполнение(1); Пауза(2); Пропустить команду(3);
• "Время запуска (startTm)" — время запуска в секундах.
• "Текущая команда-шаг (curCom)" — текущая обрабатываемая команда.
• "Рабочая программа (work)" — актуальная и обрабатываемая на данный момент программа в объекте.

Функции

• Формирует "Список команд (comLs)", доступных для использования в пользовательских рецептах-программах.
• Обрабатывает "Имя выбранной программы (prog)", смена которой приводит к загрузке её последовательности команд в Рабочая программа (work)" или созданию новой программы.
• Исполняет программу в "Имя выбранной программы (prog)" после получения команды "Исполнение(1)" в "Режим (mode)" и отмечает этот процесс в: "Текущий режим (curMode)", "Время запуска (startTm)", "Текущая команда-шаг (curCom)" и "Рабочая программа (work)".
• Генерирует сообщения действий в течении исполнения рецепта на предмет:

КАТЕГОРИЯ: определяет идентификатор пользовательского рецепта-программы 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".

ВВ шаблона

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

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

• [JavaLikeCalc] или непосредственно объект JavaLikeCalc контроллера.

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 Шаблоны команд

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

ВВ шаблона

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

1. Создать и запустить объект логического контроллера с необходимыми свойствами планирования, или использовать созданный для менеджера рецепта.

2. Создать объект логического параметра и выбрать этот шаблон для него. Включить параметр.

5. РЕЗУЛЬТАТ: Запустив должны получить оперативные данные во вкладке "Атрибуты" для результата команды.

6. В процессе работы, через вкладку оперативных данных "Атрибуты", кроме получения результата, можно осуществлять оперативную настройку и контроль на предмет репрезентативных атрибутов команд рецепта и дополнительных:

• Время — установка времени таймера, в секундах.

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

ВВ шаблона

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

1. Создать и запустить объект логического контроллера с необходимыми свойствами планирования, или использовать созданный для менеджера рецепта.

2. Создать объект логического параметра и выбрать этот шаблон для него. Включить параметр.

5. РЕЗУЛЬТАТ: Запустив должны получить оперативные данные во вкладке "Атрибуты" для результата команды.

6. В процессе работы, через вкладку оперативных данных "Атрибуты", кроме получения результата, можно осуществлять оперативную настройку и контроль на предмет репрезентативных атрибутов команд рецепта и дополнительных:

• Время — установка времени таймера, в секундах.

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

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

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

• такой что поставляется с готовым и соответствующим пакетом дистрибутива Linux вроде "openscada-libdb-vca", "openscada-LibDB.VCA";
• наиболее актуальный и непосредственно полученный из репозиторию subversion, преобразованный в файл БД SQLite путём:

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

• загрузка прикреплённого тут.

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

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

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

• "Библиотека" — библиотека со списком программ и элементами управления библиотекой.
• "Программа" — список шагов-команд выбранного в библиотеке рецепта-программы с элементами управления.
• "Команда" — поле редактирования выбранного шага рецепта в составе выбора команды и установки имени, описания, флага фонового исполнения и значений доступных атрибутов, а также кнопки сохранения изменений.

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

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

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

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

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

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

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

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

• "Запуск/останов/пропуск" — две кнопки запуска и останова выбранной программы, а также кнопка пропуска выполнения текущего шага.
• "Библиотека" — библиотека со списком программ.
• "Программа" — документ списка шагов-команд, выбранного в библиотеке рецепта-программы. При исполнении в этом поле отслеживается текущее состояние исполнения путём соответствующей подсветки шагов.

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

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

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

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

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

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

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

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

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

• "Запуск/останов/пропуск" — две кнопки запуска и останова выбранной программы, а также кнопка пропуска исполнения текущего шага.
• "Библиотека" — кнопка отображения текущего рецепта-программы и вызова диалога выбора программы в дереве.
• "Программа" — документ со строками активных на текущий момент команд.

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

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

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

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