English Version
Óêðà¿íñüêà âåðñ³ÿ?

Ìîäóëü ïîäñèñòåìû “Ïðîòîêîëû” <UserProtocol>

Ââåäåíèå

Ìîäóëü òðàíñïîðòíîãî ïðîòîêîëà UserProtocol ïðåäíàçíà÷åí äëÿ ïðåäîñòàâëåíèÿ ïîëüçîâàòåëþ âîçìîæíîñòè ñîçäàíèÿ ðåàëèçàöèé ðàçëè÷íûõ ïðîòîêîëîâ ñîáñòâåííûìè ñèëàìè íà îäíîì èç âíóòðåííèõ ÿçûêîâ OpenSCADA, îáû÷íî JavaLikeCalc, íå ïðèáåãàÿ ê íèçêîóðîâíåâîìó ïðîãðàììèðîâàíèþ OpenSCADA.

Îñíîâíàÿ öåëü ìîäóëÿ - óïðîñòèòü çàäà÷ó ïîäêëþ÷åíèÿ ê ñèñòåìå OpenSCADA óñòðîéñòâ èñòî÷íèêîâ äàííûõ, êîòîðûå èìåþò íåçíà÷èòåëüíîå ðàñïðîñòðàíåíèå è/èëè ïðåäîñòàâëÿþò äîñòóï ê ñîáñòâåííûì äàííûì ïî ñïåöèôè÷åñêîìó ïðîòîêîëó, îáû÷íî äîñòàòî÷íî ïðîñòîìó äëÿ ðåàëèçàöèè íà âíóòðåííåì ÿçûêå OpenSCADA. Äëÿ ðåàëèçàöèè ýòîãî ïðåäîñòàâëÿåòñÿ ìåõàíèçì ôîðìèðîâàíèÿ ïðîòîêîëà èñõîäÿùåãî çàïðîñà.

Êðîìå ìåõàíèçìà ïðîòîêîëà èñõîäÿùåãî çàïðîñà ïðåäîñòàâëÿåòñÿ ìåõàíèçì ïðîòîêîëà âõîäÿùåãî çàïðîñà, êîòîðûé ïîçâîëÿåò OpenSCADA îáñëóæèâàòü çàïðîñû íà ïîëó÷åíèå äàííûõ ïî ñïåöèôè÷åñêèì ïðîòîêîëàì, êîòîðûå äîñòàòî÷íî ïðîñòî ìîãóò áûòü ðåàëèçîâàíû íà âíóòðåííåì ÿçûêå OpenSCADA.

Ìîäóëü ïðåäîñòàâëÿåò âîçìîæíîñòü ñîçäàíèÿ ðåàëèçàöèé ìíîæåñòâà ðàçëè÷íûõ ïðîòîêîëîâ â îáúåêòå "Ïîëüçîâàòåëüñêèé ïðîòîêîë" (ðèñ.1).

Ðèñ.1. Îñíîâíàÿ âêëàäêà îáúåêòà "Ïîëüçîâàòåëüñêèé ïðîòîêîë".

Ãëàâíàÿ âêëàäêà ñîäåðæèò îñíîâíûå íàñòðîéêè ïîëüçîâàòåëüñêîãî ïðîòîêîëà:

• Ðàçäåë "Ñîñòîÿíèå" - ñîäåðæèò ñâîéñòâà, õàðàêòåðèçóþùèå ñîñòîÿíèå ïðîòîêîëà:
  • Ñîñòîÿíèå - òåêóùåå ñîñòîÿíèå ïðîòîêîëà.
  • Âêëþ÷åí - ñîñòîÿíèå ïðîòîêîëà "Âêëþ÷åí".
  • ÁÄ - ÁÄ, â êîòîðîé õðàíèòñÿ êîíôèãóðàöèÿ.
