CustomReadings: Unterschied zwischen den Versionen

CustomReadings
Zweck / Funktion
	Erstellen von eigenen "Readings" in FHEM
Allgemein
Typ	Hilfsmodul
Details
Dokumentation	EN / DE
Support (Forum)	Unterstützende Dienste
Modulname	98_CustomReadings.pm
Ersteller	HCS
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Aktuelle Version vom 31. Januar 2018, 16:28 Uhr

CustomReadings ist ein FHEM Modul, mit dessen Hilfe man sich die unterschiedlichsten "Readings" in FHEM erstellen kann. Das Modul kann zum Beispiel benutzt werden, um diverse Systeminformation (z.B. Kernel Version, HDD Temperatur o.ä.) in FHEM anzuzeigen und weiter zu verarbeiten.

Zielsetzung

Dieses Modul ermöglicht vielfältige Verknüpfungen mit den unterschiedlichsten Anwendungen in einem System. Weitere Einsatzzwecke sind im Abschnitt Beispiele aufgeführt.

Installation des Moduls

Das Modul befindet sich seit dem 07.09.2014 im offiziellen SVN Zweig von FHEM. Sofern es nicht gefunden wird, ist muss eine Aktualisierung von FHEM (update in die Befehlszeile) eingegeben werden.

Einbindung in FHEM

Beispieldefinition eines CustomReadings

Beispieldefinition

define myReadings CustomReadings
attr myReadings interval 2
attr myReadings readingDefinitions kernel:qx(uname -r 2>&1)

Die obige Definition zeigt die Erstellung eines sog. "CustomReadings". Das Attribut "interval" gibt das Aktualisierungsintervall in Sekunden an. Das Attribut "readingsDefinitions" enthält den eigentlichen Systembefehl. Nach spätestens zwei Sekunden wird das "Reading" kernel erzeugt und mit der Ausgabe des Systembefehls "uname -r" gefüllt.

Hinzufügen weiterer "Readings"

Beispiel mit zwei Readings

attr myReadings readingDefinitions kernel:qx(uname -r 2>&1), timezone:qx(cat /etc/timezone 2>&1)

Weitere "Readings" können einfach über das Attribut "readingsDefinitions" mit Hilfe des Trennzeichens "," (Komma) hinzugefügt werden. Im folgenden wird die Zeitzone als "Reading" "timezone" hinzugefügt.

Beispiele

Definition	Erläuterungen
attr myReadings readingDefinitions hdd_temperature:qx(hddtemp /dev/sda 2>&1)	Anzeigen der Festplattentemperatur HINWEIS: Funktioniert nur auf Systemen, auf denen auch das Programm hddtemp eingerichtet ist und die entsprechenden Rechte für den FHEM-User gesetzt wurden!
fhem_backup_folder_size:qx(fhem_backup_folder_size:qx(du -ch /opt/fhem/backup/ \|awk 'END {print $1}'))	Anzeigen der Größe des Backup Verzeichnisses /opt/fhem/backup
perl_version:$]	Anzeigen der Perl Version
last_fhem_log_entry:qx(tail -1 /opt/fhem/log/fhem-\$(date +%Y-%m).log)	Anzeigen des letzten Log Eintrages im fhem.log
last_fhem_log_error:qx(grep -i error ./log/fhem-\$(date +%Y-%m).log\|tail -1)	Anzeigen des letzten Log Eintrages der das Wort "error oder ERROR oder Error" beinhaltet!
COMBINED:qx(cat /proc/sys/vm/dirty_background*),dirty_bytes:,dirty_ration:	Mehrere Werte gleichzeitig in die entsprechenden "Readings" übernehmen

Links

Thread über das Modul im FHEM Forum
FHEM commandref/CustomReadings
Ankündigung

