WAGO-Software CODESYS-Bibliothek WagoLibCpuUsage.lib zur Ermittlung der CPU-Auslastung. Bibliotheksbeschreibung. Version 1.0.0

Transkript

1 Pos : 3 /Alle Serien (Allgemeine M odul e)/hinweise z ur Dokumentation/Impres sum für Standardhandbüc her - allg. Angaben, Ansc hriften, Tel efonnummer n und -Adres @ 1 Pos : 2 /D okumentati on allgemein/ei nbandeinband H andbuc h - Dec kbl att mi t Standar dbil d für @ 1 WAGO-Software CODESYS-Bibliothek WagoLibCpuUsage.lib zur Ermittlung der CPU-Auslastung

2 === Ende der Liste für T extmar ke Ei nband_vorne === 2 WAGO-Software 2013 by WAGO Kontakttechnik GmbH & Co. KG Alle Rechte vorbehalten. WAGO Kontakttechnik GmbH & Co. KG Hansastraße 27 D Minden Tel.: +49 (0) 571/ Fax: +49 (0) 571/ Web: info@wago.com Technischer Support Tel.: +49 (0) 571/ Fax: +49 (0) 571/ support@wago.com Es wurden alle erdenklichen Maßnahmen getroffen, um die Richtigkeit und Vollständigkeit der vorliegenden Dokumentation zu gewährleisten. Da sich Fehler, trotz aller Sorgfalt, nie vollständig vermeiden lassen, sind wir für Hinweise und Anregungen jederzeit dankbar. documentation@wago.com Wir weisen darauf hin, dass die im Handbuch verwendeten Soft- und Hardware- Bezeichnungen und Markennamen der jeweiligen Firmen im Allgemeinen einem Warenzeichenschutz, Markenzeichenschutz oder patentrechtlichem Schutz unterliegen.

3 === Ende der Liste für T extmar ke Verzeic hnis_vor ne === WAGO-Software Inhaltsverzeichnis 3 Pos : 5 /D okumentati on allgemein/verzeic hnisse/inhalts verz eichnis - Ü berschrift og und Verzei @ 1 Inhaltsverzeichnis 1 Hinweise zu dieser Dokumentation Urheberschutz Symbole Darstellung der Zahlensysteme Schriftkonventionen WagoLibCpuUsage.lib CPU_Usage... 8 Tabellenverzeichnis... 10

4 Pos : 8.2 /D okumentati on allgemein/gliederungsel emente/---seitenwec @ 1 4 Hinweise zu dieser Dokumentation WAGO-Software Pos : 7 /Alle Serien (Allgemeine M odul e)/übersc hriften für all e Serien/Hinweis zur Dokumentation/Hinweise zur Dokumentation - Ü bersc hrift Hinweise zu dieser Dokumentation Pos : 8.1 /Alle Serien (Allgemeine M odule) /Hinweise z ur Dokumentation/Urhebersc hutz ausführlic Urheberschutz Diese Dokumentation, einschließlich aller darin befindlichen Abbildungen, ist urheberrechtlich geschützt. Jede Weiterverwendung dieser Dokumentation, die von den urheberrechtlichen Bestimmungen abweicht, ist nicht gestattet. Die Reproduktion, Übersetzung in andere Sprachen sowie die elektronische und fototechnische Archivierung und Veränderung bedarf der schriftlichen Genehmigung der WAGO Kontakttechnik GmbH & Co. KG, Minden. Zuwiderhandlungen ziehen einen Schadenersatzanspruch nach sich.