• Ðàçäåë "Êîíôèãóðàöèÿ" - íåïîñðåäñòâåííî ñîäåðæèò ïîëÿ êîíôèãóðàöèè:
  • ID - èíôîðìàöèÿ îá èäåíòèôèêàòîðå ïðîòîêîëà.
  • Èìÿ - óêàçûâàåò èìÿ ïðîòîêîëà.
  • Îïèñàíèå - êðàòêîå îïèñàíèå ïðîòîêîëà è åãî íàçíà÷åíèÿ.
  • Âêëþ÷àòü - óêàçûâàåò íà ñîñòîÿíèå "Âêëþ÷åí", â êîòîðîå ïåðåâîäèòü ïðîòîêîë ïðè çàãðóçêå.

1. ×àñòü ïðîòîêîëà äëÿ âõîäÿùèõ çàïðîñîâ

Ïðîòîêîë âõîäÿùèõ çàïðîñîâ ðàáîòàåò â êîîïåðàöèè ñ âõîäÿùèì òðàíñïîðòîì, è îòäåëüíûé îáúåêò "Ïîëüçîâàòåëüñêîãî ïðîòîêîëà" óêàçûâàåòñÿ â ïîëå êîíôèãóðàöèè ïðîòîêîëà òðàíñïîðòà âìåñòå ñ èìåíåì ìîäóëÿ UserProtocol. Â äàëüíåéøåì âñå çàïðîñû ê òðàíñïîðòó áóäóò íàïðàâëÿòüñÿ â ïðîöåäóðó îáðàáîòêè çàïðîñà ïðîòîêîëà (ðèñ.2).

Ðèñ.2. Âêëàäêà ïðîöåäóðû îáðàáîòêè âõîäÿùèõ çàïðîñîâ.

Âêëàäêà ïðîöåäóðû îáðàáîòêè âõîäÿùèõ çàïðîñîâ ñîäåðæèò ïîëå äëÿ âûáîðà âíóòðåííåãî ÿçûêà ïðîãðàììèðîâàíèÿ OpenSCADA è ïîëå ââîäà òåêñòà ïðîöåäóðû îáðàáîòêè.

Äëÿ ïðîöåäóðû îáðàáîòêè ïðåäîïðåäåëåíû ñëåäóþùèå ïåðåìåííûå îáìåíà ñ âõîäÿùèì òðàíñïîðòîì:

• rez - ðåçóëüòàò îáðàáîòêè (false-ïîëíûé çàïðîñ; true-íå ïîëíûé çàïðîñ);
• request - ñîîáùåíèå çàïðîñà;
• answer - ñîîáùåíèå îòâåòà;
• sender - îòïðàâèòåëü çàïðîñà.

Îáùèé ñöåíàðèé îáðàáîòêè âõîäÿùèõ çàïðîñîâ:

• Çàïðîñ ôîðìèðóåòñÿ óäàë¸ííîé ñòàíöèåé è ÷åðåç ñåòü ïîïàäàåò íà òðàíñïîðò OpenSCADA.
• OpenSCADA òðàíñïîðò ïåðåäà¸ò çàïðîñ âûáðàííîìó â ïîëå ïðîòîêîëà ìîäóëþ UserProtocol è îáúåêòó ïîëüçîâàòåëüñêîãî ïðîòîêîëà â âèäå çíà÷åíèé ïåðåìåííîé "request" - äëÿ áëîêà çàïðîñà è "sender" - äëÿ àäðåñà îòïðàâèòåëÿ çàïðîñà.
• Çàïóñêàåòñÿ âûïîëíåíèå ïðîöåäóðû ïðîòîêîëà âõîäÿùåãî çàïðîñà, â ïðîöåññå êîòîðîé àíàëèçèðóåòñÿ ñîäåðæèìîå ïåðåìåííîé "request" è ôîðìèðóåòñÿ îòâåò â ïåðåìåííîé "answer". Ïî îêîí÷àíèþ âûïîëíåíèÿ ïðîöåäóðû ôîðìèðóåòñÿ ïåðåìåííàÿ "rez", êîòîðàÿ óêàçûâàåò òðàíñïîðòó íà ôàêò ïîëó÷åíèÿ ïîëíîöåííîãî çàïðîñà è ôîðìèðîâàíèå êîððåêòíîãî îòâåòà (false) èëè íåîáõîäèìîñòü òðàíñïîðòó îæèäàòü îñòàâøèõñÿ äàííûõ (true).
• Åñëè â ðåçóëüòàòå ïðîöåäóðû îáðàáîòêè ïåðåìåííàÿ "rez" ðàâíà 'false' è îòâåò â ïåðåìåííîé "answer" íåíóëåâîé, òî òðàíñïîðò îòïðàâëÿåò îòâåò è îáíóëÿåò íàêîïëåíèå "request".
• Åñëè â ðåçóëüòàòå ïðîöåäóðû îáðàáîòêè ïåðåìåííàÿ "rez" ðàâíà 'true', òî òðàíñïîðò ïðîäîëæàåò îæèäàòü äàííûå. Ïðè ïîëó÷åíèè ñëåäóþùåé ïîðöèè äàííûõ îíè äîáàâëÿþòñÿ ê ïåðåìåííîé "request" è âûïîëíåíèå ïðîöåäóðû ïîâòîðÿåòñÿ.

 êà÷åñòâå ïðèìåðà ðàññìîòðèì ðåàëèçàöèþ îáðàáîòêè çàïðîñîâ ïî ïðîñòîìó ïðîòîêîëó DCON, äëÿ íåêîòîðûõ çàïðîñîâ ê èñòî÷íèêó äàííûõ ñ àäðåñîì "10":
