FB_EcGetAllSlaveAddr
Mit dem Funktionsbaustein FB_EcGetAllSlaveAddr
können die Adressen von allen an den Master angeschlossenen Slaves ausgelesen werden. Bei erfolgreichem Aufruf enthält der im Parameter pAddrBuf übergebene Puffer die Adressen aller Slaves als Array von UINTs.
Eingänge
VAR_INPUT
sNetId : T_AmsNetId;
pAddrBuf : POINTER TO ARRAY[0..EC_MAX_SLAVES] OF UINT;
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) |
pAddrBuf | POINTER TO ARRAY [0..EC_MAX_SLAVES] OF UINT | Adresse eines Arrays von UINTs, in das die Adressen der einzelnen Slaves 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_GetAllSlaveAddresses
VAR
fbGetAllSlaveAddr : FB_EcGetAllSlaveAddr;
sNetId : T_AmsNetId := '172.16.2.131.2.1';
bExecute : BOOL;
slaveAddresses : ARRAY[0..255] OF UINT;
nSlaves : UINT := 0;
bError : BOOL;
nErrId : UDINT;
END_VAR
fbGetAllSlaveAddr(sNetId:= sNetId,pAddrBuf := ADR(slaveAddresses), cbBufLen:= SIZEOF(slaveAddresses), bExecute:=bExecute);
nSlaves := fbGetAllSlaveAddr.nSlaves;
bError := fbGetAllSlaveAddr.bError;
nErrId := fbGetAllSlaveAddr.nErrId;
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS- Bibliotheken |
---|---|---|
TwinCAT v3.1.0 | PC oder CX (x86, x64, Arm®) | Tc2_EtherCAT |