Interne Datenpunkte des OPC HDA Clients

_OPCHDA

Für jeden OPC HDA Client muss ein Datenpunkt _OPCHDA<ManagerNumber> dieses Typs existieren.

Datenpunktelement Typ Beschreibung
Config.Servers dyn_string Liste der Datenpunkte vom Typ "_OPCHDAServer" zu denen der OPC HDA Client eine Verbindung aufbaut. Der OPC HDA Client erkennt Änderungen an diesem Datenpunktelement zur Laufzeit.

_OPCHDAServer

Für die Abbildung von Daten verwendet der OPC HDA Client diesen internen Datenpunkttyp. Für jeden OPC HDA Server zu dem sich der Client verbinden soll, muss ein Datenpunkt dieses Typs existieren.

Datenpunktelement Typ Beschreibung
Config.ConnInfo string Definiert die Server-URL im Format <hostname>/<COM object> über die der Server erreicht werden kann.
State.VendorInfo string Herstellerspezifische Informationen
State.MajorVersion uint Major Version Number
State.MinorVersion uint Minor Version Number
State.BuildNumber uint Build Number
State.StartTime time Zeitpunkt wann der Server das letzte Mal gestartet wurde.
State.ServerState uint Aktueller Serverstatus
State.MaxReturnValues uint Maximale Anzahl an Werten die der Server pro Item liefern kann. Der Wert 0 bedeutet, dass der Server kein Limit für die Anzahl der Werte vorgibt.
State.ServerStateText string Optionaler Statustext der vom Server geliefert werden kann
State.LastUpdateTime time Zeitpunkt des letzten Updates vom Serverstatus
Browse.GetBranch dyn_string

Über dieses Element wird eine Browse-Abfrage ausgelöst. Folgende Parameter müssen definiert werden:

Parameter Beschreibung
requestId Eindeutige Request-ID
startNode Startknoten, definiert ab welcher Position gebrowst werden soll. Für das Browsen der ersten Ebene muss hier ein Leerstring verwendet werden.
browseType

Definiert den Browse-Modus. Folgende Möglichkeiten stehen zur Verfügung:

Wert Beschreibung
1 Liefert alle Branches unterhalb des angegebenen Startknotens.
2 Liefert alle Leaves unterhalb des angegebenen Startknotens.
3 Liefert die gesamte Serverstruktur, d.h. alle Items mitsamt Pfad. In diesem Fall muss beim Parameter "startNode" ein Leerstring verwendet werden.
Browse.BranchNames dyn_string Das Browse-Ergebnis (Branch-Namen) wird auf diesem Element angezeigt.
Browse.BranchIds dyn_string Das Browse-Ergebnis (Branch-IDs) wird auf diesem Element angezeigt.
Command.HistoryRead dyn_string

Über dieses Element wird eine historische Abfrage gestartet. Folgende Parameter müssen definiert werden:

Parameter Beschreibung
requestId Eindeutige Request-ID
itemDescr Pfad bzw. Item das abgefragt wird
start Startzeit
end Endzeit
valueCount Anzahl der abgefragten Werte
withBounds Mit oder ohne Grenzwerten, nähere Informationen siehe "OPC HDA 1.20"-Spezifikation.
respDP Ergebnis-Datenpunkt

Hinweis

Mindestens zwei der Paramter start, end und valueCount müssen gesetzt werden, damit eine Abfrage durchgeführt wird.

_OPCHDAHistoryReadResponse

Das Ergebnis von historischen Abfragen wird auf Response-Datenpunkte dieses Typs geschrieben.

Datenpunktelement Typ Beschreibung
RequestId string Zur Identifikation zu welchem Request das Ergebnis gehört
Timestamps dyn_time Zeitstempel der abgefragten Werte
DataValues dyn_string Werte die vom OPC HDA Server abgefragt wurden
ValueStatusCodes dyn_bit32 Qualitätsinformationen der abgefragten Werte
ReturnCode int

Rückgabewert der Abfrage. Folgende Werte sind möglich:

Wert Beschreibung
0 Abfrage erfolgreich
-2 Keine Verbindung zum Server
-3 Probleme beim Anfordern eines Server-Handles
-4 Fehler beim Lesen der Daten
-5 Zu wenige Parameter wurden angegeben (von den Parametern Startzeit, Endzeit und Anzahl der Werte müssen mindestens 2 ausgewählt werden)
-6 Server liefert bei der Abfrage einen Fehler
DataType string

Datentyp des abgefragten Items. Folgende Datentypen werden unterstützt:

  • VT_BOOL

  • VT_I4

  • VT_UI4

  • VT_R8

  • VT_UI4

  • VT_DATE