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