FB_EcGetExtSlaveState

Mit dem Funktionsbaustein FB_EcGetExtSlaveState kann der EtherCAT-Status, der erweiterte EtherCAT-Status und der Link-Status eines einzelnen EtherCAT-Slave-Gerätes ausgelesen werden. Bei erfolgreichem Aufruf enthält die Ausgangsvariable extState vom Typ ST_EcSlaveState die angeforderte Status-Information. Der Funktionsbaustein FB_EcGetExtSlaveState wird bei Verwendung des MX-Systems benötigt, um leere MX-Slots (ohne gestecktes MX-Modul) in der SPS erkennen zu können.

Eingänge

VAR_INPUT
    sNetId     : T_AmsNetId; 
    nSlaveAddr : UINT; 
    bExecute   : BOOL; 
    tTimeout   : TIME := DEFAULT_ADS_TIMEOUT; 
END_VAR

Name	Typ	Beschreibung
sNetId	T_AmsNetId	String, der die AMS-Netzwerkerkennung des EtherCAT-Master-Gerätes enthält.
nSlaveAddr	UINT	Feste Adresse des EtherCAT-Slaves, dessen Status ausgelesen werden soll.
bExecute	BOOL	Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
tTimeout	TIME	Maximale Zeit, die bei der Ausführung des Funktionsbausteins nicht überschritten werden darf.

Ausgänge

VAR_OUTPUT
    bBusy    : BOOL;
    bError   : BOOL;
    nErrId   : UDINT;
    extState : ST_EcExtendedSlaveState;
END_VAR

Name	Typ	Beschreibung
bBusy	BOOL	Dieser Ausgang wird bei der Aktivierung des Funktionsbausteins gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
bError	BOOL	Dieser Ausgang wird gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde, wenn bei der Übertragung des Kommandos ein Fehler auftritt.
nErrId	UDINT	Liefert bei einem gesetzten bError-Ausgang den ADS-Fehlercode des zuletzt ausgeführten Befehls.
extState	ST_EcExtendedSlaveState	Struktur, die den erweiterten EtherCAT-Status und den Link-Status des Slaves enthält. (Typ: ST_EcExtendedSlaveState)

Beispiel für eine Implementierung in ST:

PROGRAM TEST_GetExtSlaveState
VAR
    fbGetExtSlaveState : FB_EcGetExtSlaveState;
    sNetId             : T_AmsNetId := '172.16.2.131.2.1';
    bExecute           : BOOL;
    extState           : ST_EcExtendedSlaveState;
    nSlaveAddr         : UINT := 1001;
    bError             : BOOL;
    nErrId             : UDINT;
END_VAR

fbGetExtSlaveState(sNetId:= sNetId, nSlaveAddr:= nSlaveAddr, bExecute:=bExecute);
extState := fbGetExtSlaveState.extState;
bError   := fbGetExtSlaveState.bError;
nErrId   := fbGetExtSlaveState.nErrId;

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS- Bibliotheken
TwinCAT v3.1.4026.26	PC oder CX (x86, x64, Arm^®)	Tc2_EtherCAT >= 3.8.1.0