FB_EcGetAllSlaveAddr

FB_EcGetAllSlaveAddr 1:

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.

FB_EcGetAllSlaveAddr 2: 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.

FB_EcGetAllSlaveAddr 3: 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