FB_EcGetMasterState

Mit dem Funktionsbaustein FB_EcGetMasterState kann der EtherCAT-Zustand des Masters ausgelesen werden. Bei erfolgreichem Aufruf enthält die Ausgangsvariable state vom Typ WORD die angeforderte Status-Information.

Eingänge

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

Name	Typ	Beschreibung
sNetId	T_AmsNetId	String, der die AMS-Netzwerkkennung des EtherCAT-Master-Gerätes enthält. (Typ: T_AmsNetId)
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;
    state  : WORD; 
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.
state	WORD	Aktueller EtherCAT-Zustand des Masters. (Siehe State)

state

Aktueller EtherCAT-Zustand des Masters. Die möglichen Werte sind:

Konstante	Wert	Beschreibung
EC_DEVICE_STATE_INIT	0x01	Master ist im Init-Zustand
EC_DEVICE_STATE_PREOP	0x02	Master ist im Pre-Operational-Zustand
EC_DEVICE_STATE_SAFEOP	0x04	Master ist im Safe-Operational-Zustand
EC_DEVICE_STATE_OP	0x08	Master ist im Operational -Zustand

Beispiel für eine Implementierung in ST:

PROGRAM TEST_GetMasterState
VAR
    fbGetMasterState : FB_EcGetMasterState;
    sNetId           : T_AmsNetId := '172.16.2.131.2.1';
    bExecute         : BOOL;
    state            : WORD;
    bError           : BOOL;
    nErrId           : UDINT;
END_VAR

fbGetMasterState(sNetId:= sNetId, bExecute:=bExecute);
state := fbGetMasterState.state;
bError := fbGetMasterState.bError;
nErrId := fbGetMasterState.nErrId;

Voraussetzungen

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