OpenSCADAWiki: Doc/VCA/part4/part8 ...

Âàæíûì ýëåìåíòîì ëþáîãî èíòåðôåéñà âèçóàëèçàöèè ÿâëÿåòñÿ óâåäîìëåíèå ïîëüçîâàòåëÿ ïðî íàðóøåíèÿ — ñèãíàëèçàöèÿ. Äëÿ óïðîùåíèÿ âîñïðèÿòèÿ, à òàêæå â âèäó òåñíîé ñâÿçíîñòè âèçóàëèçàöèè è óâåäîìëåíèÿ (êàê ïðàâèëî óâåäîìëåíèå äîïîëíÿåò âèçóàëèçàöèþ) ðåøåíî èíòåãðèðîâàòü èíòåðôåéñ óâåäîìëåíèÿ â èíòåðôåéñ âèçóàëèçàöèè. Äëÿ ýòîãî âî âñåõ âèäæåòàõ ïðåäóñìàòðèâàþòñÿ äâà äîïîëíèòåëüíûõ àòðèáóòà (óðîâíÿ ñåàíñà): "alarm" è "alarmSt". Àòðèáóò "alarm" èñïîëüçóåòñÿ äëÿ ôîðìèðîâàíèÿ ñèãíàëà âèäæåòîì â ñîîòâåòñòâèè ñ åãî ëîãèêîé, à àòðèáóò "alarmSt" èñïîëüçóåòñÿ äëÿ êîíòðîëÿ çà ôàêòîì ñèãíàëèçàöèè âåòâè äåðåâà ñåàíñà ïðîåêòà.

Àòðèáóò "alarm" ÿâëÿåòñÿ ñòðîêîé è èìååò ñëåäóþùèé ôîðìàò: "{lev}|{categ}|{message}|{type}|{tp_arg}"
Ãäå:

• lev — óðîâåíü ñèãíàëèçàöèè: ÷èñëî îò 0 äî 255;
• categ — êàòåãîðèÿ ñèãíàëà: ïàðàìåòð ïîäñèñòåìû ñáîðà, îáúåêò, ïóòü èëè êîìáèíàöèÿ;
• message — ñîîáùåíèå ñèãíàëèçàöèè;
• type — òèïû óâåäîìëåíèÿ, óêàçûâàþòñÿ â âèäå öåëîãî ÷èñëà (0...7), ñîäåðæàùåãî ôëàãè ñïîñîáîâ óâåäîìëåíèé; òèïîâûå ñïîñîáû óâåäîìëåíèÿ:
  • 0x01 — âèçóàëüíàÿ;
  • 0x02 — ãóäîê, ÷àñòî ïðîèçâîäèòñÿ ÷åðåç PC-speaker;
  • 0x04 — çâóêîâîé ñèãíàë èç ôàéëà çâóêà èëè ñèíòåç ðå÷è; åñëè â tp_arg óêàçàíî èìÿ ðåñóðñà çâóêîâîãî ôàéëà, òî âîñïðîèçâîäèòñÿ èìåííî îí, èíà÷å âûïîëíÿåòñÿ ñèíòåç ðå÷è èç òåêñòà óêàçàííîãî â message.
• tp_arg — àðãóìåíò òèïà; ÷àñòî èñïîëüçóåòñÿ â ñëó÷àå îñóùåñòâëåíèÿ çâóêîâîé ñèãíàëèçàöèè äëÿ ïðÿìîãî óêàçàíèÿ ðåñóðñà çâóêîâîãî ñèãíàëà (ôàéë çâóêîâîãî ôîðìàòà).

Àòðèáóò "alarmSt" ÿâëÿåòñÿ öåëûì ÷èñëîì, êîòîðîå îòðàæàåò ìàêñèìàëüíûé óðîâåíü ñèãíàëà è ôàêò êâèòèðîâàíèÿ âåòâè äåðåâà ñåàíñà ïðîåêòà. Ôîðìàò ÷èñëà èìååò ñëåäóþùèé âèä:

