PLC_ReadSymInfoByNameEx

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.

Eingänge

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

Name	Typ	Beschreibung
NETID	T_AmsNetID	Hier kann die Netzwerkadresse des TwinCAT-Rechners angegeben werden, auf dem Funktion ausgeführt werden soll. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.
PORT	T_AmsPort	Die Portnummer des SPS-Laufzeitsystems zu dem die Symbolvariable gehört.
SYMNAME	T_MaxString	Der Symbolname der SPS-Variablen deren Informationen gelesen werden sollen (max. 255 Zeichen, inklusive des gesamten Pfades z. B. 'MAIN.INIT_TASK.VARINT' ).
START	BOOL	Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
TMOUT	TIME	Timeout-Zeit, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.

Ausgänge

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

Name	Typ	Beschreibung
BUSY	BOOL	Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
ERR	BOOL	Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der BUSY-Ausgang zurückgesetzt wurde.
ERRID	ADS-Fehlernummer	Liefert bei einem gesetzten ERR-Ausgang den Fehlercode.
SymInfo	SYMINFOSTRUCT	Struktur mit zusätzlichen Informationen zu der Symbolvariablen.
OVTYPE	BOOL	Zeigt an, ob der String mit der Datentypbezeichnung einen Überlauf verursacht hat (TRUE). Der String mit der Datentypbezeichnung wurde möglicherweise abgeschnitten.
OVCOMMENT	BOOL	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)