Interne Datenpunkte des OPC UA-Clients

Definiert das Mapping von OPC UA Severities (Gewichtungen) auf WinCC OA-Alarmklassen.

Ein Mapping hat den folgenden Aufbau:

<OPC UA startSeverity1> <WinCC OA alertClass1>
<OPC UA startSeverity2> <WinCC OA alertClass2>
                                ...

Ein Beispiel für ein solches Mapping ist:

0 OPCUA_info
250 OPCUA_warning
500 OPCUA_alarm
1000 OPCUA_danger

D.h.:

• Wenn ein Alarm mit einer OPC UA Severity von 150 empfangen wird, gehört er der WinCC OA-Alarmklasse "OPCUA_info" an.
• Wenn ein Alarm mit einer OPC UA Severity von 499 empfangen wird, gehört er der WinCC OA-Alarmklasse "OPCUA_warning" an.
• Wenn ein Alarm mit einer OPC UA Severity von 500 empfangen wird, gehört er der WinCC OA-Alarmklasse "OPCUA_alarm" an
• Wenn ein Alarm mit einer OPC UA-Severity von 1000 (höchste OPC UA-Severity) empfangen wird, gehört er der WinCC OA-Alarmklasse "OPCUA_danger" an

Der Rückgabewert kann folgende Werte beinhalten:

• 0 - die angegebenen Abfrage-Parameter waren gültig und die Abfrage wurde an den Server übermittelt

• -1 - keine RequestId oder keine Verbindung zum Server

• -2 - Unbekannte Funktion

• -3 - Unbekannte Methode

• -4 - Keine treffende Peripherieadresse gefunden

Ergebniscodes der historischen Abfrage. Wurde eine Peripherieadressen-Wildcard definiert, enthält dieses Element eine Liste von Resultcodes für die entsprechenden Datenpunktelemente.

Folgende Werte sind möglich:

• 0 - Der OPC UA Server liefert für die historische Abfrage den Statuscode "Good" zurück

• -1 - Der OPC UA Server liefert für die historische Abfrage den Statuscode "Bad" oder "Uncertain" zurück

• -2 - Die Parameter der historischen Abfrage sind invalid, keine Abfrage wurde an den Server übermittelt

Der Datentyp der Variable, für die eine historische Abfrage ausgelöst wurde.

Dieses Element wird nur beschrieben, wenn "NodeId" oder "BrowsePath" als Methode definiert wurden.

Enthält die historischen Werte die für die Abfrage geliefert wurden.

Dieses Element wird nur beschrieben, wenn "NodeId" oder "BrowsePath" als Methode definiert wurden.

Enthält die Zeitstempel der Quelle in Lokalzeit.

Dieses Element wird nur beschrieben, wenn "NodeId" oder "BrowsePath" als Methode definiert wurden.

Enthält die Zeitstempel des Servers in Lokalzeit.

Dieses Element wird nur beschrieben, wenn "NodeId" oder "BrowsePath" als Methode definiert wurden.

Enthält die OPC UA Statuscodes der Werte, die durch die historische Abfrage übermittelt wurden.

Dieses Element wird nur beschrieben, wenn "NodeId" oder "BrowsePath" als Methode definiert wurden.

Spezifiziert die Server URL. Diese definiert, wie der OPC UA Server zu erreichen ist. Ein Beispiel für das Format ist:

opc.tcp://localhost:4841

Die jeweiligen Bits (0-basierende Zählung) erlauben zusätzliche Einstellungen für den OPC UA Client.

bit 3

Das Setzen des Bits (=1) verzögert die Erstellung von Subscriptions im Client, bis der Server den Zustand "Running" zurückgibt.

WARNUNG: Bitte stellen Sie sicher, dass der Server den Status "Running" unterstützt, sonst werden keine Subscriptions erstellt.

bit 8

Setzen des bits (=1) erlaubt es dem Client mit OPC UA-Servern zu kommunzieren, welche keine sichere Kommunikation unterstützen.

VORSICHT: Diese Einstellung sollte nur vorgenommen werden, wenn Ihre Anlage in einer sicheren Umgebung betrieben wird, da es zu einer Übertragung unverschlüsselter Passwörter zwischen Client und Server kommt.

bit 9

Setzen des Bits (=1) erlaubt es dem Client mit einem OPC UA-Server zu kommunizieren, welcher kein gültiges Zertifikat besitzt.

VORSICHT: Diese Einstellung sollte nur vorgenommen werden, wenn es nicht möglich ist ein gültiges Zertifikat für den Server bereitzustellen.

Enthält das Passwort für den Zugriff auf den Server. Das Passwort wird verschlüsselt dargestellt.

