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 es 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_VARNETID: Hier kann die AmsNetId des TwinCAT Rechners angegeben werden, auf dem Funktion ausgeführt werden soll. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.
PORT: Die Portnummer des SPS-Laufzeitsystems zu dem die Symbolvariable gehört. Das erste SPS-Laufzeitsystem besitzt die Portnummer 801.
SYMNAME: Der Symbolname der SPS-Variablen deren Informationen gelesen werden soll (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;(* TRUE => Type name string length overflow, FALSE => no overflow *)
OVCOMMENT : BOOL;(* TRUE => Comment string length overflow, FALSE => no overflow *)
END_VARBUSY: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
ERR: Sollte ein ADS-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.
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 für einen Aufruf in FUP
Siehe in der Dokumentation des Funktionsbausteins: PLC_ReadSymInfoByName
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS-Bibliotheken |
|---|---|---|
TwinCAT v2.11.0 Build > 1550 | PC or CX (x86) | TcUtilities.Lib |