Бібліотеки/Основна

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

Other languages:

English • ‎mRussian • ‎Українська

Назва	Версія	Ліцензія	Джерело	Мови	Автор	Опис
Основна бібліотека	2.3	GPLv2	OscadaLibs.db (SQL, GZip) > DAQ.tmplb_base	en, uk, ru	Роман Савоченко	Бібліотека основних шаблонів опрацювання DAQ-джерел та похідних сервісів. Засновано: Січень 2006 Спонсоровано: залежно від елементу ... Використано: більшість проектів на OpenSCADA + завершити реалізацію запиту Часток Вмісту (шматків) у WebUser: HTTP Файловий Сервер після підтримки запиту HEAD у Protocol.HTTP (загальна функція переведення).

Бібліотеку створено для надання основних шаблонів опрацювання DAQ-джерел та похідних сервісів.

Назви шаблонів та їх параметрів доступні на мовах: Англійська, Українська та mRussian. Їх вихідний код написано у мово(людська)-незалежному режимі з викликом функції перекладу tr() та переклад цих повідомлень також доступний Англійською, Українською та mRussian.

Для підключення бібліотеки до проекту станції 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", зареєструвавши файл бази даних у конфігурації.

Для DAQ-шаблонів загалом Вам треба створити представницький об'єкт пристрою у модулі Логічного Рівня та обрати відповідний шаблон з бібліотеки шаблонів. Далі, для коректної конфігурації, дотримуйтесь специфіки шаблону у особистому описі.

1 Шаблони стандартних структур DAQ-параметрів

1.1 Аналоговий сигнал, уніфікований (anUnif)	2.4	GPLv2	*	en, uk, ru	Роман Савоченко

Загальний, представницький та уніфікований шаблон обробки аналогових вхідних сигналів. Шаблон формує структуру аналогового параметру (складного тегу) який може бути легко підключений до більшості віджетів та кадрів бібліотеки основних елементів інтерфейсу користувача просто вказавши об'єкт параметру.

Представницькою структурою аналогового параметру (складного тегу) є:

"Змінна (var)" — кінцева змінна параметру — інженерне реальне значення, доступне та придатне до архівації.
"Помилка (err)" — обов'язковий атрибут будь якого параметру, що містить комбінацію коду помилки та короткого опису, на кшталт "2:Немає даних або підключення до джерела". Шаблон резервує наступні коди помилок:
- 1, 2 — помилки обладнання, коли дані переважно помилкові;
- 3, 4 — помилки аварійної границі;
- 5, 6 — помилки попереджувальної границі;
- 7 — помилка швидкості зміни змінної.
"Придушення (alSup) та затримка (alDelay) порушень" — загальний контроль порушень щодо придушення та затримки.
"Шкала: мінімум (min)" та "Шкала: максимум (max)" — головна шкала кінцевої змінної, вихід за яку призводить до помилки апаратної границі. Шкала також використовується як шкала відображення тренду змінної на графіках.
"Логарифмічна шкала (log)" — ознака відображення тренду змінної на графіках у логарифмічній шкалі.
"Одиниця виміру (ed)" — одиниця виміру змінної.
"Точність (prec)" — кількість знаків після крапки, для позитивних значень, та точність (знаків загалом), для негативних, для відображення реальної кінцевої змінної на екрані.

Значні графічні образи представлення структури:

Спонсорування, розширення загального поля "DESCR" використанням для специфічних параметрів порушеньна на 0.1 ЛД^[!]: INSERTEC LTDA

Функції

Загальне опрацювання аналогового входу щодо:

проста корекція-калібрування за формулою "in = iMult*(in+iAdd)";
масштабування від апаратної границі [plcMin...plcMax] у головну границю [min...max], враховуючи квадратичну шкалу scSqr;

Апаратні границі може бути інвертовано та взагалі вимкнено однаковими значеннями максимуму та мінімуму, коли використовується тільки головна шкала.

дозвіл на перевищення границі вхідним значенням на величину plcExcess відсотків;
фільтрування зміни вхідного значення на час Tf.

Проста імітація аналогового входу, встановленням plcImit та підключенням джерела імітації-симуляції до plcImitIn.

Відсутність зв'язка plcImitIn (EVAL) призводить до генерації випадкового аналогового входу

Складна передобробка та повна генерація-імітація аналогового входу на внутрішній мові програмування OpenSCADA у конфігураційному ВВ inProc (із доповненням вбудованими правилами підсвітлення синтаксису), де ви можете оперувати наступними сервісними параметрами:

in [IN|OUT] — той самий сирий аналоговий ВВ;
var [IN] — ВВ кінцевої змінної;
min, max [IN] — ВВ головної шкали;
plcMin, plcMax [IN] — ВВ апаратної шкали;
plcImit, plcImitIn [IN] — ВВ простої імітації;
levErr, tErr [IN|OUT] — рівень аварії [-79...0] та текст помилки (формат атрибуту "err");
f_frq [IN] — частота обчислення, шаблонний ВВ;
this [IN] — посилання на об'єкт параметру, що виконує шаблон;
ctx [IN] — об'єкт користувацького контексту, що зберігається між циклами виклику;
toSave [OUT] — примусово зберігати об'єкт параметру при виході.

Проста підстановка значення subVar за помилкою (недостовірністю) вхідної змінної (EVAL) у режимах: "немає", "останнє" та "підстановка".
Опрацювання кінцевої змінної var на предмет порушення деяких границь та критеріїв, генеруючи аварії та відповідно встановлюючи атрибут err. Границі аварії можуть мати деякий гістерезис HystBnd, можуть бути затримані на час alDelay та можуть бути придушені встановленням alSup. Надаються наступні границі та критерії:

відсутність даних або підключення до джерела за вхідним значенням EVAL — код помилки 1 та рівень аварії 5;
перевищення апаратної границі вхідним значенням — код помилки 1,2 та рівень аварії 5;
перевищення аварійної границі кінцевою змінною [aMin...aMax] — код помилки 3,4 та рівень аварії 4;

Вимикається встановленням однакових або інверсних значень границі

перевищення попереджувальної границі кінцевою змінною [wMin...wMax] — код помилки 5,6 та рівень аварії 2;

Вимикається встановленням однакових або інверсних значень границі

велика швидкість зміни speed кінцевої змінної — код помилки 7 та рівень аварії 2.

Перевизначення специфічних параметрів у загальному атрибуті DESCR:

перший рядок — як опис повідомлень порушень;
поле CustomFlds — визначення користувацьких полів повідомлень порушень у формі "CustomFlds: {CustFld0} => {CustFld1} => ... => {CustFldN}";
поле CustomAlarms — перевизначення стандартних рівнів порушень для повідомлень порушень у формі "CustomAlarms: {ConErr};{BrdAlarm};{BrdWarn}".

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
in	Вхід	Реальний	Вхід	Не атрибут	Зв'язок	Вхід\|var
inProc	Вхідна процедура обробки	Текст	Вхід	Не атрибут	Константа
var	Змінна	Реальний	Вхід	Тільки читання	Змінна	0
ed	Одиниця виміру	Рядок	Вхід	Повний доступ	Змінна
min	Шкала: мінімум	Реальний	Вхід	Повний доступ	Змінна	0
max	Шкала: максимум	Реальний	Вхід	Повний доступ	Змінна	100
scSqr	Шкала: квадратична	Логічний	Вхід	Повний доступ	Змінна	0
subMode	Заміна: режим	Вибір цілих чисел	Вхід	Повний доступ	Змінна	0 0;1;2 немає;останнє;підстановка
subVar	Заміна: змінна	Реальний	Вхід	Повний доступ	Змінна	0
alSup	Придушення порушень	Логічний	Вхід	Повний доступ	Змінна
alDelay	Затримка порушень, секунди	Реальний	Вхід	Повний доступ	Змінна	0
aMin	Границя нижня аварійна	Реальний	Вхід	Повний доступ	Змінна	0
aMax	Границя верхня аварійна	Реальний	Вхід	Повний доступ	Змінна	0
wMin	Границя нижня попереджув.	Реальний	Вхід	Повний доступ	Змінна	0
wMax	Границя верхня попереджув.	Реальний	Вхід	Повний доступ	Змінна	0
HystBnd	Гистерезис порушення границь	Реальний	Вхід	Повний доступ	Змінна	1
speed	Швидкість зміни, %/цикл	Реальний	Вхід	Повний доступ	Змінна	0
prec	Точність, знаків	Цілий	Вхід	Повний доступ	Змінна	2
log	Логарифмічна шкала	Логічний	Вхід	Повний доступ	Змінна	0
Tf	Час фільтру, секунд	Реальний	Вхід	Повний доступ	Змінна	0
iAdd	Додаток до входу	Реальний	Вхід	Не атрибут	Константа	0
iMult	Множник входу	Реальний	Вхід	Не атрибут	Константа	1
plcMin	Мінімум шкали модуля	Реальний	Вхід	Не атрибут	Константа	0
plcMax	Максимум шкали модуля	Реальний	Вхід	Не атрибут	Константа	0
plcExcess	Дозволене перевищення шкали, %	Реальний	Вхід	Не атрибут	Константа	0
plcImit	Імітація ПЛК	Логічний	Вхід	Не атрибут	Константа	0
plcImitIn	Вхід імітації ПЛК	Реальний	Вхід	Не атрибут	Зв'язок	Імітація\|var
this	Об'єкт	Об'єкт	Вихід	Не атрибут	Змінна
SHIFR	Шифр	Рядок	Вхід	Не атрибут	Змінна
NAME	Ім'я	Рядок (переклад)	Вхід	Не атрибут	Змінна
DESCR	Опис	Текст (переклад)	Вхід	Не атрибут	Змінна
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0

Конфігурація та використання

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

2. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:

Вхід — зв'язати із джерелом "сирого" сигналу.
Вхідна процедура обробки — сформувати для складної передобробки та повної генерації-імітації аналогового входу на внутрішній мові програмування OpenSCADA. Є необов'язковою та має визначатися за складних випадків, наприклад:

проста та прозора попередня обробка з приведення відсотків навантаження ДБЖ до потужності, що можна виконати і за допомогою iMult:

in = 490*in/100;	//the UPS has 480W

реалізація лічильника вхідного сигналу — спожитої електрики ДБЖ:

