'''Dieser Code-Fragment ermöglicht die aktuellen Temperatur/Luftfeuchte und die Wettervorherssage mit Hilfe von [[Text2Speech]]-Modul vorlesen zu lassen.'''
 

== FHEM-Devices ==
Es werden einige FHEM-Geräte benötigt:
# Das Text2Speak-Device (mit dem Namen 'tts')
# Der Temperatur/Feuchte-Sensor ('thSensor')
# Das Weather-Modul ('Wetter')
: (Die Namen können im Code anpasst werden.)
 

== Code ==
Der Code muss in irgendein Modul hineingeschrieben werden. Z.B. 99_myUtils.pm

=== Konstanten ===
Die Konstanten legen die Geräte-Namen fest.

<pre>
use constant {
DEVICE_NAME_TTS => "tts",
DEVICE_NAME_TH => "thSensor",
DEVICE_NAME_WEATHER => "Wetter",
};
</pre>

=== Hauptmethoden ===
Die zwei Methoden, die die eigentliche Sprachausgabe auslösen: speakWetterDaten(;$) und speakWetterVorhersage(;$).
Zum Testen kann man sie (wenn alles fertig eingetragen ist) direkt in der FHEM-Console (oder eben in der Commandline des Webinterfaces) eingeben:
<pre>{speakWetterDaten()}</pre>
und
<pre>{speakWetterVorhersage()}</pre>
Beide haben optionale Parameter, diese sind im Quellcode beschrieben.

<pre>
###############################################################################
# Sagt Wetterdaten an
# Param: Art: Variante der Aussage:
# 0: Kurzansage, 1: Normal
###############################################################################
sub speakWetterDaten(;$) {
my($art)=@_;
if(!defined($art)){$art=1;}
# TODO: Sauber / Abstraktionslayer erstellen
my $temp = prepareNumToSpeak(rundeZahl0(ReadingsVal(+DEVICE_NAME_TH,"temperature","unbekannt")));
my $humi = prepareNumToSpeak(rundeZahl0(ReadingsVal(+DEVICE_NAME_TH,"humidity","unbekannt")));
if($art==0) {
#speak("Aussentemperatur ".$temp." Grad. Feuchtigkeit ".$humi." Prozent.",0);
speak($temp." Grad. Feuchtigkeit ".$humi." Prozent.",0);
}
if($art==1) {
#speak("Die Aussentemperatur betraegt ".$temp." Grad. Die Luftfeuchtigkeit liegt bei ".$humi." Prozent.",0);
speak("Temperatur ".$temp." Grad. Luftfeuchtigkeit ".$humi." Prozent.",0);
}
}

###############################################################################
# Sagt Wettervorhersage an.
# Parameter: Tag: Zahl 1-5 (1-heute, 2-morgen,...) Defaul=2
###############################################################################
sub speakWetterVorhersage(;$) {
my ($day) = @_;
if(!defined($day)) {$day=2;}

# TODO: Sauber / Abstraktionslayer erstellen
my $t1= ReadingsVal(+DEVICE_NAME_WEATHER,"fc".$day."_condition",undef);
my $t2= ReadingsVal(+DEVICE_NAME_WEATHER,"fc".$day."_low_c",undef);
my $t3= ReadingsVal(+DEVICE_NAME_WEATHER,"fc".$day."_high_c",undef);

my $text = "";
if($day==1) {
#$text = "Wetter heute ";
$text = "Heute ";
}
if($day==2) {
$text = "Morgen ";
}
if($day==3) {
$text = "Uebermorgen ";
}
if($day>3) {
$text = "Wetter in ".($day-1)." Tagen ";
}
if(defined($t1) && defined($t2) && defined($t3)) {
$text.=$t1.". ";
$text.="Temperatur von ".$t2." bis ".$t3." Grad.";
if($day==1) {
# gefuehlte Temperatur
my $tg= ReadingsVal(+DEVICE_NAME_WEATHER,"wind_chill",undef);
#$text.="Gefuehlte Temperatur aktuell ".$tg." Grad.";
$text.="Gefuehlte ".$tg." Grad.";
my $tw= ReadingsVal(+DEVICE_NAME_WEATHER,"wind_speed",undef);
#$text.="Windgeschwindigkeit ".$tw." Kilometer pro Stunde.";
$text.="Wind ".$tw." Kilometer pro Stunde.";
}
} else {
$text="Leider keine Vorhersage verfuegbar.";
}

speak($text,0);
}
</pre>

=== Hilfsroutinen ===
Diese halten bestimmte (in den Hauptmethoden benötigte) Services bereit.

<pre>
###############################################################################
# Bereitet Zahlen zur Ansage auf.
# Ersetzt Kommas und Punkte durch das Wort 'Komma'.
###############################################################################
sub prepareNumToSpeak($) {
my($text) = @_;
$text =~ s/\./Komma/g;
$text =~ s/,/Komma/g;
return $text;
}

# Rundet eine Zahl ohne Nachkommastellen
sub rundeZahl0($) {
my($val)=@_;
# Prüfen, ob numerisch
if(int($val)>0) {
$val = int($val+0.5);
}
return $val;
}

# Rundet eine Zahl mit 1-er Nachkommastelle
sub rundeZahl1($) {
my($val)=@_;
# Prüfen, ob numerisch
if(int($val)>0) {
$val = int(10*$val+0.5)/10;
}
return $val;
}

###############################################################################
# Bereitet Texte zur Ansage auf.
# Ersetzt Umlaute (ä=ae etc.)
###############################################################################
sub prepareTextToSpeak($) {
my($text) = @_;
# TODO: Ist halt noch nicht fertig geworden ;)
return $text;
}
</pre>

ja, und dann noch die Methode, die den TTS-Modul anspricht. Die Lautstärke wird je nach Tageszeit geändert (also Nachts leiser etc.)
<pre>
######################################################
# Sprachausgabe ueber Text2Speak Modul
# Parameter:
# - text: Auszugebender Text
# - volume (optional) - Lautstaerke
# (wenn nicht vorhaneden: wird aktuell gesetzte
# Lautstaerke benutzt,
# wenn 1 oder groesser: dieser Wert wird benutzt,
# wenn 0: adaptiv gesetzt je nach Fageszeit
# (also Nachts wesentlich leiser)
# (ggf. spaeter adaptiv durch ermitteln der Zimmerlautstaerke)
######################################################
sub speak($;$) {
my($text,$volume)=@_;
if(defined ($volume)) {
if(int($volume) >=1) {
fhem("set ".+DEVICE_NAME_TTS." volume ".$volume);
} else {
if(int($volume) == 0) {
# Adaptiv
my ($sec,$min,$hour,$mday,$month,$year,$wday,$yday,$isdst) = localtime;
# 5 - sehr leise
# 10 - ok
# 50 - gut hoerbar
# 100 - default / gut laut
#
# 20:00 - 22:00 => 10
# 22:00 - 05:00 => 5
# 05:00 - 07:00 => 10
# 07:00 - 08:00 => 50
# 08:00 - 20:00 => 100
if ($hour>=20 && $hour<22) {$volume=18}
if ($hour>=22 || $hour<5) {$volume=8}
if ($hour>=5 && $hour<7) {$volume=15}
if ($hour>=7 && $hour<8) {$volume=40}
if ($hour>=8 && $hour<20) {$volume=100}

fhem("set ".+DEVICE_NAME_TTS." volume ".$volume);
}
}
}
fhem("set ".+DEVICE_NAME_TTS." tts ".prepareTextToSpeak($text));
}
</pre>
 