Folgende Sicherheitsstrategien sind hier möglich:

• None (0)

• Basic128Rsa15 (2)

• Basic256 (3)

• Basic256Sha256 (4)

• Aes128Sha256RsaOaep (5)

• Aes256Sha256RsaPss (6)

Folgende Nachrichtenmodi können konfiguriert werden:

• None (0)

• Sign (1)

• Sign&Encrypt (2)

Zertifikat, welches der Client für den Verbindungsaufbau zum Server verwenden soll (Beispiel: myCertificate.der).

Ist das Feld leer, so verwendet der Client "WinCC_OA_UA_Client.der".

Gibt das Mapping der OPC UA Status-Codes auf die WinCC OA Userbits an.

Das Mapping wird in einem dyn_string angegeben. Dieser dyn_string enthält Einträge der Form:

<UA status code><space><user bit number>

Wobei ein Userbit auf der rechten Seite mehrfach vorkommen kann.

Zum Beispiel:

0x00000000 1
0x80280000 2
0x80300000 2
2150891520 32

Über dieses Datenpunktelement können Statusfilter für eingehende Werte festgelegt werden. Das bedeutet, dass Werte die vom OPC UA Server je nach Status gefiltert und verworfen werden.

Es können verschiedene Statusfilter definiert werden.

Eine Subscription ist immer eindeutig einem Server zugeordnet. Einem Server dürfen mehrere Subscriptions zugewiesen werden. In diesem internen Datenpunktelement werden die zugehörigen Subscriptions im Format:

<systemName>:_<subscriptionName>

Definiert, welcher Zeitstempel bei Methode 3 (Schreiben der Daten einer historischen Abfrage auf das _archive-Config des entsprechenden Datenpunktelementes) verwendet werden soll.

• 0 (Default): Zeitstempel der Subscription des entsprechenden Datenpunktelementes. Ist keine Susbcription definiert, wird der Quellzeitstempel verwendet.

• 1: Zeitstempel der Subscription des entsprechenden Datenpunktelementes. Ist keine Susbcription definiert, wird der Serverzeitstempel verwendet.

Zeigt den Verbindungszustand zum Server an.

• Nicht verbunden (0)

• Verbunden (1)

• Fehler (5)

Format:

Enthält Informationen über Timeout-Fehler. Mögliche Werte sind:

• 0 - Kein Fehler
• 1 - Fehler während Read (nicht verwendet)
• 2 - Fehler während Write

Löst eine Generalabfrage auf dem Server aus.

Durch den angegebenen Wert, wird unterschieden, ob Werte, Alarme oder beides abgefragt wird:

• Werte und Alarme (0)

• nur Werte (1)

• nur Alarme (2)

Über dieses Element werden historische Abfragen ausgelöst. Folgende Parameter müssen hierfür gesetzt werden:

Hier wird die Server URL des redundanten Servers angegeben. Diese definiert, wie der OPC UA-Server zu erreichen ist. Ein Beispiel für das Format ist:

opc.tcp://localhost:4841

Definiert das Verhalten bei historischen Abfragen bei redundanten OPC UA-Servern. Folgende Werte können gesetzt werden:

• 0: Die HistoryRead-Anfrage wird nur an den ersten erreichbaren Server gesendet (Defaultverhalten, wenn eine Verbindung zu einem OPC UA-Server in WinCC OA parametriert wird).

• 1: Die HistoryRead-Anfrage wird an beide redundante Server übermittelt. Das Ergebnis der beiden Service-Requests wird zusammengeführt. Zum Zusammenführen der historischen Daten werden die Quellzeitstempel verwendet. Wenn der Server keine Quellzeitstempel zur Verfügung stellt, werden die Server-Zeitstempel vom Ergebnis der historischen Leseabfrage verwendet.

Definiert die Input Datenquelle innerhalb eines redundanten Serverpaars.

Die erlaubten Werte sind:

• 0 - Die Daten beider Server werden verwendet (Verhalten wie bisher)
• 1 - Nur die Daten von Server 1 werden verwendet
• 2 - Nur die Daten von Server 2 werden verwendet
• 3 - Die Daten des Servers mit der besseren Fehlergewichtung werden verwendet

Wenn ein Server explizit ausgewählt wurde, verwendet der Server die Daten des anderen Servers nicht, auch dann nicht, wenn die Verbindung zum ausgewählten Server verloren geht. In diesem Fall muss die Applikation manuell auf den anderen Server gewechselt werden.

Diese Option betrifft nur Input-Daten. Output Daten werden in jedem Fall auf beide Server geschrieben.

