UA_ReadList

Dieser Funktionsbaustein liest Werte aus mehreren gegebenen Knoten- und Verbindungshandles.

Eingänge

VAR_INPUT
    Execute          : BOOL;
    ConnectionHdl    : DWORD;
    NodeHdlCount     : UINT;
    NodeHdls         : ARRAY[1..nMaxNodeIDsInList] OF DWORD;
    stNodeAddInfo    : ARRAY[1..nMaxNodeIDsInList] OF ST_UANodeAdditionalInfo;
    pVariable        : PVOID;
    cbData           : ARRAY[1..nMaxNodeIDsInList] UDINT;
    cbDataTotal      : UDINT;
    Timeout          : TIME := DEFAULT_ADS_TIMEOUT;    
END_VAR

Name	Typ	Beschreibung
Execute	BOOL	Der Befehl wird durch eine steigende Flanke an diesem Eingang ausgelöst.
ConnectionHdl	DWORD	Verbindungshandle, das vorher vom Funktionsbaustein UA_Connect ausgegeben wurde.
NodeHdlCount	UINT	Anzahl Knotenhandles, die in der Eingangsvariablen NodeHdls gespeichert sind.
NodeHdls	ARRAY	Array von Knotenhandles, die vorher vom Funktionsbaustein UA_NodeGetHandle oder UA_NodeGetHandleList erhalten wurden.
stNodeAddInfo	ARRAY	Definiert zusätzliche Informationen, z. B. welches Attribut aus dem UA‑Namensraum gelesen (Standard: 'Value'-Attribut) oder welcher IndexRange verwendet werden soll. Wird durch STRUCT ST_UANodeAdditionalInfo spezifiziert.
pVariable	PVOID	Zeiger auf Datenspeicher, wo die gelesenen Daten abgespeichert werden sollen.
cbData	ARRAY	Bestimmt die Größe der zu lesenden Daten.
cbDataTotal	UDINT	Gesamtgröße der zu empfangenden Daten.
Timeout	TIME	Zeit bis zum Abbruch der Funktion. DEFAULT_ADS_TIMEOUT ist eine globale Konstante, gesetzt auf 5 Sekunden.

Ausgänge

VAR_OUTPUT
    Done      : BOOL;
    Busy      : BOOL;
    Error     : BOOL;
    ErrorID   : UDINT;
    cbData_R  : UDINT;
END_VAR

Name	Typ	Beschreibung
Done	BOOL	Schaltet auf TRUE, wenn der Funktionsbaustein erfolgreich ausgeführt wurde.
Busy	BOOL	TRUE, bis der Baustein einen Befehl ausführt hat, maximal für die Dauer des „Timeout“ am Eingang. Solange Busy = TRUE ist, akzeptieren die Eingänge keinen neuen Befehl. Es wird nicht die Zeit der Verbindung sondern die Empfangszeit überwacht.
Error	BOOL	Schaltet auf TRUE, wenn bei der Ausführung eines Befehls ein Fehler auftritt. Der befehlsspezifische Fehlercode steht in nErrID.
ErrorID	UDINT	Enthält den befehlsspezifischen ADS‑Fehlercode des zuletzt ausgeführten Befehls.
cbData_R	UDINT	Anzahl der gelesenen Bytes.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken
TwinCAT 3.1	Win32, Win64, CE-X86, CE-Arm®	Tc3_PLCopen_OpcUa