FB_EcGetAllMasters

Mit dem Funktionsbaustein FB_EcGetAllMasters können Informationen von allen EtherCAT Mastern ausgelesen werden. Bei erfolgreichem Aufruf enthält der im Parameter pAddrBuf übergebene Puffer die Informationen (Device ID, AMS Net ID, Name) aller Master als Array von ST_EcDeviceInfo.

Ist der Puffer zu klein für die Informationen aller vorhandenen Master, so wird der Puffer bis zur angegebenen Größe gefüllt und der Ausgang nMasters gibt die Gesamtanzahl aller vorhandenen Master aus.

Eingänge

VAR_INPUT
    sNetId   : T_AmsNetId;
    bExecute : BOOL; 
    pAddrBuf : POINTER TO ARRAY[0..EC_MAX_DEVICES] OF ST_EcDeviceInfo; 
    cbBufLen : UDINT 
    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) default = local host
bExecute	BOOL	Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.
pAddrBuf	POINTER TO ARRAY [0..EC_MAX_DEVICES] OF ST_EcDeviceInfo	Adresse eines Arrays von ST_EcDeviceInfo, in das die Infos der einzelnen Master geschrieben werden sollen. ST_EcDeviceInfo beinhaltet jeweils die Device ID, AMS Net ID und den Namen eines EtherCAT Masters.
cbBufLen	UDINT	Maximal verfügbare Puffergröße für die zu lesenden Daten in Bytes.
tTimeout	TIME	Maximale Zeit, die bei der Ausführung der ADS Aufrufe nicht überschritten werden darf.

Ausgänge

VAR_OUTPUT
    bBusy    : BOOL;
    bError   : BOOL;
    nErrId   : UDINT;
    nMasters : 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. Bsp.: Fehler 1798 (0x706) verweist auf einen Nullpointer an der Pufferadresse.
nMasters	UINT	Anzahl der an den Master angeschlossenen Slaves.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS- Bibliotheken
TwinCAT >= v3.1.4024.62	PC oder CX (x86, x64, Arm^®)	Tc2_EtherCAT >= v3.6.1.0