//Checking for the data validity
if(ctx.cntr.isEVal())	ctx.cntr = this.var.get();
if(!in.isEVal()) {
	pUPS = 33;
	if(ctx.cntr.isEVal())	ctx.cntr = (pUPS+in)/(3600*f_frq);
	else ctx.cntr += (pUPS+in)/(3600*f_frq);
}

//Checking for the next month reset
month = 0; SYS.localtime(SYS.time(), 0, 0, 0, 0, month);
if(!ctx.month.isEVal() && month != ctx.month)	ctx.cntr = 0;
ctx.month = month;

in = ctx.cntr;

генерації розширених порушень — обробка зовнішніх сигналів, пов'язаних з джерелом:

gO = this.cntr().prm_grps;
if(SYS.DAQ.JavaLikeCalc.lib_aviary.sensorError(gO.prm_generic.PRG_Input_Err_T_room_S.get(),levErr,tErr));
else if(!(tVl=gO.prm_alarms.PRG_Alarm_T_max.get()).isEVal() && tVl)
	levErr = -4, tErr = "11:above the set limit";
else if(!(tVl=gO.prm_alarms.PRG_Alarm_T_min.get()).isEVal() && tVl)
	levErr = -4, tErr = "11:below the set limit";

Мінімум та максимум шкали модуля — має вказуватися у випадку значного розходження апаратної шкали із загальною, наприклад:

вхід сирий та вимірюється значенням струму [4...20]мА, тобто тут треба вказати 4 та 20 мА;
попередній випадок де треба просто та прозоро відкалібрувати покази — зразковим приладом задаємо 4мА та 20мА та вказуємо тут реальні виміряні значення "сирого" сигналу.

Додаток та множник до входу — використати для простої лінійної корекції входу, наприклад:

калібрування показів, що менш прозоро та ці коефіцієнти мають вираховуватися за формулами:

iAdd = ((plcMin*precMeasMax)/plcMax - precMeasMin)*(plcMax/(plcMax-plcMin))

iMult = (plcMax - plcMin) / (precMeasMax - precMeasMin)

Дозволене перевищення шкали — встановити за потреби перевищення значенням загальної шкали та коли ця шкала починає виконувати рекомендавчу функцію, скажемо для початкового відображення історії у цій шкалі.
Імітація та вхід імітації ПЛК — визначити за потреби імітації входу згідно опису у функціях.

4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: змінної, стану помилки; та генерацію порушень, якщо стан помилки ненульовий.

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

Шкала: мінімум та максимум — суворо встановити у діапазон зміни даних за наявністю та відповідно до апаратної границі, інакше значення буде викривлене! За відсутності апаратної границі ця, основна границя, є довільною та дорадчою, хоча вихід значення за неї також супроводжується порушенням.
Шкала: квадратична — встановити якщо апаратна шкала квадратична.
Час фільтру — встановити у час фільтрації для зашумлених сигналів.
Заміна: режим та змінна — встановити у потрібний режим підстановки-заміни значення за недостовірною змінною.
Придушення порушень — встановити за потреби повного придушення порушень параметру — вимкнути їх генерацію взагалі.
Затримка порушень — встановити час затримки генерації порушення, для виключення частої генерації, характерної для непевних джерел даних, що відрізняються короткочасною втратою зв'язку.
Границя верхня/нижня аварійна/попереджувальна — встановити коли треба генерувати порушення за виходом за аварійну/попереджувальну границі.
Гистерезис порушення границь — встановити у гістерезис зняття порушення, тобто зняття порушення відбувається на вказаний відсоток пізніше, щоб запобігти частій генерації за коливанням значення біля границі.
Швидкість зміни — встановити якщо треба попереджати про швидку зміну значення.
Назва, Опис, Одиниця виміру, Точність, Логарифмічна шкала — встановити за потреби такої інформації при відображені, або як елементи паспорту.

1.2 Аналоговий сигнал, уніфікований, стани порушень (anUnifSt)	1.3	GPLv2	*	en, uk, ru	Роман Савоченко

Загальний, представницький та уніфікований шаблон обробки аналогових вхідних сигналів, розширений бінарними станами індикації порушень. Шаблон засновано на базовому шаблоні "Аналоговий сигнал, уніфікований" з відповідною до нього представницькою структурою та деякими відмінностями, характерними до незалежного розвитку та розширення.

Бінарні стани передбачалося для зручного використання у алгоритмах роботи за границями порушення об'єкту параметру, переважно у блокових схемах загальних алгоритмів керування.

Функції
Переважно відповідають базовому шаблону "Аналоговий сигнал, уніфікований" та додатково надаються ознаки порушень границь: "H", "L", "HH", "LL", "EVAL".

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація
ВВ шаблону "Аналоговий сигнал, уніфікований"
H	Порушення верхньої попереджув. границі	Логічний	Вихід	Тільки читання	Змінна
L	Порушення нижньої попереджув. границі	Логічний	Вихід	Тільки читання	Змінна
HH	Порушення верхньої аварійної границі	Логічний	Вихід	Тільки читання	Змінна
LL	Порушення нижньої аварійної границі	Логічний	Вихід	Тільки читання	Змінна
EVAL	Помилка значення	Логічний	Вихід	Тільки читання	Змінна

Конфігурація та використання
Повністю ідентичне базовому "Аналоговий сигнал, уніфікований" за відмінністю використання ознак порушень границь: "H", "L", "HH", "LL", "EVAL"; на які можна під'єднуватися із зовнішніх обчислень.

1.3 Ручний ввід, уніфікований (manInUnif)	1.2	GPLv2	*	en, uk, ru	Роман Савоченко

Загальний, представницький та уніфікований шаблон ручного вводу та сигналу аналогового виходу. Шаблон формує структуру параметру (складного тегу) ручного вводу, який може бути легко підключений до більшості віджетів та кадрів бібліотеки основних елементів інтерфейсу користувача просто вказавши об'єкт параметру, контроль переважно можна здійснювати через панель контролю Елемент кадр.

Представницькою структурою параметру (складного тегу) ручного вводу є:

"Змінна (var)" — кінцева змінна параметру — інженерне реальне значення, доступне та придатне до архівації.
"Введення змінної (varIn)" — атрибут введення нового інженерного значення, який надалі потрапляє до змінної.
"Помилка (err)" — обов'язковий атрибут будь якого параметру, що містить комбінацію коду помилки та короткого опису, на кшталт "2:Немає даних або підключення до джерела". Шаблон резервує наступні коди помилок:
- 1, 2 — помилки обладнання, коли дані переважно помилкові;
- 3, 4 — помилки аварійної границі;
- 5, 6 — помилки попереджувальної границі;
- 7 — помилка швидкості зміни змінної.
"Придушення (alSup) та затримка (alDelay) порушень" — загальний контроль порушень щодо придушення та затримки.
"Шкала: мінімум (min)" та "Шкала: максимум (max)" — головна шкала кінцевої змінної, вихід за яку призводить до помилки апаратної границі. Шкала також використовується як шкала відображення тренду змінної на графіках.
"Логарифмічна шкала (log)" — ознака відображення тренду змінної на графіках у логарифмічній шкалі.
"Одиниця виміру (ed)" — одиниця виміру змінної.
"Точність (prec)" — кількість знаків після крапки, для позитивних значень, та точність (знаків загалом), для негативних, для відображення реальної кінцевої змінної на екрані.

Значні графічні образи представлення структури:

Бібліотека основних елементів інтерфейсу користувача:
- Елемент кадр

Функції

Загальне опрацювання аналогового входу щодо:

проста корекція-калібрування за формулою "in = iMult*(in+iAdd)";
масштабування від апаратної границі [plcMin...plcMax] у головну границю [min...max], враховуючи квадратичну шкалу scSqr;

Апаратні границі може бути інвертовано та взагалі вимкнено однаковими значеннями максимуму та мінімуму, коли використовується тільки головна шкала.

дозвіл на перевищення границі вхідним значенням на величину plcExcess відсотків;
фільтрування зміни вхідного значення на час Tf.

Опрацювання кінцевої змінної var на предмет порушення деяких границь та критеріїв, генеруючи аварії та відповідно встановлюючи атрибут err. Границі аварії можуть мати деякий гістерезис HystBnd, можуть бути затримані на час alDelay та можуть бути придушені встановленням alSup. Надаються наступні границі та критерії:

відсутність даних або підключення до джерела за вхідним значенням EVAL — код помилки 1 та рівень аварії 5;
перевищення апаратної границі вхідним значенням — код помилки 1,2 та рівень аварії 5;
перевищення аварійної границі кінцевою змінною [aMin...aMax] — код помилки 3,4 та рівень аварії 4;

Вимикається встановленням однакових або інверсних значень границі

перевищення попереджувальної границі кінцевою змінною [wMin...wMax] — код помилки 5,6 та рівень аварії 2;

Вимикається встановленням однакових або інверсних значень границі

велика швидкість зміни speed кінцевої змінної — код помилки 7 та рівень аварії 2.

Зворотне перетворення введеного інженерного значення змінної та запис у вихід.

За відсутності підключення "Входу/Виходу" запису не здійснюється та відбувається автономна робота.

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
inout	Вхід/Вихід	Реальний	Вихід	Не атрибут	Зв'язок	Parameter\|var
var	Змінна	Реальний	Вхід	Тільки читання	Змінна	0
varIn	Введення змінної	Реальний	Вхід	Повний доступ	Змінна	0
ed	Одиниця виміру	Рядок	Вхід	Повний доступ	Змінна
min	Шкала: мінімум	Реальний	Вхід	Повний доступ	Змінна	0
max	Шкала: максимум	Реальний	Вхід	Повний доступ	Змінна	100
scSqr	Шкала: квадратична	Логічний	Вхід	Повний доступ	Змінна	0
alSup	Придушення порушень	Логічний	Вхід	Повний доступ	Змінна	0
alDelay	Затримка порушень, секунди	Логічний	Вхід	Повний доступ	Змінна
aMin	Границя нижня аварійна	Реальний	Вхід	Повний доступ	Змінна	0
aMax	Границя верхня аварійна	Реальний	Вхід	Повний доступ	Змінна	0
wMin	Границя нижня попереджув.	Реальний	Вхід	Повний доступ	Змінна	0
wMax	Границя верхня попереджув.	Реальний	Вхід	Повний доступ	Змінна	0
HystBnd	Гистерезис порушення границь	Реальний	Вхід	Повний доступ	Змінна	1
speed	Швидкість зміни, %/цикл	Реальний	Вхід	Повний доступ	Змінна	0
prec	Точність, знаків	Цілий	Вхід	Повний доступ	Змінна	2
log	Логарифмічна шкала	Логічний	Вхід	Повний доступ	Змінна	0
Tf	Час фільтру, секунд	Реальний	Вхід	Повний доступ	Змінна	0
iAdd	Додаток до входу	Реальний	Вхід	Не атрибут	Константа	0
iMult	Множник входу	Реальний	Вхід	Не атрибут	Константа	1
plcMin	Мінімум шкали модуля	Реальний	Вхід	Не атрибут	Константа	0
plcMax	Максимум шкали модуля	Реальний	Вхід	Не атрибут	Константа	0
plcExcess	Дозволене перевищення шкали, %	Реальний	Вхід	Не атрибут	Константа	0
this	Об'єкт	Об'єкт	Вихід	Не атрибут	Змінна
SHIFR	Шифр	Рядок	Вхід	Не атрибут	Змінна
NAME	Ім'я	Рядок (переклад)	Вхід	Не атрибут	Змінна
DESCR	Опис	Текст (переклад)	Вхід	Не атрибут	Змінна
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0