//SYS.messDebug("TEST REQ: ",request); //Ïðîâåðêà çàïðîñà íà ïîëíîòó if(request.length < 4 || request[request.length-1] != "\r") { if(request.length > 10) request = ""; return true; } //Ïðîâåðêà çàïðîñà íà öåëîñòíîñòü (CRC) è àäðåñà CRC = 0; for(i = 0; i < (request.length-3); i++) CRC += request.charCodeAt(i); if(CRC != request.slice(request.length-3,request.length-1).toInt(16) || request.slice(1,3).toInt(16) != 10) return false; //Àíàëèç çàïðîñà è ïîäãîòîâêà îòâåòà if(request.charCodeAt(0) == "#") answer = ">+05.123+04.153+07.234-02.356+10.000-05.133+02.345+08.234"; else if(request.charCodeAt(0) == "@") answer = ">AB3C"; else answer = "?"; //Çàâåðøåíèå îòâåòà CRC = 0; for(i=0; i < answer.length; i++) CRC += answer.charCodeAt(i); answer += (CRC&0xFF).toString(16)+"\r"; SYS.messDebug("TEST ANSV: "+answer.charCodeAt(0),answer); return 0;

2. ×àñòü ïðîòîêîëà äëÿ èñõîäÿùèõ çàïðîñîâ

Ïðîòîêîë èñõîäÿùèõ çàïðîñîâ ðàáîòàåò â êîîïåðàöèè ñ èñõîäÿùèì òðàíñïîðòîì è îòäåëüíûì îáúåêòîì "Ïîëüçîâàòåëüñêîãî ïðîòîêîëà". Èñòî÷íèêîì çàïðîñà ÷åðåç ïðîòîêîë ìîæåò âûñòóïàòü ôóíêöèÿ îáùåñèñòåìíîãî API ïîëüçîâàòåëüñêîãî ïðîãðàììèðîâàíèÿ èñõîäÿùåãî òðàíñïîðòà int messIO( XMLNodeObj req, string prt );, â ïàðàìåòðàõ êîòîðîé óêàçûâàåòñÿ:

• req - çàïðîñ â âèäå äåðåâà XML ñî ñòðóêòóðîé, ñîîòâåòñòâóþùåé âõîäíîìó ôîðìàòó ðåàëèçîâàííîãî ïðîòîêîëà;
• prt - èìÿ ìîäóëÿ "UserProtocol".

Çàïðîñ, îòïðàâëåííûé âûøåóêàçàííûì îáðàçîì, íàïðàâëÿòüñÿ â ïðîöåäóðó îáðàáîòêè çàïðîñà ïðîòîêîëà (ðèñ.3) ñ èäåíòèôèêàòîðîì ïîëüçîâàòåëüñêîãî ïðîòîêîëà, óêàçûâàåìûì â àòðèáóòå req.attr("ProtIt").

