IOF_GetBoxNameByAddr

IOF_GetBoxNameByAddr 1:

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 z. B. die physikalische Boxnummer im Lichtwellenleiter-Ring). Beim Erfolg liefert der Funktionsbaustein die im TwinCAT konfigurierte Box-Bezeichnung als String zurück.

IOF_GetBoxNameByAddr 2: Eingänge

VAR_INPUT
    NETID     : T_AmsNetId;
    DEVICEID  : UDINT;
    BOXADDR   : UINT;
    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.

BOXADDR

UINT

Die Feldbusadresse der Box.

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.

IOF_GetBoxNameByAddr 3: Ausgänge

VAR_OUTPUT
    BUSY    : BOOL;
    ERR     : BOOL;
    ERRID   : UDINT;
    BOXNAME : 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.

BOXNAME

T_MaxString

Die Box-Bezeichnung 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)