Zeigt den Verbindungsstatus zum redundanten Server an.

• nicht verbunden (0)

• verbunden (1)

Zeigt die Startzeit des redundanten Servers an. Format:

JJJJ.MM.TT HH:MM:SS:MMM

Enthält Informationen über Timeout-Fehler. Mögliche Werte sind:

• 0 - Kein Fehler
• 1 - Fehler während Read (derzeit nicht verwendet)
• 2 - Fehler während Write

Über dieses Datenpunktelement wird das Browsen ausgelöst. Gespeichert wird:

• Id - Id des Requests (wird vom UI vergeben, damit eine Antwort vom Client dem Request zugeordnet werden kann)
• StartNode ns=1;s=SYSTEM
• Level 0 (rekursiv), >0 (Anzahl der Ebenen nach unten)
• EventSource 1 nur EventSource Nodes; 0 alle Nodes

Über dieses Datenpunktelement wird das Browsen von Alarmtypen ausgelöst. Der dyn_string enthält nur die Id aus dem UI (siehe Browse.GetBranch).

Die Funktion entspricht Browse.GetBranch, allerdings wird als Startknoten immer ConditionType verwendet, es werden beliebig viele Ebenen nach unten durchlaufen und es werden nur Nodes zurückgegeben, die Alarmtypen repräsentieren.

Anzeige der Namen ab dem Startknoten. Getrennt werden die einzelnen Ebenen durch ein, im Serverdatenpunkt eingestelltes, Trennzeichen (Separator).

Zum Beispiel:

Folder?stringArray

Anzeige des kompletten Browse-Pfades in der definierten Schreibweise ab dem Node /0:Objects:

/1:AGENT/1:Objects/1:pUInt32

Anzeige jeder einzelnen NodeId pro gebrowsten Node in der definierten Schreibweise:

ns=1;s=AGENT.Objects.pUInt32

Anzeige jeder einzelnen Knotenklassen (NodeClass) pro gebrowsten Knoten (Node):

• OpcUa_NodeClass_Unspecified

• OpcUa_NodeClass_Object

• OpcUa_NodeClass_Variable

• OpcUa_NodeClass_Method

• OpcUa_NodeClass_ObjectType

• OpcUa_NodeClass_VariableType

• OpcUa_NodeClass_ReferenceType

• OpcUa_NodeClass_DataType

• OpcUa_NodeClass_View

Eine Bitmaske die angibt, ob der aktuelle Wert des Value-Attributes lesbar und schreibbar ist und ob die Historie des Wertes lesbar und schreibbar ist.

Definiert wie viele Meldungen ein Server maximal als Antwort auf einen Publish-Request schicken soll. Beim Übertragen von gepufferten Daten kann dadurch die Spitzenlast der Kommunikation reduziert werden.

Der Wert 0 bedeutet, dass der Client keine Grenze vorgibt und der Server die maximale Anzahl an Meldungen pro Publish verwendet.

Der Maximalwert ist abhängig vom Server und beträgt beim WinCC OA OPC UA-Server beispielsweise 65535.

Dieser Wert gibt an, mit welcher Priorität Notifikationen aus dieser Subscription vom Server verschickt werden.

Wertebereich: 0 - 255;

wobei 0 keine spezielle Priorität und 255 die höchste Priorität aufweist.

Definiert, ob es sich um eine Subscription auf:

• Daten (1)
• Ereignisse (2)
• Alarme & Zustände (3)
• undefiniert (0) - im Panel nicht auswählbar

handelt.

Gibt an, welcher Zeitstempel des Nodes verwendet werden soll.

In WinCC OA ergibt sich die entsprechende Verfügbarkeit aus:

• Quelle (0)
• Server (1)
• Reserviert (2)
• keinem (3) - OPC UA-Client vergibt Zeitstempel.

Definiert den Auslöser, auf den der Filter angewendet wird:

• Status (0)
• Status, Wert (1)
• Status, Wert, Zeitstempel (2)

Definiert den Totband-Typ für die Berechnung des Wertes:

• kein (0)
• absolut (1)
• prozent (2)

Interne Identifikationsnummer für jede Subscription. Diese ist pro Server eindeutig.

• 0 = invalid

Zurückgelieferter MaxKeepAliveCount.

• 0 = invalid

Zurückgeliefertes Publishing-Intervall in Millisekunden.

• 0 = invalid

Auslöser für die Generalabfrage pro Subscription. Diese wird unabhängig vom Wert ausgelöst.

Da eine Subscription nur für Werte oder Alarme verwendet wird, ist hier der übergebene Wert irrelevant.