FB_EcGetAllSlaveStates

FB_EcGetAllSlaveStates 1:

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 vom Typ ST_EcSlaveState.

Eingänge

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

Name	Typ	Beschreibung
sNetId	T_AmsNetId	String, der die AMS-Netzwerkerkennung des EtherCAT-Master-Gerätes enthält. (Typ: T_AmsNetId)
pStateBuf	POINTER TO ARRAY[0..EC_MAX_SLAVES] OF ST_EcSlaveState	Adresse eines ARRAY of ST_EcSlaveStates, in das die Slave-Status geschrieben werden sollen.
cbBufLen	UDINT	Maximal verfügbare Puffergröße für die zu lesenden Daten in Bytes
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;
    nSlaves : UINT; 
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. Fehler 1798 (0x706) verweist auf einen Nullpointer an der Pufferadresse. Fehler 1797 (0x705) verweist auf einen zu kleinen Puffer.
nSlaves	UINT	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 v3.1.0	PC oder CX (x86, x64, Arm^®)	Tc2_EtherCAT