5 Pos : /Alle Serien (Allgemeine M odule) /Wic htige Erl äuter ung en/sic her hei ts- und s onstige Hi nweise/gefahr/gefahr: _Warnung vor Pers onensc häden allgemein_ - @ 1 Pos : /Alle Serien (Allgemeine M odule) /Wic htige Erl äuter ung en/sic her hei ts- und s onstige Hi nweise/gefahr/gefahr: _Warnung vor Pers onensc häden durch elektrischen Strom_ - Erl äuter @ 1 Pos : /Alle Serien (Allgemeine M odule) /Wic htige Erl äuter ung en/sic her hei ts- und s onstige Hi nweise/warnung/war nung: _War nung vor Personenschäden allgemei n_ - Erl äuter @ 1 Pos : /Alle Serien (Allgemeine M odule) /Wic htige Erl äuter ung en/sic her hei ts- und s onstige Hi nweise/vorsicht/vorsic ht: _Warnung vor Pers onensc häden allgemein_ - @ 1 Pos : /Alle Serien (Allgemeine M odule) /Wic htige Erl äuter ung en/sic her hei ts- und s onstige Hi nweise/ac htung/ac htung: _Warnung vor Sachs chäden allgemei n_ - Erl äuter @ 1 Pos : /Alle Serien (Allgemeine M odule) /Wic htige Erl äuter ung en/sic her hei ts- und s onstige Hi nweise/ac htung/ac htung: _Warnung vor Sachs chäden durc h elektros tatisc he Aufladung _ - Erläuter @ 1 Pos : /Alle Serien (Allgemeine M odule) /Wic htige Erl äuter ung en/sic her hei ts- und sonstige Hi nweise/hinweis/hinweis: _Wichtiger Hi nweis allgemei n_ - Er äuter @ 1 Pos : /Alle Serien (Allgemeine M odule) /Wic htige Erl äuter ung en/sic her hei ts- und s onstige Hi nweise/infor mati on/infor mati on: _Weitere Infor mati on allgemein_ - @ 1 Pos : 8.5 /Dokumentation allgemein/gliederungselemente/---seitenwec @ 1 WAGO-Software Hinweise zu dieser Dokumentation 5 Pos : 8.3 /Alle Serien (Allgemeine M odule) /Übersc hriften für alle Serien/Hi nweis zur Dokumentation/Symbole - Übersc hrift Symbole GEFAHR GEFAHR Warnung vor Personenschäden! Kennzeichnet eine unmittelbare Gefährdung mit hohem Risiko, die Tod oder schwere Körperverletzung zur Folge haben wird, wenn sie nicht vermieden wird. Warnung vor Personenschäden durch elektrischen Strom! Kennzeichnet eine unmittelbare Gefährdung mit hohem Risiko, die Tod oder schwere Körperverletzung zur Folge haben wird, wenn sie nicht vermieden wird. WARNUNG Warnung vor Personenschäden! Kennzeichnet eine mögliche Gefährdung mit mittlerem Risiko, die Tod oder (schwere) Körperverletzung zur Folge haben kann, wenn sie nicht vermieden wird. VORSICHT Warnung vor Personenschäden! Kennzeichnet eine mögliche Gefährdung mit geringem Risiko, die leichte oder mittlere Körperverletzung zur Folge haben könnte, wenn sie nicht vermieden wird. ACHTUNG ESD Hinweis Information Warnung vor Sachschäden! Kennzeichnet eine mögliche Gefährdung, die Sachschaden zur Folge haben könnte, wenn sie nicht vermieden wird. Warnung vor Sachschäden durch elektrostatische Aufladung! Kennzeichnet eine mögliche Gefährdung, die Sachschaden zur Folge haben könnte, wenn sie nicht vermieden wird. Wichtiger Hinweis! Kennzeichnet eine mögliche Fehlfunktion, die aber keinen Sachschaden zur Folge hat, wenn sie nicht vermieden wird. Weitere Information Weist auf weitere Informationen hin, die kein wesentlicher Bestandteil dieser Dokumentation sind (z. B. Internet).

6 Pos: 9 /Dokumentation allgemein/gliederungselemente/---seitenwec @ 1 6 Hinweise zu dieser Dokumentation WAGO-Software Pos : 8.6 /Alle Serien (Allgemeine M odule) /Hinweise z ur Dokumentation/Z ahl ens Darstellung der Zahlensysteme Tabelle 1: Darstellungen der Zahlensysteme Zahlensystem Beispiel Bemerkung Dezimal 100 Normale Schreibweise Hexadezimal 0x64 C-Notation Binär '100' ' ' In Hochkomma, Nibble durch Punkt getrennt Pos : 8.7 /Alle Serien (Allgemeine Module)/Hinweise zur Schriftkonventionen Tabelle 2: Schriftkonventionen Schriftart Bedeutung kursiv Namen von Pfaden und Dateien werden kursiv dargestellt z. B.: C:\Programme\WAGO-I/O-CHECK Menü Menüpunkte werden fett dargestellt z. B.: Speichern > Ein Größer als - Zeichen zwischen zwei Namen bedeutet die Auswahl eines Menüpunktes aus einem Menü z. B.: Datei > Neu Eingabe Bezeichnungen von Eingabe- oder Auswahlfeldern werden fett dargestellt z. B.: Messbereichsanfang Wert Eingabe- oder Auswahlwerte werden in Anführungszeichen dargestellt z. B.: Geben Sie unter Messbereichsanfang den Wert 4 ma ein. [Button] Schaltflächenbeschriftungen in Dialogen werden fett dargestellt und in eckige Klammern eingefasst z. B.: [Eingabe] [Taste] Tastenbeschriftungen auf der Tastatur werden fett dargestellt und in eckige Klammern eingefasst z. B.: [F5]