• ïåðâûé áàéò (0...255) õàðàêòåðèçóåò óðîâåíü ñèãíàëà âåòâè;
• âòîðîé áàéò óêàçûâàåò òèï óâåäîìëåíèÿ (òàêæå êàê è â àòðèáóòå "alarm");
• òðåòèé áàéò óêàçûâàåò òèï íåñêâèòèðîâàííîãî óâåäîìëåíèÿ (òàêæå êàê è â àòðèáóòå "alarm");
• ÷åòâ¸ðòûé áàéò èìååò ñïåöèàëüíîå çíà÷åíèå, îïðåäåëÿåìîå îòäåëüíûìè áèòàìè:
  • áèò 0 — óêàçûâàåò, óñòàíîâêîé, íà ôàêò êâèòèðîâàíèÿ óâåäîìëåíèé â ïåðâîì áàéòå;
  • áèò 1 — óêàçûâàåò, ïðè óñòàíîâêå åãî è áèòà 0, íà âîçâðàò êâèòèðîâàíèÿ — âêëþ÷åíèå óâåäîìëåíèÿ.

Ôîðìèðîâàíèå ñèãíàëà è ïîëó÷åíèå åãî âèçóàëèçàòîðîì.
Ôîðìèðîâàíèå ñèãíàëà ïðîèçâîäèòñÿ ñàìèì âèäæåòîì ïóò¸ì óñòàíîâêè ñîáñòâåííîãî àòðèáóòà "alarm" íóæíûì îáðàçîì, è â ñîîòâåòñòâèè ñ íèì àâòîìàòè÷åñêè óñòàíàâëèâàåòñÿ àòðèáóò "alarmSt" òåêóùåãî è âûøåñòîÿùèõ âèäæåòîâ. Âèçóàëèçàòîðû ïîëó÷àþò óâåäîìëåíèå î ñèãíàëå ñ ïîìîùüþ ñòàíäàðòíîãî ìåõàíèçìà óâåäîìëåíèÿ îá èçìåíåíèè àòðèáóòîâ âèäæåòîâ.

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

Õîòÿ ìåõàíèçì ñèãíàëèçàöèè è ïîñòðîåí â ñðåäå âèçóàëèçàöèè, âîçìîæíîñòü ôîðìèðîâàíèÿ íåâèçóàëüíûõ ýëåìåíòîâ ñèãíàëèçàöèè îñòà¸òñÿ, íàïðèìåð, ïóò¸ì ñîçäàíèÿ ñòðàíèöû, êîòîðàÿ íèêîãäà íå áóäåò îòêðûâàòüñÿ.

Êâèòèðîâàíèå
Êâèòèðîâàíèå — ïðîöåññ ïðèíÿòèÿ íàðóøåíèÿ(é) ñ óâåäîìëåíèåì ê ñâåäåíèþ, îòêëþ÷åíèå óâåäîìëåíèÿ è ïðèíÿòèå ìåð ïî óñòðàíåíèþ íàðóøåíèÿ(é).  êîíòåêñòå ýêðàíà ïîëüçîâàòåëüñêîãî èíòåðôåéñà êâèòèðîâàíèå ïðåäïîëàãàåò òîëüêî îòêëþ÷åíèå óâåäîìëåíèÿ.

Êâèòèðîâàíèå ïðîèçâîäèòñÿ ïóò¸ì óêàçàíèÿ êîðíÿ âåòâè âèäæåòîâ è òèïîâ óâåäîìëåíèÿ. Ýòî ïîçâîëÿåò ðåàëèçîâàòü êâèòèðîâàíèå íà ñòîðîíå âèçóàëèçàòîðà êàê ïî ãðóïïàì, íàïðèìåð, ïî îáúåêòàì ñèãíàëèçàöèè, òàê è èíäèâèäóàëüíî ïî îáúåêòàì. Ïðè ýòîì ìîæíî íåçàâèñèìî êâèòèðîâàòü ðàçíûå òèïû ñèãíàëèçàöèé. Óñòàíîâêà êâèòèðîâàíèÿ ïðîèçâîäèòñÿ ïðîñòîé ìîäèôèêàöèåé àòðèáóòà "alarmSt".

