IOF_GetDeviceName

IOF_GetDeviceName 1:

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.

IOF_GetDeviceName 2: 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.

IOF_GetDeviceName 3: 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)