English
Ðóññêàÿ

---

Ïåðåêëàä

Ìîäóëü <FLibSYS> ï³äñèñòåìè "Ñïåö³àëüí³"

Âñòóï

Ñïåö³àëüíèé ìîäóëü FLibSYS íàäຠâ ñèñòåìó OpenSCADA ñòàòè÷íó á³áë³îòåêó ôóíêö³é äëÿ ðîáîòè ç ñèñòåìîþ OpenSCADA íà ð³âí³ ¿¿ ñèñòåìíîãî API. Ö³ ôóíêö³¿ ìîæóòü âèêîðèñòîâóâàòèñÿ ó ñåðåäîâèù³ êîðèñòóâàöüêîãî ïðîãðàìóâàííÿ ñèñòåìè OpenSCADA äëÿ îðãàí³çàö³¿ íåîðäèíàðíèõ àëãîðèòì³â âçàºìî䳿.

Äëÿ àäðåñàö³¿ äî ôóíêö³¿ ö³º¿ á³áë³îòåêè ìîæíà âèêîðèñòîâóâàòè ñòàòè÷íó àäðåñó âèêëèêó "Special.FLibSYS.{Func}()" àáî äèíàì³÷íó "SYS.Special.FLibSYS["{Func}"].call()", "SYS.Special.FLibSYS.{Func}()". Äå {Func} — ³äåíòèô³êàòîð ôóíêö³¿ ó á³áë³îòåö³.

Íèæ÷å íàâåäåíî îïèñ êîæíî¿ ôóíêö³¿ á³áë³îòåêè. Äëÿ êîæíî¿ ôóíêö³¿ çä³éñíþâàëàñÿ îö³íêà ÷àñó âèêîíàííÿ. Âèì³ðþâàííÿ çä³éñíþâàëîñÿ íà ñèñòåì³ ç íàñòóïíèìè ïàðàìåòðàìè: Athlon 64 3000+ (ALTLinux 4.0(32á³ò)) øëÿõîì çàì³ðó çàãàëüíîãî ÷àñó âèêîíàííÿ ôóíêö³¿ ïðè âèêëèêó ¿¿ 1000 ðàç³â. Âèá³ðêà çä³éñíþâàëàñÿ ³ç ï'ÿòè îá÷èñëåíü ³ç îêðóãëåííÿì äî ìåíøîãî ö³ëîãî. ×àñ îòî÷óºòüñÿ êóòîâèìè äóæêàìè òà âèì³ðþºòüñÿ ó ì³êðîñåêóíäàõ.

1. Çàãàëüíîñèñòåìí³ ôóíêö³¿

1.1. Âèêëèê êîíñîëüíèõ êîìàíä òà óòèë³ò îïåðàö³éíî¿ ñèñòåìè (sysCall)

Îïèñ: Çä³éñíþº âèêëèê êîíñîëüíèõ êîìàíä ÎÑ. Ôóíêö³ÿ â³äêðèâຠøèðîê³ ìîæëèâîñò³ êîðèñòóâà÷ó OpenSCADA øëÿõîì âèêëèêó áóäü-ÿêèõ ñèñòåìíèõ ïðîãðàì, óòèë³ò òà ñêðèïò³â, à òàêîæ îòðèìàííÿ çà ïîñåðåäíèöòâîì íèõ äîñòóïó äî âåëè÷åçíîãî îá'ºìó ñèñòåìíèõ äàíèõ. Íàïðèêëàä êîìàíäà "ls -l" ïîâåðíå äåòàë³çîâàíèé âì³ñò ðîáî÷î¿ òåêè.
Ïàðàìåòðè:

Ïðèêëàä:

using Special.FLibSYS;
test=sysCall("ls -l");
messPut("Example",0,"Example: "+test);

1.2. SQL çàïèò (dbReqSQL)

Îïèñ: Ôîðìóâàííÿ SQL-çàïèòó äî ÁÄ.
Ïàðàìåòðè:

1.3. Âóçîë XML (xmlNode)

Îïèñ: Ñòâîðåííÿ îá'ºêòó âóçëà XML.
Ïàðàìåòðè:

Ïðèêëàä:

using Special.FLibSYS;
//Ñòâîðåííÿ îá'ºêòó "get" âóçëà XML.
req = xmlNode("get");
//Ñòâîðåííÿ  îá'ºêòó "get" âóçëà XML ³ç ñòâîðåííÿì àòðèáóò³â.
//sub_DAQ/mod_ModBus/cntr_1/prm_1 — øëÿõ çã³äíî ñòðóêòóðè ïðîåêòó
req = xmlNode("get").setAttr("path",);