Конфігурація та використання

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

2. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:

Вхід/Вихід — зв'язати із джерелом "сирого" сигналу ВВ, або не прив'язувати для автономного режиму.
Мінімум та максимум шкали модуля — має вказуватися у випадку значного розходження апаратної шкали із загальною, для прикладу дивіться шаблон "Аналоговий сигнал, уніфікований".
Додаток та множник до входу — використати для простої лінійної корекції входу, для прикладу дивіться шаблон "Аналоговий сигнал, уніфікований".
Дозволене перевищення шкали — встановити за потреби перевищення значенням загальної шкали та коли ця шкала починає виконувати рекомендавчу функцію, скажемо для початкового відображення історії у цій шкалі.

4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: змінної, стану помилки; та генерацію порушень, якщо стан помилки ненульовий; та він буде доступний до встановлення нових значень.

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

Шкала: мінімум та максимум — суворо встановити у діапазон зміни даних за наявністю та відповідно до апаратної границі, інакше значення буде викривлене! За відсутності апаратної границі ця, основна границя, є довільною та дорадчою, хоча вихід значення за неї також супроводжується порушенням.
Шкала: квадратична — встановити якщо апаратна шкала квадратична.
Час фільтру — встановити у час фільтрації для зашумлених сигналів.
Придушення порушень — встановити за потреби повного придушення порушень параметру — вимкнути їх генерацію взагалі.
Затримка порушень — встановити час затримки генерації порушення, для виключення частої генерації, характерної для непевних джерел даних, що відрізняються короткочасною втратою зв'язку.
Границя верхня/нижня аварійна/попереджувальна — встановити коли треба генерувати порушення за виходом за аварійну/попереджувальну границі.
Гистерезис порушення границь — встановити у гістерезис зняття порушення, тобто зняття порушення відбувається на вказаний відсоток пізніше, щоб запобігти частій генерації за коливанням значення біля границі.
Швидкість зміни — встановити якщо треба попереджати про швидку зміну значення.
Назва, Опис, Одиниця виміру, Точність (знаків), Логарифмічна шкала — встановити за потреби такої інформації при відображені, або як елементи паспорту.

1.4 Дискретний блок, уніфікований (digitBlockUnif)	1.0	GPLv2	*	en, uk, ru	Роман Савоченко

Загальний, представницький та уніфікований шаблон блоку поєднання дискретних параметрів у пристрій загального контролю. Шаблон формує структуру дискретного параметру-блоку (складного тегу) який може бути легко підключений до більшості віджетів та кадрів бібліотеки основних елементів інтерфейсу користувача просто вказавши об'єкт параметру.

Представницькою структурою дискретного параметру (складного тегу) є об'єкт засувки із характерними двома станами та трьома командами, які у кінцевому представленні можуть мати інше значення та назву:

"Стан "Відкрито" (st_open)" — стан засувки "Відкрито". Є первинним сигналом стану, який може використовуватися без наступного, коли 1 (true) — "Відкрито", а 0 (false) — "Закрито".
"Стан "Закрито" (st_close)" — стан засувки "Відкрито".
"Команда "Відкрити" (com)" — команда засувки "Відкрити". Є первинним сигналом команди, який може використовуватися без наступного, коли 1 (true) — "Відкрити", а 0 (false) — "Закрити".
"Команда "Закрити" (close)" — команда засувки "Закрити".
"Команда "Зупинити" (stop)" — команда засувки "Зупинити".

Значні графічні образи представлення структури:

Функції

Пряме отримання, за посиланням, двох станів (тільки читання) та трьох команд (читання та запис).
Можливість утримання команди протягом визначеного часу та зняття їх.
Можливість перевизначення станів та команд відповідним налаштуванням елементів інтерфейсу, як то digStts, для статусів, та digComs, для команд.

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
com	Команда "Відкрити"	Логічний	Вихід	Повний доступ	Зв'язок	Кран\|com
close	Команда "Закрити"	Логічний	Вихід	Повний доступ	Зв'язок	Кран\|close
stop	Команда "Зупинити"	Логічний	Вихід	Повний доступ	Зв'язок	Кран\|stop
st_open	Стан "Відкрито"	Логічний	Вхід	Тільки читання	Зв'язок	Кран\|st_open
st_close	Стан "Закрито"	Логічний	Вхід	Тільки читання	Зв'язок	Кран\|st_close
tCmd	Час утримання команди, секунди	Цілий	Вхід	Не атрибут	Константа	5
last_cmd	Остання команда	Цілий	Вихід	Не атрибут	Змінна	0
w_tm	Лічильник обробки команди	Реальний	Вихід	Не атрибут	Змінна	0
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0

Конфігурація та використання

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

2. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:

Всі стани та команди — зв'язати із джерелом "сирого" сигналу.
Час утримання команди, секунди — встановити у потрібне значення утримання або у 0 для вимкнення цієї функції.

4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: станів та команд.

5. У процесі роботи, через вкладку оперативних даних "Атрибути", окрім отримання результату можна здійснювати оперативний контроль, видачею команд.

1.5 Сигналізація дискретна (digAlarm)	1.3	GPLv2	*	en, uk, ru	Роман Савоченко

Загальний, представницький шаблон обробки окремого дискретного параметру (складного тегу) із формування сигналізації за визначеним критерієм. Шаблон формує структуру дискретного параметру (складного тегу) який може бути легко підключений до більшості віджетів та кадрів бібліотеки основних елементів інтерфейсу користувача просто вказавши об'єкт параметру.

Шаблон надає окремі поля представницької структури дискретного параметру та додає поле помилки:

"Стан "Відкрито" (st_open)" — стан "Відкрито".
"Стан "Закрито" (st_close)" — стан "Відкрито".
"Помилка (err)" — обов'язковий атрибут будь якого параметру, що містить комбінацію коду помилки та короткого опису, на кшталт "1:Немає даних або підключення до джерела". Шаблон резервує наступні коди помилок:
- 1 — помилки обладнання, коли дані переважно помилкові;
- 3 — порушення за визначеної умови.
"Придушення (alSup) та затримка (alDelay) порушень" — загальний контроль порушень щодо придушення та затримки.

Функції

Пряме отримання, за посиланням, первинного стану та формування двох репрезентативних станів з можливістю їх інверсії stInv.
Складна передобробка та повна генерація-імітація дискретного входу на внутрішній мові програмування OpenSCADA у конфігураційному ВВ inProc (із доповненням вбудованими правилами підсвітлення синтаксису), де ви можете оперувати наступними сервісними параметрами:

in [IN|OUT] — той самий сирий дискретний ВВ;
levErr, tErr [IN|OUT] — рівень аварії [-79...0] та текст помилки (формат атрибуту "err");
f_frq [IN] — частота обчислення, шаблонний ВВ;
this [IN] — посилання на об'єкт параметру, що виконує шаблон;
ctx [IN] — об'єкт користувацького контексту, що зберігається між циклами виклику.

Опрацювання дискретного входу in на предмет формування порушення та відповідного встановлення атрибуту err, за умови "{st}:{lev}:{mess}", тобто генерація порушення з рівнем lev та текстом mess за стану входу st (0|1). Що може бути затримано на час alDelay та придушено встановленням alSup.
Перевизначення специфічних параметрів у загальному атрибуті DESCR:

перший рядок — як опис повідомлень порушень;
поле CustomFlds — визначення користувацьких полів повідомлень порушень у формі "CustomFlds: {CustFld0} => {CustFld1} => ... => {CustFldN}".

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
alrm	Сигнал "{st}:{lev}:{mess}"	Рядок	Вхід	Не атрибут	Константа
stInv	Інверсія стану	Логічний	Вхід	Не атрибут	Константа
in	Вхід	Логічний	Вхід	Тільки читання	Зв'язок	Input\|in
inProc	Вхідна процедура обробки	Текст	Вхід	Не атрибут	Константа
alSup	Придушення порушень	Логічний	Вхід	Повний доступ	Змінна
alDelay	Затримка порушень, секунди	Реальний	Вхід	Повний доступ	Змінна	0
st_open	Стан "Відкрито"	Логічний	Вхід	Тільки читання	Змінна
st_close	Стан "Закрито"	Логічний	Вхід	Тільки читання	Змінна
SHIFR	Шифр	Рядок	Вхід	Не атрибут	Змінна
NAME	Ім'я	Рядок (переклад)	Вхід	Не атрибут	Змінна
DESCR	Опис	Текст (переклад)	Вхід	Не атрибут	Змінна
this	Об'єкт	Об'єкт	Вхід	Не атрибут	Змінна
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0

Конфігурація та використання

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

2. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:

"Сигнал "{st}:{lev}:{mess}" — визначити критерій формування порушення, залишити порожнім для вимкнення генерації порушень.
"Інверсія стану" — встановити для інвертування репрезентативних атрибутів, тобто "st_open" встановити за "in" рівного false.
"Вхід" — зв'язати із джерелом "сирого" сигналу.
Вхідна процедура обробки — сформувати для складної передобробки та повної генерації-імітації дискретного входу на внутрішній мові програмування OpenSCADA. Наприклад:

повне створення складного статусу:

gO = this.cntr().prm_grps;
status = gO.prm_generic.PRG_Input_Err_T_Zone1_S.get();
in = gO.prm_generic.SET_CalcFan_UseSensor_T1.get() || !(status == 0 || status == 2 || status == 3);

4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: змінної, стану помилки; та генерацію порушень, якщо стан помилки ненульовий.

1.6 Стан за кодом (codeState)	1.4	GPLv2	*	en, uk, ru	Роман Савоченко

Варіант загального, представницького та уніфікованого шаблону блоку поєднання дискретних параметрів, розширений більш ніж двома станами та трьома командами які можна закодувати цілим значенням. Шаблон формує структуру параметру (складного тегу) стану за кодом який може бути легко підключений до більшості віджетів та кадрів бібліотеки основних елементів інтерфейсу користувача просто вказавши об'єкт параметру.

Спонсорування: Вінницька Птахофабрика

Представницькою структурою параметру (складного тегу) стану за кодом є:

"Стан "Текст" (st_text)" — текстовий опис стану.
"Команда "Текст" (com_text)" — текст команди.
"Команди (digComs)" — загальний перелік можливих команд, для формування обрання.
"Помилка (err)" — обов'язковий атрибут будь якого параметру, що містить комбінацію коду помилки та короткого опису, на кшталт "1:Немає даних або підключення до джерела". Шаблон резервує наступні коди помилок:
- 1 — помилки обладнання, коли дані переважно помилкові.
"Придушення (alSup) та затримка (alDelay) порушень" — загальний контроль порушень щодо придушення та затримки.

Значні графічні образи представлення структури:

Бібліотека основних елементів інтерфейсу користувача:

Функції

Пряме отримання, за посиланням, коду стану та команди (тільки читання), а також встановлення тексту стану згідно до переліку станів stats.
Опрацювання тексту команди com_text на предмет пошуку її у загальному переліку команд coms та видача отриманого коду команди на вихід.
Формування із загальному переліку команд coms переліку команд для обрання у digComs.
Складна обробка та повна генерація-імітація коду стану, а також обробка коду або тексту команди для цільових дій, на внутрішній мові програмування OpenSCADA у конфігураційному ВВ inProc, де ви можете оперувати наступними сервісними параметрами:

in [IN|OUT] — ВВ коду статусу;
text [OUT] — пряме встановлення тексту статусу;
coms [IN] — перелік наявних команд, відповідного ВВ;
com_text [IN|OUT] — текст отриманої команди;
levErr, tErr [IN|OUT] — рівень аварії [-79...0] та текст помилки (формат атрибуту "err");
f_frq [IN] — частота обчислення, шаблонний ВВ;
this [IN] — посилання на об'єкт параметру, що виконує шаблон;
ctx [IN] — об'єкт користувацького контексту, що зберігається між циклами виклику.

Формування порушення та відповідне встановлення атрибуту err, за умови встановлення у процедурі обробки або відсутності зв'язку (in = EVAL). Що може бути затримано на час alDelay та придушено встановленням alSup.

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
in	Вхід	Цілий	Вхід	Тільки читання	Зв'язок	Signal\|in
out	Вихід	Цілий	Вихід	Тільки читання	Зв'язок	Signal\|out
inProc	Вхідна процедура обробки	Текст	Вхід	Не атрибут	Константа
alSup	Придушення порушень	Логічний	Вхід	Повний доступ	Змінна
alDelay	Затримка порушень, секунди	Реальний	Вхід	Повний доступ	Змінна	0
st_text	Стан "Текст"	Рядок	Вхід	Тільки читання	Змінна
stats	Стани, рядки "{code}:{State}"	Текст	Вхід	Повний доступ	Змінна
com_text	Команда "Текст"	Рядок	Вхід	Повний доступ	Змінна
coms	Команди-стани, рядки "{code}:{State}"	Текст	Вхід	Повний доступ	Змінна
digComs	Команди	Текст	Вхід	Тільки читання	Змінна
SHIFR	Код	Рядок	Вхід	Не атрибут	Змінна
NAME	Ім'я	Рядок (переклад)	Вхід	Не атрибут	Змінна
DESCR	Опис	Текст (переклад)	Вхід	Не атрибут	Змінна
this	Об'єкт	Об'єкт	Вихід	Не атрибут	Змінна
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0

Конфігурація та використання

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

2. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:

Вхід та Вихід — зв'язати із джерелом "сирого" сигналу.
Вхідна процедура обробки — сформувати для обробки та повної генерації-імітації входу, та видачі специфічного виходу, на внутрішній мові програмування OpenSCADA. Наприклад:

повне створення коду статусу та формування порушення:

gO = this.cntr().prm_grps;
if(gO.prm_fansControl.PRG_CntrFan_AutoMode_G1.get().isEVal())	in = 4;
else {
  if(!(tVl=gO.prm_fansControl.PRG_CntrFan_Alarm_ThermalRelay.get()).isEVal() && tVl)
    levErr = -4, tErr = "11:alarm";
  if(gO.prm_fansControl.PRG_CntrFan_AutoMode_G1.get())
    in = gO.prm_fansControl.PRG_CntrFan_On_G1.get() ? 1 : 2;
  else in = 3;
}

формування тексту часу годинника та виклик синхронізації часу — пряме встановлення тексту статусу та виконання специфічних команд:

curTm = SYS.time();
text = SYS.strftime(curTm, "%H։%M %d.%m.%Y");
gO = this.cntr().prm_grps;
if(!(tVl=gO.prm_other.PRG_RTC_UNIX.get()).isEVal()) {
  text += " ("+(tVl-curTm).toString(10,0,true)+")";
}

if(com_text.length && !com_text.isEVal() && (tVl=coms.match("^([^:]+):"+com_text,"m")).length && tVl[1] == 1) {
  gO.prm_other.SET_RTC_New_UNIX.set(curTm);
  gO.prm_other.KEY_RTC_set_time.set(true);
}

4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: входу, виходу, стану за кодом-входом, стану помилки; та генерацію порушень, якщо стан помилки ненульовий.

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

Стани — встановити у перелік відповідності коду стану до його тексту.
Команди-стани — встановити у перелік відповідності коду стану-команди до його тексту.
Команда "Текст" — встановити у текст команди, яку описано у переліку команд, для перетворення у код та видачі.
Придушення порушень — встановити за потреби повного придушення порушень параметру — вимкнути їх генерацію взагалі.
Затримка порушень — встановити час затримки генерації порушення, для виключення частої генерації, характерної для непевних джерел даних, що відрізняються короткочасною втратою зв'язку.

1.7 ПІД сигнал, уніфікований, стани порушень (pidUnif)	1.2	GPLv2	*	en, uk, ru	Роман Савоченко

Загальний, представницький та уніфікований шаблон інтерфейсу до Пропорційного Інтегрального Диференційного (ПІД) регулятору заснованому на аналоговому вхідному сигналі, розширеному бінарними станами індикації порушень. Шаблон формує структуру аналогового ПІД-регулятору, який може бути легко підключений до деяких кадрів та віджетів бібліотеки основних елементів інтерфейсу користувача, просто вказавши об'єкт параметру.

Спонсоровано: ТОВ "ДІЯ"

Представницькою структурою аналогового ПІД-регулятору є:

"Змінна (var)" — кінцева змінна параметру — інженерне реальне значення, доступне та придатне до архівації.
"Помилка (err)" — обов'язковий атрибут будь якого параметру, що містить комбінацію коду помилки та короткого опису, на кшталт "2:Немає даних або підключення до джерела". Шаблон резервує наступні коди помилок:
- 1, 2 — помилки обладнання, коли дані переважно помилкові;
- 3, 4 — помилки аварійної границі;
- 5, 6 — помилки попереджувальної границі;
- 7 — помилка швидкості зміни змінної.
"Придушення (alSup) та затримка (alDelay) порушень" — загальний контроль порушень щодо придушення та затримки.
"Завдання (sp)" — завдання для досягнення значенням аналоговим сигналом у автоматичному режимі.
"Ручний ввід (manIn)" — атрибут введення нового значення виходу, яке надалі потрапляє до виходу у ручному режимі.
"Вихід (out)" — вихід (сигнал контролю) ПІД-регулятору.
"Режим: автомат (auto)" — режим "Автомат" ПІД-регулятору.
"Режим: каскад (casc)" — режим "Каскад" ПІД-регулятору.
"Шкала: мінімум (min)" та "Шкала: максимум (max)" — головна шкала кінцевої змінної, вихід за яку призводить до помилки апаратної границі. Шкала також використовується як шкала відображення тренду змінної на графіках.
"Логарифмічна шкала (log)" — ознака відображення тренду змінної на графіках у логарифмічній шкалі.
"Одиниця виміру (ed)" — одиниця виміру змінної.
"Точність (prec)" — кількість знаків після крапки, для позитивних значень, та точність (знаків загалом), для негативних, для відображення реальної кінцевої змінної на екрані.

Значні графічні образи представлення структури:

Функції

Загальне опрацювання аналогового входу щодо:

проста корекція-калібрування за формулою "in = iMult*(in+iAdd)";
масштабування від апаратної границі [plcMin...plcMax] у головну границю [min...max], враховуючи квадратичну шкалу scSqr;
дозвіл на перевищення границі вхідним значенням на величину plcExcess відсотків;
фільтрування зміни вхідного значення на час Tf.

Проста імітація аналогового входу, встановленням plcImit та підключенням джерела імітації-симуляції до plcImitIn.
Опрацювання кінцевої змінної var на предмет порушення деяких границь та критеріїв, генеруючи аварії та відповідно встановлюючи атрибут err. Границі аварії можуть мати деякий гістерезис HystBnd, можуть бути затримані на час alDelay та можуть бути придушені встановленням alSup. Надаються наступні границі та критерії:

відсутність даних або підключення до джерела за вхідним значенням EVAL — код помилки 1 та рівень аварії 5;
перевищення апаратної границі вхідним значенням — код помилки 1,2 та рівень аварії 5;
перевищення аварійної границі кінцевою змінною [aMin...aMax] — код помилки 3,4 та рівень аварії 4;

Вимикається встановленням однакових або інверсних значень границі

