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

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

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

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

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

Бібліотеку створено для надання основних шаблонів опрацювання 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)" — кількість знаків після крапки, для позитивних значень, та точність (знаків загалом), для негативних, для відображення реальної кінцевої змінної на екрані.

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

- Бібліотека основних елементів інтерфейсу користувача:
  - Відображення аналогового
  - Відображення аналогового 1; Відображення аналогового 1, короткий
  - Елемент групи графіків
  - Кадр групи огляду
  - Кадр зведених графіків
  - Елемент кадр
  - Паспорт, розширений
- Бібліотека елементів мнемосхем інтерфейсу користувача:
  - Рівень
- Бібліотека звітів та документів:
  - Звіт миттєвих значень
  - Добовий звіт середніх за годину значень
  - Місячний звіт середніх за добу значень
  - Річний звіт місячних значень
  - Звіт двох робочих змін

- Спонсорування, розширення загального поля "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] — об'єкт користувацького контексту, що зберігається між циклами виклику;
  - args [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] — об'єкт користувацького контексту, що зберігається між циклами виклику;
  - args [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] — об'єкт користувацького контексту, що зберігається між циклами виклику;
  - args [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) | 2.2 | GPLv2 | * | en, uk, ru | Роман Савоченко

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

Надалі шаблон розширено прямою реалізацією ДБЖ або Інверторів Потужності підтримка яких відсутня у NUT (у основі частини "ДБЖ"), і таким першим пристроєм став Must EP2100 PRO. І для цього тут також додано користувацьке визначення властивостей пристрою для розташування у якості DAQ-Атрибутів із можливістю перевизначення опису.

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

ВВ шаблону

Ідентифікатор | Ім'я | Тип | Режим | Атрибут | Конфігурація | Значення
--- | --- | --- | --- | --- | --- | ---
srcAddr | Адреса вихідного об'єкту "System.slow.prm_UPS" - для підключення до DAQ.System параметру у частині ДБЖ; "Serial.ep21:/dev/ttyUSB0:9600:8N1||500:30" - для підключення до послідовного порту Must EP2100 PRO. | Рядок | Вхід | Не атрибут | Константа |
alSup | Придушення порушень | Логічний | Вхід | Повний доступ | Змінна |
alDelay | Затримка порушень, секунди | Реальний | Вхід | Повний доступ | Змінна | 0
items | Всі елементи | Об'єкт | Вихід | Повний доступ | Змінна |
defs | Визначення елементів У формі рядків - "{id}:{toAttr}:{descr}" | Текст | Вихід | Повний доступ | Змінна |
bChL | Низький заряд батареї | Реальний | Вхід | Повний доступ | Змінна | 20
bChLL | Критичний заряд батареї | Реальний | Вхід | Повний доступ | Змінна | 5
inVL | Низька вхідна напруга | Реальний | Вхід | Повний доступ | Змінна | 210
inVH | Висока вхідна напруга | Реальний | Вхід | Повний доступ | Змінна | 250
inFLL | Дуже низька вхідна частота | Реальний | Вхід | Повний доступ | Змінна | 40
inFL | Низька вхідна частота | Реальний | Вхід | Повний доступ | Змінна | 45
inFH | Висока вхідна частота | Реальний | Вхід | Повний доступ | Змінна | 55
inFHH | Дуже висока вхідна частота | Реальний | Вхід | Повний доступ | Змінна | 60
loadH | Навантаження високе | Реальний | Вхід | Повний доступ | Змінна | 80
loadHH | Навантаження дуже високе | Реальний | Вхід | Повний доступ | Змінна | 100
tH | Висока температура | Реальний | Вхід | Повний доступ | Змінна | 50
tHH | Температура дуже висока | Реальний | Вхід | Повний доступ | Змінна | 70
hyst | Гістерезис границь, % | Реальний | Вхід | Повний доступ | Змінна | 5
this | Об'єкт | Об'єкт | Вхід | Не атрибут | Змінна |
SHIFR | Шифр | Рядок | Вхід | Не атрибут | Змінна |
NAME | Ім'я | Рядок (переклад) | Вхід | Не атрибут | Змінна |
DESCR | Опис | Текст (переклад) | Вхід | Не атрибут | Змінна |
f_start | Прапорець запуску функції | Логічний | Вхід | Не атрибут | Змінна | 0
f_frq | Частота обчислення функції, Гц | Реальний | Вхід | Не атрибут | Змінна | 1000
f_err | Помилка функції | Рядок | Вхід | Не атрибут | Змінна | 0
f_stop | Прапорець зупинки функції | Логічний | Вхід | Не атрибут | Змінна | 0

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

  1. [ DAQ.System ] Створити об'єкт контролеру джерела у модулі DAQ.System і встановити його ідентифікатор на кшталт "SYSData".
  2. [ DAQ.System ] Створити об'єкт параметру джерела у попередньо створеному об'єкті контролера і встановити його ідентифікатор на кшталт "UPS".
  3. Створити і запустити Об'єкт Логічного Контролеру або використати будь який наявний з потрібними властивостями планування.
  4. Створити Об'єкт Логічного Параметру і обрати цей шаблон для нього. Ввімкнути параметр.
  5. У вкладці "Конфігурація шаблону" Об'єкту Логічного Параметру маєте встановити:
  - Адреса вихідного об'єкту
    - [ DAQ.System ] — у адресу об'єкту вихідного параметру ДБЖ (дивіться крок 1), на кшталт "System.SYSData.prm_UPS";
    - [ Must EP2100 PRO ] — у Послідовну адресу підключення пристрою на кшталт "Serial.ep21:/dev/ttyUSB0:9600:8N1||500:30".
  6. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) і якщо він не запущений, маємо отримати у атрибуті параметру Всі елементи (items) цей об'єкт з усіма атрибутами і їх властивостями. У випадку деяких порушень отримаємо відповідну інформацію у атрибуті Помилка (err), стосовно чого можете налаштувати атрибути границь відповідних порушень. Для адаптації до користувача деяких описів елементів і для розташування деяких у DAQ-Атрибутах, можете відредагувати "Визначення елементів (defs)" щодо них. Зі створених DAQ-Атрибутів можете також контролювати доступні до запису.
  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.1 | GPLv2 | * | en, uk | Роман Савоченко

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

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

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

