FB_EcGetAllSlaveStates
Mit dem Funktionsbaustein FB_EcGetAllSlaveStates kann der EtherCAT Status und der Link Status von allen an den Master angeschlossenen Slaves ausgelesen werden. Bei erfolgreichem Aufruf enthält der im Parameter pStateBuf übergebene Puffer die angeforderte Status-Information als Array von ST_EcSlaveState.
VAR_INPUT
VAR_INPUT
sNetId : T_AmsNetId;
pStateBuf : POINTER TO ARRAY[0..EC_MAX_SLAVES] OF ST_EcSlaveState;
cbBufLen : UDINT;
bExecute : BOOL;
tTimeout : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR
sNetId: Ist ein String, der die AMS-Netzwerkkennung des EtherCAT Master Gerätes enthält.
pStateBuf : Die Adresse eines ARRAY of ST_EcSlaveStates, in das die Slave-Stati geschrieben werden sollen.
cbBufLen: Die maximal verfügbare Puffergröße für die zu lesenden Daten in Bytes.
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;
nSlaves : UINT;
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
nSlaves: Anzahl der an den Master angeschlossenen Slaves.
Beispiel für eine Implementierung in ST:
PROGRAM TEST_GetAllSlaveStates
VAR
fbGetAllSlaveStates : FB_EcGetAllSlaveStates;
sNetId : T_AmsNetId := '172.16.2.131.2.1';
bExecute : BOOL;
devStates : ARRAY[0..255] OF ST_EcSlaveState;
nSlaves : UINT := 0;
bError : BOOL;
nErrId : UDINT;
END_VAR
fbGetAllSlaveStates(sNetId:= sNetId, pStateBuf := ADR(devStates), cbBufLen:=SIZEOF(devStates), bExecute:=bExecute);
nSlaves:=fbGetAllSlaveStates.nSlaves;
bError:=fbGetAllSlaveStates.bError;
nErrId:=fbGetAllSlaveStates.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) |