IOF_GetDeviceName
Der Funktionsbaustein IOF_GetDeviceName liest die Gerätebezeichnung eines IO-Gerätes. Die Gerätebezeichnung kann während der Konfiguration in TwinCAT-System vom Benutzer festgelegt werden. Beim Systemstart wird diese dann als String in den IO-Treiber gesendet und kann über die ADS-Kommandos gelesen werden. Über die Eingangsvariable DEVICEID wird das IO-Gerät spezifiziert, dessen Gerätebezeichnung gelesen werden soll.
Eingänge
VAR_INPUT
NETID : T_AmsNetId;
DEVICEID : UDINT;
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 das ADS-Kommando ausgeführt werden soll. Für den lokalen Rechner kann auch ein Leerstring angegeben werden. |
DEVICEID | UDINT | Über die DeviceId (Geräte-ID) wird das IO-Gerät spezifiziert, auf dem die Funktion ausgeführt werden soll. Die Geräte-IDs werden während der Hardware-Konfiguration von TwinCAT-System festgelegt. |
START | BOOL | Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert. |
TMOUT | TIME | Gibt die Timeout-Zeit an, die bei der Ausführung des Kommandos nicht überschritten werden darf. |
Ausgänge
VAR_OUTPUT
BUSY : BOOL;
ERR : BOOL;
ERRID : UDINT;
DEVICENAME : T_MaxString;
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 | UDINT | Liefert bei einem gesetzten ERR-Ausgang die ADS-Fehlernummer. |
DEVICENAME | T_MaxString | Die Geräte-Bezeichnung eines IO-Gerätes als String. |
Voraussetzungen
Entwicklungsumgebung |
Zielplattform |
IO Hardware |
Einzubindende SPS-Bibliotheken (Kategoriegruppe) |
---|---|---|---|
TwinCAT v3.1.0 |
PC oder CX (x86, x64, ARM) |
Alle IO-Geräte |
Tc2_IoFunctions (IO) |