ВВ шаблону

Ідентифікатор | Ім'я | Тип | Режим | Атрибут | Конфігурація | Значення
--- | --- | --- | --- | --- | --- | ---
srcAddr | Адреса вихідного об'єкту | Рядок | Вхід | Не атрибут | Константа |
inProc | Вхідна процедура обробки | Текст | Вхід | Не атрибут | Константа |
items | Всі елементи | Об'єкт | Вихід | Повний доступ | Змінна |
defs | Визначення елементів | Текст | Вхід | Повний доступ | Змінна |
    160:Uncorrectable sectors count when read/write (160)
    161:Number of Valid Spare Blocks (161)
    162:Uncorrectable Sector Count (162)
    163:Number of Initial Invalid Blocks (163)
    164:Total Erase Count (164)
    165:Block Erase Count (165)
    166:Minimum PE Cycles TLC (166)
    167:Max Bad Blocks per Die (167)
    168:Maximum PE Cycles TLC (168)
    168:Max Erase Count of Spec (168)
    168:SATA PHY error count (168)
    169:Total Bad Blocks (169)
    169:Remain Life (169)
    170:Grown Bad Blocks (170)
    170:Bad Block Count (170)
    171:Program Fail Count (171)
    172:Erase Fail Count (172)
    173:Average PE Cycles TLC (173)
    173:Max Erase Count (173)
    174:Unexpected Power Loss (174)
    184:End-to-End Error (184)
    187:Reported Uncorrect (187)
    188:Command Timeout (188)
    218:CRC Error Count (218)
    230:Media Wearout Indicator (230)
    231:SSD Life Left (231)
    233:NAND GB Written TLC (233)
    234:NAND GB Written SLC (234)
    241:Host Writes GB (241)
    242:Host Reads GiB (242)
    244:Temp Throttle Status (244)
    245:Flash Write Sector Count (245)
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".
  - Вхідна процедура обробки — сформувати для складної передобробки і повної генерації-імітації SMART полів із окремими атрибутами на внутрішній мові програмування OpenSCADA.
  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 Контроль віддалених ініціативних підключень (initRemCntr) | 1.2 | GPLv2 | * | en, uk | Роман Савоченко

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

Шаблон загалом здійснює:

- виявлення нового підключення від віддаленого хосту, яке не має ІД;
- надсилання ознайомчого прямого запиту за встановленим підключенням для отримання КЛЮЧА хосту, якщо це підключення вже раніше було, і для отримання інформації щодо хосту для створення ІД хосту;
- встановлення ІД для підключення;
- створення запису у таблиці хостів OpenSCADA для підключення і надсилання подальших запитів вже через хост;
- створення на віддаленому хості представницького Логічного Контролеру;
- створення на віддаленому хості представницького Об'єкту Контролеру DAQ.System у автоматичному режимі, за відсутності інших там;
- опрацювання наявних Об'єктів Контролеру DAQ.System щодо посилань параметрів Логічного Рівня на них і створення деяких логічних параметрів обробки, із оновленням усіх джерел за кожного перепідключення і перевірки щодо їх видалення вже без джерел;
- запис згенерованого ключа рядком "SrcKey: {ID}" до опису Логічного Контролеру у якості ознаки завершення ініціалізації;
- створення Об'єкту Контролеру у DAQ.DAQGate із підключенням до віддаленого Логічного Контролеру і його синхронізації кожні 10ть хвилин щодо додання нових джерел і видалення відсутніх.