Ðèñ.3. Âêëàäêà ïðîöåäóðû îáñëóæèâàíèÿ èñõîäÿùèõ çàïðîñîâ.

Âêëàäêà ïðîöåäóðû îáðàáîòêè èñõîäÿùèõ çàïðîñîâ ñîäåðæèò ïîëå äëÿ âûáîðà âíóòðåííåãî ÿçûêà ïðîãðàììèðîâàíèÿ OpenSCADA è ïîëå ââîäà òåêñòà ïðîöåäóðû îáðàáîòêè.

Äëÿ ïðîöåäóðû îáðàáîòêè ïðåäîïðåäåëåíû ñëåäóþùèå ïåðåìåííûå îáìåíà:

• io - XML óçåë îáìåíà ñ êëèåíòîì, ÷åðåç êîòîðûé ïðîòîêîë ïðèíèìàåò çàïðîñû è â êîòîðûé ïîìåùàåò ðåçóëüòàò ñ ôîðìàòîì, ðåàëèçóåìûì â ïðîöåäóðå;
• tr - îáúåêò òðàíñïîðòà, ïðåäíàçíà÷åí äëÿ âûçîâà ôóíêöèè òðàíñïîðòà string messIO( string mess, real timeOut = 1000 ); "tr.messIO(req)".

Îáùèé ñöåíàðèé ôîðìèðîâàíèÿ èñõîäÿùåãî çàïðîñà:

• Ôîðìèðîâàíèå XML-äåðåâà â ñîîòâåòñòâèè ñî ñòðóêòóðîé, ðåàëèçóåìîé ïðîòîêîëîì, è óêàçàíèå èäåíòèôèêàòîðà ïîëüçîâàòåëüñêîãî ïðîòîêîëà â àòðèáóòå "ProtIt".
• Îòïðàâêà çàïðîñà ê òðàíñïîðòó ÷åðåç ïðîòîêîë SYS.Transport["Modul"]["OutTransp"].messIO(req,"UserProtocol");.
• Âûáîð ïîëüçîâàòåëüñêîãî èíòåðôåéñà â ñîîòâåòñòâèè ñ req.attr("ProtIt") è èíèöèàëèçàöèÿ ïåðåìåííûõ èñõîäÿùåãî òðàíñïîðòà io - ñîîòâåòñòâåííî ê ïåðâîìó àðãóìåíòó messIO() è tr - îáúåêò "OutTransp".
• Âûçîâ ïðîöåäóðû íà èñïîëíåíèå, êîòîðàÿ, îáðàáîòàâ ñòðóêòóðó "io", ôîðìèðóåò ïðÿìîé çàïðîñ òðàíñïîðòó tr.messIO(req);, ðåçóëüòàò êîòîðîãî îáðàáàòûâàåòñÿ è ïîìåùàåòñÿ íàçàä â io.

Ñóòü âûäåëåíèÿ ïðîòîêîëüíîé ÷àñòè êîäà â ïðîöåäóðó ïîëüçîâàòåëüñêîãî ïðîòîêîëà çàêëþ÷àåòñÿ â óïðîùåíèè èíòåðôåéñà êëèåíòñêîãî îáìåíà ïðè ìíîãîêðàòíîì èñïîëüçîâàíèè è ïðåäïîëàãàåò ôîðìèðîâàíèå ñòðóêòóðû XML-óçëà îáìåíà â âèäå àòðèáóòîâ àäðåñîâ óäàë¸ííûõ ñòàíöèé, àäðåñîâ ÷èòàåìûõ è çàïèñûâàåìûõ ïåðåìåííûõ, à òàêæå çíà÷åíèé ñàìèõ ïåðåìåííûõ. Ïðè ýòîì âåñü ãðóç íåïîñðåäñòâåííîãî êîäèðîâàíèÿ çàïðîñà è äåêîäèðîâàíèÿ îòâåòà âîçëàãàåòñÿ íà ïðîöåäóðó ïîëüçîâàòåëüñêîãî ïðîòîêîëà.

Ññûëêè