DLCD

---- noch nicht Teil von FHEM ----
Zweck / Funktion
	Daten sammeln und formatiert auf LCD ausgeben
Allgemein
Typ	Inoffiziell
Details
Dokumentation	siehe Forum
Support (Forum)	Codeschnipsel
Modulname	39_DLCD.pm
Ersteller	epsrw1 (Forum / Wiki)
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Das DLCD-Modul bietet eine einfache Möglichkeit, Daten zu sammeln und für die Anzeige auf einem seriellen LCD aufzubereiten.

Features

Diese Wiki-Seite beschreibt den Versionsstand 2.0 des DLCD-Moduls.

Thread im Fhem-Forum mit der jeweils aktuellen Version des Moduls als Anhang im ersten Beitrag.

Beschreibung

Funktionsweise

DLCD bietet als kleines Helferlein die Möglichkeit, Textzeilen eines LCD Displays als Readings vorzubereiten und mit Daten frei konfigurierbarer Readings zu befüllen.

Jede Zeile wird als Attr vordefiniert, und mit Platzhaltern (z.B.: %1%) für die einzutragenden Werte versehen.

Die Liste aller einzulesenden Devices:Readings wird in einem attr eingestellt. Das Modul prüft dann regelmäßig (attr: poll interval) die Daten der Fhem-Devices und aktualisiert dann die Anzeige sobald sich einer der Werte geändert hat.

Zusätzlich können Zahlen einfach über attr formatiert werden (Kommastellen, Rundung, Anzeige von + und - Zeichen).

Eine Reihe von Platzhaltern ermöglicht das Einsetzen von Datum und Zeit-Werten in die Ausgabezeilen (zB Minute einzeln, Wochentag, Datum, ....)

Die über attr einschaltbare Rollierfunktion verschiebt die Zeilen bei jedem Update um eine Ziffer nach oben. So läßt sich zB eine wechselanzeige auf einem einzeiligen Display realisieren.

Die eigentliche Ausgabe auf das LCD erfolgt jeweils immer dann wenn eine Änderung der Daten festgestellt wird, auf beliebiges konfigurierbares Device. Zum beispiel I2C LCD über FHEM, oder auch über shell-command für nicht von FHEM unterstützte displays.

Manche Displays können Leerzeichen oder Umlaute nicht richtig wiedergeben. Daher kann DLCD über attr eingestellte Ersetzungen vornehmen, bevor die Daten an das LCD-device übergeben werden.

Um die Einrichtung zu erleichtern, kann man mit dem attr dlcdDebugOutput die jeweils an das Device abgesetzten Befehle als reading ausgeben lassen.

Mit stateFormat state Line1 Line2 Line3 Line4 kann man sich ein Abbild des Displayinhaltes im Web-frontend anzeigen lassen.

Frontend-Beispiel

Define

define <name> DLCD

In der Basisversion wurde Number::Format von cpan benötigt. Dies ist ab v. 1.1. nicht mehr der Fall.

Attribute

Alle Attribute sind auch in fhem durch das Kommando get attrHelp <varname> erklärt, für's "schnelle Nachschauen zwischendurch".

dlcdRows -> Anzahl Datenzeilen (kann mehr als am Display sein mit eingeschaltetem Scrolling)
dlcdCols -> Anzahl Spalten des LC-Displays
dlcdPollInterval -> Zeitintervall, nach dem FHEM versucht, die Daten zu aktualisieren
dlcdLine1 -> Formatvorlage für LCD-Zeile z.B.: text: %1% text: %2%
dlcdLine2 -> Formatvorlage für LCD-Zeile z.B.: text: %3% text: %4%
dlcdLine3 -> Formatvorlage für LCD-Zeile z.B.: text: %5% text: %6%
dlcdLine4 -> Formatvorlage für LCD-Zeile Text: %7% text: %8%
dlcdLine5 -> Formatvorlage für LCD-Zeile Text: %11% text: %12%
dlcdVal1 -> Quelle für den Wert %1% im Format: FhemDev:reading
dlcdVal2 -> Quelle für den Wert %2% im Format: FhemDev:reading
dlcdVal3 -> Quelle für den Wert %3% im Format: FhemDev:reading
...
dlcdVal20 -> Quelle für den Wert %12% im Format: FhemDev:reading

dlcdTriggerCmd -> Fhem-Befehl zum Schreiben einer LCD-Zeile, z.B.: set lcd_wand writeXY 0,%L%,20,1 %T%
dlcdVal1formatnum -> Zahlenformatierung für Wert %1%, muss none sein bei Nicht-Zahl
dlcdVal2formatnum -> Zahlenformatierung für Wert %1%, muss none sein bei Nicht-Zahl
dlcdVal3formatnum -> Zahlenformatierung für Wert %1%, muss none sein bei Nicht-Zahl
...
dlcdVal20formatnum -> Zahlenformatierung für Wert %1%, muss none sein bei Nicht-Zahl

