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) |