Interne Datenpunkte des OPC A&E Client
Über den Server Datenpunkt werden die Eigenschaften eines OPC A&E Server gesetzt bzw. die Statusinformationen und die Daten des Servers zur Verfügung gestellt. Die Werte werden in den OPC A&E Client Parametrierpanels von WinCC OA dargestellt - siehe auch Parametrierung des OPC A&E Client.
Für jeden OPC A&E Server, der gestartet werden soll, muss vor dem Start des OPC A&E Client von WinCC OA so ein Datenpunkt vom Typ _OPCAEServer vorhanden sein. Der Datenpunktname setzt sich nach folgender Konvention zusammen:
"_" + symbolischer Servername
Beispiel
Symbolischer Name: WinCC OA
Name des internen Datenpunktes vom Typ _OPCAEServer: _WCCOA
Über die Event Subscription Datenpunkte werden die Server Subscriptions definiert. Für einen Server kann es einen oder mehrere Event Subscription Datenpunkte geben. In den Datenpunktelementen werden die Eigenschaften der Event Subscription gesetzt. Die Werte werden in den OPC A&E Client Parametrierpanels von WinCC OA dargestellt - siehe auch Parametrierung des OPC A&E Client.
Für jede Event Subscription muss so ein Datenpunkt vom Typ _OPCAEEventSubscription vorhanden sein. Der Datenpunktname setzt sich nach folgender Konvention zusammen:
"_" + Event Subscription Name
Beispiel
Event Subscription Name: WCCOASubs
Name des internen Datenpunktes vom Typ _OPCAEEventSubscription: _WCCOASubs
Die Elemente des Datenpunkttyps _OPCAEServer sind in den folgenden Tabellen angeführt.
_OPCAEServer
Tabelle: Status-Datenpunktelemente von _OPCAEServer
| Datenpunktelement | Typ | Beschreibung |
|---|---|---|
| Connected | bool | Wird vom Treiber gesetzt (TRUE), wenn eine Verbindung zum entsprechenden Server besteht. Wird rückgesetzt (FALSE), wenn die Verbindung unterbrochen wird. Dieser Wert kann vom User nicht gesetzt werden. |
| VendorInfo | string | Herstellerspezifische Information zum Server. Dieser Wert kann vom User nicht gesetzt werden. |
| ServerStateText | string |
Falls in ServerState ein OPC Standard ServerState steht, wird in diesem Wert die Darstellung dieses Wertes als Text geliefert. Dieser Wert kann vom User nicht gesetzt werden.
Beispiel: ServerState = 1 ServerStateText = OPC_STATUS_RUNNING |
| ServerState | int | Der vom Server gelieferte Status als Zahl laut OPC Spezifikation. Dieser Wert kann vom User nicht gesetzt werden. |
| StartTime | time | Gibt den Zeitpunkt (in lokaler Zeit) an, zu dem der Server gestartet wurde. Dieser Wert kann vom User nicht gesetzt werden. |
| LastUpdateTime | time | Zeitpunkt des letzten Updates durch den Server in lokaler Zeit. Dieser Wert kann vom User nicht gesetzt werden. |
| MajorVersion | int | Major Version der Server Software. Dieser Wert kann vom User nicht gesetzt werden. |
| MinorVersion | int | Minor Version der Server Software. Dieser Wert kann vom User nicht gesetzt werden. |
| BuildNumber | int | Build number der Server Software. Dieser Wert kann vom User nicht gesetzt werden. |
| FilterMask | int | Zeigt an, welche Filter vom Server unterstützt werden. Die Zahl ist laut OPC Spezifikation zu interpretieren. Dieser Wert kann vom User nicht gesetzt werden. |
Tabelle: Daten-Datenpunktelemente von _OPCAEServer
| Datenpunktelement | Typ | Beschreibung |
|---|---|---|
| EventCategories.EventCategoryNames | dyn_string | Namen der Event Categories des Servers. Der Wert kann vom User nicht gesetzt werden. |
| EventCategories.EventCategoryIds | dyn_int | Ids der Event Categories des Servers. Der Wert kann vom User nicht gesetzt werden. |
| Conditions.EventCategoryNames | dyn_string | Event Category Namen der Conditions des Servers. Der Wert kann vom User nicht gesetzt werden. |
| Conditions.ConditionNames | dyn_string | Namen der Conditions des Servers. Der Wert kann vom User nicht gesetzt werden. |
| Subconditions.EventCategoryNames | dyn_string | Event Category Namen der Sub Conditions des Servers. Der Wert kann vom User nicht gesetzt werden. |
| Subconditions.ConditionNames | dyn_string | Condition Namen der Sub Conditions des Servers. Der Wert kann vom User nicht gesetzt werden. |
| Subconditions.SubConditionNames | dyn_string | Namen der Sub Conditions des Servers. Der Wert kann vom User nicht gesetzt werden. |
| SourceConditions | dyn_string |
Conditions der Server Items. Syntax:
<Item Name> | <Condition 1> | …
Der Wert kann vom User nicht gesetzt werden. |
| ConditionIdentification.ConditionName | dyn_string | Namen der Conditions des Servers. Der Wert kann vom User nicht gesetzt werden. |
| SourceIdentification.QualifiedSourceName | dyn_string | Namen der Server Items. Der Wert kann vom User nicht gesetzt werden. |
| SourceIdentification.QualifiedSourceNameBackup | dyn_string | Kopie von SourceIdentification.QualifiedSourceName. Der Wert ist notwendig, damit die Parametrierung erhalten bleibt, wenn beim Durchsuchen des Servers während des Client- Starts, der Server nicht alle Items liefert. |
| QualifiedAreaNames | dyn_string | Namen der Server Areas. Der Wert kann vom User nicht gesetzt werden. |
Tabelle: Parametrier-Datenpunktelemente von _OPCAEServer
| Datenpunktelement | Typ | Beschreibung |
|---|---|---|
| RegServerName | string | ProgID des OPC A&E Server. |
| EventCategories.Attributes4Original | dyn_string | Attribut der Event Category, das auf den Originalwert in WinCC OA abgebildet wird. |
| EventAttributes.EventCategoryNames | dyn_string | Enthält für jede Category drei Einträge. Dient zur Feststellung, welches Attribute der Category zugewiesen ist. |
| EventAttributes.EventAttributeNames | dyn_string | Enthält für jede Category die drei Einträge Ack Comment, Areas, Current Value. Dient zur Feststellung, welches Attribute der Category zugewiesen ist. |
| EventAttributes.EventAttributeIds | dyn_int | Enthält für jede Category drei Einträge. Dient zur Feststellung, welches Attribute der Category zugewiesen ist. |
| EventAttributes.EventAttributeTypes | dyn_int | Enthält für jede Category die drei Einträge VT_BSTR, VT_RESERVED, VT_R8). |
| ConditionIdentification.MasterNameFromCondition | dyn_string | Automatisch generierter Name des Master-Datenpunktes für eine Condition. Der Wert kann vom User nicht gesetzt werden. |
| ConditionIdentification.MasterNameChanged | dyn_string | Manuell geänderter Name des Master-Datenpunktes für eine Condition. Ist ein Eintrag nicht vorhanden, wird der Eintrag aus "ConditionIdentification.MasterNameFromCondition" verwendet. |
| SourceIdentification.ClientNameFromSource | dyn_string | Automatisch generierter Name des WinCC OA Datenpunktes für ein Server Item. Der Wert kann vom User nicht gesetzt werden. |
|
SourceIdentification.ClientNameFromSourceBackup
|
dyn_string |
Kopie von SourceIdentification.ClientNameFromSource. Der Wert ist notwendig, damit die Parametrierung erhalten bleibt, wenn beim Durchsuchen des Servers während des Client- Starts, der Server nicht alle Items liefert. |
| SourceIdentification.ClientNameChanged | dyn_string | Manuell geänderter Name des WinCC OA Datenpunktes für ein Server Item. |
| SourceIdentification.ClientNameChangedBackup | dyn_string |
Kopie von SourceIdentification.ClientNameChanged. Der Wert ist notwendig, damit die Parametrierung erhalten bleibt, wenn beim Durchsuchen des Servers während des Client- Starts, der Server nicht alle Items liefert. |
| Update | bool | Wird der Wert auf 1 gesetzt, wird ein Update der Server-Daten in WinCC OA ausgeführt. |
| Acknowledge | dyn_dpId | Hier werden alle Acknowledgements vom Meldeschirm eingetragen. |
| AddSubscription | bool | Wird dieser Wert auf 1 gesetzt, erhält der Client einen Hotlink, dass eine neue Subscription angelegt wurde. |
| Prefix | string | Präfix, der allen automatisch generierten Datenpunkten vorangestellt wird. |
| QualInfoFilter.QualInfo | int | Der Wert dieses Datenpunktes gibt an, welcher Teil der OPC Qualitätsinformation auf die Benutzerbits in WinCC OA abgebildet wird. |
| QualInfoFilter.QualInfoDetail | int | Dieser Wert gibt an, auf welche Benutzerbits der unter "QualInfoFilter.QualInfo" eingestellte Teil der Qualitätsinformation abgebildet wird. Siehe dazu auch die Tabelle bei der Dokumentation des OPC Data Access Client in WinCC OA. |
| InvalidMapping | int | Ist dieser Wert TRUE wird das Invalid Bit vom Treiber gesetzt, falls die OPC Quality Information BAD oder UNCERTAIN ist. Diese Einstellung ist kombinierbar mit alle möglichen Einstellungen von "QualInfoFilter.QualInfo" und "QualInfoFilter.QualInfoDetail". |
| StateTimer | unsigned | Dieser Wert legt das Sekundenintervall fest, in dem der Serverstatus abgefragt wird. Da die Statusabfrage (zusammen mit einem Callback Mechanismus) zur Verbindungsüberwachung verwendet wird, sollte dieser Wert nicht zu groß gewählt werden. (1 - 30 Sekunden). Bei 0 wird der Serverstatus nicht abgefragt. |
| ReconnectTimer | unsigned | Nach einer Unterbrechung der Verbindung des Client zum Server, versucht der Client die Verbindung zum Server wiederherzustellen. Dieser Wert gibt die Länge des Intervalls in Sekunden an, nach dessen Ablauf der Client eine Wiederverbindung (ein Reconnect) probiert. ACHTUNG: Dieser Wert sollte nicht zu klein gewählt werden, da sonst ein Reconnect probiert wird bevor der Server den Shutdown ausgeführt hat. (~20 Sekunden). |
| QuerySourceConditions | bool | Wird der Wert auf 1 gesetzt, werden die Conditions der Server Items vom Server aktualisiert. |
| DeleteServer | bool | Wird der Wert auf 1 gesetzt, wird der Server-Datenpunkt gelöscht. |
| newSourceIdentFromServer | dyn_string | Macht der Server eine Notifikation von einem Item, das nicht in der Subscription angemeldet ist, wird dieses Item hier eingetragen. |
| RefreshState | uint | Zeigt an, ob gerade ein Refresh durchgeführt wird (1) oder nicht (0). |
Die Elemente des Datenpunkttyps _OPCAEEventSubscription sind in der folgenden Tabelle angeführt.
_OPCAEEventSubscription
Tabelle: Datenpunktelemente von _OPCAEEventSubscription
| Datenpunktelement | Typ | Beschreibung |
|---|---|---|
| OPCAEServer | string | Name des Server-Datenpunktes, zu dem die Subscription gehört. |
| FilterEventType | int | Definiert die Event Typen für die Subscription. |
| FilterCategories | dyn_string | Definiert die Event Categories für die Subscription. |
| FilterLowSeverity | int | Definiert die untere Prioritätsgrenze für die Subscription. |
| FilterHighSeverity | int | Definiert die obere Prioritätsgrenze für die Subscription. |
| FilterSources | dyn_string | Definiert die Server Items für die Subscription. |
| Refresh | bool | Wird dieser Wert auf 1 gesetzt, wird ein Refresh auf die Event Subscription ausgeführt. |
| Active | bool | Wird dieser Wert auf 1 gesetzt, ist die Subscription aktiv, d.h. der Server schickt Events für diese Subscription. |
| BufferTimeReq | int | Zeit, die der Server buffern soll, bevor er neue Events an den Client schickt. 0 bedeutet, der Server buffert gar nicht und schickt Änderungen sofort. |
| BufferTimeAct | int | Zeit, die der Server tatsächlich buffern kann, bevor er neue Events an den Client schickt. Der Wert kann vom User nicht gesetzt werden. |
| MaxSizeReq | int | Maximale Anzahl von Events, die ein Callback vom Server enthalten soll. Der Server buffert so lange, bis diese Anzahl erreicht ist. Ist vorher die zuvor eingestellte Bufferzeit vergangen, schickt der Server Daten, auch wenn die maximale Anzahl von Events noch nicht erreicht ist. 0 bedeutet, der Server buffert gar nicht und schickt Änderungen sofort. |
| MaxSizeAct | int | Maximale Anzahl von Events, die ein Callback vom Server tatsächlich enthalten kann. Der Wert kann vom User nicht gesetzt werden. |
| Items | dyn_string | Definiert die WinCC OA DPEs für die Subscription. Das sind die DPEs, auf denen die Server-Events abgebildet werden. |
| returnedAttributes | dyn_int | Wird nicht benutzt. |
