Protokol OPC Data Access 2.05 & 3.0 Client
Podporované typy a verzie zariadení
Konfigurácia komunikačnej linky
Konfigurácia komunikačnej stanice
Konfigurácia meraných bodov
Prehľadávanie adresného priestoru OPC servera
Dočítavanie historických údajov
Tell príkazy
Konfigurácia DCOM pre pripojenie sa ku remote OPC serveru
Chyby a problémy
Literatúra
Zmeny a úpravy
Revízie dokumentu
Podporované typy a verzie zariadení
...
Názov | Popis | Jednotka | Náhradná hodnota |
---|
OPC HDA: Server if Available | Meno (ProgID) OPC HDA servera, ak je dostupný. Prázdny text pre neaktivovanie OPC HDA funkcií. | - |
|
OPC HDA: Max. Number of Values | Nastavuje parameter NumItems pri synchrónnom čítaní historických "raw" hodnôt. Implicitná hodnota 0 znamená všetky hodnoty v danom intervale. | - | 0 |
| seqt | seqt | Úroveň autentifikácie použitá pri vytváraní spojenia na OPC server. OPC štandard definuje tieto úrovne: - RPC_C_AUTHN_LEVEL_DEFAULT (0)
- RPC_C_AUTHN_LEVEL_NONE (1)
- RPC_C_AUTHN_LEVEL_CONNECT (2)
- RPC_C_AUTHN_LEVEL_CALL (3)
- RPC_C_AUTHN_LEVEL_PKT (4)
- RPC_C_AUTHN_LEVEL_PKT_INTEGRITY (5)
- RPC_C_AUTHN_LEVEL_PKT_PRIVACY (6)
Pozn: prednastavená hodnota RPC_C_AUTHN_LEVEL_CONNECT (2) už nemusí vyhovovať. Microsoft zaviedol security hardening kvôli riešeniu bezpečnostných problémov popísaných v CVE-2021-26414. Viac detailov viď "KB5004442—Manage changes for Windows DCOM Server Security Feature Bypass (CVE-2021-26414)". | - | 2 |
| Zapína sekvenčné radenie volaní funkcie "Refresh2" rozhraní "Async I/O 2.0” a "Async I/O 3.0". Volania sú realizované po sebe vždy až po ukončení predchádzajúceho (t.j. získaní hodnôt). | YES/NO | Sequenced TransactionsZapína sekvenčné radenie volaní funkcie "Refresh2" rozhraní "Async I/O 2.0” a "Async I/O 3.0". Volania sú realizované po sebe vždy až po ukončení predchádzajúceho (t.j. získaní hodnôt). | YES/NO | NO |
Repeat Failed Group Activation | Opakovanie zlyhaných operácií aktivácie OPC grupy po čase určenom parametrom "Group reactivation delay". | YES/NO | YES |
| Čas, po ktorom je opakovaná neúspešná aktivácie OPC grupy, pokiaľ je zapnuté opakovanie aktivácie parametrom "Repeat failed group activation". | sec | 30 |
Reconnect After Failed Group Activation | Po zlyhaní operácií aktivácie OPC grupy dôjde k odpojeniu od OPC servera a k opätovnému pripojeniu. Parameter má význam najmä pri konfigurácii redundantných OPC serverov (po po odpojení sa od OPC servera nasleduje pripojenie k druhému OPC serveru, kde aktivácia môže byť úspešná). | YES/NO | NO |
| Perióda opakovania volania "GetGroupState" rozhrania "IOPCGroupStateMgt". Toto synchrónne volanie sa, ako jediné, cyklicky opakuje a slúži na detekciu problémov v komunikácii s OPC Serverom. | sec | 10 |
Accept All GetGroupState Errors | Považovanie všetkých chýb, ktoré vracia volanie "GetGroupState" rozhrania "IOPCGroupStateMgt", za fatálne (dôjde k odpojeniu od OPC servera a k opätovnému pripojeniu, prípadne k reštartu KOM procesu). Príklad chybovej hlášky volania "GetGroupState": WARNING: Siemens.TXP.OPC caused COM/OPC error 80010108H on IOPCGroupStateMgt::GetState(), Error string : The object invoked has disconnected from its clients. | YES/NO | NO |
Stop KOM When OPC Server Fails | Pri fatálnej chybe v komunikácii povoľuje zastaviť celý KOM proces. Viď poznámku. | YES/NO | NO |
| Iba aktívny KOM proces (t.j. aktívna inštancia pripojená k HOT serveru) komunikuje s OPC serverom. KOM proces, ktorý sa stane pasívnym (zmenou aktívnej inštancie alebo prepnutím redundancie), zavrie spojenie s OPC serverom. Pozn: parameter umožňuje znížiť záťaž OPC servera v redundantných D2000 systémoch ako aj riešiť napr. problémy s licenčným obmedzením počtu OPC klientov. | YES/NO | NO |
...
Názov | Popis | Jednotka | Náhradná hodnota |
---|
| Povoľuje vykonávať overenie hodnoty po zápise synchrónnym čítaním. | YES/NO | NO |
| Povoľuje vykonávať zápisy do OPC Servera vždy iba synchrónnym rozhraním "IOPCSyncIO2". | YES/NO | NO |
| Pri voľbe "Async I/O 3" povoľuje vykonávať zápisy funkciou WriteVQT rozhrania IOPCASyncIO3 (t.j. zápis umožňujúci prenos kvality a časovej značky spolu s vlastnou hodnotou). | YES/NO | NO |
| Zapína ladiace výpisy. Výrazne zvýši počet informácii o chode komunikácie. Odporúčame zapínať iba pri detekcii problémov a ladení komunikácie. | YES/NO | NO |
| Špeciálny mód pre komunikáciu s OPC servermi firmy Merz. Pre hodnoty typu TiA a ToA sa používa konverzia z/do formátu "MS DOS Date Time Format" (2 x WORD). | YES/NO | NO |
| Oneskorenie umelo vkladané medzi volania AddItems na spomalenie inicializačnej fázy. | ss:mss | 0 |
| Celočíselná hodnota stavu "ERROR" pre prevod do štvorstavového vstupu Qi. | 0,1,2,3 | 3 |
| Celočíselná hodnota stavu "OFF" pre prevod do štvorstavového vstupu Qi. | 0,1,2,3 | 2 |
| Celočíselná hodnota stavu "ON" pre prevod do štvorstavového vstupu Qi. | 0,1,2,3 | 1 |
| Celočíselná hodnota stavu "TRANS" pre prevod do štvorstavového vstupu Qi. | 0,1,2,3 | 0 |
Keep Values Valid as Weak | Ak dôjde ku zmene kvality OPC itemu na "BAD", hodnota meraného bodu zostane platná (valid) s príznakom "Weak". | YES/NO | NO |
Don't Repeat Failed AddItems | Zablokuje opakované pokusy volania AddItems po jeho zlyhaní. | YES/NO | NO |
Do AddItems in Single Call | Aktivácia všetkých položiek skupiny jedným volaním AddItems. Môže zrýchliť štart OPC komunikácie. | YES/NO | NO |
| Všetky volania funkcii "Write" a "Refresh2" sú evidované ako samostatné transakcie. Ak nie sú ukončené (úspešne či neúspešne) do tohto timeoutu, je o tom užívateľ informovaný chybovým hlásením v trace súbore komunikácie. | sec | 120 |
Reconnect/Reinitialisation Delay | Timeout, ktorým sa oneskorujú opakovania zlyhaných operácii:
- vytvorenie skupiny AddGroup,
- vytvorenie položky AddItems (pozri tiež parameter protokolu SA),
- opakované pripojenie na OPC Server po jeho zastavení, páde alebo sieťovom odpojení,
- vytváranie skupín a položiek po opakovanom pripojení na OPC Server.
| sec | 5 |
Do Sync Read Before Write If Unk. Type | Povolenie vykonania synchrónneho čítania hodnoty položky pred zápisom v prípade, že KOM proces nevie správny dátový typ položky (to zn., že v prípade implicitnej hodnoty dátového typu "Empty/Default (VT_EMPTY)" je nutné vykonať zápis hodnoty). | YES/NO | YES |
| Adresa OPC Itemu (OPC Item ID), ktorý obsahuje chybový stav OPC servera resp. konkrétnej OPC grupy (napr. v závislosti od stavu komunikácie). Musí existovať aj meraný bod s touto adresou. Ak stav indikuje chybu, ovplyvní to hodnoty všetkých meraných bodov na stanici (budú mať príznak Weak). O tom, aká hodnota zodpovedá chybovému stavu, hovorí parameter Status Item Inverted Operation | - | - |
Status Item Inverted Operation | Interpretácia hodnoty OPC Itemu Status Item Name s chybovým stavom OPC servera alebo OPC grupy. Hodnota NO znamená, že hodnoty False resp. 0 znamenajú korektný stav a True resp. nenulová chybu . Hodnota YES znamená, že hodnoty False resp. 0 znamenajú chybový stav a True resp. nenulová korektný stav. | YES/NO | NO |
| Mapovanie OPC DA príznaku kvality Non Specific do atribútov hodnoty meraného bodu. | None, FA, FB, FC, FD, FE, FF, FG, FH, FI, FJ, FK, FL, FM, FN, FO, FP | None |
Map LocalOverride as Flag | Mapovanie OPC DA príznaku kvality LocalOverride do atribútov hodnoty meraného bodu. |
| Mapovanie OPC DA príznaku kvality Config Error do atribútov hodnoty meraného bodu. |
| Mapovanie OPC DA príznaku kvality Not Connected do atribútov hodnoty meraného bodu. |
Map DeviceFailure as Flag | Mapovanie OPC DA príznaku kvality Device Failure do atribútov hodnoty meraného bodu. |
Map SensorFailure as Flag | Mapovanie OPC DA príznaku kvality Sensor Failure do atribútov hodnoty meraného bodu. |
| Mapovanie OPC DA príznaku kvality Last Known do atribútov hodnoty meraného bodu. |
| Mapovanie OPC DA príznaku kvality Comm Failure do atribútov hodnoty meraného bodu. |
| Mapovanie OPC DA príznaku kvality Out Of Service do atribútov hodnoty meraného bodu. |
Map WaitingForInitData as Flag | Mapovanie OPC DA príznaku kvality Waiting For Initial Data do atribútov hodnoty meraného bodu. |
| Mapovanie OPC DA príznaku kvality Last Usable do atribútov hodnoty meraného bodu. |
| Mapovanie OPC DA príznaku kvality Sensor Cal do atribútov hodnoty meraného bodu. |
| Mapovanie OPC DA príznaku kvality EGU Exceededdo atribútov hodnoty meraného bodu. |
| Mapovanie OPC DA príznaku kvality Sub Normaldo atribútov hodnoty meraného bodu. |
Reconnect After Error Count | Pokiaľ dôjde pri čítaní hodnôt k počtu chýb po sebe rovnému hodnote parametra, dôjde k reinicializácii OPC spojenia. Nulová hodnota parametra znamená, že reinicializácia sa nevykoná (prednastavené správanie). Aktuálna implementácia rieši iba výpadky v synchrónnom móde (nastavenie typu na "Synchronous I/O" v záložke Adresa objektu Stanica). | - | 0 |
...
Adresa meraného bodu vyžaduje zadať “OPC Item ID” (string max. 200 znakov). Ak OPC server podporuje rozhranie IOPCBrowseServerAddressSpace, je možné si vybrať adresu OPC Item ID priamo zo zoznamu adries, ktoré OPC server podporuje priamo po stlačení tlačidla "Browse Items...", viď kapitolu Prehľadávanie adresného priestoru OPC servera.
Pozn: ak sa zadá adresa meraného bodu ako %IGNORE, takýto meraný bod bude ignorovaný.
...
Zobrazenie môže mať formu "Hierarchical" alebo "Flat". Niektoré OPC servery nemusia podporovať "Hierarchical" formu zobrazovania adresného priestoru OPC položiek. Vtedy je tlačidlo "Hierarchical" zakázané. Ak OPC server podporuje obe formy zobrazenia položiek, je možné sa medzi nimi prepínať.
- Hierarchical zobrazenie umožňuje prehľadávanie adresného priestoru OPC servera podľa logických hierarchických skupín a podskupín, ktoré zvyčajne odrážajú reálne členenie hardvéru, s ktorým OPC server komunikuje. Okno "OPC Item Browser" obsahuje pole so stromovým hierarchickým členením adresného priestoru OPC servera a v dolnej časti okna je pole so zoznamom OPC položiek (OPC tagy), ktoré prislúchajú k vybranej vetve hierarchického členenia adresného priestoru.
- Flat model zobrazovania adresného priestoru OPC servera zobrazuje všetky dostupné OPC položky v jednom lineárnom zozname.
OPC Item ID vyberiete dvojitým kliknutím na položku. Vybratá položka sa prenesie do poľa OPC Item ID v záložke Adresa meraného bodu a okno "OPC Item Browser" sa zatvorí. Ak si užívateľ nepraje zmeniť OPC položku, okno "OPC Item Browser" sa zavrie stlačením tlačidla "Návrat".
Filtrovacie možnosti prehľadávania adresného priestoru OPC servera sú v hornej časti okna "OPC Item Browser". Textový filter "Filter" zobrazí len položky vyhovujúce zadanej textovej maske (niektoré OPC servery podporujú tzv. hviezdičkovú konvenciu). Filter "Data Type Filter" zobrazí len položky s vyhovujúcim dátovým typom. Voľba "Empty/Default" je implicitná a povoľuje zobrazenie všetkých položiek. Pri zadaní filtračných podmienok "Filter" a "Data Type Filter" je nutné vybrať, či sa filter má vzťahovať na hierarchickú stromovú štruktúru (zaškrtávacie políčko "Apply to the branches", iba pri hierarchickom zobrazení) alebo aj na vlastné OPC položky (zaškrtávacie políčko "Apply to the items").
Podľa prístupových práv je možné zobrazovať iba položky na čítanie (zaškrtávacie políčko "Browse readable items") alebo na zápis (zaškrtávacie políčko "Browse writeable items"). Implicitne sú povolené obe možnosti pre zobrazenie položiek bez obmedzenia.
Po akejkoľvek zmene filtračných podmienok je nutné stlačiť tlačidlo "Refresh" pre ich aktiváciu.
položiek, je možné sa medzi nimi prepínať.
- Hierarchical zobrazenie umožňuje prehľadávanie adresného priestoru OPC servera podľa logických hierarchických skupín a podskupín, ktoré zvyčajne odrážajú reálne členenie hardvéru, s ktorým OPC server komunikuje. Okno "OPC Item Browser" obsahuje pole so stromovým hierarchickým členením adresného priestoru OPC servera a v dolnej časti okna je pole so zoznamom OPC položiek (OPC tagy), ktoré prislúchajú k vybranej vetve hierarchického členenia adresného priestoru.
- Flat model zobrazovania adresného priestoru OPC servera zobrazuje všetky dostupné OPC položky v jednom lineárnom zozname.
OPC Item ID vyberiete dvojitým kliknutím na položku. Vybratá položka sa prenesie do poľa OPC Item ID v záložke Adresa meraného bodu a okno "OPC Item Browser" sa zatvorí. Ak si užívateľ nepraje zmeniť OPC položku, okno "OPC Item Browser" sa zavrie stlačením tlačidla "Návrat".
Filtrovacie možnosti prehľadávania adresného priestoru OPC servera sú v hornej časti okna "OPC Item Browser". Textový filter "Filter" zobrazí len položky vyhovujúce zadanej textovej maske (niektoré OPC servery podporujú tzv. hviezdičkovú konvenciu). Filter "Data Type Filter" zobrazí len položky s vyhovujúcim dátovým typom. Voľba "Empty/Default" je implicitná a povoľuje zobrazenie všetkých položiek. Pri zadaní filtračných podmienok "Filter" a "Data Type Filter" je nutné vybrať, či sa filter má vzťahovať na hierarchickú stromovú štruktúru (zaškrtávacie políčko "Apply to the branches", iba pri hierarchickom zobrazení) alebo aj na vlastné OPC položky (zaškrtávacie políčko "Apply to the items").
Podľa prístupových práv je možné zobrazovať iba položky na čítanie (zaškrtávacie políčko "Browse readable items") alebo na zápis (zaškrtávacie políčko "Browse writeable items"). Implicitne sú povolené obe možnosti pre zobrazenie položiek bez obmedzenia.
Po akejkoľvek zmene filtračných podmienok je nutné stlačiť tlačidlo "Refresh" pre ich aktiváciu.
Kopírovanie tagov
Klávesová skratka Ctrl+C skopíruje zoznam zobrazených tagov (v aktuálnej vetve) do schránky Windows (clipboardu). Pokiaľ je vyznačený konkrétny tag, skopíruje sa iba ten.
Klávesová skratka Ctrl+Shift+C skopíruje názvy tagov vo všetkých prejdených vetvách do schránky Windows (clipboardu).
Pozn: vo verziách z 20.12.2018 a novších bolo implementované recyklovanie prehliadacieho dialógu. Pokiaľ je dialóg zavretý tlačidlom Návrat alebo po výbere tagu, v skutočnosti je iba skrytý a je k dispozícii pre browsovanie iného meraného bodu v rámci tej istej stanice, takže sa zachováí stromová štruktúra prehliadaných objektov. Kliknutie na krížik vpravo hore spôsobí skutočné zavretie dialógu.
...
Príkaz | Syntax | Popis |
| STWATCH MenoStanice | Tell príkaz pošle na stanicu príkazy na vyčítanie hodnôt jednotlivých meraných bodov. |
...
...
Konfigurácia DCOM pre pripojenie sa ku vzdialenému (remote) OPC serveru
...
Zlé nastavenie prístupových práv pravdepodobne povedie ku chybe (viď kapitolu "Výpis COM/OPC chýb"):
|E|> ERROR: ServerProgID caused COM/OPC error 80070005H on CoCreateInstanceEx(CLSCTX_REMOTE_SERVER), Error string : Access is denied.
...
- 3. jan. 2003 - pridaný parameter UPDATE_RATE, polia hodnôt.
- 23. jan. 2004 – prepracované parametre grupa/item, chybové hlásenia a DCOM.
- 22. nov. 2005 - pridané nové parametre protokolu.
- 10.okt. 2007 - aktualizácia parametrov protokolu, Async I/O 3.0.
- 3. dec. 2007 - doplnené informácie o cieľovom stĺpci.
- mar. 2009 - doplnená podpora HDA.
- feb. 2010 - doplnený OPC Item browsing.
- mar. 2013 - doplnené tell príkazy.
- júl 2021 - doplnená podpora pre prácu so 64-bitovým INT / UINT
Revízie dokumentu
...
- Ver. 1.0 – 9. feb. 2000
- Ver. 1.1 - 3. jan. 2002
- Ver. 1.2 - 23. jan. 2004
- Ver. 1.3 - 22. nov. 2005
- Ver. 1.4 - 10. okt. 2007
- Ver. 1.5 - 3. dec. 2007
- Ver. 1.6 - 13. mar. 2008
- Ver. 1.7 - 8. feb. 2010
- Ver. 1.8 - 5. mar. 2013
- Ver. 1.9 - 16. júl 2021
- Ver. 1.10 - 7. feb. 2021 - pridaný parameter "Authentication Level"
...