ІД віддаленого хосту формується у вигляді "{HostDomain}{StatName}{RandKey}" із обмеженням у 20ть символів, де:

- HostDomain — мережеве ім'я-домен хосту;
- StatName — ім'я станції проєкту OpenSCADA;
- RandKey — випадковий ключ у дві шістнадцяткові цифри.

Модель даних представницького Логічного Контролеру може містити як згенеровані посилання із параметрами обробки, так і користувацькі параметри, якщо користувач вирішить опублікцівати додаткові дані. Згенеровані із DAQ.System елементи наразі представляють джерела:

- "CPU", "MEM", "sensors", "Power", "uptime" => посилання у контейнері параметрів "Система (SYS)";
- "fs", "hddstat", "hddsmart" => посилання у контейнері параметрів "Диск (DISK)" із однією обробкою для "hddsmart" за шаблоном base.DiskSMART;
- "netstat" => посилання у контейнері параметрів "Мережа (NET)";
- "ups" => посилання у корені із однією обробкою за шаблоном base.UPS.

Агреговані дані у DAQ.GAQGate можуть бути підняті на гору, або використані у похідних DAQ об'єктах, або прямо на користувацьких кадрах, або у майбутньому на Динамічному Кадрі, який заплановано до реалізації; та без жодних додаткових дій ви отримаєте сповіщення про порушення на хостах.

ВВ шаблону

Ідентифікатор | Ім'я | Тип | Режим | Атрибут | Конфігурація | Значення
--- | --- | --- | --- | --- | --- | ---
inTransport | Вхідний транспорт | Рядок | Вхід | Не атрибут | Константа | Sockets.InitRemCntr
conTm | Час підключення, мс | Цілий | Вхід | Не атрибут | Константа | 5000
accessTm | Час доступу, години Використовується для повтору створення представницьких об'єктів недоступних хостів і для видалення старих підключень. Нуль або негативне для вимкнення контролю! | Цілий | Вхід | Не атрибут | Константа | 24
cntrUser | Доступ: користувач | Рядок | Вхід | Не атрибут | Константа | root
cntrPass | Доступ: пароль | Рядок | Вхід | Не атрибут | Константа | openscada
cntrObj | Об'єкт контролю у DAQ.LogicLev і DAQ.System | Рядок | Вхід | Не атрибут | Константа | RemCntr
prcTr | Опрацьовані підключення | Текст | Вихід | Тільки читання | Змінна |
this | Об'єкт | Об'єкт | Вхід | Не атрибут | Змінна | 0
f_stop | Прапорець зупинки функції | Логічний | Вхід | Не атрибут | Змінна | 0
f_start | Прапорець запуску функції | Логічний | Вхід | Не атрибут | Змінна | 0
f_err | Помилка функції | Рядок | Вхід | Не атрибут | Змінна | 0
f_frq | Частота обчислення функції, Гц | Реальний | Вхід | Не атрибут | Змінна | 1000

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

  1. Створити вхідний транспорт прийняття ініціативних підключень у модулі "Сокети" або "SSL" із назвою на кшталт "Sockets.InitRemCntr".
  2. Для попередньо створеного транспорту встановити потрібну адресу відкриття вхідного сокету і перевести його у режим створення асоційованих вихідних транспортів, залишивши поле протоколу порожнім.
  3. Для цього шаблону створити і запустити об'єкт логічного контролеру або використати будь який наявний з потрібними властивостями планування.
  4. Створити об'єкт логічного параметру і обрати цей шаблон для нього. Ввімкнути параметр.
  5. У вкладці "Конфігурація шаблону" об'єкту логічного параметру маєте встановити:
  - Вхідний транспорт — у значення ідентифікатору вхідного транспорту, створеного у пункті 1, на кшталт "Sockets.InitRemCntr";
  - Час підключення — час підключення до ініціативних хостів після якого закривати підключення;
  - Час доступу — використовується для повтору створення представницьких об'єктів недоступних хостів і для видалення старих підключень; нуль або негативне для вимкнення контролю;
  - Доступ: користувач і пароль — користувач і пароль віддаленого хосту із правами створення там Логічного Контролеру і Об'єкту Контролеру DAQ.System, тобто користувач мусить бути включеним до групи "DAQ";
  - Об'єкт контролю у DAQ.LogicLev і DAQ.System — у ІД контрольованого-створюваного Об'єкту Контролеру на віддаленому хості.
  6. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати перевірку визначеного вхідного транспорту на предмет ініціативних підключень і їх ініціалізацію у описаний вище спосіб, та із зауваженням опрацьованих підключень у атрибуті "Опрацьовані підключення".

### 3.3 Опрацювання ініціативних підключень щодо асоційованих вихідних транспортів (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.4 Погода (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.2 | 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}".

Libs/Main/uk - GFDL | May 2026 | OpenSCADA 0.9.9