IOF_GetBoxNameByAddr
Der Funktionsbaustein IOF_GetBoxNameByAddr ermittelt die Box-Bezeichnung anhand der Geräte-Id und der Feldbusadresse einer Box (Box = Slave, Modul, Station) . Ist eine Feldbusadresse nicht vorhanden, dann kann als Feldbusadresse an den Funktionsbaustein eine logische oder physikalische Adresse übergeben werden (bei Beckhoff Lightbus ist es z.B. die physikalische Boxnummer im Lichtwellenleiter-Ring). Beim Erfolg liefert der Funktionsbaustein die im TwinCAT konfigurierte Box-Bezeichnung als String zurück.
VAR_INPUT
VAR_INPUT
NETID : T_AmsNetId;
DEVICEID : UDINT;
BOXADDR : UINT;
START : BOOL;
TMOUT : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR
NETID: Hier kann die Netzwerkadresse des TwinCAT-Rechners angegeben werden, auf dem die Funktion ausgeführt werden soll (Typ: T_AmsNetID). Für den lokalen Rechner kann auch ein Leerstring angegeben werden.
DEVICEID: Über die DeviceId (Geräte-ID) wird das 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.
BOXADDR: Die Feldbusadresse der Box.
START: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
TMOUT: Gibt die Timeout-Zeit an, die bei der Ausführung des Kommandos nicht überschritten werden darf.
VAR_OUTPUT
VAR_OUTPUT
BUSY : BOOL;
ERR : BOOL;
ERRID : UDINT;
BOXNAME : T_MaxString;
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.
BOXNAME: Die Box-Bezeichnung als String (Typ: T_MaxString).
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) |