7 WAGO-Software WagoLibCpuUsage.lib 7 Pos : 10 /Serie 759 ( WAGO-Softwar e)/wago-i/o-pr O / COD ESYS/Bi bliotheken/wagoli bcpuus age.li WagoLibCpuUsage.lib Diese Bibliothek ermöglicht das Ermitteln der CPU-Auslastung.

8 8 WagoLibCpuUsage.lib WAGO-Software 2.1 CPU_Usage Der Funktionsblock CPU_Usage ermöglicht das Ermitteln der CPU-Auslastung. Die Auslastung wird in einem Messintervall von einer Sekunde ermittelt. Die aktuelle Auslastung des Prozessors ist auf der SYS-LED sowie mittels der Gerätediagnose (WBM) auch ohne Verwendung der WagoLibCpuUsage.lib in einem CODESYS-Projekt sichtbar. Anzeige der SYS-LED: - Auslastung < 80 %: Grün - Auslastung > 80 % und < 90 %: Gelb - Auslastung > 90 %: Rot Kategorie Utility Name CPU_Usage Typ Funktionsblock Name der Bibliothek WagoLibCpuUsage.lib Erforderliche Bibliotheken --- Anwendbar für x Eingangsparameter Name Datentyp Beschreibung bylowerthreshold BYTE Grenzwert für den Übergang von niedriger zu mittlerer Auslastung (Standardwert: 80 %). byupperthreshold BYTE Grenzwert für den Übergang von mittlerer zu hoher Auslastung (Standardwert: 90 %). Ausgangsparameter Name Datentyp Beschreibung xlowerthreshold Reached BOOL Gibt an, ob die Auslastung den unteren Grenzwert überschritten hat (Standardwert: 80 %). xupperthreshold Reached BOOL Gibt an, ob die Auslastung den oberen Grenzwert überschritten hat (Standardwert: 90 %). bycpuusagetotal BYTE Gesamtauslastung in Prozent (Summe von Realtime und Other) bycpuusagerealtime BYTE Auslastung durch Echtzeitprozesse in Prozent bycpuusageother BYTE Auslastung durch Nichtechtzeitprozesse in Prozent

9 === Ende der Liste für T extmar ke Inhalt_mitte === WAGO-Software WagoLibCpuUsage.lib 9 Grafische Darstellung Beschreibung Bei der Anzeige auf der SYS-LED sowie bei der Grenzwertüberschreitung wird nur der Wert von bycpuusagerealtime betrachtet, da dies der wichtige Wert bei einem System mit prioritätsgesteuerter Preemption ist. (Hier gilt als Faustformel, dass bei einer Auslastung unterhalb von 80 % die Einhaltung aller Deadlines garantiert werden kann).

10 === Ende der Liste für T extmar ke Verzeic hnis_hi nten === 10 Tabellenverzeichnis WAGO-Software Pos : 12 /D okumentation allgemei n/verz eic hniss e/tabell enverz eichnis - Übersc hrift og und Verz @ 1 Tabellenverzeichnis Tabelle 1: Darstellungen der Zahlensysteme... 6 Tabelle 2: Schriftkonventionen... 6

11 Pos : 14 /D okumentation allgemei n/einband/einband H andbuc h - Leers eite für ger ade Seitenz @ 1 WAGO-Software 11

12 Pos : 15 /D okumentation allgemei n/einband/einband H andbuc h - R üc @ 1 === Ende der Liste für T extmar ke Ei nband_hinten === WAGO Kontakttechnik GmbH & Co. KG Postfach 2880 D Minden Hansastraße 27 D Minden Telefon: 05 71/ Telefax: 05 71/ info@wago.com Internet: