Export translations
Views
Special page
From OpenSCADAWiki
Jump to:
navigation
,
search
Settings
Group
About
Documents
Documents/API
Documents/DAQ
Documents/FAQ
Documents/How to
Documents/How to/Build from source
Documents/How to/Crash report
Documents/How to/Create module
Documents/How to/Create multi language project
Documents/How to/Cyclic programming
Documents/How to/Debug
Documents/How to/Install
Documents/How to/Live disk
Documents/How to/Release
Documents/How to/Transferring project configuration
Documents/How to/Violations, alarms and notifications
Documents/Program manual
Documents/Quick start
Documents/Release 0.8.0
Documents/Release 0.8.0/Update10
Documents/Release 0.8.0/Update11
Documents/Release 0.8.0/Update12
Documents/Release 0.8.0/Update13
Documents/Release 0.8.0/Update14
Documents/Release 0.8.0/Update15
Documents/Release 0.8.0/Update16
Documents/Release 0.8.0/Update17
Documents/Release 0.8.0/Update18
Documents/Release 0.8.0/Update19
Documents/Release 0.8.0/Update20
Documents/Release 0.8.0/Update3
Documents/Release 0.8.0/Update4
Documents/Release 0.8.0/Update5
Documents/Release 0.8.0/Update6
Documents/Release 0.8.0/Update7
Documents/Release 0.8.0/Update8
Documents/Release 0.8.0/Update9
Documents/Release 0.9
Documents/Release 0.9/Update 7
Documents/Release 0.9/Update1
Documents/Release 0.9/Update2
Documents/Release 0.9/Update3
Documents/Release 0.9/Update4
Documents/Release 0.9/Update5
Documents/Release 0.9/Update6
Documents/Release 0.9/Updating 0.8.0 LTS
Documents/Terms
Documents/User API
Functions and demands
Home
Libs
Libs/Devices
Libs/Documents
Libs/Electrical elements
Libs/Generic list
Libs/LowLevelDevices
Libs/Main
Libs/Main graphical elements
Libs/Mnemo elements
Libs/Prescriptions
Libs/Regulation elements
Libs/Service procedures
Libs/Technological apparatuses
Modules
Modules/BFN
Modules/BlockCalc
Modules/Comedi
Modules/DAQGate
Modules/DBArch
Modules/DBF
Modules/DBGate
Modules/DCON
Modules/DiamondBoards
Modules/FireBird
Modules/FLibComplex1
Modules/FLibMath
Modules/FLibSYS
Modules/FSArch
Modules/GPIO
Modules/HTTP
Modules/ICP DAS
Modules/JavaLikeCalc
Modules/LDAP
Modules/LogicLev
Modules/ModBus
Modules/MySQL
Modules/OPC UA
Modules/PostgreSQL
Modules/QTCfg
Modules/QTStarter
Modules/SelfSystem
Modules/Serial
Modules/Siemens
Modules/SMH2Gi
Modules/SNMP
Modules/Sockets
Modules/SoundCard
Modules/SQLite
Modules/SSL
Modules/System
Modules/SystemTests
Modules/UserProtocol
Modules/VCAEngine
Modules/Vision
Modules/WebCfg
Modules/WebCfgD
Modules/WebUser
Modules/WebVision
Sub-projects
Sub-projects/Automatic Builder of OpenSCADA
Sub-projects/Automation Linux distributive
Sub-projects/Embedding and PLC
Sub-projects/Server
Sub-projects/VCA
User:RomanSavochenko
Using
Using/HouseSpirit
Using/Kramatorsk Ball Mills
Using/Kramatorsk Water
Using/Model AGLKS
Using/Model Boiler
Using/OpenWrt TELEOFIS RTU968
Using/Yaroslavskij broiler
Works
Works/Road map
Works/Technical Support
Works/Technical Support/Agreement
Works/To do
Language
aa - Afar
ab - Abkhazian
ace - Achinese
ady - Adyghe
ady-cyrl - адыгабзэ
aeb - Tunisian Arabic
aeb-arab - تونسي
aeb-latn - Tûnsî
af - Afrikaans
ak - Akan
aln - Gheg Albanian
am - Amharic
an - Aragonese
ang - Old English
anp - Angika
ar - Arabic
arc - Aramaic
arn - Mapuche
arq - Algerian Arabic
ary - Moroccan Arabic
arz - Egyptian Arabic
as - Assamese
ase - American Sign Language
ast - Asturian
av - Avaric
avk - Kotava
awa - Awadhi
ay - Aymara
az - Azerbaijani
azb - تۆرکجه
ba - Bashkir
bar - Bavarian
bbc - Batak Toba
bbc-latn - Batak Toba
bcc - Southern Balochi
bcl - Bikol Central
be - Belarusian
be-tarask - Belarusian (Taraškievica orthography)
bg - Bulgarian
bgn - Western Balochi
bho - Bhojpuri
bi - Bislama
bjn - Banjar
bm - Bambara
bn - Bengali
bo - Tibetan
bpy - Bishnupriya
bqi - Bakhtiari
br - Breton
brh - Brahui
bs - Bosnian
bto - Iriga Bicolano
bug - Buginese
bxr - буряад
ca - Catalan
cbk-zam - Chavacano de Zamboanga
cdo - Min Dong Chinese
ce - Chechen
ceb - Cebuano
ch - Chamorro
cho - Choctaw
chr - Cherokee
chy - Cheyenne
ckb - Central Kurdish
co - Corsican
cps - Capiznon
cr - Cree
crh - Crimean Turkish
crh-cyrl - Crimean Turkish (Cyrillic script)
crh-latn - Crimean Turkish (Latin script)
cs - Czech
csb - Kashubian
cu - Church Slavic
cv - Chuvash
cy - Welsh
da - Danish
de - German
de-at - Austrian German
de-ch - Swiss High German
de-formal - German (formal address)
diq - Zazaki
dsb - Lower Sorbian
dtp - Central Dusun
dty - डोटेली
dv - Divehi
dz - Dzongkha
ee - Ewe
egl - Emilian
el - Greek
eml - Emiliano-Romagnolo
en - English
en-ca - Canadian English
en-gb - British English
eo - Esperanto
es - Spanish
et - Estonian
eu - Basque
ext - Extremaduran
fa - Persian
ff - Fulah
fi - Finnish
fit - Tornedalen Finnish
fj - Fijian
fo - Faroese
fr - French
frc - Cajun French
frp - Arpitan
frr - Northern Frisian
fur - Friulian
fy - Western Frisian
ga - Irish
gag - Gagauz
gan - Gan Chinese
gan-hans - Simplified Gan script
gan-hant - Traditional Gan script
gd - Scottish Gaelic
gl - Galician
glk - Gilaki
gn - Guarani
gom - Goan Konkani
gom-deva - Goan Konkani (Devanagari script)
gom-latn - Goan Konkani (Latin script)
got - Gothic
grc - Ancient Greek
gsw - Swiss German
gu - Gujarati
gv - Manx
ha - Hausa
hak - Hakka Chinese
haw - Hawaiian
he - Hebrew
hi - Hindi
hif - Fiji Hindi
hif-latn - Fiji Hindi (Latin script)
hil - Hiligaynon
ho - Hiri Motu
hr - Croatian
hrx - Hunsrik
hsb - Upper Sorbian
ht - Haitian Creole
hu - Hungarian
hy - Armenian
hz - Herero
ia - Interlingua
id - Indonesian
ie - Interlingue
ig - Igbo
ii - Sichuan Yi
ik - Inupiaq
ike-cans - Eastern Canadian (Aboriginal syllabics)
ike-latn - Eastern Canadian (Latin script)
ilo - Iloko
inh - Ingush
io - Ido
is - Icelandic
it - Italian
iu - Inuktitut
ja - Japanese
jam - Jamaican Creole English
jbo - Lojban
jut - Jutish
jv - Javanese
ka - Georgian
kaa - Kara-Kalpak
kab - Kabyle
kbd - Kabardian
kbd-cyrl - Адыгэбзэ
kg - Kongo
khw - Khowar
ki - Kikuyu
kiu - Kirmanjki
kj - Kuanyama
kk - Kazakh
kk-arab - Kazakh (Arabic script)
kk-cn - Kazakh (China)
kk-cyrl - Kazakh (Cyrillic script)
kk-kz - Kazakh (Kazakhstan)
kk-latn - Kazakh (Latin script)
kk-tr - Kazakh (Turkey)
kl - Kalaallisut
km - Khmer
kn - Kannada
ko - Korean
ko-kp - 한국어 (조선)
koi - Komi-Permyak
kr - Kanuri
krc - Karachay-Balkar
kri - Krio
krj - Kinaray-a
ks - Kashmiri
ks-arab - Kashmiri (Arabic script)
ks-deva - Kashmiri (Devanagari script)
ksh - Colognian
ku - Kurdish
ku-arab - كوردي (عەرەبی)
ku-latn - Kurdish (Latin script)
kv - Komi
kw - Cornish
ky - Kyrgyz
la - Latin
lad - Ladino
lb - Luxembourgish
lbe - лакку
lez - Lezghian
lfn - Lingua Franca Nova
lg - Ganda
li - Limburgish
lij - Ligurian
liv - Livonian
lmo - Lombard
ln - Lingala
lo - Lao
loz - Lozi
lrc - Northern Luri
lt - Lithuanian
ltg - Latgalian
lus - Mizo
luz - Southern Luri
lv - Latvian
lzh - Literary Chinese
lzz - Laz
mai - Maithili
map-bms - Basa Banyumasan
mdf - Moksha
mg - Malagasy
mh - Marshallese
mhr - Eastern Mari
mi - Maori
min - Minangkabau
mk - Macedonian
ml - Malayalam
mn - Mongolian
mo - молдовеняскэ
mr - Marathi
mrj - Western Mari
ms - Malay
mt - Maltese
mus - Creek
mwl - Mirandese
my - Burmese
myv - Erzya
mzn - Mazanderani
na - Nauru
nah - Nāhuatl
nan - Min Nan Chinese
nap - Neapolitan
nb - Norwegian Bokmål
nds - Low German
nds-nl - Low Saxon
ne - Nepali
new - Newari
ng - Ndonga
niu - Niuean
nl - Dutch
nl-informal - Nederlands (informeel)
nn - Norwegian Nynorsk
nov - Novial
nrm - Nouormand
nso - Northern Sotho
nv - Navajo
ny - Nyanja
oc - Occitan
olo - Livvi-Karelian
om - Oromo
or - Oriya
os - Ossetic
pa - Punjabi
pag - Pangasinan
pam - Pampanga
pap - Papiamento
pcd - Picard
pdc - Pennsylvania German
pdt - Plautdietsch
pfl - Palatine German
pi - Pali
pih - Norfuk / Pitkern
pl - Polish
pms - Piedmontese
pnb - Western Punjabi
pnt - Pontic
prg - Prussian
ps - Pashto
pt - Portuguese
pt-br - Brazilian Portuguese
qu - Quechua
qug - Chimborazo Highland Quichua
rgn - Romagnol
rif - Riffian
rm - Romansh
rmy - Romani
rn - Rundi
ro - Romanian
roa-tara - tarandíne
ru - Russian
rue - Rusyn
rup - Aromanian
ruq - Megleno-Romanian
ruq-cyrl - Megleno-Romanian (Cyrillic script)
ruq-latn - Megleno-Romanian (Latin script)
rw - Kinyarwanda
sa - Sanskrit
sah - Sakha
sat - Santali
sc - Sardinian
scn - Sicilian
sco - Scots
sd - Sindhi
sdc - Sassarese Sardinian
sdh - Southern Kurdish
se - Northern Sami
sei - Seri
ses - Koyraboro Senni
sg - Sango
sgs - Samogitian
sh - Serbo-Croatian
shi - Tachelhit
shi-latn - Tašlḥiyt
shi-tfng - ⵜⴰⵛⵍⵃⵉⵜ
si - Sinhala
sk - Slovak
sl - Slovenian
sli - Lower Silesian
sm - Samoan
sma - Southern Sami
sn - Shona
so - Somali
sq - Albanian
sr - Serbian
sr-ec - Serbian (Cyrillic script)
sr-el - Serbian (Latin script)
srn - Sranan Tongo
ss - Swati
st - Southern Sotho
stq - Saterland Frisian
su - Sundanese
sv - Swedish
sw - Swahili
szl - Silesian
ta - Tamil
tcy - Tulu
te - Telugu
tet - Tetum
tg - Tajik
tg-cyrl - Tajik (Cyrillic script)
tg-latn - Tajik (Latin script)
th - Thai
ti - Tigrinya
tk - Turkmen
tl - Tagalog
tly - Talysh
tn - Tswana
to - Tongan
tokipona - Toki Pona
tpi - Tok Pisin
tr - Turkish
tru - Turoyo
ts - Tsonga
tt - Tatar
tt-cyrl - Tatar (Cyrillic script)
tt-latn - Tatar (Latin script)
tum - Tumbuka
tw - Twi
ty - Tahitian
tyv - Tuvinian
tzm - Central Atlas Tamazight
udm - Udmurt
ug - Uyghur
ug-arab - Uyghur (Arabic script)
ug-latn - Uyghur (Latin script)
uk - Ukrainian
ur - Urdu
uz - Uzbek
uz-cyrl - ўзбекча
uz-latn - oʻzbekcha
ve - Venda
vec - Venetian
vep - Veps
vi - Vietnamese
vls - West Flemish
vmf - Main-Franconian
vo - Volapük
vot - Votic
vro - Võro
wa - Walloon
war - Waray
wo - Wolof
wuu - Wu Chinese
xal - Kalmyk
xh - Xhosa
xmf - Mingrelian
yi - Yiddish
yo - Yoruba
yue - Cantonese
za - Zhuang
zea - Zeelandic
zh - Chinese
zh-cn - Chinese (China)
zh-hans - Simplified Chinese
zh-hant - Traditional Chinese
zh-hk - Chinese (Hong Kong)
zh-mo - 中文(澳門)
zh-my - 中文(马来西亚)
zh-sg - Chinese (Singapore)
zh-tw - Chinese (Taiwan)
zu - Zulu
qqq - Message documentation
Format
Export for off-line translation
Export in native format
{{DISPLAYTITLE:Модулі/FLibSYS}}<languages/> {| class="wikitable" |- ! Модуль !! Ім'я !! Версія !! Ліцензія !! Джерело !! Мови !! Платформи !! Тип !! Автор !! Опис |- <section begin=info /> | [[Special:MyLanguage/Modules/FLibSYS|FLibSYS]] || Системні функції | 1.8 || GPL2 || spec_FLibSYS.so || en,uk,ru,de || x86,x86_64,ARM <section end=info /> | Спеціальні || Роман Савоченко || Надає бібліотеку системних функцій середовища програмування користувача OpenSCADA. |} __TOC__ Модуль надає до OpenSCADA статичну бібліотеку функцій для використання у середовищі користувацького програмування та організації неординарних алгоритмів взаємодії. Для адресації до функцій цієї бібліотеки можна використовувати статичну адресу виклику '''Special.FLibSYS.{Func}()''' або динамічну '''SYS.Special.FLibSYS["{Func}"].call()''', '''SYS.Special.FLibSYS.{Func}()'''. Де ''{Func}'' — ідентифікатор функції у бібліотеці. == Загальносистемні функції == === {{Anch|sysCall|SYS: Виклик (sysCall)}} === ''Опис:'' Здійснює виклик консольних команд ОС. Функція відкриває широкі можливості користувачу OpenSCADA, шляхом виклику будь-яких системних програм, утиліт та скриптів, а також отримання за посередництвом них доступу до величезного об'єму системних даних. Наприклад, команда "ls -l" поверне деталізований вміст робочої теки.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | com || Команда || Рядок || Вхід || |} ''Приклад:'' <syntaxhighlight lang="JS"> using Special.FLibSYS; test=sysCall("ls -l"); messPut("Example",0,"Example: "+test); </syntaxhighlight> === {{Anch|IO|SYS: Ввід/Вивід (IO)}} === ''Опис:'' Ввід/Вивід у: файл, строковий потік.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Об'єкт(IO) || Повернення || |- | name || Ім'я файлу або дані (для строкового потоку) || Рядок || Вхід || |- | accs || Доступ до файлу (""-строковий потік;"r[+]"-читання;"w[+]"-запис з нуля;"a[+]"-додання;...) || Рядок || Вхід || |- | mFormat || Формат даних машини ('n'-сист. порядок;'b'-BigEndian;'l'-LittleEndian) || Ціле || Вхід || "n" |- | enc || Кодування рядку у файлі/потоці || Логічний || Вхід || |} ==== IO об'єкт ==== Значення: * ''valType'' — типи значень: ** "uchar", "unsigned char", "char", "schar", "signed char"; ** "uint8"; ** "uint16", "ushort"; ** "uint32", "uint", "ulong"; ** "uint64"; ** "int8", "integer*1"; ** "int16", "short", "integer*2"; ** "int32", "int", "long", "integer*4", "integer"; ** "int64", "integer*8"; ** "float", "float32", "single", "real*4"; ** "double", "float64", "real*8", "real"; * ''accs'' — режим доступу та тип: ** '' — строковий потік; ** 'r[+]' — читання; ** 'w[+]' — запис з нуля; ** 'a[+]' — додання. * ''mFormat'' — формат даних машини: ** 'n' — рідний; ** 'l' — LittleEndian; ** 'b' — BigEndian. Властивості: * ''length'' — довжина потоку; * ''pos'' (w) — позиція читання/запису потоку. * ''string'' (w) — повне значення строкового потоку; * ''mFormat'' (w) — формат даних машини; * ''stringEncode'' (w) — кодування підрядків файлу/потоку. Функції: * ''bool open(string name = "", string accs = "", string mFormat = "n", string enc = "");'' — відкрити новий поток для рядка або файлу ''name''. * ''bool close();'' — закрити поток. * ''{string|int|real|Array[int|real]} read(string valType = "char", int cnt = -1, string mFormatEnc = "n|NoEnc");'' — читати значення типу ''valType'' у кількості ''cnt'' для формату машини або вхідного кодування рядка ''mFormatEnc''. * ''{int|IO} {write|wr}({string|int|real|Array} vals, string valType = "char", string mFormatEnc = "n|NoEnc", int cnt = 1);'' — записати значення ''vals'' для типу ''valType'' для формату машини або вхідного кодування рядка ''mFormatEnc'', та повтору скалярних значень у кількості ''cnt''. === {{Anch|dbReqSQL|DB: SQL запит (dbReqSQL)}} === ''Опис:'' Формування SQL-запиту ''req'' до БД ''addr'', всередині (''trans''=true), назовні (''trans''=false) або без різниці (''trans''=EVAL) до транзакції. У випадку помилки її значення поміщається до властивості "err" результату.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Режим !! По замовченню |- | rez || Результат || Об'єкт(Масив) || Повернення || |- | addr || Адреса БД, "{TypeDB}.{DB}" || Рядок || Вхід || |- | req || SQL-запит || Рядок || Вхід || |- | trans || Транзакція || Логічний || Вхід || EVAL |} === {{Anch|xmlNode|XML: Вузол (xmlNode)}} === ''Опис:'' Створення об'єкту XML вузла.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Режим !! По замовченню |- | rez || Результат || Об'єкт(XMLNodeObj) || Повернення || |- | name || Ім'я || Рядок || Вхід || |} ''Приклад:'' <syntaxhighlight lang="JS"> using Special.FLibSYS; //Створення об'єкту "get" вузла XML. req = xmlNode("get"); //Створення об'єкту "get" вузла XML із створенням атрибутів. //sub_DAQ/mod_ModBus/cntr_1/prm_1 — шлях згідно структури проекту req = xmlNode("get").setAttr("path","/sub_DAQ/mod_ModBus/cntr_1/prm_1/%2fprm%2fst%2fen"); </syntaxhighlight> === {{Anch|xmlCntrReq|XML: Запит інтерфейсу керування (xmlCntrReq)}} === ''Опис:'' Запит щодо контролю програми, за XML. Звичайний запит записується у вигляді "'''<get path="/OPath/%2felem"/>'''". За визначенням станції здійснюється запит до вказаної зовнішньої станції.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | req || Запит || Об'єкт(XMLNodeObj) || Вихід || |- | stat || Станція || Рядок || Вхід || |} ''Приклад (більше прикладів дивіться для [[Special:MyLanguage/Documents/User_API#SYS|аналогічної внутрішньої функції SYS.cntrReq()]]):'' <syntaxhighlight lang="JS"> using Special.FLibSYS; //Отримання ознаки "Ввімкнений/Вимкнений" параметру "1" контролеру "1" модуля "ModBus". //sub_DAQ/mod_ModBus/cntr_1/prm_1 — шлях згідно до структури проекту req = xmlNode("get").setAttr("path","/sub_DAQ/mod_ModBus/cntr_1/prm_1/%2fprm%2fst%2fen"); rez = xmlCntrReq(req); messPut("test",0,"Значення: "+req.text()); //Встановлення ознаки "Ввімкнений" параметру "1" контролеру "1" модуля "ModBus". req = xmlNode("set").setAttr("path","/sub_DAQ/mod_ModBus/cntr_1/prm_1/%2fprm%2fst%2fen").setText(1); rez = xmlCntrReq(req); //Встановлення ознаки "Вимкнений" параметру "1" контролеру "1" модуля "ModBus". req = xmlNode("set").setAttr("path","/sub_DAQ/mod_ModBus/cntr_1/prm_1/%2fprm%2fst%2fen").setText(0); rez = xmlCntrReq(req); </syntaxhighlight> == Функції роботи з часом == === {{Anch|tmTime|Time: Час (tmTime)}} === ''Опис:'' Повертає абсолютний час у секундах від епохи 1.1.1970 та мікросекунди у ''usec'', якщо вказано таку зміну та її значення негативне.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | sec || Секунди || Цілий || Повернення || 0 |- | usec || Мікросекунди || Цілий || Вихід || -1 |} === {{Anch|tmDate|Time: Дата та час (tmDate)}} === ''Опис:'' Повна дата та час у секундах, хвилинах, годинах та інше, виходячи з абсолютного часу в секундах від епохи 1.1.1970.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | fullsec || Повні секунди || Цілий || Вхід || 0 |- | sec || Секунди [0...59] || Цілий || Вихід || 0 |- | min || Хвилини [0...59] || Цілий || Вихід || 0 |- | hour || Години [0...23] || Цілий || Вихід || 0 |- | mday || День місяця [1...31] || Цілий || Вихід || 0 |- | month || Місяць [0...11] || Цілий || Вихід || 0 |- | year || Рік, від 1900 || Цілий || Вихід || 0 |- | wday || День тижня [0...6] || Цілий || Вихід || 0 |- | yday || День у року [0...365] || Цілий || Вихід || 0 |- | isdst || Літній час || Цілий || Вихід || 0 |} ''Приклад:'' <syntaxhighlight lang="JS"> using Special.FLibSYS; curMin=curHour=curDay=curMonth=curYear=0; tmDate(tmTime(),0,curMin,curHour,curDay,curMonth,curYear); messPut("test",0,"Поточна хвилина: "+curMin); messPut("test",0,"Поточна година: "+curHour); messPut("test",0,"Поточний день: "+curDay); messPut("test",0,"Поточний місяць: "+curMonth); messPut("test",0,"Поточний рік: "+curYear); </syntaxhighlight> === {{Anch|tmFStr|Time: Рядок часу (tmFStr)}} === ''Опис:'' Отримання часу як форматований рядок. Запис формату відповідає POSIX-функції "strftime()".<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | val || Рядок дати та часу || Рядок || Повернення || |- | sec || Секунди || Ціле || Вхід || 0 |- | form || Формат дати та часу || Рядок || Вхід || %Y-%m-%d %H:%M:%S |} ''Приклад:'' <syntaxhighlight lang="JS"> using Special.FLibSYS; test = tmFStr(SYS.time(),"%d %m %Y"); messPut("Приклад",0,"tmFStr(): "+test); </syntaxhighlight> === {{Anch|tmStrPTime|Time: Рядок у час (tmStrPTime)}} === ''Опис:'' Перетворення строкового представлення дати та часу, за форматом ''form'', у час в секундах з 01.01.1970. Наприклад, шаблону "%Y-%m-%d %H:%M:%S" відповідає час "2006-08-08 11:21:55". Опис формату шаблону можна отримати із документації на POSIX-функцію "strptime()".<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | sec || Секунди || Цілий || Повернення || 0 |- | str || Рядок дати та часу || Рядок || Вхід || |- | form || Формат дати та часу || Рядок || Вхід || %Y-%m-%d %H:%M:%S |} ''Приклад:'' <syntaxhighlight lang="JS"> using Special.FLibSYS; curMin=curHour=curDay=curMonth=curYear=0; tmDate(tmTime(),0,curMin,curHour,curDay,curMonth,curYear); test = tmStrPTime(""+curYear+"-"+(curMonth+1)+"-"+curDay+" 9:0:0","%Y-%m-%d %H:%M:%S"); messPut("Приклад",0,"tmStrPTime(): "+test); </syntaxhighlight> === {{Anch|tmCron|Time: Планувати час за CRON (tmCron)}} === ''Опис:'' Планування часу за стандартом CRON, повертаючи спланований час починаючи від базового часу ''base'' або від поточного якщо базовий не вказаний.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | res || Результат, секунди || Цілий || Повернення || 0 |- | str || CRON || Рядок || Вхід || * * * * * |- | base || Базовий час, секунди || Цілий || Вхід || 0 |} === {{Anch|tmSleep|Time: сон (tmSleep)}} === ''Опис:'' Короткий сон від наносекунд та до STD_INTERF_TM (5 секунд).<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | res || Результат || Цілий || Повернення || 0 |- | tm || Час, секунди || Реальний || Вхід || 0 |} == Функції роботи з рядками == === {{Anch|strSize|Рядок: Отримати розмір (strSize)}} === ''Опис:'' Отримання розміру рядка.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Цілий || Повернення || |- | str || Рядок || Рядок || Вхід || |} ''Приклад:'' <syntaxhighlight lang="JS"> using Special.FLibSYS; messPut("Приклад",1,"ReturnString: "+strSize("Приклад")); </syntaxhighlight> === {{Anch|strSubstr|Рядок: Отримати частину рядка (strSubstr)}} === ''Опис:'' Отримання частини рядка.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | str || Рядок || Рядок || Вхід || |- | pos || Позиція || Цілий || Вхід || 0 |- | n || Кількість || Цілий || Вхід || -1 |} ''Приклад:'' <syntaxhighlight lang="JS"> using Special.FLibSYS; test = strSubstr("Приклад", 0, strSize("Приклад")-1); messPut("Приклад", 1, "ReturnString: "+test); </syntaxhighlight> === {{Anch|strInsert|Рядок: Вставити рядок у інший (strInsert)}} === ''Опис:'' Вставка рядку до іншого рядку.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | str || Рядок || Рядок || Вихід || |- | pos || Позиція || Цілий || Вхід || 0 |- | ins || Рядок для вставки || Рядок || Вхід || |} === {{Anch|strReplace|Рядок: Замінити частину рядка іншим (strReplace)}} === ''Опис:'' Заміна частини рядку іншим рядком.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | str || Рядок || Рядок || Вихід || |- | pos || Позиція || Цілий || Вхід || 0 |- | n || Кількість || Цілий || Вхід || -1 |- | repl || Рядок для заміни || Рядок || Вхід || |} === {{Anch|strParse|Рядок: Розібрати за роздільником (strParse)}} === ''Опис:'' Розбір рядка за роздільником.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | str || Рядок || Рядок || Вхід || |- | lev || Рівень || Цілий || Вхід || |- | sep || Роздільник || Рядок || Вхід || "." |- | off || Зміщення || Цілий || Вихід || |} ''Приклад:'' <syntaxhighlight lang="JS"> using Special.FLibSYS; ExapleString = "Приклад:123"; test = strParse(ExapleString, 1, ":"); messPut("Приклад", 0, "strParse(): "+test); </syntaxhighlight> === {{Anch|strParsePath|Рядок: Розібрати шлях (strParsePath)}} === ''Опис:'' Розбір шляху за елементами.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | path || Шлях || Рядок || Вхід || |- | lev || Рівень || Цілий || Вхід || |- | off || Зміщення || Цілий || Вихід || |} ''Приклад:'' <syntaxhighlight lang="JS"> using Special.FLibSYS; test = strParsePath(path, 0, "/"); messPut("Приклад", 1, "strParsePath(): "+test); </syntaxhighlight> === {{Anch|strPath2Sep|Рядок: Шлях у рядок з роздільником (strPath2Sep)}} === ''Опис:'' Перетворення шляху у рядок за роздільником.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | src || Джерело || Рядок || Вхід || |- | sep || Роздільник || Рядок || Вхід || "." |} ''Приклад:'' <syntaxhighlight lang="JS"> //Перетворює значення "/ses_AGLKS/pg_so" атрибута "path" у значення "ses_AGLKS.pg_so" using Special.FLibSYS; test = strPath2Sep(path); messPut("Приклад", 0, "path: "+path); messPut("Приклад", 0, "strPath2Sep(): "+test); </syntaxhighlight> === {{Anch|strEnc2HTML|Рядок: Кодувати рядок у HTML (strEnc2HTML)}} === ''Опис:'' Кодування рядку для використання у вихідних HTML.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | src || Джерело || Рядок || Вхід || |} === {{Anch|strEnc2Bin|Рядок: Кодувати текст у бінарний вигляд (strEnc2Bin)}} === ''Опис:'' Кодування тексту у бінарний вигляд, для формату тексту <00 A0 FA DE>.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | src || Джерело || Рядок || Вхід || |} === {{Anch|strDec4Bin|Рядок: Декодувати текст з бінарного вигляду (strDec4Bin)}} === ''Опис:'' Декодування тексту з бінарного вигляду, для формату тексту <00 A0 FA DE>.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | src || Джерело || Рядок || Вхід || |} === {{Anch|real2str|Рядок: Реальне у рядок (real2str)}} === ''Опис:'' Перетворення реального значення у формат рядку.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | val || Значення || Реальне || Вхід || |- | prc || Точність || Ціле || Вхід || 4 |- | tp || Тип || Рядок || Вхід || "f" |} === {{Anch|int2str|Рядок: Ціле у рядок (int2str)}} === ''Опис:'' Перетворення цілого значення у формат рядку.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | val || Значення || Ціле || Вхід || |- | base || База (8, 10, 16) || Ціле || Вхід || 10 |} === {{Anch|str2real|Рядок: Рядок у реальне (str2real)}} === ''Опис:'' Перетворення значення рядку у формат реального.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Режим !! По замовченню |- | rez || Результат || Реальне || Повернення || |- | val || Значення || Рядок || Вхід || |} === {{Anch|str2int|Рядок: Рядок у ціле (str2int)}} === ''Опис:'' Перетворення значення рядку у формат цілого.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Режим !! По замовченню |- | rez || Результат || Ціле || Повернення || |- | val || Значення || Рядок || Вхід || |- | base || Основа (2...36) || Цілий || Вхід || 0 |} === {{Anch|CRC|Циклічний Надмірний Код (CRC)}} === ''Опис:'' Уніфікована та повна реалізація Циклічного Надмірного Коду для ширини 1-64 біт з нормальним поліномом, початковим CRC, вхідною та вихідною послідовністю, та XOR для виходу.<br/> Також підтримується попередня нотація цієї функції, де реверсивний поліном розміщується у позиції ширини ''width''!<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Цілий || Повернення || |- | data || Дані || Рядок || Вхід || |- | width || Ширина || Цілий || Вхід || 16 |- | poly || Поліном || Цілий || Вхід || 32773 (0x8005) |- | init || Поч. значення || Цілий || Вхід || -1 (0xFFFFFFFFFFFFFFFF) |- | RefIn || Послідовність входу || Логічний || Вхід || 1 |- | RefOut || Послідовність виходу || Логічний || Вхід || 1 |- | XorOut || XOR для виходу || Цілий || Вхід || 0 |} === {{Anch|MD5|Зліпок повідомлення 5 (MD5)}} === ''Опис:'' Обчислення зліпка повідомлення 5 для даних ''data''.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Рядок || Повернення || |- | data || Дані || Рядок || Вхід || |} == Функції роботи з реальним == === {{Anch|floatSplitWord|Float: Поділити на слова (floatSplitWord)}} === ''Опис:'' Поділ значення float (4 байтів) на два слова (2 байти).<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | val || Значення || Реальне || Вхід || |- | w1 || Слово 1 || Цілий || Вихід || |- | w2 || Слово 2 || Цілий || Вихід || |} === {{Anch|floatMergeWord|Float: Поєднати слова (floatMergeWord)}} === ''Опис:'' Формування значення float (4 байтів) з двох слів (2 байти).<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Реальне || Повернення || |- | w1 || Слово 1 || Цілий || Вхід || |- | w2 || Слово 2 || Цілий || Вхід || |} === {{Anch|floatExtract|Float: Вилучити (floatExtract)}} === ''Опис:'' Вилучення мантиси та експоненти з реального значення.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | magn || Розмір || Реальний || Повернення || |- | val || Значення || Реальний || Вхід || |- | exp || Експонента || Цілий || Вихід || |} == Функції архівів == === {{Anch|messGet|Mess: Отримання (messGet)}} === ''Опис:'' Отримати повідомлення програми.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Об'єкт(Масив) || Повернення || |- | btm || Час початку, секунди || Ціле || Вхід || |- | etm || Час кінця, секунди || Ціле || Вхід || |- | cat || Категорія || Рядок || Вхід || |- | lev || Рівень || Цілий || Вхід || |- | arch || Архіватор || Рядок || Вхід || |} === {{Anch|messPut|Mess: Розмістити (messPut)}} === ''Опис:'' Розмістити повідомлення до програми.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | cat || Категорія || Рядок || Вхід || |- | lev || Рівень || Цілий || Вхід || |- | mess || Повідомлення || Рядок || Вхід || |} ''Приклад:'' <syntaxhighlight lang="JS"> rnd_sq_gr11_lineClr="red"; Special.FLibSYS.messPut("Приклад",1,"Event: "+rnd_sq_gr12_leniClr); </syntaxhighlight> === {{Anch|vArh|Val: Архів (vArh)}} === ''Опис:'' Отримання об'єкту архіву значень (VArchObj) через підключення до архіву за його адресою.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Ім'я !! Тип !! Режим !! По замовченню |- | rez || Результат || Об'єкт(VArchObj) || Повернення || |- | name || Ім'я — адреса до атрибуту параметра з архівом ('''DAQ.{Module}.{Cntr}.{Prm}.{Attr}''') або безпосередньо до архіву значень ('''Archive.va_{ValArchive}'''). || Рядок || Вхід || |} ==== Об'єкт VArchObj ==== Функції: * ''bool isNull()'' — об'єкт не ініційовано. * ''int begin( int usec = 0, string archiver = "" )'' — час початку архіву, через повернення секунд та мікросекунд ''usec'' для архіватору ''archiver''. * ''int end( int usec = 0, string archiver = "" )'' — час закінчення архіву, через повернення секунд та мікросекунд ''usec'' для архіватору ''archiver''. * ''int period( int usec = 0, string archiver = "" )'' — період архіву, через повернення секунд та мікросекунд ''usec'' для архіватору ''archiver''. * ''ValObj get( int sec, int usec, bool upOrd = false, string archiver = "" )'' — значення із архіву на час ''sec'':''usec'' з прив'язкою до гори ''upOrd'' та для архіватору ''archiver''. Реальний час отриманого значення встановлюється у ''sec'':''usec''. * ''bool set( ValObj val, int sec, int usec, string archiver = "" )'' [<span style='color:red'>доступ до підсистеми Архіви-Історія для операцій з архівом</span>] — записує значення ''val'' у архів на час ''sec'':''usec'' для архіватору ''archiver''. * ''bool copy( VArchObj src, int begSec, int begUSec, int endSec, int endUSec, string archiver = "" )'' [<span style='color:red'>доступ до підсистеми Архіви-Історія для операцій з архівом</span>] — копіює частину вихідного ''src'' архіву, або його буферу, до поточного, починаючи з ''begSec'':''begUSec'' та закінчуючи ''endSec'':''endUSec'' для архіватору ''archiver''. * ''ArrayObj FFT( int tm, real size, string archiver = "", int tm_usec = 0 )'' — розкласти у ряд Фур'є за допомогою FFT алгоритму. Повертається масив амплітуд частот для вікна значень із архіву з часом початку ''tm:tm_usec'' (секунди:мікросекунди), глибиною у історію архіву ''size'' (секунд) та для архіватору ''archiver''. ''Приклад:'' <syntaxhighlight lang="JS"> using Special.FLibSYS; val = vArh(strPath2Sep(addr)).get(time,uTime,0,archiver); return val.isEval() ? "Порожньо" : real2str(val,prec);</syntaxhighlight> === {{Anch|vArhBuf|Val: Буфер архіву (vArhBuf)}} === ''Опис:'' Отримання об'єкту буфера значень для тимчасового збереження значень та виконання проміжних операцій над кадрами даних.<br/> ''Параметри:'' {| class="wikitable" |- ! Ідентифікатор !! Параметр !! Тип !! Режим !! По замовченню |- | rez || Результат || Об'єкт(VArchObj) || Повернення || |- | tp || Тип значень архіву (0-Логічний, 1-Цілий, 4-Реальний, 5-Рядок) || Цілий || Вхід || 1 |- | sz || Максимальний розмір буферу || Цілий || Вхід || 100 |- | per || Період значень буферу, мікросекунди || Цілий || Вхід || 1000000 |- | hgrd || Жорстка мережа часу || Логічний || Вхід || 0 |- | hres || Висока роздільна здатність часу (мікросекунди)" || Логічний || Вхід || 0 |} == API користувацького програмування == Модуль, як об'єкт, надає функції користувацького програмування. <section begin=API /> '''Об'єкт "Бібліотека функцій" (SYS.Special.FLibSYS)''' * ''ElTp {funcID}(ElTp prm1, ...)'' — виклик функції бібліотеки ''{funcID}''. Повертає результат викликаної функції. '''Об'єкт "Користувацька функція" (SYS.Special.FLibSYS["funcID"])''' * ''ElTp call(ElTp prm1, ...)'' — виклик цієї функції з параметрами ''<prm{N}>''. Повертає результат викликаної функції. <section end=API />
Navigation menu
OpenSCADA
Site
Download
Old Wiki
OpenSCADA Wiki
Home
About OpenSCADA
Functions and demands
Tasks
Using
Fund
Recent changes
Random page
Search
Tools
Special pages
MediaWiki
Help
Personal tools
English
Log in