перевищення попереджувальної границі кінцевою змінною [wMin...wMax] — код помилки 5,6 та рівень аварії 2;

Вимикається встановленням однакових або інверсних значень границі

велика швидкість зміни speed кінцевої змінної — код помилки 7 та рівень аварії 2.

Передавання специфічної ПІД інформації, контролю та атрибутів коефіцієнтів до та з ПЛК або іншого джерела даних із регулюванням.

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
in	Вхід	Реальний	Вхід	Не атрибут	Зв'язок	Signal\|in
sp	Завдання	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|sp
var	Змінна	Реальний	Вхід	Тільки читання	Змінна	0
manIn	Ручний ввід, %	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|manIn
out	Вихід, %	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|out
auto	Режим: автомат	Логічний	Вхід	Повний доступ	Зв'язок	ПІД\|auto
casc	Режим: каскад	Логічний	Вхід	Повний доступ	Зв'язок	ПІД\|casc
ed	Одиниця виміру	Рядок	Вхід	Повний доступ	Змінна
min	Шкала: мінімум	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|min
max	Шкала: максимум	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|max
scSqr	Шкала: квадратична	Логічний	Вхід	Повний доступ	Змінна	0
alSup	Придушення порушень	Логічний	Вхід	Повний доступ	Змінна	0
alDelay	Затримка порушень, секунди	Реальний	Вхід	Повний доступ	Змінна	0
aMin	Границя нижня аварійна	Реальний	Вхід	Повний доступ	Змінна	0
aMax	Границя верхня аварійна	Реальний	Вхід	Повний доступ	Змінна	0
wMin	Границя нижня попереджув.	Реальний	Вхід	Повний доступ	Змінна	0
wMax	Границя верхня попереджув.	Реальний	Вхід	Повний доступ	Змінна	0
HystBnd	Гістерезис порушень границь	Реальний	Вхід	Повний доступ	Змінна	0
speed	Швидкість зміни, %/цикл	Реальний	Вхід	Повний доступ	Змінна	0
prec	Точність, знаків	Цілий	Вхід	Повний доступ	Змінна	2
log	Логарифмічна шкала	Логічний	Вхід	Повний доступ	Змінна	0
H	Порушення верхньої попереджув. границі	Логічний	Вихід	Тільки читання	Змінна	0
L	Порушення нижньої попереджув. границі	Логічний	Вихід	Тільки читання	Змінна	0
HH	Порушення верхньої аварійної границі	Логічний	Вихід	Тільки читання	Змінна	0
LL	Порушення нижньої аварійної границі	Логічний	Вихід	Тільки читання	Змінна	0
EVAL	Значення невірогідне	Логічний	Вихід	Тільки читання	Змінна	0
Tf	Час фільтру, мілісекунд	Реальний	Вхід	Повний доступ	Змінна	0
Kp	Kп	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|Kp
Ti	Tі, мілісекунд	Цілий	Вхід	Повний доступ	Зв'язок	ПІД\|Ti
Kd	Кп диференціалу	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|Kd
Td	Tд, мілісекунд	Цілий	Вхід	Повний доступ	Зв'язок	ПІД\|Td
Tzd	T фільтру диференціалу, мілісекунд	Цілий	Вхід	Повний доступ	Зв'язок	ПІД\|Tzd
Zi	Нечутливість, %	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|Zi
Hup	Верхня границя виходу, %	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|Hup
Hdwn	Нижня границя виходу, %	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|Hdwn
K1	Коефіцієнт входу 1	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|K1
K2	Коефіцієнт входу 2	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|K2
K3	Коефіцієнт входу 3	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|K3
K4	Коефіцієнт входу 4	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|K4
iAdd	Додаток до входу	Реальний	Вхід	Не атрибут	Константа	0
iMult	Множник входу	Реальний	Вхід	Не атрибут	Константа	1
plcMin	Мінімум шкали модуля	Реальний	Вхід	Не атрибут	Константа	1
plcMax	Максимум шкали модуля	Реальний	Вхід	Не атрибут	Константа	5
plcExcess	Дозволене перевищення шкали, %	Реальний	Вхід	Не атрибут	Константа	0
plcImit	Імітація ПЛК	Логічний	Вхід	Не атрибут	Константа	0
plcImitIn	Вхід імітації ПЛК	Реальний	Вхід	Не атрибут	Зв'язок	Імітація\|var
this	Об'єкт	Об'єкт	Вихід	Не атрибут	Змінна
SHIFR	Шифр	Рядок	Вхід	Не атрибут	Змінна
NAME	Ім'я	Рядок (переклад)	Вхід	Не атрибут	Змінна
DESCR	Опис	Текст (переклад)	Вхід	Не атрибут	Змінна
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0

Конфігурація та використання

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

2. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:

Вхід — зв'язати із джерелом "сирого" аналогового сигналу.
Завдання, Ручний ввід, Вихід, Режим: автомат, Режим: каскад, Шкала: мінімум, Шкала: максимум, Kп, Tі, Кп диференціалу, Tд, T фільтру диференціалу, мілісекунд, Нечутливість, Верхня границя виходу, Нижня границя виходу, Коефіцієнт входу 1, Коефіцієнт входу 2, Коефіцієнт входу 3, Коефіцієнт входу 4 — зв'язати із джерелом ПІД-регулятору.
Додаток та множник до входу — використати для простої лінійної корекції входу, для прикладу дивіться шаблон "Аналоговий сигнал, уніфікований".
Дозволене перевищення шкали — встановити за потреби перевищення значенням загальної шкали та коли ця шкала починає виконувати рекомендавчу функцію, скажемо для початкового відображення історії у цій шкалі.
Імітація та вхід імітації ПЛК — визначити за потреби імітації входу згідно опису у функціях.

4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: змінної, стану помилки; та генерацію порушень, якщо стан помилки ненульовий. Також отримаємо всі ПІД-специфічні атрибути.

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

Шкала: мінімум та максимум — суворо встановити у діапазон зміни даних за наявністю та відповідно до апаратної границі, інакше значення буде викривлене!
Шкала: квадратична — встановити якщо апаратна шкала квадратична.
Час фільтру — встановити у час фільтрації для зашумлених сигналів.
Придушення порушень — встановити за потреби повного придушення порушень параметру — вимкнути їх генерацію взагалі.
Затримка порушень — встановити час затримки генерації порушення, для виключення частої генерації, характерної для непевних джерел даних, що відрізняються короткочасною втратою зв'язку.
Границя верхня/нижня аварійна/попереджувальна — встановити коли треба генерувати порушення за виходом за аварійну/попереджувальну границі.
Гистерезис порушення границь — встановити у гістерезис зняття порушення, тобто зняття порушення відбувається на вказаний відсоток пізніше, щоб запобігти частій генерації за коливанням значення біля границі.
Швидкість зміни — встановити якщо треба попереджати про швидку зміну значення.
Назва, Опис, Одиниця виміру, Точність, Логарифмічна шкала — встановити за потреби такої інформації при відображені, або як елементи паспорту.

1.8 Імпульсний ПІД сигнал, уніфікований, стани порушень (pidUnifImp)	1.1	GPLv2	*	en, uk, ru	Роман Савоченко

Загальний, представницький та уніфікований шаблон інтерфейсу до Пропорційного Інтегрального Диференційного (ПІД) регулятору заснованому на аналоговому вхідному сигналі але із ШІМ-виходом, розширеному бінарними станами індикації порушень та переважно схоже на шаблон "ПІД сигнал, уніфікований, стани порушень". Шаблон формує структуру імпульсного ПІД-регулятору, який може бути легко підключений до деяких кадрів та віджетів бібліотеки основних елементів інтерфейсу користувача, просто вказавши об'єкт параметру.

Спонсоровано: ТОВ "ДІЯ"

Представницька структура імпульсних ПІД-регуляторів переважно еквівалентна шаблону "ПІД сигнал, уніфікований, стани порушень" та містить низку атрибутів, специфічних до імпульсного виходу та атрибут визначення роботи цього регулятору у аналоговому режимі, тобто цей шаблон є навіть більш узагальнювальним:

"Імпульсний вихід у гору (impQup)" та "Імпульсний вихід до низу (impQdwn)" — сигнали ШІМ-виходу.
"Режим: аналоговий (analog)" — ознака роботи регулятору у режимі аналогового виходу.

Функції
Переважно те саме що у базового шаблону "ПІД сигнал, уніфікований, стани порушень" та додатково надаються імпульсно-специфічні атрибути: "Імпульсний вихід у гору", "Імпульсний вихід до низу", "Режим: аналоговий", "T період імпульсів", "Мінімальна довжина імпульсу", "Рейтинг фактор імпульсів".

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
ВВ шаблону "ПІД сигнал, уніфікований, стани порушень"
impQup	Імпульсний вихід у гору	Логічний	Вхід	Тільки читання	Зв'язок	ПІД\|impQupTm
impQdwn	Імпульсний вихід до низу	Логічний	Вхід	Тільки читання	Зв'язок	ПІД\|impQdwnTm
analog	Режим: аналоговий	Логічний	Вхід	Тільки читання	Зв'язок	ПІД\|analog
TImpPer	T період імпульсів, мілісекунд	Цілий	Вхід	Повний доступ	Зв'язок	ПІД\|TImpPer
TImpMin	Мінімальна довжина імпульсу, мілісекунд	Цілий	Вхід	Повний доступ	Зв'язок	ПІД\|TImpMin
KImpRfact	Рейтинг фактор імпульсів	Реальний	Вхід	Повний доступ	Зв'язок	ПІД\|KImpRfact

Конфігурація та використання
Переважно те саме що у базового шаблону "ПІД сигнал, уніфікований, стани порушень" із відмінністю використання імпульсо-специфічного виходу: "Імпульсний вихід у гору", "Імпульсний вихід до низу", "Режим: аналоговий", "T період імпульсів", "Мінімальна довжина імпульсу", "Рейтинг фактор імпульсів".

2 Шаблони комплексних об'єктів

У окремих випадках, коли деякий об'єкт є лише частиною загальної автоматизованої системи та такий що не потребує глибокої деталізації до рівня сигналів та параметрів (складного тегу) довкола них, включно без потреби архівації, їх зручно уніфікувати у одному представницькому об'єкті джерела даних OpenSCADA із відповідним консолідованим представленням та контролем об'єкту, як набору простих атрибутів із елементами сигналізації. Така консолідація часто відбувається довкола спеціалізованих джерел даних, доступ до даних яких зазвичай й реалізуються окремим протоколом обміну, але без уніфікації передачі цих даних на рівень візуалізації та сигналізації за окремим атрибутом об'єкту.

