FB_EcMasterFrameStatistic

FB_EcMasterFrameStatistic 1:

Mit dem Funktionsbaustein FB_EcMasterFrameStatistic kann die Frame-Statistik des EtherCAT-Masters ausgelesen werden. Es wird zwischen zyklischen und azyklischen (queued) Frames unterschieden. Azyklische Frames werden z.B. für die Initialisierung oder für Parameterzugriffe auf EtherCAT-Slaves verwendet. Frames gelten dann als verloren, wenn sie nicht zum Master zurückkommen oder wenn sie ungültig sind.
Die Anzahl der "Lost Frames" (die verloren gegangenen oder ungültigen zyklischen Frames), die Anzahl der zykischen Frames pro Sekunde, die Anzahl der "Lost Queued Frames" (die verloren gegangenen oder ungültigen azyklischen Frames) und die Anzahl der "Queued Frames" pro Sekunde werden am Ausgang des Bausteins zur Verfügung gestellt.

FB_EcMasterFrameStatistic 2: Eingänge

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

Name

Typ

Beschreibung

sNetId

T_AmsNetId

String, der die AMS-Netzwerkkennung des EtherCAT-Master-Gerätes enthält. (Typ: T_AmsNetId)

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_EcMasterFrameStatistic 3: Ausgänge

VAR_OUTPUT
    bBusy                  : BOOL;
    bError                 : BOOL;
    nErrId                 : UDINT;
    nLostFrames            : UDINT;
    fFramesPerSecond       : LREAL;
    nLostQueuedFrames      : UDINT;
    fQueuedFramesPerSecond : LREAL;
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.

nLostFrames

UDINT

Liefert die momentane Anzahl der verloren gegangenen bzw. ungültigen zyklischen Frames.

fFramesPer
Second

LREAL

Liefert die momentane Anzahl der zyklischen Frames pro Sekunde.

nLostQueuedFrames

UDINT

Liefert die momentane Anzahl der verloren gegangenen bzw. ungültigen Queued (azyklischen) Frames.

fQueuedFramesPerSecond

LREAL

Liefert die momentane Anzahl der Queued (azyklischen) Frames pro Sekunde.

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS- Bibliotheken

TwinCAT v3.1.0

PC oder CX (x86, x64, Arm®)

Tc2_EtherCAT