FB_EcGetMasterState

Mit dem Funktionsbaustein FB_EcGetMasterState kann der EtherCAT Zustand des Master ausgelesen werden. Bei erfolgreichem Aufruf enthält die Ausgangsvariable state vom Typ WORD die angeforderte Status-Information.
VAR_INPUT
VAR_INPUT
sNetId : T_AmsNetId;
bExecute : BOOL;
tTimeout : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR
sNetId: Ist ein String, der die AMS-Netzwerkkennung des EtherCAT Master Gerätes enthält.
bExecute: Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
tTimeout: Maximale Zeit, die bei der Ausführung des Funktionsbausteins nicht überschritten werden darf.
VAR_OUTPUT
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrId : UDINT;
state : WORD;
END_VAR
bBusy: Dieser Ausgang wird bei der Aktivierung des Funktionsbausteins gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
bError: Dieser Ausgang wird, nachdem der bBusy-Ausgang zurückgesetzt wurde, gesetzt, sollte ein Fehler bei der Übertragung des Kommandos erfolgen.
nErrId: Liefert bei einem gesetzten bError-Ausgang den ADS-Fehlercode des zuletzt ausgeführten Befehles
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 v2.10.0 oder höher  | PC or CX (x86)  | TcEtherCAT.Lib  | 
TwinCAT v2.10.0 Build >= 1301 oder höher  | CX (ARM)  |