NETLOAD_LIMITER_STATISTIC

Typ	Funktionsbaustein
Beschreibung	Ermöglicht das Abrufen oder den Reset von Netload-Limiter-Statistiken einer oder mehrerer Netzwerkschnittstellen.
Hinweise	Funktionsbausteine müssen instanziiert werden. Der FB-Instanzname muss in der 'Variablen'-Tabelle der POE deklariert werden, in welcher der FB verwendet werden soll. Der Instanzname muss innerhalb der POE eindeutig sein.
Parameter	Eingänge REQ Datentyp: BOOL Beschreibung: Bei einer steigenden Flanke am Eingang REQ wird die Netload-Limiter-Statistik für die Schnittstelle mit der ID NETWORK_INTERFACE_ID abgerufen. Wenn der Vorgang abgeschlossen ist und die Ausgänge DONE oder ERROR TRUE sind, muss REQ auf FALSE gesetzt werden, um die Daten erneut abzurufen oder zurückzusetzen. Hinweis Wenn REQ und RESET gleichzeitig TRUE sind, wird kein Request bzw. Reset gestartet. Das bedeutet auch, dass nach der Ausführung eines Requests die Ausgänge REQ und RESET FALSE sein müssen, um Daten erneut abzurufen bzw. zurückzusetzen. RESET Datentyp: BOOL Beschreibung: Bei einer steigenden Flanke am Eingang RESET wird die Netload-Limiter-Statistik für die Schnittstelle mit der ID NETWORK_INTERFACE_ID zurückgesetzt. Wenn der Vorgang abgeschlossen ist und die Ausgänge DONE oder ERROR TRUE sind, muss RESET auf FALSE gesetzt werden, um die Daten erneut abzurufen oder zurückzusetzen. Mit NETWORK_INTERFACE_ID = 0 werden die Netload-Limiter-Statistiken aller Netzwerkschnittstellen zurückgesetzt. Hinweis Wenn REQ und RESET gleichzeitig TRUE sind, wird kein Request bzw. Reset gestartet. Das bedeutet auch, dass nach der Ausführung eines Resets die Ausgänge REQ und RESET FALSE sein müssen, um Daten erneut abzurufen bzw. zurückzusetzen. NETWORK_INTERFACE_ID Datentyp: BYTE Beschreibung: ID der Netzwerkschnittstelle, für die Statistiken abgerufen bzw. zurückgesetzt werden. Die erste Netzwerkschnittstelle besitzt die ID 1. Ausgänge DONE Datentyp: BOOL Beschreibung: TRUE: Der Vorgang wurde erfolgreich ohne Fehler abgeschlossen. DONE bleibt TRUE bis an den Eingängen REQ oder RESET eine fallende Flanke erkannt wird. BUSY Datentyp: BOOL Beschreibung: TRUE: Der Funktionsbaustein fürht die Operation aus. ERROR bleibt TRUE bis an den Eingängen REQ oder RESET eine fallende Flanke erkannt wird. ERROR Datentyp: BOOL Beschreibung: Bei einem Fehler wird der Ausgang ERROR auf TRUE gesetzt. Solange ERROR = TRUE ist, liefert der STATUS-Ausgang Informationen zur Fehlerursache. Die STATUS-Ausgang wird bei einer fallenden Flanke an den Eingängen REQ oder RESET auf FALSE zurückgesetzt. Die Beschreibung der möglichen Fehlercodes finden Sie am Ende dieses Themas. STATUS Datentyp: DWORD Beschreibung: Im Fehlerfall (ERROR = TRUE) wird der Fehlercode angezeigt. Die Beschreibung der möglichen Fehlercodes finden Sie am Ende dieses Themas. STATISTIC_RESULT Datentyp: NETLOAD_LIMITER_STATISTIC_RESULT Beschreibung: Wenn REQ und DONE TRUE sind, enthält STATISTIC_RESULT die Network-Limiter-Statistik der Netzwerkschnittstelle mit der ID NETWORK_INTERFACE_ID. Elemente der Struktur NETLOAD_LIMITER_STATISTIC_RESULT Strukturelement Datentyp Beschreibung NETWORK_INTERFACE_ID BYTE Enthält die ID der Netzwerkschnittstelle. PACKET_LIMITER LIMITER_STATISTIC Enthält die Statistik des Packet Limiter. Die Einheit der Elemente MOVING_AVERAGE, MOVING_AVERAGE_MAX und PEAK ist 'Pakete pro ms'. BYTE_LIMITER LIMITER_STATISTIC Enthält die Statistik des Byte Limiter. Die Einheit der Elemente MOVING_AVERAGE, MOVING_AVERAGE_MAX und PEAK ist 'Byte pro ms'. DURATION_SINCE_LAST_RESET ULINT Enthält die Zeit (in μs) seit dem letzten Reset der Statistik. Elemente der Struktur LIMITER_STATISTIC Strukturelement Datentyp Beschreibung MOVING_AVERAGE UDINT Moving Average (über 1 s). Die Einheit hängt vom Limiter ab (Pakete/Byte pro Millisekunden). MOVING_AVERAGE_MAX UDINT Max. Wert von MOVING_AVERAGE. Die Einheit hängt vom Limiter ab (Pakete/Byte pro Millisekunden). PEAK UDINT Höchster Wert. Die Einheit hängt vom Limiter ab (Pakete/Byte pro Millisekunden). LIMITING_DURATION ULINT Dauer (in μs) der Begrenzung durch den Limiter (akkumuliert). LIMITING_EVENT_COUNT UDINT Anzahl der Limiting-Ereignisse seit dem letzten Reset.
Fehlercodes	Fehlercodes am Ausgang STATUS Fehlercode Bedeutung 0 Kein Fehler aufgetreten. 1 Unbekannte Schnittstelle 2 Limit-Wert ist außerhalb des gültigen Bereichs. 3 Netzwerkschnittstelle unterstützt die Neload-Limiter-Funktion nicht. 4 Interner Fehler in Rsc Dienst aufgetreten. 5 Ungültige Eingänge: REQ und RESET können nicht gleichzeitig getriggert werden. 6 Interner Fehler im Funktionsbaustein aufgetreten.