DLCD

Aus FHEMWiki
Version vom 25. August 2014, 19:14 Uhr von Epsrw1 (Diskussion | Beiträge) (→‎Attribute: neue funtion: zeilen automatisch scrollen lassen)
Zur Navigation springen Zur Suche springen
---- 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

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
  • ...