PLC_ReadSymInfoByNameEx

PLC_ReadSymInfoByNameEx 1:

Der Funktionsbaustein "PLC_ReadSymInfoByNameEx" hat eine ähnliche Funktionalität wie der Funktionsbaustein PLC_ReadSymInfoByName. Beide Funktionsbausteine können Symbolinformationen anhand des Symbolnamens auslesen. Der Unterschied bei diesen zwei Bausteinen besteht darin, dass der hier beschriebene Baustein bei einer Überschreitung der verfügbaren Puffergröße keinen Fehler meldet und die nicht ganz kompletten Informationen am Ausgang trotzdem ausgibt. In diesem Fall kann der Kommentar und/oder die Datentypbezeichnung abgeschnitten worden sein. Zwei zusätzliche Ausgangsvariablen zeigen dies an: OVTYPE und OVCOMMENT, so dass die Applikation darauf reagieren kann.

VAR_INPUT

VAR_INPUT
    NETID   : T_AmsNetId;
    PORT    : T_AmsPort;
    SYMNAME : T_MaxString;
    START   : BOOL;
    TMOUT   : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

NETID: Hier kann ein String mit der Netzwerkadresse des TwinCAT Rechners angegeben werden, auf dem Funktion ausgeführt werden soll (Typ: T_AmsNetID). Für den lokalen Rechner kann auch ein Leerstring angegeben werden.

PORT: Die Portnummer des SPS-Laufzeitsystems zu dem die Symbolvariable gehört (Typ: T_AmsPort).

SYMNAME: Der Symbolname der SPS-Variablen deren Informationen gelesen werden soll (Typ: T_MaxString, max. 255 Zeichen, inklusive des gesamten Pfades z.B. 'MAIN.INIT_TASK.VARINT' ).

START: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.

TMOUT: Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.

VAR_OUTPUT

VAR_OUTPUT
    BUSY      : BOOL;
    ERR       : BOOL;
    ERRID     : UDINT;
    SymInfo   : SYMINFOSTRUCT;
    OVTYPE    : BOOL;
    OVCOMMENT : BOOL;
END_VAR

BUSY: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.

ERR: Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der BUSY-Ausgang zurückgesetzt wurde.

ERRID: Liefert bei einem gesetzten ERR-Ausgang die ADS-Fehlernummer.

SymInfo: Struktur mit zusätzlichen Informationen zu der Symbolvariablen (Typ: SYMINFOSTRUCT).

OVTYPE: Zeigt an ob der String mit der Datentypbezeichnung einen Überlauf verursacht hat (TRUE). Der String mit der Datentypbezeichnung wurde möglicherweise abgeschnitten.

OVCOMMENT: Zeigt an ob der String mit dem Symbolkommentar einen Überlauf verursacht hat( TRUE). Der String mit dem Kommentar wurde möglicherweise abgeschnitten.

Beispiel:

Siehe in der Dokumentation des Funktionsbausteins: PLC_ReadSymInfoByName

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken (Kategoriegruppe)
TwinCAT v3.1.0	PC oder CX (x86, x64, ARM)	Tc2_Utilities (System)