Загалом, представницькою структурою комплексного об'єкту є:

"Всі елементи (items)" — спільний атрибут об'єктного типу де атрибути фізичного об'єкту прямо описуються атрибутами об'єктного типу у items та із визначеними описовими атрибутами у кожному:
- id — ідентифікатор атрибуту;
- descr — текстовий опис атрибуту;
- wr — ознака можливості запису до атрибуту або перелік варіантів значень для їх обрання, через символ ';';
- alarm — код порушення:
  - 0 — відсутність порушення — "НОРМА";
  - 1 — порушення рівня "ПОПЕРЕДЖЕННЯ";
  - 2 — порушення рівня "АВАРІЯ";
- val — значення атрибуту;
- set — значення атрибуту для встановлення атрибутів доступних для запису.
"Помилка (err)" — обов'язковий атрибут загального статусу порушення за об'єктом цілком, що містить комбінацію коду помилки та короткого опису, на кшталт "2:Немає даних або підключення до джерела". Зарезервовано наступні коди помилок:
- 1 — порушення рівня "ПОПЕРЕДЖЕННЯ";
- 2 — порушення рівня "АВАРІЯ";
- 3 — недостовірність або відсутність даних.
"Придушення (alSup) та затримка (alDelay) порушень" — загальний контроль порушень щодо придушення та затримки.