1.4. Çàïèò ³íòåðôåéñó óïðàâë³ííÿ (xmlCntrReq)

Îïèñ: Çàïèò ³íòåðôåéñó óïðàâë³ííÿ äî ñèñòåìè çà ïîñåðåäíèöòâîì XML. Çâè÷àéíèé çàïèò çàïèñóºòüñÿ ó âèãëÿä³ "<get path="/OPath/%2felem"/>". Ïðè âêàçàíí³ ñòàíö³¿ çä³éñíþºòüñÿ çàïèò äî çîâí³øíüî¿ ñòàíö³¿.
Ïàðàìåòðè:

Ïðèêëàä:

using Special.FLibSYS;
//Îòðèìàííÿ îçíàêè "Âêëþ÷åíèé/Âèêëþ÷åíèé" ïàðàìåòðàó "1" êîíòðîëåðó "1" ìîäóëÿ "ModBus".
//sub_DAQ/mod_ModBus/cntr_1/prm_1 — øëÿõ çã³äíî ñòðóêòóðè ïðîåêòó
req = xmlNode("get").setAttr("path",);
rez = xmlCntrReq(req);
messPut("test",0,"Çíà÷åííÿ: "+req.text());

//Âñòàíîâëåííÿ îçíàêè "Âêëþ÷åíèé" ïàðàìåòðó "1" êîíòðîëåðó "1" ìîäóëÿ "ModBus".
req = xmlNode("set").setAttr("path",).setText(1);
rez = xmlCntrReq(req);

//Âñòàíîâëåííÿ îçíàêè "Âèêëþ÷åíèé" ïàðàìåòðó "1" êîíòðîëåðó "1" ìîäóëÿ "ModBus".
req = xmlNode("set").setAttr("path",).setText(0);
rez = xmlCntrReq(req);

1.5. Àðõ³â çíà÷åíü (vArh)

Îïèñ: Îòðèìàííÿ îá'ºêòó àðõ³âó çíà÷åíü (VArchObj) øëÿõîì ï³äêëþ÷åííÿ äî àðõ³âó çà éîãî àäðåñîþ.
Ïàðàìåòðè:

Îá'ºêò VArchObj

Ôóíêö³¿:

• bool isNull() — îá'ºêò íå ³í³ö³éîâàíî.
• int begin( int usec = 0, string archivator = "" ) — îòðèìàííÿ ÷àñó ïî÷àòêó àðõ³âó øëÿõîì ïîâåðíåííÿ ñåêóíä òà ì³êðîñåêóíä usec äëÿ àðõ³âàòîðó archivator.
• int end( int usec = 0, string archivator = "" ) — îòðèìàííÿ ÷àñó çàê³í÷åííÿ àðõ³âó øëÿõîì ïîâåðíåííÿ ñåêóíä òà ì³êðîñåêóíä usec äëÿ àðõ³âàòîðó archivator.
• int period( int usec = 0, string archivator = "" ) — îòðèìàííÿ ïåð³îäè÷íîñò³ àðõ³âó øëÿõîì ïîâåðíåííÿ ñåêóíä òà ì³êðîñåêóíä usec äëÿ àðõ³âàòîðó archivator.
• ValObj get( int sec, int usec, bool upOrd = false, string archivator = "" ) — îòðèìàííÿ çíà÷åííÿ ³ç àðõ³âó íà ÷àñ sec:usec ç ïðèâ'ÿçêîþ äî ãîðè upOrd òà äëÿ àðõ³âàòîðó archivator. Ðåàëüíèé ÷àñ îòðèìàíîãî çíà÷åííÿ âñòàíîâëþºòüñÿ ó sec:usec.
• bool set( ValObj val, int sec, int usec ) — çàïèñ çíà÷åííÿ val ó áóôåð àðõ³âó íà ÷àñ sec:usec.
• bool copy( VArchObj src, int begSec, int begUSec, int endSec, int endUSec, string archivator = "" ) — êîï³þâàííÿ ÷àñòèíè âèõ³äíîãî src àðõ³âó àáî éîãî áóôåðó äî ïîòî÷íîãî ïî÷èíàþ÷è ç begSec:begUSec òà çàê³í÷óþ÷è endSec:endUSec äëÿ àðõ³âàòîðó archivator.
• ArrayObj FFT( int tm, real size, string archivator = "", int tm_usec = 0 ) — âèêîíóº ðîçêëàäàííÿ ó ðÿä Ôóð'º çà äîïîìîãîþ FFT àëãîðèòìó. Ïîâåðòàºòüñÿ ìàñèâ àìïë³òóä ÷àñòîò äëÿ â³êíà çíà÷åíü ³ç àðõ³âó ç ÷àñîì ïî÷àòêó tm:tm_usec (ñåêóíäè:ì³êðîñåêóíäè), ãëèáèíîþ ó ³ñòîð³þ àðõ³âó size (ñåêóíä) òà äëÿ àðõ³âàòîðó archivator.