Ïðèìåð ñêðèïòà äëÿ ðàáîòû ñ ñèãíàëàìè ïðèâåä¸í íèæå:
//Âûäåëåíèå ôàêòà íàëè÷èÿ ñèãíàëèçàöèé ðàçíûõ ñïîñîáîâ-òèïîâ óâåäîìëåíèÿ cvt_light_en = alarmSt&0x100; cvt_alarm_en = alarmSt&0x200; cvt_sound_en = alarmSt&0x400; //Âûäåëåíèå ôàêòà íàëè÷èÿ íåñêâèòèðîâàííûõ ñèãíàëèçàöèé ðàçíûõ ñïîñîáîâ óâåäîìëåíèÿ cvt_light_active = alarmSt&0x10000; cvt_alarm_active = alarmSt&0x20000; cvt_sound_active = alarmSt&0x40000; //Îáðàáîòêà ñîáûòèé êíîïîê êâèòèðîâàíèÿ è êâèòèðîâàíèå ðàçíûõ ñïîñîáîâ óâåäîìëåíèé for(ev_rez = "", off = 0; (sval=event.parse(0,"\n",off)).length; ) { if(sval == "ws_BtPress:/cvt_light") alarmSt = 0x1000001; else if(sval == "ws_BtPress:/cvt_alarm") alarmSt = 0x1000002; else if(sval == "ws_BtPress:/cvt_sound") alarmSt = 0x1000004; else ev_rez += sval + "\n"; } event = ev_rez;

Âíåøíèå ìåòîäû óâåäîìëåíèÿ
Îñíîâíûì è òèïîâûì ñïîñîáîì óâåäîìëåíèÿ ÿâëÿåòñÿ äèñïëåéíàÿ ñâåòîâàÿ ñèãíàëèçàöèÿ àâàðèéíûìè öâåòàìè è èõ äèíàìèêîé ó ýëåìåíòîâ âèçóàëèçàöèè, êîòîðàÿ ïðèñóòñòâóåò âñåãäà è íå òðåáóåò ñïåöèôè÷åñêîé êîíôèãóðàöèè. Îäíàêî ÷àñòî íóæíû óâåäîìëåíèÿ âíåøíåãî òèïà, íàïðèìåð: âíåøíåé ëàìïîé, áóçåðîì PC èëè "ðåâóíîì", ïðîèçâîëüíûì çâóêîì, ñèíòåçèðîâàííîé ðå÷üþ è ò.ä.

Äëÿ îñóùåñòâëåíèÿ òàêîé âîçìîæíîñòè âíåøíèå ñïîñîáû óâåäîìëåíèÿ è ñîîòâåòñòâóþùèå èì òèïû óâåäîìëåíèÿ ñâîáîäíî îïèñûâàþòñÿ íà ñòîðîíå ñåðâåðà âèçóàëèçàöèè è ñàìîãî âèçóàëèçàòîðà. Íà ñòîðîíå ñåðâåðà âèçóàëèçàöèè îïèñûâàåòñÿ ôîðìèðîâàíèå-ïîëó÷åíèå ðåñóðñà óâåäîìëåíèÿ è ñàìî óâåäîìëåíèå. Íà ñòîðîíå âèçóàëèçàòîðà îïèñûâàåòñÿ óâåäîìëåíèå ñîãëàñíî ðåñóðñàì ñåðâåðà âèçóàëèçàöèè.

Îïèñàíèå âíåøíèõ óâåäîìëåíèé îñóùåñòâëÿåòñÿ íà ãëàâíîé ñòðàíèöå è ñ ïîìîùüþ àòðèáóòîâ òåêñòîâîãî òèïà:

• Äëÿ ñåðâåðà âèçóàëèçàöèè àòðèáóòîì "notify{N}" â ôîðìàòå:

• Äëÿ âèçóàëèçàòîðà àòðèáóòîì "notifyVis[Vision|WebVision]{N}" â ôîðìàòå:

Ôëàãè:

• notify[{DL}] — âêëþ÷àåò óâåäîìëåíèå c ïîâòîðîì ÷åðåç âðåìÿ DL, åñëè óêàçàíî; äëÿ DL = 0 ïîâòîð ïðîèçâîäèòñÿ ñðàçó.
• resource — çàïðàøèâàòü-ôîðìèðîâàòü (ïðèíóäèòåëüíî) ðåñóðñ óâåäîìëåíèÿ ó ñåðâåðà âèçóàëèçàöèè, ìîæåò áûòü çâóêîâûì ôàéëîì, òåêñòîì èëè äðóãèìè äàííûìè äëÿ ôîðìèðîâàíèÿ óâåäîìëåíèÿ.
• queue — ðåñóðñû óâåäîìëåíèÿ îïðåäåëÿþòñÿ íå òîëüêî ïî ãëîáàëüíîìó ïðèçíàêó íàðóøåíèÿ è êâèòàöèè, à è ñîãëàñíî ïðèîðèòåòíîé î÷åðåäè èñòî÷íèêîâ óâåäîìëåíèÿ-ðåñóðñîâ. Î÷åðåäü ôîðìèðóåòñÿ íà ñòîðîíå ñåðâåðà âèçóàëèçàöèè, à äëÿ âèçóàëèçàòîðîâ óêàçûâàåòñÿ íåîáõîäèìîñòü ðàáîòû ñ íåé ïðè çàïðîñå ðåñóðñîâ.
• qMergeMess — îáúåäèíÿòü óâåäîìëåíèÿ â î÷åðåäè ïî ðàâåíñòâó ñîîáùåíèÿ.
• quittanceRet — âîçìîæíîñòü âèçóàëèçàòîðà îòçûâà-âîçâðàòà êâèòèðîâàíèÿ, ò.å. ïî ñóòè îáðàòíîãî âêëþ÷åíèÿ óâåäîìëåíèÿ.

Ïåðåìåííûå îáìåíà:

• en[0,1] — óâåäîìëåíèå âêëþ÷èòü (1) èëè âûêëþ÷èòü (0);
• doNtf[0,1] — âûçîâ ñöåíàðèÿ äëÿ óâåäîìëåíèÿ;
• doRes[0,1] — âûçîâ ñöåíàðèÿ äëÿ ôîðìèðîâàíèÿ ðåñóðñà;
• res — ñîäåðæèìîå èëè èìÿ ôàéëà ñ ñîäåðæèìûì (äëÿ âíåøíèõ ñöåíàðèåâ) ðåñóðñà;
• mess — ñîîáùåíèå-ïàðàìåòðû äëÿ ôîðìèðîâàíèÿ ðåñóðñà è óâåäîìëåíèÿ.
• lang — ÿçûê òåêóùåãî ïîëüçîâàòåëÿ èëè ñèñòåìû.

Ïðèìåðû è êîììåíòàðèè ê ðàáîòå òèïîâûõ ñïîñîáîâ óâåäîìëåíèé:

• Áóçåð íà ñòîðîíå âèçóàëèçàòîðà èëè ñåðâåðà âèçóàëèçàöèè:
  • alarm = "10|Prm||0x02"
  • notifyVisVision1 | notify1 =
  //flags=notify if(en) SYS.system("beep -f 1000 -l 1000000 &", true); else if((beepPID=SYS.system("pidof beep")).toInt()) SYS.system("kill "+beepPID);
  
  • notifyVisVision1 | notify1 =
  #!/bin/sh #flags=notify if test $en = 1; then beep -f 1000 -l 1000000 & else beepPID=$(pidof beep) if test "x$beepPID" != "x"; then kill $beepPID; fi fi
  
• Ïîâòîðÿþùååñÿ ïðîèãðûâàíèå ãîòîâîãî çâóêîâîãî ôàéëà, îäíîãî îáùåãî, íà ñòîðîíå âèçóàëèçàòîðà èëè ñåðâåðà âèçóàëèçàöèè:
  • alarm = "10|Prm||0x04"
  • notify2 | notifyVisVision2 =
  //flags=notify2 if(en) SYS.system("play -q alarm.ogg");
  
  • notify2 | notifyVisVision2 =
  #!/bin/sh #flags=notify2 if test $en = 1; then play -q alarm.ogg; fi
  
• Ïðîèãðûâàíèå èíäèâèäóàëüíîãî äëÿ èñòî÷íèêà çâóêîâîãî ôàéëà, íà ñòîðîíå âèçóàëèçàòîðà:
  • alarm = "10|Prm||0x04|res:al_prm1"
  • notify2 =
  //flags=queue
  
  • notifyVisVision2 =
  //flags=notify2|queue if(doNtf && en && res.length) { SYS.fileWrite("tmpPlay", res); SYS.system("play -q tmpPlay"); SYS.fileRemove("tmpPlay"); }
  
  • notifyVisVision2 =
  #!/bin/sh #flags=notify2|queue if test $doNtf = 1 -a $en = 1 -a -s $res; then play -q $res; fi
  
