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
	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 1.1 des DLCD-Moduls.

Thread im Forum:[1]

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 (zB.: %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).

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.

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 Attributes 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 LCD Displays

dlcdPollInterval -> Zeitintervall nach dem FHEM die Daten versucht zu aktualisieren

dlcdLine1 -> Formatvorlage für LCD-zeile zB: text: %1% text: %2%

dlcdLine2 -> Formatvorlage für LCD-zeile zB: text: %3% text: %4%

dlcdLine3 -> Formatvorlage für LCD-zeile zB: 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

...

dlcdVal12 -> Quelle für den Wert %12% im Format: FhemDev:reading

dlcdTriggerCmd -> Fhem-Command zum Schreiben einer LCD-Zeile. zB.: 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

...

dlcdVal12formatnum -> 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 das configfile können eigenkreationen eingestellt werden die nicht in der liste sind

dlcdBlankspaceReplace -> Leerzeichen wird im dlcdTriggerCmd durch diesen attr-Wert ersetzt. zB: \x20

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

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

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

[2] Thread im Forum, in dem dieses Modul vorgestellt wurde
...