Ïðèêëàä:

using Special.FLibSYS;
val = vArh(strPath2Sep(addr)).get(time,uTime,0,archivator);
return val.isEval() ? "Ïîðîæíüî" : real2str(val,prec);

1.6. Áóôåð àðõ³âó çíà÷åíü (vArhBuf)

Îïèñ: Îòðèìàííÿ îá'ºêòó áóôåðó àðõ³âó çíà÷åíü (VArchObj) äëÿ âèêîíàííÿ ïðîì³æíèõ îïåðàö³é íàä êàäðàìè äàíèõ.
Ïàðàìåòðè:

1.7. Ââ³ä/Âèâ³ä (IO)

Îïèñ: Ââ³ä/Âèâ³ä ó: ôàéë, ñòðîêîâèé ïîò³ê.
Ïàðàìåòðè:

IO îá'ºêò

Çíà÷åííÿ:

• valType — òèïè çíà÷åíü:
  • "uchar", "uint8", "unsigned char";
  • "uint16", "ushort";
  • "uint32", "uint", "ulong";
  • "uint64";
  • "char", "int8", "schar", "signed char", "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|double|Array} vals, string valType = "char", string mFormatEnc = "n|NoEnc", int cnt = 1); — Çàïèñ çíà÷åííÿ(ü) vals äëÿ òèïó valType äëÿ ôîðìàòó ìàøèíè àáî âõ³äíîãî êîäóâàííÿ ðÿäêà mFormatEnc, òà ïîâòîðó ñêàëÿðíèõ çíà÷åíü ó ê³ëüêîñò³ cnt.

Ïåðåêëàä

2. Ôóíêöèè äëÿ ðàáîòû ñ àñòðîíîìè÷åñêèì âðåìåíåì

2.1. Ñòðîêà âðåìåíè (tmFStr) <3047>

Îïèñàíèå: Ïðåîáðàçóåò àáñîëþòíîå âðåìÿ â ñòðîêó íóæíîãî ôîðìàòà. Çàïèñü ôîðìàòà ñîîòâåòñòâóåò POSIX-ôóíêöèè strftime.
Ïàðàìåòðû:

Ïðèìåð:

using Special.FLibSYS;
test=tmFStr(SYS.time(),);
messPut("Example",0,"tmFStr(): "+test);

2.2. Ïîëíàÿ äàòà (tmDate) <973>

Îïèñàíèå: Âîçâðàùàåò ïîëíóþ äàòó â ñåêóíäàõ, ìèíóòàõ, ÷àñàõ è ò.ä, èñõîäÿ èç àáñîëþòíîãî âðåìåíè â ñåêóíäàõ îò ýïîõè 1.1.1970.
Ïàðàìåòðû:

Ïðèìåð:

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);

2.3. Àáñîëþòíîå âðåìÿ (tmTime) <220>

Îïèñàíèå: Âîçâðàùàåò àáñîëþòíîå âðåìÿ â ñåêóíäàõ îò ýïîõè 1.1.1970 è ìèêðîñåêóíäàõ, åñëè usec óñòàíîâëåí â íåîòðèöàòåëüíîå çíà÷åíèå.
Ïàðàìåòðû:

2.4. Êîíâåðòàöèÿ âðåìåíè èç ñèìâîëüíîãî ïðåäñòàâëåíèè âî âðåìÿ â ñåêóíäàõ, îò ýïîõè 1.1.1970 (tmStrPTime) <2600>