Узагальнюючи, такий шаблон (прошарок над об'єктом фізичних джерел даних) доцільно створювати над джерелом сирих даних, яке надає ці дані у вигляді атрибутів та без обробки, та цей шаблон відтак здійснює:

збірку цих атрибутів сирого джерела до items;
опрацювання властивостей атрибутів;
перевірку та передачу команд встановлення значень;
опрацювання умов порушень як за окремими атрибутами так і загалом за об'єктом, разом з яким ці порушення можуть фіксуватися у таблиці поточних порушень, зазвичай функцією alarmSet().

Окрім шаблонів комплексного об'єкту цей механізм загально-об'єктного контролю може реалізовуватися шаблонами реалізації логічного рівня доступу до даних, як то у IEC60870.

Для представлення даних механізму загально-об'єктного контролю наразі надається відповідний кадр "Властивості об'єкту", який надає ці властивості у вигляді таблиці-переліку із підсвіченням порушень та можливістю зміни обраних та редагованих властивостей-рядків.

2.1 Джерело Безперебійного Живлення (UPS)	1.3	GPLv2	*	en, uk, ru	Роман Савоченко

Об'єднання даних Джерела Безперебійного Живлення у комплексному об'єкті атрибуту "Всі елементи". Шаблон розроблено для використання із модулем джерела даних "Система" у частині "ДБЖ" та представлення цих даних кадром "Властивості об'єкту" як комплексний об'єкт із властивостями, сигналізацією за окремими границями та записом.

Спонсоровано: ТОВ "ДІЯ"

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
srcAddr	Адреса вихідного об'єкту	Рядок	Вхід	Не атрибут	Константа
alSup	Придушення порушень	Логічний	Вхід	Повний доступ	Змінна
alDelay	Затримка порушень, секунди	Реальний	Вхід	Повний доступ	Змінна	0
items	Всі елементи	Об'єкт	Вихід	Повний доступ	Змінна
bChL	Заряд батареї низький	Реальний	Вхід	Повний доступ	Змінна	20
bChLL	Заряд батареї критичний	Реальний	Вхід	Повний доступ	Змінна	5
inVL	Низька вхідна напруга	Реальний	Вхід	Повний доступ	Змінна	210
inVH	Висока вхідна напруга	Реальний	Вхід	Повний доступ	Змінна	250
inFLL	Дуже низька вхідна частота	Реальний	Вхід	Повний доступ	Змінна	40
inFL	Низька вхідна частота	Реальний	Вхід	Повний доступ	Змінна	45
inFH	Висока вхідна частота	Реальний	Вхід	Повний доступ	Змінна	55
inFHH	Дуже висока вхідна частота	Реальний	Вхід	Повний доступ	Змінна	60
loadH	Навантаження високе	Реальний	Вхід	Повний доступ	Змінна	80
loadHH	Навантаження дуже високе	Реальний	Вхід	Повний доступ	Змінна	100
tH	Температура висока	Реальний	Вхід	Повний доступ	Змінна	50
tHH	Температура дуже висока	Реальний	Вхід	Повний доступ	Змінна	70
this	Об'єкт	Об'єкт	Вхід	Не атрибут	Змінна
SHIFR	Шифр	Рядок	Вхід	Не атрибут	Змінна
NAME	Ім'я	Рядок (переклад)	Вхід	Не атрибут	Змінна
DESCR	Опис	Текст (переклад)	Вхід	Не атрибут	Змінна
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0

Конфігурація та використання

1. Створити об'єкт контролеру джерела у модулі "Система" та встановити його Ідентифікатор на кшталт "SYSData".

2. Створити об'єкт параметру джерела у попередньо створеному об'єкті контролера та встановити його Ідентифікатор на кшталт "UPS".

3. Створити та запустити об'єкт логічного контролеру або використати будь який наявний з потрібними властивостями планування.

4. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

5. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:

Адреса вихідного об'єкту — у адресу об'єкту вихідного параметру ДБЖ (дивіться крок 1), на кшталт "System.SYSData.UPS".

6. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати у атрибуті параметру items цей об'єкт з усіма атрибутами та їх властивостями. У випадку деяких порушень отримаємо відповідну інформацію у атрибуті параметру err, стосовно чого ви можете налаштувати атрибути границь відповідних порушень.

7. У візуальному інтерфейсі розробки модуля Vision розташуйте кадр "Властивості об'єкту" до будь-якої сторінки та зв'яжіть його із об'єктом цього параметру, створеного на кроці 4.

8. РЕЗУЛЬТАТ: При виконанні сторінки ви отримаєте таблицю з даними об'єкту, повідомленням про порушення у заголовку та об'єкті сигналізації та можливістю встановлення властивостей доступних до запису.

2.2 Мережеві пристрої за SNMP (SNMP)	1.1	GPLv2	*	en, uk, ru	Роман Савоченко

Об'єднання даних пристрою, доступного за протоколом SNMP, у комплексному об'єкті атрибуту "Всі елементи". Шаблон розроблено для використання із модулем джерела даних "SNMP" та представлення цих даних кадром "Властивості об'єкту" як комплексний об'єкт із властивостями, сигналізацією за окремими границями та записом. Враховуючи велику специфіку та розмаїття пристроїв доступних за протоколом SNMP, цей шаблон фактично є заготовкою та прикладом створення на його основі шаблону до відповідного пристрою із специфічною до нього обробкою вхідних властивостей, формування порушень та можливістю запису.

Спонсорувано: ПАС ХАРТРОН

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
srcAddr	Адреса вихідного об'єкту	Рядок	Вхід	Не атрибут	Константа
manTables	Ручні таблиці	Рядок	Вхід	Не атрибут	Константа
alSup	Придушення порушень	Логічний	Вхід	Повний доступ	Змінна
alDelay	Затримка порушень, секунди	Реальний	Вхід	Повний доступ	Змінна	0
items	Всі елементи	Об'єкт	Вихід	Повний доступ	Змінна
this	Об'єкт	Об'єкт	Вхід	Не атрибут	Змінна
SHIFR	Шифр	Рядок	Вхід	Не атрибут	Змінна
NAME	Ім'я	Рядок (переклад)	Вхід	Не атрибут	Змінна
DESCR	Опис	Текст (переклад)	Вхід	Не атрибут	Змінна
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000

Конфігурація та використання

1. Створити об'єкт контролеру джерела у модулі "SNMP" та встановити його Ідентифікатор на кшталт "SYSData".

2. Створити об'єкт параметру джерела у попередньо створеному об'єкті контролера та встановити його Ідентифікатор на кшталт "DEV".

3. Створити та запустити об'єкт логічного контролеру або використати будь який наявний з потрібними властивостями планування.

4. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

5. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:

Адреса вихідного об'єкту — у адресу об'єкту параметру вихідного пристрою SNMP (дивіться крок 1), на кшталт "SNMP.SYSData.DEV";
Ручні таблиці — вручну введіть деякі статичні MIB-змінні.

6. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати у атрибуті параметру items цей об'єкт з усіма атрибутами та їх властивостями. У випадку деяких порушень отримаємо відповідну інформацію у атрибуті параметру err, стосовно чого ви можете налаштувати атрибути границь відповідних порушень.

7. У візуальному інтерфейсі розробки модуля Vision розташуйте кадр "Властивості об'єкту" до будь-якої сторінки та зв'яжіть його із об'єктом цього параметру, створеного на кроці 4.

8. РЕЗУЛЬТАТ: При виконанні сторінки ви отримаєте таблицю з даними об'єкту, повідомленням про порушення у заголовку та об'єкті сигналізації та можливістю встановлення властивостей доступних до запису.

2.3 Дисковий SMART (DiskSMART)	1.0	GPLv2	*	en, uk	Роман Савоченко

Об'єднання даних дискового SMART у комплексному об'єкті атрибуту "Всі елементи". Шаблон розроблено для використання із модулем джерела даних "Система" у частині "SMART Диску" та представлення цих даних кадром "Властивості об'єкту" як комплексний об'єкт із властивостями і сигналізацією за загальних помилок. Деякі атрибути SMART можуть бути невідомими або помилковими для визначеного диску через їх відсутність у БД дисків, особливо для сучасних SSD, тож шаблоном надається властивість перевизначення назв атрибутів.

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
srcAddr	Адреса вихідного об'єкту	Рядок	Вхід	Не атрибут	Константа
items	Всі елементи	Об'єкт	Вихід	Повний доступ	Змінна
defs	Визначення елементів	Текст	Вхід	Повний доступ	Змінна
this	Об'єкт	Об'єкт	Вхід	Не атрибут	Змінна
SHIFR	Шифр	Рядок	Вхід	Не атрибут	Змінна
NAME	Назва	Рядок	Вхід	Не атрибут	Змінна
DESCR	Опис	Рядок	Вхід	Не атрибут	Змінна
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000

Конфігурація та використання

1. Створити об'єкт контролеру джерела у модулі "Система" та встановити його Ідентифікатор на кшталт "SYSData", встановити властивість "Авт. створювати активні джерела даних" у "Всі джерела" і запустити встановленням "Виконується".

2. Створити та запустити об'єкт логічного контролеру або використати будь який наявний з потрібними властивостями планування.

3. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

4. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:

Адреса вихідного об'єкту — у адресу об'єкту вихідного параметру диску SMART на кшталт "System.SYSData.DiskSMARTsda".

5. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати у атрибуті параметру items цей об'єкт з усіма атрибутами та їх властивостями. У випадку деяких порушень отримаємо відповідну інформацію у атрибуті параметру err.

6. У візуальному інтерфейсі розробки модуля Vision розташуйте кадр "Властивості об'єкту" до будь якої сторінки та зв'яжіть його із об'єктом цього параметру, створеного на кроці 3.

7. РЕЗУЛЬТАТ: При виконанні сторінки ви отримаєте таблицю з даними об'єкту, повідомленням про порушення у заголовку та об'єкті сигналізації і можливістю перевизначити назви атрибутів SMART.

3 Сервіси

3.1 Сповіщувач за SMS, EMail-SMTP (ntf)	1.0	GPLv2	* => UserProtocol	en, uk, ru	Роман Савоченко

Комплексний шаблон сповіщення містить частини диспетчеру та вихідний користувацький протокол сповіщення за EMail(SMTP) та SMS.

Загальна працемісткість: > 1.05 ЛД^[!]
Спонсорування, ініціативної імплементації частини SMS-надсилання на 0.2 ЛД^[!]: Олег Сидашов
Спонсорування, уніфікації, додання SMTP та контролеру сповіщення на 0.65 ЛД^[!]: ТОВ "СВІТоВИР АВТоМАТИК"

ДИСПЕТЧЕР може виконуватися для вказаних повідомлень буферу повідомлень OpenSCADA та застосовується на Логічному рівні або об'єкті контролеру модуля JavaLikeCalc.

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
io	UserPrt: Вихідний ВВ	Об'єкт	Вхід	Не атрибут	Змінна
tr	UserPrt: Транспорт	Об'єкт	Вхід	Не атрибут	Змінна
tmOut	Максимальний таймаут сповіщення, секунд	Цілий	Вхід	Не атрибут	Константа	5
messLev	Рівень сповіщень, негативний для порушень	Цілий	Вхід	Не атрибут	Константа	1
messCat	Категорія сповіщень, шаблон або регулярний вираз	Рядок	Вхід	Не атрибут	Константа	al:
messCatExcl	Категорія виключення повідомлень, у регулярному виразі	Рядок	Вхід	Не атрибут	Константа
emailState	Поточний стан сповіщення Ел.поштою	Рядок	Вихід	Тільки читання	Змінна
emailTrAddr	Вихідний транспорт SMTP підключень, порожньо для вимкнення	Рядок	Вхід	Не атрибут	Константа	Sockets.out_SMTP
emailAuth	Автентифікація, порожньо для вимкнення	Рядок	Вхід	Не атрибут	Константа	user:pass
emailSender	Відправник	Рядок	Вхід	Не атрибут	Константа	noreply@oscada.org
emailReceiver	Адреса призначення одержувача	Рядок	Вхід	Не атрибут	Константа	test@oscada.org
emailTopic	Тема Ел.пошти	Рядок	Вхід	Не атрибут	Константа	Повідомлення
emailMess	Повідомлення Ел.пошти	Рядок	Вхід	Не атрибут	Константа
SMSState	Поточний стан повідомлення SMS	Рядок	Вихід	Тільки читання	Змінна
SMSTrAddr	Послідовний транспорт SMS, порожньо для вимкнення	Рядок	Вхід	Не атрибут	Константа	Serial.out_SMS
SMSPin	Пін-код SMS, порожньо для вимкнення	Рядок	Вхід	Не атрибут	Константа	1111
SMSTel	Адреса одержувача SMS, номер телефону	Рядок	Вхід	Не атрибут	Константа	+380XXXXXXXXX
SMSTextMd	SMS у текстовому режимі, інакше PDU	Логічний	Вхід	Не атрибут	Константа	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0

Конфігурація та використання

1. Створити параметр у об'єкті контролеру Логічного рівня або об'єкт контролеру у модулі DAQ.JavaLikeCalc.

2. Створити вихідний транспорт типу "Послідовний" та встановити його Ідентифікатор на кшталт "SMS", один транспорт підходить для багатьох одержувачів.

3. Встановити властиву адресу, тільки для Послідовного пристрою. Швидкість, формат асинхронних даних та таймаути послідовного порту будуть налаштовані функцією.

4. Створити вихідний транспорт типу "Сокети" або "SSL" та встановити його Ідентифікатор на кшталт "SMTP", один транспорт підходить для багатьох одержувачів.

5. Встановити властиву адресу, для Сокетів(25) або SSL(465). Таймаути транспорту будуть налаштовані функцією.

6. У вкладці "Конфігурація шаблону" ви маєте встановити:

Максимальний таймаут сповіщення, секунд.
Рівень повідомлень, негативний для порушень.
Категорія повідомлень, шаблон або регулярний вираз.
Категорія виключення повідомлень, у регулярному виразі
Вихідний транспорт SMTP підключень, порожньо для вимкнення.
Автентифікація, порожньо для вимкнення.
Відправник.
Адреса призначення одержувача.
Тема Ел.пошти.
Повідомлення Ел.пошти.
Послідовний транспорт SMS, порожньо для вимкнення.
Пін-код SMS, порожньо для вимкнення.
Адреса одержувача SMS, номер телефону.
SMS у текстовому режимі, інакше PDU.

7. РЕЗУЛЬТАТ: Надсилання вказаних сповіщень як SMS або EMail(SMTP).

"SMS" ЧАСТИНА ВИХІДНОГО КОРИСТУВАЦЬКОГО ПРОТОКОЛУ надає операції із SMS за допомогою GSM-модему, підключеного як послідовний пристрій. Наразі підтримується лише відправка SMS сповіщень на номер віддаленого мобільного телефону або GSM-модему. Для надсилання підтримується: вимкнення ЛУНИ, перевірка та встановлення PIN, надсилання у PDU та текстовому режимі.

Структура XML-запиту вихідного користувацького протоколу
<cmd pin="1111" tel="+380XXXXXXXXX" text="{0|1}" err="1:Error">{SMSText}</cmd>

cmd — команда, наразі наявне лише "send";

pin — PIN-код для доступу до SIM-карти;

tel — номер телефону одержувача (віддалений номер телефону або GSM-модем);

text{0,1} — SMS у текстовому режимі, лише ASCII;

SMSText — текст повідомлення;

err — встановлюється у результат запиту.

Конфігурація та використання

1. Створити вихідний транспорт типу "Послідовний" та встановити його Ідентифікатор на кшталт "SMS", один транспорт підходить для багатьох одержувачів.

2. Встановити властиву адресу. Швидкість, формат асинхронних даних та таймаути послідовного порту будуть налаштовані функцією.

3. Створити потрібний об'єкт користувацького протоколу заснованого на шаблонах, із Ідентифікатором на кшталт "SMS".

4. Розмістити деякі команди запиту безпосередньо у наявній або новій внутрішній процедурі OpenSCADA на кшталт:

req = SYS.XMLNode("send"); req.setAttr("ProtIt","SMS").setAttr("pin","1111").setAttr("tel","+380XXXXXXXXX").setText("Notify message");
SYS.Transport.Serial.out_SMS.messIO(req, "UserProtocol");
rez = req.attr("err").toInt() ? req.attr("err") : "OK";

5. РЕЗУЛЬТАТ: У змінній rez ви отримаєте "OK" якщо не виникло жодної помилки та повідомлення вдало надіслано одержувачу.

"SMTP" ЧАСТИНА ВИХІДНОГО КОРИСТУВАЦЬКОГО ПРОТОКОЛУ надає операції із SMTP-сервером щодо доставки електронної пошти відправленням через TCP-Сокет або SSL. Наразі підтримуються: TCP, SSL, AUTH, кодування теми у UTF-8.

Структура XML-запиту вихідного користувацького протоколу
<send auth="{user}:{pass}" from="{FromAddr}" to="{ToAddr}" topic="{My Topic}" err="1:Error">{MessageText}</send>

topic — тема повідомлення;

from — адреса відправника;

to — адреса призначення отримувача;

auth — користувач та пароль отримувача;

MessageText — текст повідомлення;

err — встановлюється у результат запиту.

Конфігурація та використання

1. Створити вихідний транспорт типу "Сокети" або "SSL" та встановити його Ідентифікатор на кшталт "SMTP", один транспорт підходить для багатьох одержувачів.

2. Встановити властиву адресу, для Сокетів(25) або SSL(465). Таймаути транспорту будуть налаштовані функцією.

3. Створити потрібний об'єкт користувацького протоколу заснованого на шаблонах, із Ідентифікатором на кшталт "SMTP".

4. Розмістити деякі команди запиту безпосередньо у наявній або новій внутрішній процедурі OpenSCADA на кшталт:

req = SYS.XMLNode("send");
req.setAttr("ProtIt","SMTP").setAttr("from","noreply@oscada.org").setAttr("to","oscada@oscada.org").setAttr("topic","My topic").setText("My message");
SYS.Transport.Sockets.out_SMTP.messIO(req, "UserProtocol");
rez = req.attr("err").toInt() ? req.attr("err") : "OK";

5. РЕЗУЛЬТАТ: У змінній rez ви отримаєте "OK" якщо не виникло жодної помилки та повідомлення вдало надіслано одержувачу.

3.2 Опрацювання ініціативних підключень щодо асоційованих вихідних транспортів (initConAssociateTrs)	1.2	GPLv2	*	en, uk, ru	Роман Савоченко

Шаблон служби опрацювання вхідних ініціативних підключень створено для надання останньої ланки реалізації та підтримки концепції збору даних у пасивному режимі та ініціативного підключення, а саме — контролю асоційованих транспортів створюваних вхідним транспортом за кожного підключення.

Після реалізації цього контролю разом із новою функцією загального-уніфікованого підключення вихідного транспорту outAt() цей шаблон став застарілим для джерел адаптованих до використання нового механізму, але ви все ще можете використовувати шаблон для неадаптованих джерел.

Функцію створення вихідних асоційованих транспортів за підключенням на вхідний наразі підтримує лише модуль транспортів "Сокети" та для TCP-сокетів.

Загальна працемісткість: 0.9 ЛД^[!]
Спонсоровано, загальну працемісткість: Еліор Турабоєв, ТОВ BLUE STAR GROUP

Контроль асоційованих транспортів передбачає:

отримання переліку асоційованих транспортів функцією вхідного транспорту assignTrsList();
читання із нових транспортів (відкритих) ідентифікаційної інформації яка наразі репрезентує тільки ідентифікатор об'єкту джерела;
- пошук за отриманим ідентифікатором об'єкта джерела та призначення йому адреси цього транспорту;
- реєстрацію у атрибуті об'єктного типу "prcTr".
перевірка діючих транспортів на предмет їх закриття (від'єднання), щодо чого здійснюється дереєстрація у атрибуті об'єктного типу "prcTr" та встановлення об'єкту джерела порожнього значення; вимкнені вихідні асоціативні транспорти повторно використовуються вхідним за отриманням нового підключення після чого він вмикається.

Шаблон може керувати контейнерами об'єктів джерел даних, побудованих як у вигляді DAQ-об'єктів контролерів, так і параметрів логічного рівня, що репрезентують джерело даних та мають поле визначення адреси транспорту та що загалом визначається конфігураційним полем "srcObjPath" із форматом {CntrAddr}:{TrCntrFldAddr}, де:

CntrAddr — адреса контейнеру, наприклад: "ModBus" — для DAQ-об'єктів контролерів, "LogicLev.CntrPLC" — для параметрів логічного рівня;
TrCntrFldAddr — адреса поля контролю транспорту у об'єкті джерела, наприклад — "%2fcntr%2fcfg%2fADDR" для "ModBus"; що може бути отримано у конфігураторі за історією наведення на поля контролю у рядку статусу.

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
inTransport	Вхідний транспорт	Рядок	Вхід	Не атрибут	Постійна	InitiateCons
outTrTm	Таймаути вихідних транспортів	Рядок	Вхід	Не атрибут	Постійна	10:0.1
srcObjPath	Шлях об'єкту джерела	Рядок	Вхід	Не атрибут	Постійна	ModBus:%2fcntr%2fcfg%2fADDR
prcTr	Опрацьовані транспорти	Об'єкт	Вихід	Тільки читання	Змінна
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000

Конфігурація та використання

1. Створити вхідний транспорт прийняття ініціативних підключень у модулі "Сокети" із назвою на кшталт "InitiateCons".

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

3. Передбачити контейнер джерел даних до яких асоціативні транспорти мають під'єднуватися, який може бути або DAQ-модулем (як то "DAQ.ModBus"), або логічним контролером (як то "DAQ.LogicLev.Sources"), чи параметром у ньому (як то "DAQ.LogicLev.PLC.Sources"), із вмістом параметрів логічного рівня, що представляють джерело даних.

4. Для цього шаблону створити та запустити об'єкт логічного контролеру або використати будь який наявний з потрібними властивостями планування.

5. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

6. У вкладці "Конфігурація шаблону" об'єкту логічного параметру треба встановити:

Вхідний транспорт — у значення ідентифікатору вхідного транспорту, створеного у пункті 1, на кшталт "InitiateCons;
Таймаути вихідних транспортів — збільшити першу цифру для дуже повільних підключень та типове є нормальним для більшості ситуацій;
Шлях об'єктів джерела — встановити згідно до пункту 3, для першої частини, та у шлях до контрольного поля, для другої частини, наприклад, та типово для "ModBus", це — "ModBus:%2fcntr%2fcfg%2fADDR".

6. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати у атрибуті параметру prcTr інформацію щодо вдало опрацьованих, а відтак і вдало пов'язаних із транспортом, джерелах даних. У випадку деяких порушень отримаємо відповідну інформацію у атрибуті параметру err. Інформація про відсутність представницького об'єкту для отриманого ідентифікатору поміщається у протоколі порушень.

3.3 Погода (weather)	1.0	GPLv2	*	en, uk	Роман Савоченко

Шаблон отримання даних погоди з різних погодних служб у Інтернет і первинно лише Open Weather.

Погодні дані діляться на поточні і прогноз із їх розміщенням у відповідних об'єктах, де поточні атрибути розташовуються прямо у корені та прогноз на день (об'єкт "day") і час (об'єкт "time") всередині відповідного дня згідно до поточної часової зони. Ці дані отримуються за відповідним розкладом незалежно для поточних і прогнозу, та типово поточні запитуються щогодинно, а прогноз один раз на день. Дані можуть бути доступні користувачу як прямо, так і посередництвом спеціально-створеного віджету основної бібліотеки.

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
schedCur	Планування за CRON оновлення поточних даних	Рядок	Вхід	Не атрибут	Константа	0 8-20 * * *
schedFC	Планування за CRON оновлення прогнозованих даних	Рядок	Вхід	Не атрибут	Константа	0 8 * * *
city	ІД Міста	Рядок	Вхід	Повний доступ	Змінна	709932
current	Поточне	Об'єкт	Вхід	Тільки читання	Змінна
forecast	Прогноз	Об'єкт	Вхід	Тільки читання	Змінна
this	Параметр	Об'єкт	Вхід	Не атрибут	Змінна	0
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0

Конфігурація та використання

1. Для цього шаблону створити та запустити об'єкт логічного контролеру або використати будь який наявний з потрібними властивостями планування.

2. Створити об'єкт логічного параметру та обрати цей шаблон для нього. Ввімкнути параметр.

3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру треба встановити:

Планування за CRON оновлення поточних даних — у значення необхідного планування для отримання поточних даних у форматі CRON, за порожнього отримання здійснюватиметься із періодом виконання об'єкту контролеру;
Планування за CRON оновлення прогнозованих даних — у значення необхідного планування для отримання прогнозованих даних у форматі CRON, за порожнього отримання здійснюватиметься із періодом виконання об'єкту контролеру.

4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати у атрибуті параметру Поточне (current) і Прогноз (forecast) та після встановлення кода вашого міста у відповідному атрибуті. Код міста ви можете отримати із офіційного сайту у адресі (URL) після пошуку вашого міста у формі сайту.

4 Для WebUser

4.1 WebUser: HTTP Файловий Сервер (fileServerHTTP)	1.1	GPLv2	*	en, uk	Роман Савоченко

Шаблон для реалізації Файлового Серверу HTTP безпосередньо в OpenSCADA, який корисний за відсутності повнофункціонального для функцій обслуговування файлових запитів із OpenSCADA Web-інтерфейсів.

Наразі реалізовано лише запити файлів HTTP запитом GET. Також реалізуються шматки і запити Часток Контенту за одним діапазоном зі змушуванням до цього режиму за певного налаштованого розміру файлу.

ВВ шаблону

Ідентифікатор	Ім'я	Тип	Режим	Атрибут	Конфігурація	Значення
rez	Результат	Рядок	Вхід	Не атрибут	Змінна	200 OK
HTTPreq	HTTP запит	Рядок	Вхід	Не атрибут	Змінна
url	URL	Рядок	Вхід	Не атрибут	Змінна
sender	Відправник	Рядок	Вхід	Не атрибут	Змінна
page	WWW-сторінка	Рядок	Вихід	Не атрибут	Змінна
HTTPvars	HTTP змінні	Об'єкт	Вихід	Не атрибут	Змінна
baseD	Базовий каталог	Рядок	Вхід	Не атрибут	Константа	/data/share_res/local/Lib/
fSzSolidLim	Обмеження на розмір файлу для читання цілком, інакше вмикається вміст частками	Реальний	Вхід	Не атрибут	Константа	10e6
tr	Транспорт	Об'єкт	Вихід	Не атрибут	Змінна
prt	Протокол	Об'єкт	Вихід	Не атрибут	Змінна
f_start	Прапорець запуску функції	Логічний	Вхід	Не атрибут	Змінна	0
f_frq	Частота обчислення функції, Гц	Реальний	Вхід	Не атрибут	Змінна	1000
f_stop	Прапорець зупинки функції	Логічний	Вхід	Не атрибут	Змінна	0
f_err	Помилка функції	Рядок	Вхід	Не атрибут	Змінна	0

Конфігурація і використання

1. Створити сторінку у модулі UI.WebUser із певним доцільним ідентифікатором PageId.

2. У вкладці "Процедура" необхідно встановити:

Базовий каталог від якого сторінка буде шукати файли.
Обмеження на розмір файлу для читання цілком, інакше вмикається вміст частками.

3. РЕЗУЛЬТАТ: Відкриття URL "http://{OpenSCADAHost}/WebUser/{PageId}/{MyFile}" у Web Оглядачі відкриє та надішле вам файл на ФС "{baseD}/{MyFile}".

Бібліотеки/Основна

Views

Contents

1 Шаблони стандартних структур DAQ-параметрів

1.1 Аналоговий сигнал, уніфікований (anUnif)

1.2 Аналоговий сигнал, уніфікований, стани порушень (anUnifSt)

1.3 Ручний ввід, уніфікований (manInUnif)

1.4 Дискретний блок, уніфікований (digitBlockUnif)

1.5 Сигналізація дискретна (digAlarm)

1.6 Стан за кодом (codeState)

1.7 ПІД сигнал, уніфікований, стани порушень (pidUnif)

1.8 Імпульсний ПІД сигнал, уніфікований, стани порушень (pidUnifImp)

2 Шаблони комплексних об'єктів

2.1 Джерело Безперебійного Живлення (UPS)

2.2 Мережеві пристрої за SNMP (SNMP)

2.3 Дисковий SMART (DiskSMART)

3 Сервіси

3.1 Сповіщувач за SMS, EMail-SMTP (ntf)

3.2 Опрацювання ініціативних підключень щодо асоційованих вихідних транспортів (initConAssociateTrs)

3.3 Погода (weather)

4 Для WebUser

4.1 WebUser: HTTP Файловий Сервер (fileServerHTTP)

Navigation menu

OpenSCADA

OpenSCADA Wiki

Search

Tools

MediaWiki

Personal tools