@@ Zeile 1: / Zeile 1: @@
 {{Infobox Modul
 |ModPurpose=Erstellen von eigenen "Readings" in FHEM
-|ModType=x
+|ModType=h
 <!-- |ModCmdRef=   wird automatisch generiert -->
 |ModForumArea=Unterstützende Dienste
@@ Zeile 14: / Zeile 14: @@
 == Installation des Moduls ==
-Momentan ist das Modul noch nicht im offiziellen FHEM SVN eingepflegt. Das bedeutet, dass die Installation manuell durchgeführt werden muss. Das Modul kann aus dem {{Link2Forum|Topic=26656|Message=196915|LinkText=zweiten Beitrag}} des Forenthreads zu CustomReadings heruntergeladen werden. Danach muss es in den FHEM Ordner <code>./FHEM/</code> kopiert werden (normalerweise unter /opt/fhem/FHEM bei einem Linux-System).
+Das Modul befindet sich seit dem 07.09.2014 im offiziellen SVN Zweig von FHEM.
+Sofern es nicht gefunden wird, ist muss eine Aktualisierung von FHEM (update in die Befehlszeile)
+eingegeben werden.
-== Einbindung in Fhem ==
+== Einbindung in FHEM ==
 [[Datei:example_customreading_kernel.png|mini|400px|rechts|Beispieldefinition eines CustomReadings]]
 '''Beispieldefinition'''
@@ Zeile 38: / Zeile 40: @@
 ! Definition !! Erläuterungen
 |-
-| style="width:40%" |<code>attr myReadings readingDefinitions hdd_temperature:qx(hddtemp /dev/sda 2>&1)</code>
+| style="width:40%" |<pre>attr myReadings readingDefinitions hdd_temperature:qx(hddtemp /dev/sda 2>&1)</pre>
 | Anzeigen der Festplattentemperatur
 '''HINWEIS''': Funktioniert nur auf Systemen, auf denen auch das Programm hddtemp eingerichtet ist und die entsprechenden Rechte für den FHEM-User gesetzt wurden!
 |-
-| <code><nowiki>fhem_backup_folder_size:qx(fhem_backup_folder_size:qx(du -ch /opt/fhem/backup/ |awk 'END {print $1}'))</nowiki></code>
+| <pre><nowiki>fhem_backup_folder_size:qx(fhem_backup_folder_size:qx(du -ch /opt/fhem/backup/ |awk 'END {print $1}'))</nowiki></pre>
 | Anzeigen der Größe des Backup Verzeichnisses /opt/fhem/backup
 |-
-| <code>perl_version:$]</code>
+| <pre>perl_version:$]</pre>
 | Anzeigen der Perl Version
 |-
-| <code>last_fhem_log_entry:qx(tail -1 /opt/fhem/log/fhem-\$(date +%Y-%m).log)</code>
+| <pre>last_fhem_log_entry:qx(tail -1 /opt/fhem/log/fhem-\$(date +%Y-%m).log)</pre>
 | Anzeigen des letzten Log Eintrages im fhem.log
 |-
-| <code>last_fhem_log_error:qx(grep -i error ./log/fhem-\$(date +%Y-%m).log|tail -1)</code>
+| <pre>last_fhem_log_error:qx(grep -i error ./log/fhem-\$(date +%Y-%m).log|tail -1)</pre>
-| Anzeigen des letzten Log Eintrages der das Wort "error|ERROR|Error" beinhaltet!
+| Anzeigen des letzten Log Eintrages der das Wort "error oder ERROR oder Error" beinhaltet!
 |-
+|-
+| <pre>COMBINED:qx(cat /proc/sys/vm/dirty_background*),dirty_bytes:,dirty_ration:</pre>
+| Mehrere Werte gleichzeitig in die entsprechenden "Readings" übernehmen
+|-
 |}
 == Links ==
-* Thread über das Modul im {{Link2Forum|Topic=26656|LinkText=Fhem Forum}}
+* Thread über das Modul im {{Link2Forum|Topic=26656|LinkText=FHEM Forum}}
-* {{Link2Forum|Topic=26656|Message=196915|LinkText=Download}} des inoffiziellen Moduls
+* FHEM {{Link2CmdRef|Anker=CustomReadings}}
+* {{Link2Forum|Topic=26810|Message=0|LinkText=Ankündigung}}
 [[Kategorie:HOWTOS]]
 [[Kategorie:Code Snippets]]