• Ñèíòåç ðå÷è èíäèâèäóàëüíîãî ñîîáùåíèÿ äëÿ èñòî÷íèêà, íà ñòîðîíå âèçóàëèçàòîðà:
  • alarm = "10|Prm|Òåêñòîâîå ñîîáùåíèå äëÿ ñèíòåçà ðå÷è|0x04"
  • notify2 =
  //flags=queue
  
  • notifyVisVision2 =
  //flags=notify2|queue if(doNtf && en && mess.length) { SYS.fileWrite("tmpForSpeech", mess); SYS.system("festival --tts tmpForSpeech"); SYS.fileRemove("tmpForSpeech"); }
  
  • notifyVisVision2 =
  #!/bin/sh #flags=notify2|queue if test $doNtf = 1 -a $en = 1 -a "x" != "x$mess"; then echo $mess > tmpForSpeech festival --tts tmpForSpeech rm tmpForSpeech fi
  
• Ïîäãîòîâêà çâóêîâîãî ôàéëà, îäíîãî îáùåãî, è åãî ïðîèãðûâàíèå íà ñòîðîíå âèçóàëèçàòîðà èëè ñåðâåðà âèçóàëèçàöèè:
  • alarm = "10|Prm||0x04"
  • notify2 =
  //flags=notify2|resource if(doRes) res = SYS.fileRead("alarm.ogg"); //Âñòàâèòü ñþäà äðóãîé ìåòîä ãåíåðàöèè if(doNtf && en && res.length) { SYS.fileWrite("tmpPlay", res); SYS.system("play -q tmpPlay"); SYS.fileRemove("tmpPlay"); }
  
  • notify2 =
  #!/bin/sh #flags=notify2|resource if test $doRes = 1; then cp -f alarm.ogg $res; fi #Âñòàâèòü ñþäà äðóãîé ìåòîä ãåíåðàöèè if test $doNtf = 1 -a $en = 1 -a -s $res; then play -q $res; fi
  
  • notifyVisVision2 =
  //flags=notify2|resource if(en && res.length) { SYS.fileWrite("tmpPlay", res); SYS.system("play -q tmpPlay"); SYS.fileRemove("tmpPlay"); }
  
  • notifyVisVision2 =
  #!/bin/sh #flags=notify2|resource if test $en = 1 -a -s $res; then play -q $res; fi
  
• Ïîäãîòîâêà èíäèâèäóàëüíîãî äëÿ èñòî÷íèêà óâåäîìëåíèÿ çâóêîâîãî ôàéëà ÷åðåç ñèíòåç ðå÷è, íà ñòîðîíå âèçóàëèçàòîðà èëè ñåðâåðà âèçóàëèçàöèè:
  • alarm = "10|Prm|Òåêñòîâîå ñîîáùåíèå äëÿ ñèíòåçà ðå÷è|0x04"
  • notify2 =
  //flags=notify2|queue if(doRes && mess.length) { SYS.fileWrite("tmpText", mess); SYS.system("text2wave tmpText -o tmpWAV"); res = SYS.fileRead("tmpWAV"); SYS.fileRemove("tmpText"); SYS.fileRemove("tmpWAV"); } if(doNtf && en && res.length) { SYS.fileWrite("tmpPlay", res); SYS.system("play -q tmpPlay"); SYS.fileRemove("tmpPlay"); }
  
  • notify2 =
  #!/bin/sh #flags=notify2|queue if test $doRes = 1 -a "x" != "x$mess"; then echo $mess > tmpText text2wave tmpText -o $res rm tmpText fi if test $doNtf = 1 -a $en = 1 -a -s $res; then play -q $res; fi
  
  • notifyVisVision2 =
  //flags=notify2|queue if(en && res.length) { SYS.fileWrite("tmpPlay", res); SYS.system("play -q tmpPlay"); SYS.fileRemove("tmpPlay"); }
  
  • notifyVisVision2 =
  #!/bin/sh #flags=notify2|queue if test $en = 1 -a -s $res; then play -q $res; fi