dlcdVal .. formatnum setzen die Anzahl Dezimalstellen fest, sowie ob ein + bzw. - Zeichen vorangestellt wird. Es funktioniert wie folgt:

erste Ziffer: Gesamtzahl Ziffern in der Ausgabe. zweite Ziffer: Anzahl fester Dezimalstellen optional: +- an dritter Stelle

Beispiele: 2+1 -> 1.1 9.0 0.4 4+2+- -> -12.34 +10.50 4+0+- -> -0012 +0010

Die möglichen Optionen sind in einer Liste fest vorgegeben, um Fehleinstellungen zu vermeiden. Über manuellen Eintrag in der fhem-config können Eigenkreationen eingestellt werden, die nicht in der Liste enthalten sind (zB. 10+2+-).

dlcdVal1formatstring -> benutzerdefinierter sprintf format pattern, setzt formatnum außer kraft. zB: %03f
dlcdVal2formatstring -> benutzerdefinierter sprintf format pattern, setzt formatnum außer kraft. zB: %03f
dlcdVal3formatstring -> benutzerdefinierter sprintf format pattern, setzt formatnum außer kraft. zB: %03f
...
dlcdVal20formatstring -> benutzerdefinierter sprintf format pattern, setzt formatnum außer kraft. zB: %03f

dlcdBlankspaceReplace -> Leerzeichen wird im dlcdTriggerCmd durch diesen attr-Wert ersetzt. z.B.: \\x20 oder \\x{10}
dlcdReplaceRegex -> beliebige ersetzung von zeichen, kommagetrennte paare mit = zeichen, zB.: ä=\\xE1,ö=\\xEF,ü=\\xF5,Ä=\\xE1,Ö=\\xEF,Ü=\\xF5,ß=\\xE2,°=\\x{DF}, Unicode-Beispiel: \N{U+code}, zB \N{U+0041}und \N{U+41} werden zu A und A
dlcdPhysicalRows -> Anzahl physikalisch vorhandener Zeilen am Ausgabedisplay
dlcdScrolling -> Zeilen automatisch scrollen, 1=an 0=aus
dlcdDebugOutput -> zusätzliche readings für aktuelle Display-ausgabe zum testen der Scroll-Funktion
dlcdClearLineCmd -> optional: command um lcd-zeile zu leeren (%L%=line 0-n), zB. Set lcd42 clear %L%
dlcdClearAllCmd -> optional: command um lcd komplett zu leeren (nur bei scrolling)
dlcdLineAddrMap -> alternative Zeilenadressierung. Default ist 0,1,2,3,4,5,6,7,8,9. Beispiel: 1,2,3 verwendet nur 2. bis 4. LCD-zeile und überspringt die erste.
disable -> keine neuen schreibvorgänge

Settings

reset ->alle Readings zurücksetzen

Readings

Line1 -> Aktuelle Anzeige der Zeile 1

Line2 -> Aktuelle Anzeige der Zeile 2

Line3 -> Aktuelle Anzeige der Zeile 3

Line4 -> Aktuelle Anzeige der Zeile 4

Line5 -> Aktuelle Anzeige der Zeile 5

Spezielle Anzeigefunktionen

Datum und Uhrzeit basieren aktuell auf der Systemzeit des FHEM-Servers. Eine Möglichkeit, als Zeitbasis den Timestamp eines FHEM-Readings zu verwenden, ist denkbar; wer das nutzen möchte, bitte im Forum melden.

Datum

%date_Y% --> Jaheszahl 4-stellig
%date_y% --> Jahreszahl 2-stellig
%date_M% --> Monat als Zahl, 2-stellig
%date_M_eng% --> Monat, Abkürzung englisch
%date_M_ger% --> Monat, Abkürzung deutsch
%date_D% --> Tag des Monats 2-stellig
%date_WD% --> Wochentag 1-stellig im Format 0(So) ... 6(Sa)
%date_WD_eng% --> Wochentag, Abkürzung englisch
%date_WD_ger% --> Wochentag, Abkürzung deutsch
%date_dmy% --> Datum im Format 25.08.2014

Zeit

%time_hms% --> HH:MM:SS Uhrzeit
%time_h% --> Stunde
%time_m% --> Minute
%time_s% --> Sekunde

LCD-Abbild im Web-frontend

attr <name> stateFormat state Line1 Line2 Line3 Line4 Line5

Mathematische Werteberechnung

Noch in Arbeit - Ideen sind willkommen ;) --> Forum
To be continued

Weblinks

Thread im Forum, in dem dieses Modul vorgestellt wurde
Projekt: Statusdisplay mit ESP Easy und DLCD
...