== Verwendung ==
Wie kann man das Ganze sinnvoll einsetzen? Na zum Beispiel indem man die Methoden auf ein Funkbutton oder ein Bewegungsmelder legt und sich so jeden Morgen nach dem Aufstehen auf die Welt da draußen vorbereiten lässt ;D

Was braucht man an Hardware? Außer Wettersensoren werden aktive Boxen o.ä. benötigt, die an den Line-Out Ausgang des Rechners angeschlossen werden. Und natürlich etwas zum Aktivieren der Ansage.
(Ich nutze einen in der Wand installierten Lautsprecher ([http://www.pollin.de/shop/dt/MDI2OTUzOTk-/HiFi_Car_HiFi_Video_TV/Lautsprecher/Lautsprecherboxen/Decken_Einbau_Lautsprecher.html Link], für die Sprachausgabe ausreichend, lässt sich in einer tiefen UP-Dose installieren) der über eine kleine 3Watt Verstärkerplatine an meinen Cubietruck angeschlossen ist.)
 

== Links ==
* Vorstellung und Diskussion im [http://forum.fhem.de/index.php/topic,28924.0.html Fhem Forum]
* [[Text2Speech | Beschreibung TTS-Modul]]
* [[Wetter Vorhersagen | Beispiel für Wethear-Modul]]

[[Kategorie:Code Snippets]]
[[Kategorie:Wetter]]

Wetter vorlesen lassen

2014-11-10T23:52:29Z

Hexenmeister: /* Links */

'''Dieser Code-Fragment ermöglicht die aktuellen Temperatur/Luftfeuchte und die Wettervorherssage mit Hilfe von [[Text2Speech]]-Modul vorlesen zu lassen.'''
 

== FHEM-Devices ==
Es werden einige FHEM-Geräte benötigt:
# Das Text2Speak-Device (mit dem Namen 'tts')
# Der Temperatur/Feuchte-Sensor ('thSensor')
# Das Weather-Modul ('Wetter')
: (Die Namen können im Code anpasst werden.)
 

== Code ==
Der Code muss in irgendein Modul hineingeschrieben werden. Z.B. 99_myUtils.pm

=== Konstanten ===
Die Konstanten legen die Geräte-Namen fest.

<pre>
use constant {
DEVICE_NAME_TTS => "tts",
DEVICE_NAME_TH => "thSensor",
DEVICE_NAME_WEATHER => "Wetter",
};
</pre>

=== Hauptmethoden ===
Die zwei Methoden, die die eigentliche Sprachausgabe auslösen: speakWetterDaten(;$) und speakWetterVorhersage(;$).
Zum Testen kann man sie (wenn alles fertig eingetragen ist) direkt in der FHEM-Console (oder eben in der Commandline des Webinterfaces) eingeben:
<pre>{speakWetterDaten()}</pre>
und
<pre>{speakWetterVorhersage()}</pre>
Beide haben optionale Parameter, diese sind im Quellcode beschrieben.

<pre>
###############################################################################
# Sagt Wetterdaten an
# Param: Art: Variante der Aussage:
# 0: Kurzansage, 1: Normal
###############################################################################
sub speakWetterDaten(;$) {
my($art)=@_;
if(!defined($art)){$art=1;}
# TODO: Sauber / Abstraktionslayer erstellen
my $temp = prepareNumToSpeak(rundeZahl0(ReadingsVal(+DEVICE_NAME_TH,"temperature","unbekannt")));
my $humi = prepareNumToSpeak(rundeZahl0(ReadingsVal(+DEVICE_NAME_TH,"humidity","unbekannt")));
if($art==0) {
#speak("Aussentemperatur ".$temp." Grad. Feuchtigkeit ".$humi." Prozent.",0);
speak($temp." Grad. Feuchtigkeit ".$humi." Prozent.",0);
}
if($art==1) {
#speak("Die Aussentemperatur betraegt ".$temp." Grad. Die Luftfeuchtigkeit liegt bei ".$humi." Prozent.",0);
speak("Temperatur ".$temp." Grad. Luftfeuchtigkeit ".$humi." Prozent.",0);
}
}

###############################################################################
# Sagt Wettervorhersage an.
# Parameter: Tag: Zahl 1-5 (1-heute, 2-morgen,...) Defaul=2
###############################################################################
sub speakWetterVorhersage(;$) {
my ($day) = @_;
if(!defined($day)) {$day=2;}

# TODO: Sauber / Abstraktionslayer erstellen
my $t1= ReadingsVal(+DEVICE_NAME_WEATHER,"fc".$day."_condition",undef);
my $t2= ReadingsVal(+DEVICE_NAME_WEATHER,"fc".$day."_low_c",undef);
my $t3= ReadingsVal(+DEVICE_NAME_WEATHER,"fc".$day."_high_c",undef);

my $text = "";
if($day==1) {
#$text = "Wetter heute ";
$text = "Heute ";
}
if($day==2) {
$text = "Morgen ";
}
if($day==3) {
$text = "Uebermorgen ";
}
if($day>3) {
$text = "Wetter in ".($day-1)." Tagen ";
}
if(defined($t1) && defined($t2) && defined($t3)) {
$text.=$t1.". ";
$text.="Temperatur von ".$t2." bis ".$t3." Grad.";
if($day==1) {
# gefuehlte Temperatur
my $tg= ReadingsVal(+DEVICE_NAME_WEATHER,"wind_chill",undef);
#$text.="Gefuehlte Temperatur aktuell ".$tg." Grad.";
$text.="Gefuehlte ".$tg." Grad.";
my $tw= ReadingsVal(+DEVICE_NAME_WEATHER,"wind_speed",undef);
#$text.="Windgeschwindigkeit ".$tw." Kilometer pro Stunde.";
$text.="Wind ".$tw." Kilometer pro Stunde.";
}
} else {
$text="Leider keine Vorhersage verfuegbar.";
}

speak($text,0);
}
</pre>

=== Hilfsroutinen ===
Diese halten bestimmte (in den Hauptmethoden benötigte) Services bereit.

<pre>
###############################################################################
# Bereitet Zahlen zur Ansage auf.
# Ersetzt Kommas und Punkte durch das Wort 'Komma'.
###############################################################################
sub prepareNumToSpeak($) {
my($text) = @_;
$text =~ s/\./Komma/g;
$text =~ s/,/Komma/g;
return $text;
}

# Rundet eine Zahl ohne Nachkommastellen
sub rundeZahl0($) {
my($val)=@_;
# Prüfen, ob numerisch
if(int($val)>0) {
$val = int($val+0.5);
}
return $val;
}

# Rundet eine Zahl mit 1-er Nachkommastelle
sub rundeZahl1($) {
my($val)=@_;
# Prüfen, ob numerisch
if(int($val)>0) {
$val = int(10*$val+0.5)/10;
}
return $val;
}

###############################################################################
# Bereitet Texte zur Ansage auf.
# Ersetzt Umlaute (ä=ae etc.)
###############################################################################
sub prepareTextToSpeak($) {
my($text) = @_;
# TODO: Ist halt noch nicht fertig geworden ;)
return $text;
}
</pre>

ja, und dann noch die Methode, die den TTS-Modul anspricht. Die Lautstärke wird je nach Tageszeit geändert (also Nachts leiser etc.)
<pre>
######################################################
# Sprachausgabe ueber Text2Speak Modul
# Parameter:
# - text: Auszugebender Text
# - volume (optional) - Lautstaerke
# (wenn nicht vorhaneden: wird aktuell gesetzte
# Lautstaerke benutzt,
# wenn 1 oder groesser: dieser Wert wird benutzt,
# wenn 0: adaptiv gesetzt je nach Fageszeit
# (also Nachts wesentlich leiser)
# (ggf. spaeter adaptiv durch ermitteln der Zimmerlautstaerke)
######################################################
sub speak($;$) {
my($text,$volume)=@_;
if(defined ($volume)) {
if(int($volume) >=1) {
fhem("set ".+DEVICE_NAME_TTS." volume ".$volume);
} else {
if(int($volume) == 0) {
# Adaptiv
my ($sec,$min,$hour,$mday,$month,$year,$wday,$yday,$isdst) = localtime;
# 5 - sehr leise
# 10 - ok
# 50 - gut hoerbar
# 100 - default / gut laut
#
# 20:00 - 22:00 => 10
# 22:00 - 05:00 => 5
# 05:00 - 07:00 => 10
# 07:00 - 08:00 => 50
# 08:00 - 20:00 => 100
if ($hour>=20 && $hour<22) {$volume=18}
if ($hour>=22 || $hour<5) {$volume=8}
if ($hour>=5 && $hour<7) {$volume=15}
if ($hour>=7 && $hour<8) {$volume=40}
if ($hour>=8 && $hour<20) {$volume=100}

fhem("set ".+DEVICE_NAME_TTS." volume ".$volume);
}
}
}
fhem("set ".+DEVICE_NAME_TTS." tts ".prepareTextToSpeak($text));
}
</pre>
 

== Verwendung ==
Wie kann man das Ganze sinnvoll einsetzen? Na zum Beispiel indem man die Methoden auf ein Funkbutton oder ein Bewegungsmelder legt und sich so jeden Morgen nach dem Aufstehen auf die Welt da draußen vorbereiten lässt ;D

Was braucht man an Hardware? Außer Wettersensoren werden aktive Boxen o.ä. benötigt, die an den Line-Out Ausgang des Rechners angeschlossen werden. Und natürlich etwas zum Aktivieren der Ansage.
(Ich nutze einen in der Wand installierten Lautsprecher ([http://www.pollin.de/shop/dt/MDI2OTUzOTk-/HiFi_Car_HiFi_Video_TV/Lautsprecher/Lautsprecherboxen/Decken_Einbau_Lautsprecher.html Link], für die Sprachausgabe ausreichend, lässt sich in einer tiefen UP-Dose installieren) der über eine kleine 3Watt Verstärkerplatine an meinen Cubietruck angeschlossen ist.)
 

== Links ==
* Vorstellung und Diskussion im [http://forum.fhem.de/index.php/topic,28924.0.html Fhem Forum]
* [[Wetter Vorhersagen | Beispiel für Wethear-Modul]]

[[Kategorie:Code Snippets]]
[[Kategorie:Wetter]]

Wetter vorlesen lassen

2014-11-10T23:46:34Z

Hexenmeister:

Hexenmeister: /* get */

{{Infobox Modul
|ModPurpose=Anzeige von Informationen und Statistiken zu dem System, auf dem Fhem ausgeführt wird.
|ModType=h

|ModTechName=42_SYSMON.pm
|ModOwner=hexenmeister / [http://forum.fhem.de/index.php?action=profile;u=4065 Hexenmeister]
}}

Das [[SYSMON]] Modul liefert diverse Informationen und Statistiken zu dem System, auf dem FHEM-Server ausgeführt wird.
Es werden nur Linux-basierte Systeme unterstützt. Manche Informationen sind hardwarespezifisch und sind daher nicht auf jeder Plattform verfügbar.
Bis jetzt wurde dieses Modul auf folgenden Systemen getestet: Raspberry Pi (Debian Wheezy), BeagleBone Black, FritzBox 7390, WR703N unter OpenWrt.

==Definition==
:<code>define <name> SYSMON [<M1>[ <M2>[ <M3>[ <M4>]]]]</code>

Diese Anweisung erstellt eine neue SYSMON-Instanz. Die Parameter M1 bis M4 legen die Aktualisierungsintervalle für verschiedenen Readings (Statistiken) fest. Die Parameter sind als Multiplikatoren für die Zeit, die durch INTERVAL_BASE definiert ist, zu verstehen. Da diese Zeit fest auf 60 Sekunden gesetzt ist, können die Mx-Parameters als Zeitintervalle in Minuten angesehen werden.
Wird einer (oder mehrere) Multiplikatoren auf Null gesetzt werden, wird das entsprechende Readings deaktiviert.

===Parameter===
Die Parameter sind für die Aktualisierung der Readings nach folgender Schema zuständig:

* '''M1''': (Default-Wert: 1)
:CPU-Daten: ''cpu_freq'', ''cpu_temp'', ''cpu_temp_avg'', ''loadavg'', ''stat_cpu'', ''stat_cpu_diff'', ''stat_cpu_percent'', ''stat_cpu_text''

* '''M2''': (Default-Wert: M1)
:Speicher: ''ram'', ''swap'' etc.

* '''M3''': (Default-Wert: M1)
:Netztwerkinformationen: ''eth0'', ''eth0_diff'', ''wlan0'', ''wlan0_diff'' etc.

* '''M4''': (Default-Wert: 10*M1)
:Filesystem-Informationen

folgende Readings werden immer anhand des Basisintervalls (unabhängig von den Mx-Parameters) aktualisiert:
''fhemuptime'', ''fhemuptime_text'', ''idletime'', ''idletime_text'', ''uptime'', ''uptime_text''

==readings==

* '''cpu_bogomips'''
:CPU Speed: BogoMIPS

* '''cpu_freq'''
:CPU-Frequenz

* '''cpu_temp'''
:CPU-Temperatur

* '''cpu_temp_avg'''
:Durchschnitt der CPU-Temperatur, gebildet über die letzten 4 Werte.

* '''fhemuptime'''
:Zeit (in Sekunden) seit dem Start des FHEM-Servers.

* '''fhemuptime_text'''
:Zeit seit dem Start des FHEM-Servers: Menschenlesbare Ausgabe (texttuelle Darstellung).

* '''idletime'''
:Zeit (in Sekunden und in Prozent), die das System (nicht der FHEM-Server!) seit dem Start in dem Idle-Modus verbracht hat. Also die Zeit der Inaktivität.

* '''idletime_text'''
:Zeit der Inaktivität des Systems seit dem Systemstart in menschenlesbarer Form.

* '''loadavg'''
:Ausgabe der Werte für die Systemauslastung (load average): 1 Minute-, 5 Minuten- und 15 Minuten-Werte.

* '''ram'''
:Ausgabe der Speicherauslastung.

* '''swap'''
:Benutzung und Auslastung der SWAP-Datei (bzw. Partition).

* '''uptime'''
:Zeit (in Sekenden) seit dem Systemstart.

* '''uptime_text'''
:Zeit seit dem Systemstart in menschenlesbarer Form.

* '''Netzwerkinformationen'''
:Informationen zu den über die angegebene Netzwerkschnittstellen übertragene Datenmengen und der Differenz zu der vorherigen Messung.
:Beispiele:
::Menge der übertragenen Daten über die Schnittstelle eth0.
::eth0: RX: 940.58 MB, TX: 736.19 MB, Total: 1676.77 MB
::Änderung der übertragenen Datenmenge in Bezug auf den vorherigen Aufruf (für eth0).
::eth0_diff: RX: 0.66 MB, TX: 0.06 MB, Total: 0.72 MB

* '''Dateisysteminformationen'''
:Informationen zu der Größe und der Belegung der gewünschten Dateisystemen.
:Seit Version 1.1.0 können Dateisysteme auch benannt werden (s.u.).
:In diesem Fall werden für die diese Readings die angegebenen Namen verwendet.
:Dies soll die Übersicht verbessern und die Erstellung von Plots erleichten.
:Beispiel:
::fs_root: Total: 7340 MB, Used: 3573 MB, 52 %, Available: 3425 MB at /

* '''CPU Auslastung'''
:Informationen zu der Auslastung der CPU(s).
:Beispiel:
::stat_cpu: 10145283 0 2187286 90586051 542691 69393 400342
::stat_cpu_diff: 2151 0 1239 2522 10 3 761
::stat_cpu_percent: 4.82 0.00 1.81 93.11 0.05 0.00 0.20
::stat_cpu_text: user: 32.17 %, nice: 0.00 %, sys: 18.53 %, idle: 37.72 %, io: 0.15 %, irq: 0.04 %, sirq: 11.38 %

* '''Benutzerdefinierte Einträge'''
::Diese Readings sind Ausgaben der Kommanden, die an das Betriebssystem übergeben werden. Die entsprechende Angaben werden im Attribut user-defined vorgenommen.

'''FritzBox-spezifische Readings'''
* '''wlan_state'''
:WLAN-Status: on/off

* '''wlan_guest_state'''
:Gast-WLAN-Status: on/off

* '''internet_ip'''
:aktuelle IP-Adresse

* '''internet_state'''
:Status der Internetverbindung: connected/disconnected

* '''night_time_ctrl'''
:Status der Klingelsperre on/off

* '''num_new_messages'''
:Anzahl der neuen Anrufbeantworter-Meldungen

* '''fw_version_info'''
:Angaben zu der installierten Firmware-Version:

===Ausgabe-Beispiel===

{| class="wikitable"
|-
|cpu_freq
|900
|2013-11-27 00:05:36
|-
|cpu_temp
|49.77
|2013-11-27 00:05:36
|-
|cpu_temp_avg
|49.7
|2013-11-27 00:05:36
|-
|eth0
|RX: 2954.22 MB, TX: 3469.21 MB, Total: 6423.43 MB
|2013-11-27 00:05:36
|-
|eth0_diff
|RX: 6.50 MB, TX: 0.23 MB, Total: 6.73 MB
|2013-11-27 00:05:36
|-
|fhemuptime
|11231
|2013-11-27 00:05:36
|-
|fhemuptime_text
|0 days, 03 hours, 07 minutes
|2013-11-27 00:05:36
|-
|idletime
|931024 88.35 %
|2013-11-27 00:05:36
|-
|idletime_text
|10 days, 18 hours, 37 minutes (88.35 %)
|2013-11-27 00:05:36
|-
|loadavg
|0.14 0.18 0.22
|2013-11-27 00:05:36
|-
|ram
|Total: 485 MB, Used: 140 MB, 28.87 %, Free: 345 MB
|2013-11-27 00:05:36
|-
|swap
|n/a
|2013-11-27 00:05:36
|-
|uptime
|1053739
|2013-11-27 00:05:36
|-
|uptime_text
|12 days, 04 hours, 42 minutes
|2013-11-27 00:05:36
|-
|wlan0
|RX: 0.00 MB, TX: 0.00 MB, Total: 0 MB
|2013-11-27 00:05:36
|-
|wlan0_diff
|RX: 0.00 MB, TX: 0.00 MB, Total: 0.00 MB
|2013-11-27 00:05:36
|-
|fs_root
|Total: 7404 MB, Used: 3533 MB, 50 %, Available: 3545 MB at /
|2013-11-27 00:05:36
|-
|fs_boot
|Total: 56 MB, Used: 19 MB, 33 %, Available: 38 MB at /boot
|2013-11-27 00:05:36
|-
|fs_usb1
|Total: 30942 MB, Used: 6191 MB, 21 %, Available: 24752 MB at /media/usb1
|2013-11-27 00:05:36
|-
|stat_cpu
|10145283 0 2187286 90586051 542691 69393 400342
|2013-11-27 00:05:36
|-
|stat_cpu_diff
|2151 0 1239 2522 10 3 761
|2013-11-27 00:05:36
|-
|stat_cpu_percent
|4.82 0.00 1.81 93.11 0.05 0.00 0.20
|2013-11-27 00:05:36
|-
|stat_cpu_text
|user: 32.17 %, nice: 0.00 %, sys: 18.53 %, idle: 37.72 %, io: 0.15 %, irq: 0.04 %, sirq: 11.38 %
|2013-11-27 00:05:36
|}

==Befehle==

===get===

*interval
:Listet die bei der Definition angegebene Polling-Intervalle auf.

*list
:Gibt alle Readings aus.

*update
:Aktualisiert alle Readings. Alle Werte werden neu abgefragt.

*version
:Zeigt die Version des SYSMON-Moduls.

===set===
-TODO-

==Attribute==
-TODO-

==Plots==
-TODO-

==Methoden==

===HTML-Ausgabe===
HTML-Ausgabe-Methode (für ein Weblink): SYSMON_ShowValuesHTML(<SYSMON-Instanz>[,<Liste>])

-TODO-

===Text-Ausgabe===
-TODO-

===Readings-Werte mit Perl lesen===
SYSMON_getValues([<Liste der gewünschten Schlüssel>])

-TODO-

==Beispielkonfiguration==

# Modul-Definition
define sysmon SYSMON 1 1 1 10
#attr sysmon event-on-update-reading cpu_temp,cpu_temp_avg,cpu_freq,eth0_diff,loadavg,ram,^~ /.*usb.*,~ /$
attr sysmon event-on-update-reading cpu_temp,cpu_temp_avg,cpu_freq,eth0_diff,loadavg,ram,fs_.*,stat_cpu_percent
attr sysmon filesystems fs_boot:/boot,fs_root:/:Root,fs_usb1:/media/usb1:USB-Stick
attr sysmon network-interfaces eth0:eth0:Ethernet,wlan0:wlan0:WiFi
attr sysmon group RPi
attr sysmon room 9.03_Tech

# Log
define FileLog_sysmon FileLog ./log/sysmon-%Y-%m.log sysmon
attr FileLog_sysmon group RPi
attr FileLog_sysmon logtype SM_CPUTemp:Plot,text
attr FileLog_sysmon room 9.03_Tech

# Visualisierung: CPU-Temperatur
define wl_sysmon_temp SVG FileLog_sysmon:SM_CPUTemp:CURRENT
attr wl_sysmon_temp group RPi
attr wl_sysmon_temp label "CPU Temperatur: Min $data{min2}, Max $data{max2}, Last $data{currval2}"
attr wl_sysmon_temp room 9.03_Tech

# Visualisierung: Netzwerk-Datenübertragung für eth0
define wl_sysmon_eth0 SVG FileLog_sysmon:SM_Network_eth0:CURRENT
attr wl_sysmon_eth0 group RPi
attr wl_sysmon_eth0 label "Netzwerk-Traffic eth0: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr wl_sysmon_eth0 room 9.03_Tech

# Visualisierung: Netzwerk-Datenübertragung für wlan0
define wl_sysmon_wlan0 SVG FileLog_sysmon:SM_Network_wlan0:CURRENT
attr wl_sysmon_wlan0 group RPi
attr wl_sysmon_wlan0 label "Netzwerk-Traffic wlan0: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr wl_sysmon_wlan0 room 9.03_Tech

# Visualisierung: CPU-Auslastung (load average)
define wl_sysmon_load SVG FileLog_sysmon:SM_Load:CURRENT
attr wl_sysmon_load group RPi
attr wl_sysmon_load label "Load Min: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr wl_sysmon_load room 9.03_Tech

# Visualisierung: RAM-Nutzung
define wl_sysmon_ram SVG FileLog_sysmon:SM_RAM:CURRENT
attr wl_sysmon_ram group RPi
attr wl_sysmon_ram label "RAM-Nutzung Total: $data{max1}, Min: $data{min2}, Max: $data{max2}, Aktuell: $data{currval2}"
attr wl_sysmon_ram room 9.03_Tech

# Visualisierung: Dateisystem: Root-Partition
define wl_sysmon_fs_root SVG FileLog_sysmon:SM_FS_root:CURRENT
attr wl_sysmon_fs_root group RPi
attr wl_sysmon_fs_root label "Root Partition Total: $data{max1}, Min: $data{min2}, Max: $data{max2}, Aktuell: $data{currval2}"
attr wl_sysmon_fs_root room 9.03_Tech

# Visualisierung: Dateisystem: USB-Stick
define wl_sysmon_fs_usb1 SVG FileLog_sysmon:SM_FS_usb1:CURRENT
attr wl_sysmon_fs_usb1 group RPi
attr wl_sysmon_fs_usb1 label "USB1 Total: $data{max1}, Min: $data{min2}, Max: $data{max2}, Aktuell: $data{currval2}"
attr wl_sysmon_fs_usb1 room 9.03_Tech

# Anzeige der Readings zum Einbinden in ein 'Raum'.
define SysValues weblink htmlCode {SYSMON_ShowValuesHTML('sysmon')}
attr SysValues group RPi
attr SysValues room 9.03_Tech

# Anzeige CPU Auslasung
define wl_sysmon_cpustat SVG FileLog_sysmon:SM_CPUStat:CURRENT
attr wl_sysmon_cpustat label "CPU(min/max): user:$data{min1}/$data{max1} nice:$data{min2}/$data{max2} sys:$data{min3}/$data{max3} idle:$data{min4}/$data{max4} io:$data{min5}/$data{max5} irq:$data{min6}/$data{max6} sirq:$data{min7}/$data{max7}"
attr wl_sysmon_cpustat group RPi
attr wl_sysmon_cpustat room 9.99_Test
attr wl_sysmon_cpustat plotsize 840,420
define wl_sysmon_cpustat_s SVG FileLog_sysmon:SM_CPUStatSum:CURRENT
attr wl_sysmon_cpustat_s label "CPU(min/max): user:$data{min1}/$data{max1} nice:$data{min2}/$data{max2} sys:$data{min3}/$data{max3} idle:$data{min4}/$data{max4} io:$data{min5}/$data{max5} irq:$data{min6}/$data{max6} sirq:$data{min7}/$data{max7}"
attr wl_sysmon_cpustat_s group RPi
attr wl_sysmon_cpustat_s room 9.99_Test
attr wl_sysmon_cpustat_s plotsize 840,420
define wl_sysmon_cpustatT SVG FileLog_sysmon:SM_CPUStatTotal:CURRENT
attr wl_sysmon_cpustatT label "CPU-Auslastung"
attr wl_sysmon_cpustatT group RPi
attr wl_sysmon_cpustatT plotsize 840,420

...to be continued...

SYSMON

2014-06-12T20:51:54Z

Hexenmeister: /* Ausgabe-Beispiel */

SYSMON

2014-06-03T21:52:34Z

Hexenmeister:

Das '''SYSMON''' Modul liefert diverse Informationen und Statistiken zu dem System, auf dem FHEM-Server ausgeführt wird.
Es werden nur Linux-basierte Systeme unterstützt. Manche Informationen sind hardwarespezifisch und sind daher nicht auf jeder Plattform verfügbar.
Bis jetzt wurde dieses Modul auf folgenden Systemen getestet: Raspberry Pi (Debian Wheezy), BeagleBone Black, FritzBox 7390, WR703N unter OpenWrt.

s.a. [http://fhem.de/commandref.html#SYSMON commandref].

__TOC__

==Definition==

define <name> SYSMON [<M1>[ <M2>[ <M3>[ <M4>]]]]

Diese Anweisung erstellt eine neue SYSMON-Instanz. Die Parameter M1 bis M4 legen die Aktualisierungsintervalle für verschiedenen Readings (Statistiken) fest. Die Parameter sind als Multiplikatoren für die Zeit, die durch INTERVAL_BASE definiert ist, zu verstehen. Da diese Zeit fest auf 60 Sekunden gesetzt ist, können die Mx-Parameters als Zeitintervalle in Minuten angesehen werden.
Wird einer (oder mehrere) Multiplikatoren auf Null gesetzt werden, wird das entsprechende Readings deaktiviert.

===Parameter===
Die Parameter sind für die Aktualisierung der Readings nach folgender Schema zuständig:

* '''M1''': (Default-Wert: 1)
:CPU-Daten: ''cpu_freq'', ''cpu_temp'', ''cpu_temp_avg'', ''loadavg'', ''stat_cpu'', ''stat_cpu_diff'', ''stat_cpu_percent'', ''stat_cpu_text''

* '''M2''': (Default-Wert: M1)
:Speicher: ''ram'', ''swap'' etc.

* '''M3''': (Default-Wert: M1)
:Netztwerkinformationen: ''eth0'', ''eth0_diff'', ''wlan0'', ''wlan0_diff'' etc.

* '''M4''': (Default-Wert: 10*M1)
:Filesystem-Informationen

folgende Readings werden immer anhand des Basisintervalls (unabhängig von den Mx-Parameters) aktualisiert:
''fhemuptime'', ''fhemuptime_text'', ''idletime'', ''idletime_text'', ''uptime'', ''uptime_text''

==readings==

* '''cpu_bogomips'''
:CPU Speed: BogoMIPS

* '''cpu_freq'''
:CPU-Frequenz

* '''cpu_temp'''
:CPU-Temperatur

* '''cpu_temp_avg'''
:Durchschnitt der CPU-Temperatur, gebildet über die letzten 4 Werte.

* '''fhemuptime'''
:Zeit (in Sekunden) seit dem Start des FHEM-Servers.

* '''fhemuptime_text'''
:Zeit seit dem Start des FHEM-Servers: Menschenlesbare Ausgabe (texttuelle Darstellung).

* '''idletime'''
:Zeit (in Sekunden und in Prozent), die das System (nicht der FHEM-Server!) seit dem Start in dem Idle-Modus verbracht hat. Also die Zeit der Inaktivität.

* '''idletime_text'''
:Zeit der Inaktivität des Systems seit dem Systemstart in menschenlesbarer Form.

* '''loadavg'''
:Ausgabe der Werte für die Systemauslastung (load average): 1 Minute-, 5 Minuten- und 15 Minuten-Werte.

* '''ram'''
:Ausgabe der Speicherauslastung.

* '''swap'''
:Benutzung und Auslastung der SWAP-Datei (bzw. Partition).

* '''uptime'''
:Zeit (in Sekenden) seit dem Systemstart.

* '''uptime_text'''
:Zeit seit dem Systemstart in menschenlesbarer Form.

* '''Netzwerkinformationen'''
:Informationen zu den über die angegebene Netzwerkschnittstellen übertragene Datenmengen und der Differenz zu der vorherigen Messung.
:Beispiele:
::Menge der übertragenen Daten über die Schnittstelle eth0.
::eth0: RX: 940.58 MB, TX: 736.19 MB, Total: 1676.77 MB
::Änderung der übertragenen Datenmenge in Bezug auf den vorherigen Aufruf (für eth0).
::eth0_diff: RX: 0.66 MB, TX: 0.06 MB, Total: 0.72 MB

* '''Dateisysteminformationen'''
:Informationen zu der Größe und der Belegung der gewünschten Dateisystemen.
:Seit Version 1.1.0 können Dateisysteme auch benannt werden (s.u.).
:In diesem Fall werden für die diese Readings die angegebenen Namen verwendet.
:Dies soll die Übersicht verbessern und die Erstellung von Plots erleichten.
:Beispiel:
::fs_root: Total: 7340 MB, Used: 3573 MB, 52 %, Available: 3425 MB at /

* '''CPU Auslastung'''
:Informationen zu der Auslastung der CPU(s).
:Beispiel:
::stat_cpu: 10145283 0 2187286 90586051 542691 69393 400342
::stat_cpu_diff: 2151 0 1239 2522 10 3 761
::stat_cpu_percent: 4.82 0.00 1.81 93.11 0.05 0.00 0.20
::stat_cpu_text: user: 32.17 %, nice: 0.00 %, sys: 18.53 %, idle: 37.72 %, io: 0.15 %, irq: 0.04 %, sirq: 11.38 %

* '''Benutzerdefinierte Einträge'''
::Diese Readings sind Ausgaben der Kommanden, die an das Betriebssystem übergeben werden. Die entsprechende Angaben werden im Attribut user-defined vorgenommen.

'''FritzBox-spezifische Readings'''
* '''wlan_state'''
:WLAN-Status: on/off

* '''wlan_guest_state'''
:Gast-WLAN-Status: on/off

* '''internet_ip'''
:aktuelle IP-Adresse

* '''internet_state'''
:Status der Internetverbindung: connected/disconnected

* '''night_time_ctrl'''
:Status der Klingelsperre on/off

* '''num_new_messages'''
:Anzahl der neuen Anrufbeantworter-Meldungen

* '''fw_version_info'''
:Angaben zu der installierten Firmware-Version:

===Ausgabe-Beispiel===
-TODO-

==Befehle==

===get===
-TODO-

===set===
-TODO-

==Attribute==
-TODO-

==Plots==
-TODO-

==Methoden==

===HTML-Ausgabe===
HTML-Ausgabe-Methode (für ein Weblink): SYSMON_ShowValuesHTML(<SYSMON-Instanz>[,<Liste>])

-TODO-

===Text-Ausgabe===
-TODO-

===Readings-Werte mit Perl lesen===
SYSMON_getValues([<Liste der gewünschten Schlüssel>])

-TODO-

==Beispielkonfiguration==

# Modul-Definition
define sysmon SYSMON 1 1 1 10
#attr sysmon event-on-update-reading cpu_temp,cpu_temp_avg,cpu_freq,eth0_diff,loadavg,ram,^~ /.*usb.*,~ /$
attr sysmon event-on-update-reading cpu_temp,cpu_temp_avg,cpu_freq,eth0_diff,loadavg,ram,fs_.*,stat_cpu_percent
attr sysmon filesystems fs_boot:/boot,fs_root:/:Root,fs_usb1:/media/usb1:USB-Stick
attr sysmon network-interfaces eth0:eth0:Ethernet,wlan0:wlan0:WiFi
attr sysmon group RPi
attr sysmon room 9.03_Tech

# Log
define FileLog_sysmon FileLog ./log/sysmon-%Y-%m.log sysmon
attr FileLog_sysmon group RPi
attr FileLog_sysmon logtype SM_CPUTemp:Plot,text
attr FileLog_sysmon room 9.03_Tech

# Visualisierung: CPU-Temperatur
define wl_sysmon_temp SVG FileLog_sysmon:SM_CPUTemp:CURRENT
attr wl_sysmon_temp group RPi
attr wl_sysmon_temp label "CPU Temperatur: Min $data{min2}, Max $data{max2}, Last $data{currval2}"
attr wl_sysmon_temp room 9.03_Tech

# Visualisierung: Netzwerk-Datenübertragung für eth0
define wl_sysmon_eth0 SVG FileLog_sysmon:SM_Network_eth0:CURRENT
attr wl_sysmon_eth0 group RPi
attr wl_sysmon_eth0 label "Netzwerk-Traffic eth0: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr wl_sysmon_eth0 room 9.03_Tech

# Visualisierung: Netzwerk-Datenübertragung für wlan0
define wl_sysmon_wlan0 SVG FileLog_sysmon:SM_Network_wlan0:CURRENT
attr wl_sysmon_wlan0 group RPi
attr wl_sysmon_wlan0 label "Netzwerk-Traffic wlan0: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr wl_sysmon_wlan0 room 9.03_Tech

# Visualisierung: CPU-Auslastung (load average)
define wl_sysmon_load SVG FileLog_sysmon:SM_Load:CURRENT
attr wl_sysmon_load group RPi
attr wl_sysmon_load label "Load Min: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr wl_sysmon_load room 9.03_Tech

# Visualisierung: RAM-Nutzung
define wl_sysmon_ram SVG FileLog_sysmon:SM_RAM:CURRENT
attr wl_sysmon_ram group RPi
attr wl_sysmon_ram label "RAM-Nutzung Total: $data{max1}, Min: $data{min2}, Max: $data{max2}, Aktuell: $data{currval2}"
attr wl_sysmon_ram room 9.03_Tech

# Visualisierung: Dateisystem: Root-Partition
define wl_sysmon_fs_root SVG FileLog_sysmon:SM_FS_root:CURRENT
attr wl_sysmon_fs_root group RPi
attr wl_sysmon_fs_root label "Root Partition Total: $data{max1}, Min: $data{min2}, Max: $data{max2}, Aktuell: $data{currval2}"
attr wl_sysmon_fs_root room 9.03_Tech

# Visualisierung: Dateisystem: USB-Stick
define wl_sysmon_fs_usb1 SVG FileLog_sysmon:SM_FS_usb1:CURRENT
attr wl_sysmon_fs_usb1 group RPi
attr wl_sysmon_fs_usb1 label "USB1 Total: $data{max1}, Min: $data{min2}, Max: $data{max2}, Aktuell: $data{currval2}"
attr wl_sysmon_fs_usb1 room 9.03_Tech

# Anzeige der Readings zum Einbinden in ein 'Raum'.
define SysValues weblink htmlCode {SYSMON_ShowValuesHTML('sysmon')}
attr SysValues group RPi
attr SysValues room 9.03_Tech

# Anzeige CPU Auslasung
define wl_sysmon_cpustat SVG FileLog_sysmon:SM_CPUStat:CURRENT
attr wl_sysmon_cpustat label "CPU(min/max): user:$data{min1}/$data{max1} nice:$data{min2}/$data{max2} sys:$data{min3}/$data{max3} idle:$data{min4}/$data{max4} io:$data{min5}/$data{max5} irq:$data{min6}/$data{max6} sirq:$data{min7}/$data{max7}"
attr wl_sysmon_cpustat group RPi
attr wl_sysmon_cpustat room 9.99_Test
attr wl_sysmon_cpustat plotsize 840,420
define wl_sysmon_cpustat_s SVG FileLog_sysmon:SM_CPUStatSum:CURRENT
attr wl_sysmon_cpustat_s label "CPU(min/max): user:$data{min1}/$data{max1} nice:$data{min2}/$data{max2} sys:$data{min3}/$data{max3} idle:$data{min4}/$data{max4} io:$data{min5}/$data{max5} irq:$data{min6}/$data{max6} sirq:$data{min7}/$data{max7}"
attr wl_sysmon_cpustat_s group RPi
attr wl_sysmon_cpustat_s room 9.99_Test
attr wl_sysmon_cpustat_s plotsize 840,420
define wl_sysmon_cpustatT SVG FileLog_sysmon:SM_CPUStatTotal:CURRENT
attr wl_sysmon_cpustatT label "CPU-Auslastung"
attr wl_sysmon_cpustatT group RPi
attr wl_sysmon_cpustatT plotsize 840,420

...to be continued...

SYSMON

2014-06-03T21:49:37Z

Hexenmeister: FHEM-Modul SYSMON

Das '''SYSMON''' Modul liefert diverse Informationen und Statistiken zu dem System, auf dem FHEM-Server ausgeführt wird.
Es werden nur Linux-basierte Systeme unterstützt. Manche Informationen sind hardwarespezifisch und sind daher nicht auf jeder Plattform verfügbar.
Bis jetzt wurde dieses Modul auf folgenden Systemen getestet: Raspberry Pi (Debian Wheezy), BeagleBone Black, FritzBox 7390, WR703N unter OpenWrt.

__TOC__

==Definition==

define <name> SYSMON [<M1>[ <M2>[ <M3>[ <M4>]]]]

Diese Anweisung erstellt eine neue SYSMON-Instanz. Die Parameter M1 bis M4 legen die Aktualisierungsintervalle für verschiedenen Readings (Statistiken) fest. Die Parameter sind als Multiplikatoren für die Zeit, die durch INTERVAL_BASE definiert ist, zu verstehen. Da diese Zeit fest auf 60 Sekunden gesetzt ist, können die Mx-Parameters als Zeitintervalle in Minuten angesehen werden.
Wird einer (oder mehrere) Multiplikatoren auf Null gesetzt werden, wird das entsprechende Readings deaktiviert.

===Parameter===
Die Parameter sind für die Aktualisierung der Readings nach folgender Schema zuständig:

* '''M1''': (Default-Wert: 1)
:CPU-Daten: ''cpu_freq'', ''cpu_temp'', ''cpu_temp_avg'', ''loadavg'', ''stat_cpu'', ''stat_cpu_diff'', ''stat_cpu_percent'', ''stat_cpu_text''

* '''M2''': (Default-Wert: M1)
:Speicher: ''ram'', ''swap'' etc.

* '''M3''': (Default-Wert: M1)
:Netztwerkinformationen: ''eth0'', ''eth0_diff'', ''wlan0'', ''wlan0_diff'' etc.

* '''M4''': (Default-Wert: 10*M1)
:Filesystem-Informationen

folgende Readings werden immer anhand des Basisintervalls (unabhängig von den Mx-Parameters) aktualisiert:
''fhemuptime'', ''fhemuptime_text'', ''idletime'', ''idletime_text'', ''uptime'', ''uptime_text''

==readings==

* '''cpu_bogomips'''
:CPU Speed: BogoMIPS

* '''cpu_freq'''
:CPU-Frequenz

* '''cpu_temp'''
:CPU-Temperatur

* '''cpu_temp_avg'''
:Durchschnitt der CPU-Temperatur, gebildet über die letzten 4 Werte.

* '''fhemuptime'''
:Zeit (in Sekunden) seit dem Start des FHEM-Servers.

* '''fhemuptime_text'''
:Zeit seit dem Start des FHEM-Servers: Menschenlesbare Ausgabe (texttuelle Darstellung).

* '''idletime'''
:Zeit (in Sekunden und in Prozent), die das System (nicht der FHEM-Server!) seit dem Start in dem Idle-Modus verbracht hat. Also die Zeit der Inaktivität.

* '''idletime_text'''
:Zeit der Inaktivität des Systems seit dem Systemstart in menschenlesbarer Form.

* '''loadavg'''
:Ausgabe der Werte für die Systemauslastung (load average): 1 Minute-, 5 Minuten- und 15 Minuten-Werte.

* '''ram'''
:Ausgabe der Speicherauslastung.

* '''swap'''
:Benutzung und Auslastung der SWAP-Datei (bzw. Partition).

* '''uptime'''
:Zeit (in Sekenden) seit dem Systemstart.

* '''uptime_text'''
:Zeit seit dem Systemstart in menschenlesbarer Form.

* '''Netzwerkinformationen'''
:Informationen zu den über die angegebene Netzwerkschnittstellen übertragene Datenmengen und der Differenz zu der vorherigen Messung.
:Beispiele:
::Menge der übertragenen Daten über die Schnittstelle eth0.
::eth0: RX: 940.58 MB, TX: 736.19 MB, Total: 1676.77 MB
::Änderung der übertragenen Datenmenge in Bezug auf den vorherigen Aufruf (für eth0).
::eth0_diff: RX: 0.66 MB, TX: 0.06 MB, Total: 0.72 MB

* '''Dateisysteminformationen'''
:Informationen zu der Größe und der Belegung der gewünschten Dateisystemen.
:Seit Version 1.1.0 können Dateisysteme auch benannt werden (s.u.).
:In diesem Fall werden für die diese Readings die angegebenen Namen verwendet.
:Dies soll die Übersicht verbessern und die Erstellung von Plots erleichten.
:Beispiel:
::fs_root: Total: 7340 MB, Used: 3573 MB, 52 %, Available: 3425 MB at /

* '''CPU Auslastung'''
:Informationen zu der Auslastung der CPU(s).
:Beispiel:
::stat_cpu: 10145283 0 2187286 90586051 542691 69393 400342
::stat_cpu_diff: 2151 0 1239 2522 10 3 761
::stat_cpu_percent: 4.82 0.00 1.81 93.11 0.05 0.00 0.20
::stat_cpu_text: user: 32.17 %, nice: 0.00 %, sys: 18.53 %, idle: 37.72 %, io: 0.15 %, irq: 0.04 %, sirq: 11.38 %

* '''Benutzerdefinierte Einträge'''
::Diese Readings sind Ausgaben der Kommanden, die an das Betriebssystem übergeben werden. Die entsprechende Angaben werden im Attribut user-defined vorgenommen.

'''FritzBox-spezifische Readings'''
* '''wlan_state'''
:WLAN-Status: on/off

* '''wlan_guest_state'''
:Gast-WLAN-Status: on/off

* '''internet_ip'''
:aktuelle IP-Adresse

* '''internet_state'''
:Status der Internetverbindung: connected/disconnected

* '''night_time_ctrl'''
:Status der Klingelsperre on/off

* '''num_new_messages'''
:Anzahl der neuen Anrufbeantworter-Meldungen

* '''fw_version_info'''
:Angaben zu der installierten Firmware-Version:

===Ausgabe-Beispiel===
-TODO-

==Befehle==

===get===
-TODO-

===set===
-TODO-

==Attribute==
-TODO-

==Plots==
-TODO-

==Methoden==

===HTML-Ausgabe===
HTML-Ausgabe-Methode (für ein Weblink): SYSMON_ShowValuesHTML(<SYSMON-Instanz>[,<Liste>])

-TODO-

===Text-Ausgabe===
-TODO-

===Readings-Werte mit Perl lesen===
SYSMON_getValues([<Liste der gewünschten Schlüssel>])

-TODO-

==Beispielkonfiguration==

# Modul-Definition
define sysmon SYSMON 1 1 1 10
#attr sysmon event-on-update-reading cpu_temp,cpu_temp_avg,cpu_freq,eth0_diff,loadavg,ram,^~ /.*usb.*,~ /$
attr sysmon event-on-update-reading cpu_temp,cpu_temp_avg,cpu_freq,eth0_diff,loadavg,ram,fs_.*,stat_cpu_percent
attr sysmon filesystems fs_boot:/boot,fs_root:/:Root,fs_usb1:/media/usb1:USB-Stick
attr sysmon network-interfaces eth0:eth0:Ethernet,wlan0:wlan0:WiFi
attr sysmon group RPi
attr sysmon room 9.03_Tech

# Log
define FileLog_sysmon FileLog ./log/sysmon-%Y-%m.log sysmon
attr FileLog_sysmon group RPi
attr FileLog_sysmon logtype SM_CPUTemp:Plot,text
attr FileLog_sysmon room 9.03_Tech

# Visualisierung: CPU-Temperatur
define wl_sysmon_temp SVG FileLog_sysmon:SM_CPUTemp:CURRENT
attr wl_sysmon_temp group RPi
attr wl_sysmon_temp label "CPU Temperatur: Min $data{min2}, Max $data{max2}, Last $data{currval2}"
attr wl_sysmon_temp room 9.03_Tech

# Visualisierung: Netzwerk-Datenübertragung für eth0
define wl_sysmon_eth0 SVG FileLog_sysmon:SM_Network_eth0:CURRENT
attr wl_sysmon_eth0 group RPi
attr wl_sysmon_eth0 label "Netzwerk-Traffic eth0: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr wl_sysmon_eth0 room 9.03_Tech

# Visualisierung: Netzwerk-Datenübertragung für wlan0
define wl_sysmon_wlan0 SVG FileLog_sysmon:SM_Network_wlan0:CURRENT
attr wl_sysmon_wlan0 group RPi
attr wl_sysmon_wlan0 label "Netzwerk-Traffic wlan0: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr wl_sysmon_wlan0 room 9.03_Tech

# Visualisierung: CPU-Auslastung (load average)
define wl_sysmon_load SVG FileLog_sysmon:SM_Load:CURRENT
attr wl_sysmon_load group RPi
attr wl_sysmon_load label "Load Min: $data{min1}, Max: $data{max1}, Aktuell: $data{currval1}"
attr wl_sysmon_load room 9.03_Tech

# Visualisierung: RAM-Nutzung
define wl_sysmon_ram SVG FileLog_sysmon:SM_RAM:CURRENT
attr wl_sysmon_ram group RPi
attr wl_sysmon_ram label "RAM-Nutzung Total: $data{max1}, Min: $data{min2}, Max: $data{max2}, Aktuell: $data{currval2}"
attr wl_sysmon_ram room 9.03_Tech

# Visualisierung: Dateisystem: Root-Partition
define wl_sysmon_fs_root SVG FileLog_sysmon:SM_FS_root:CURRENT
attr wl_sysmon_fs_root group RPi
attr wl_sysmon_fs_root label "Root Partition Total: $data{max1}, Min: $data{min2}, Max: $data{max2}, Aktuell: $data{currval2}"
attr wl_sysmon_fs_root room 9.03_Tech

# Visualisierung: Dateisystem: USB-Stick
define wl_sysmon_fs_usb1 SVG FileLog_sysmon:SM_FS_usb1:CURRENT
attr wl_sysmon_fs_usb1 group RPi
attr wl_sysmon_fs_usb1 label "USB1 Total: $data{max1}, Min: $data{min2}, Max: $data{max2}, Aktuell: $data{currval2}"
attr wl_sysmon_fs_usb1 room 9.03_Tech

# Anzeige der Readings zum Einbinden in ein 'Raum'.
define SysValues weblink htmlCode {SYSMON_ShowValuesHTML('sysmon')}
attr SysValues group RPi
attr SysValues room 9.03_Tech

# Anzeige CPU Auslasung
define wl_sysmon_cpustat SVG FileLog_sysmon:SM_CPUStat:CURRENT
attr wl_sysmon_cpustat label "CPU(min/max): user:$data{min1}/$data{max1} nice:$data{min2}/$data{max2} sys:$data{min3}/$data{max3} idle:$data{min4}/$data{max4} io:$data{min5}/$data{max5} irq:$data{min6}/$data{max6} sirq:$data{min7}/$data{max7}"
attr wl_sysmon_cpustat group RPi
attr wl_sysmon_cpustat room 9.99_Test
attr wl_sysmon_cpustat plotsize 840,420
define wl_sysmon_cpustat_s SVG FileLog_sysmon:SM_CPUStatSum:CURRENT
attr wl_sysmon_cpustat_s label "CPU(min/max): user:$data{min1}/$data{max1} nice:$data{min2}/$data{max2} sys:$data{min3}/$data{max3} idle:$data{min4}/$data{max4} io:$data{min5}/$data{max5} irq:$data{min6}/$data{max6} sirq:$data{min7}/$data{max7}"
attr wl_sysmon_cpustat_s group RPi
attr wl_sysmon_cpustat_s room 9.99_Test
attr wl_sysmon_cpustat_s plotsize 840,420
define wl_sysmon_cpustatT SVG FileLog_sysmon:SM_CPUStatTotal:CURRENT
attr wl_sysmon_cpustatT label "CPU-Auslastung"
attr wl_sysmon_cpustatT group RPi
attr wl_sysmon_cpustatT plotsize 840,420

...to be continued...