FB_EcGetMasterState

FB_EcGetMasterState 1:

Mit dem Funktionsbaustein FB_EcGetMasterState kann der EtherCAT Zustand des Master ausgelesen werden. Bei erfolgreichem Aufruf enthält die Ausgangsvariable state vom Typ WORD die angeforderte Status-Information.        

VAR_INPUT

VAR_INPUT
    sNetId      : T_AmsNetId;
    bExecute    : BOOL; 
    tTimeout    : TIME := DEFAULT_ADS_TIMEOUT; 
END_VAR

sNetId: Ist ein String, der die AMS-Netzwerkkennung des EtherCAT Master Gerätes enthält.

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;
    state       : WORD; 
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

state: Aktueller EtherCAT Zustand des Masters.  Die möglichen Werte sind:
 

Konstante

Wert

Beschreibung

EC_DEVICE_STATE_INIT

0x01

Master ist im Init-Zustand

EC_DEVICE_STATE_PREOP

0x02

Master ist im Pre-Operational Zustand

EC_DEVICE_STATE_SAFEOP

0x04

Master ist im Safe-Operational Zustand

EC_DEVICE_STATE_OP

0x08

Master ist im Operational Zustand

Beispiel für eine Implementierung in ST: 

PROGRAM TEST_GetMasterState
VAR
    fbGetMasterState  : FB_EcGetMasterState;
    sNetId            : T_AmsNetId := '172.16.2.131.2.1';
    bExecute          : BOOL;
    state             : WORD;
    bError            : BOOL;
    nErrId            : UDINT;
END_VAR
fbGetMasterState(sNetId:= sNetId, bExecute:=bExecute);
state:=fbGetMasterState.state;
bError:=fbGetMasterState.bError;
nErrId:=fbGetMasterState.nErrId;

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS Bibliotheken

TwinCAT v2.10.0 oder höher

PC or CX (x86)

TcEtherCAT.Lib
( Standard.Lib; TcBase.Lib; TcSystem.Lib, TcUtilities.Lib werden automatisch eingebunden )

TwinCAT v2.10.0 Build >= 1301 oder höher

CX (ARM)