Îïèñàíèå: Âîçâðàùàåò âðåìÿ â ñåêóíäàõ îò ýïîõè 1.1.1970, èñõîäÿ èç ñòðîêîâîé çàïèñè âðåìåíè, â ñîîòâåòñòâèè ñ óêàçàííûì øàáëîíîì. Íàïðèìåð, øàáëîíó "%Y-%m-%d %H:%M:%S" ñîîòâåòñòâóåò âðåìÿ "2006-08-08 11:21:55". Îïèñàíèå ôîðìàòà øàáëîíà ìîæíî ïîëó÷èòü èç äîêóìåíòàöèè íà POSIX-ôóíêöèþ "strptime".
Ïàðàìåòðû:

Ïðèìåð:

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",);
messPut("Example",0,"tmStrPTime(): "+test);

2.5. Ïëàíèðîâàíèå âðåìåíè â ôîðìàòå Cron (tmCron)

Îïèñàíèå: Âîçâðàùàåò âðåìÿ ñïëàíèðîâàííîå â ôîðìàòå ñòàíäàðòà Cron íà÷èíàÿ îò áàçîâîãî âðåìåíè èëè îò òåêóùåãî åñëè áàçîâîå íå óêàçàíî.
Ïàðàìåòðû:

2.6. Ñîí (tmSleep)

Îïèñàíèå: Êîðîòêèé ñîí îò íàíîñåêóíä è äî STD_INTERF_TM (5 ñåêóíä).
Ïàðàìåòðû:

3. Ôóíêöèè ðàáîòû ñ ñîîáùåíèÿìè

3.1. Çàïðîñ ñîîáùåíèé (messGet)

Îïèñàíèå: Çàïðîñ ñèñòåìíûõ ñîîáùåíèé.
Ïàðàìåòðû:

3.2. Ãåíåðàöèÿ ñîîáùåíèÿ (messPut)

Îïèñàíèå: Ôîðìèðîâàíèå ñèñòåìíîãî ñîîáùåíèÿ.
Ïàðàìåòðû:

Ïðèìåð:

rnd_sq_gr11_lineClr="red";
Special.FLibSYS.messPut("Example",1,"Event: "+rnd_sq_gr12_leniClr);

4. Ôóíêöèè ðàáîòû ñ ñòðîêàìè

4.1. Ïîëó÷åíèå ðàçìåðà ñòðîêè (strSize) <114>

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ ïîëó÷åíèÿ ðàçìåðà.
Ïàðàìåòðû:

Ïðèìåð:

Special.FLibSYS.messPut("Example",1,"ReturnString: "+strSize("Example"));

4.2. Ïîëó÷åíèå ÷àñòè ñòðîêè (strSubstr) <413>

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ ïîëó÷åíèÿ ÷àñòè ñòðîêè.
Ïàðàìåòðû:

Ïðèìåð:

using Special.FLibSYS;
test=strSubstr("Example", 0, strSize("Example")-1);
messPut("Example",1,"ReturnString: "+test);

4.3. Âñòàâêà îäíîé ñòðîêè â äðóãóþ (strInsert) <1200>

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ âñòàâêè îäíîé ñòðîêè â äðóãóþ.
Ïàðàìåòðû:

4.4. Çàìåíà ÷àñòè ñòðîêè äðóãîé (strReplace) <531>

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ çàìåíû ÷àñòè ñðîêè äðóãîé ñòðîêîé.
Ïàðàìåòðû:

4.5. Ðàçáîð ñòðîêè ïî ðàçäåëèòåëþ (strParse) <537>

Îïèñàíèå: Èñïîëüçóåòñÿ â ðàçáîðå ñòðîêè ïî ðàçäåëèòåëþ.
Ïàðàìåòðû:

Ïðèìåð:

using Special.FLibSYS;
ExapleString="Example:123";
test=strParse(ExapleString,1,":");
messPut("Example",0,"strParse(): "+test);

4.6. Ðàçáîð ïóòè (strParsePath) <300>

Îïèñàíèå: Èñïîëüçóåòñÿ â ðàçáîðå ïóòè íà ýëåìåíòû.
Ïàðàìåòðû:

Ïðèìåð:

using Special.FLibSYS;
test=strParsePath(path,0,"/");
messPut("Example",1,"strParsePath(): "+test);

4.7. Ïóòü â ñòðîêó ñ ðàçäåëèòåëåì (strPath2Sep)

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ ïðåîáðàçîâàíèÿ ïóòè â ñòðîêó ñ ðàçäåëèòåëåì.
Ïàðàìåòðû:

Ïðèìåð:

//Ïðåîáðàçóåì çíà÷åíèå "/ses_AGLKS/pg_so" àòðèáóòà "path" â çíà÷åíèå "ses_AGLKS.pg_so"
using Special.FLibSYS;
test = strPath2Sep(path);
messPut("Example",0,"path: "+path);
messPut("Example",0,"strPath2Sep(): "+test);

4.8. Êîäèðîâàíèå ñòðîêè â HTML (strEnc2HTML)

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ êîäèðîâàíèÿ ñòðîêè äëÿ èñïîëüçîâàíèÿ â èñõîäíèêå HTML.
Ïàðàìåòðû:

4.9. Êîäèðîâàíèå òåêñòà â áèíàðíûé âèä (strEnc2Bin)

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ êîäèðîâàíèÿ òåêñòà â áèíàðíûé âèä, èç ôîðìàòà <00 A0 FA DE>.
Ïàðàìåòðû:

4.10. Äåêîäèðîâàíèå òåêñòà èç áèíàðíîãî âèäà (strDec4Bin)

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ äåêîäèðîâàíèÿ òåêñòà èç áèíàðíîãî âèäà â ôîðìàò <00 A0 FA DE>.
Ïàðàìåòðû:

4.11. Ïðåîáðàçîâàíèå âåùåñòâåííîãî â ñòðîêó (real2str)

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ ïðåîáðàçîâàíèÿ âåùåñòâåííîãî â ñòðîêó.
Ïàðàìåòðû:

4.12. Ïðåîáðàçîâàíèå öåëîãî â ñòðîêó (int2str)

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ ïðåîáðàçîâàíèÿ öåëîãî â ñòðîêó.
Ïàðàìåòðû:

4.13. Ïðåîáðàçîâàíèå ñòðîêè â âåùåñòâåííîå (str2real)

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ ïðåîáðàçîâàíèÿ ñòðîêè â âåùåñòâåííîå.
Ïàðàìåòðû:

4.14. Ïðåîáðàçîâàíèå ñòðîêè â öåëîå (str2int)

Îïèñàíèå: Èñïîëüçóåòñÿ äëÿ ïðåîáðàçîâàíèÿ ñòðîêè â öåëîå.
Ïàðàìåòðû:

4.15. Öèêëè÷åñêèé Èçáûòî÷íûé Êîä (CRC)

Îïèñàíèå: Ðåàëèçàöèÿ Öèêëè÷åñêîãî Èçáûòî÷íîãî Êîäà äëÿ äëèí 8-64 áèò.
Ïàðàìåòðû:

4.16. Ñëåïîê ñîîáùåíèÿ 5 (MD5)

Îïèñàíèå: Ðàñ÷¸ò ñëåïêà ñîîáùåíèÿ 5.
Ïàðàìåòðû:

5. Ôóíêöèè ðàáîòû ñ âåùåñòâåííûì

5.1. Ðàçäåëåíèå float íà ñëîâà (floatSplitWord) <56>

Îïèñàíèå: Ðàçäåëåíèå float (4 áàéòîâ) íà ñëîâà (2 áàéòà).
Ïàðàìåòðû:

5.2. Îáúåäèíåíèå float èç ñëîâ (floatMergeWord) <70>

Îïèñàíèå: Îáúåäèíåíèå float (4 áàéòîâ) èç ñëîâ (2 áàéòà).
Ïàðàìåòðû:

6. API ïîëüçîâàòåëüñêîãî ïðîãðàììèðîâàíèÿ

Íåêîòîðûå îáúåêòû ìîäóëÿ ïðåäîñòàâëÿþò ôóíêöèè ïîëüçîâàòåëüñêîãî ïðîãðàììèðîâàíèÿ.

Îáúåêò "Áèáëèîòåêà ôóíêöèé" (SYS.Special.FLibSYS)

• ElTp {funcID}(ElTp prm1, ...) — âûçîâ ôóíêöèè áèáëèîòåêè {funcID}. Âîçâðàùàåò ðåçóëüòàò âûçûâàåìîé ôóíêöèè.

Îáúåêò "Ïîëüçîâàòåëüñêàÿ ôóíêöèÿ" (SYS.Special.FLibSYS["funcID"])

• ElTp call(ElTp prm1, ...) — âûçîâ äàííîé ôóíêöèè ñ ïàðàìåòðàìè <prm{N}>. Âîçâðàùàåò ðåçóëüòàò âûçûâàåìîé ôóíêöèè.

Ññûëêè