http://wiki.fhem.de/w/api.php?action=feedcontributions&user=Damian-s&feedformat=atomFHEMWiki - Benutzerbeiträge [de]2024-03-28T08:28:02ZBenutzerbeiträgeMediaWiki 1.39.3http://wiki.fhem.de/w/index.php?title=Benutzer_Diskussion:Damian-s&diff=38499Benutzer Diskussion:Damian-s2023-07-19T16:28:36Z<p>Damian-s: /* Duplikate */</p>
<hr />
<div>== Willkommen! ==<br />
{| width="100%" cellspacing="0" cellpadding="6" style="line-height: 20px; background: #E0E0E0; border: 2px solid #1874CD;"<br />
|-<br />
| colspan="4" style="background:#1874CD;" |<big><span style="color: #FAFAFA">'''Hallo Damian-s,''' willkommen im FHEM Wiki!</span></big><br />
|-<br />
| colspan="4" | Danke für dein Interesse an unserem Projekt, ich freue mich schon auf deine weiteren Beiträge. Die folgenden Seiten sollten dir die ersten Schritte erleichtern, bitte nimm dir daher etwas Zeit, sie zu lesen.<br />
<br />
----<br />
'''FHEM-spezifische Informationen'''<br />
<br />
|-<br />
| width="8%" | &nbsp;<br />
| width="38%" | '''[[Systemübersicht]]'''<br />''FHEM Systemübersicht''<br />
| width="8%" | &nbsp;<br />
| width="38%" | '''[[FHEMWiki:Über FHEMWiki]]'''<br />''Informationen über dieses Wiki''<br />
<!-- Abschnitt auf Kommentar gesetzt<br />
|-<br />
| colspan="4" |<br />
----<br />
<br />
{{Todo|FHEM-spezifische Anleitungen und Regeln.}}<br />
<br />
---- <br />
Ende von 'Abschnitt auf Kommentar gesetzt' --><br />
|-<br />
| colspan="4" | <br />
----<br />
'''Generelle Informationen über (Media)Wikis'''<br />
|-<br />
| width="8%" | [[Datei:Crystal Clear app kedit.svg|rechts|30px|link=Hilfe:Bearbeiten]]<br />
| width="38%" | '''[[Hilfe:Bearbeiten]]'''<br />''Zugang zu allen wichtigen Informationen.''<br />
| width="8%" | [[Datei:X-office-presentation.svg|rechts|30px|link=Wikipedia:Tutorial]]<br />
| width="38%" | <!-- '''[[Wikipedia:Tutorial]]'''-->'''[http://de.wikipedia.org/wiki/Wikipedia:Tutorial Wikipedia:Tutorial]'''<br />''Schritt-für-Schritt-Anleitung für Einsteiger.''<br />
|-<br />
| [[Datei:Applications-system.svg|rechts|30px|link=Wikipedia:Grundprinzipien]]<br />
| '''<!--[[Wikipedia:Grundprinzipien]]-->[http://de.wikipedia.org/wiki/Wikipedia:Grundprinzipien Wikipedia:Grundprinzipien]'''<br />''Die grundlegende Philosophie unseres Projekts.''<br />
| [[Datei:MentorenProgrammLogo-7.svg|rechts|60px|link=Wikipedia:Mentorenprogramm]]<br />
| '''<!--[[Wikipedia:Mentorenprogramm]]-->[http://de.wikipedia.org/wiki/Wikipedia:Mentorenprogramm Wikipedia:Mentorenprogramm]'''<br />''Persönliche Einführung in die Beteiligung bei Wikipedia.''<br />
|-<br />
| colspan="4" |<br />
----<br />
Bitte beachte, <!--[[Wikipedia:Was Wikipedia nicht ist|was Wikipedia nicht ist]]-->[http://de.wikipedia.org/wiki/Wikipedia:Was_Wikipedia_nicht_ist was Wikipedia nicht ist], und "unterschreibe" deine Diskussionsbeiträge durch Eingabe von <code>--<nowiki>~~~~</nowiki></code> oder durch Drücken der Schaltfläche [[Datei:button_sig.png|Signaturknopf|20px|link=Hilfe:Signatur]] über dem Bearbeitungsfeld. Artikel werden jedoch nicht unterschrieben, und wofür die Zusammenfassungszeile da ist, erfährst du unter <!--[[wikipedia:Hilfe:Zusammenfassung und Quellen|Hilfe:Zusammenfassung und Quellen]]-->[http://de.wikipedia.org/wiki/Hilfe:Zusammenfassung_und_Quellen Zusammenfassung und Quellen]. <br /><br /><br />
[[Datei:Nuvola apps ksirc.png|25px|link=Benutzer Diskussion:Ph1959de]] &nbsp;&nbsp; '''Hast du Fragen an mich?''' Schreib mir auf [[Benutzer Diskussion:Ph1959de|<u>meiner</u> Diskussionsseite]]! Viele Grüße, [[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 13:31, 26. Dez. 2017 (CET)<br />
|}<br />
<br />
== Hochgeladene Dateien vom 10.7. ==<br />
<br />
Damian, Du hast gestern einige neue Dateien hochgeladen, es sind aber auch "ungenutzte Duplikate" dabei. Könntest Du bitte kontrollieren welche davon wirklich benötigt werden und die anderen löschen lassen?<br />
* DOIF-hover.gif - Duplikat von Datei:Hover.gif - Keine Seiten verwenden diese Datei<br />
* Hover.png - Keine Seiten verwenden diese Datei<br />
--[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 11:11, 11. Jul. 2023 (CEST)<br />
<br />
== Duplikate ==<br />
<br />
Offenbar kann ich mit meinen Rechten die überflüssigen Grafiken nicht löschen.</div>Damian-shttp://wiki.fhem.de/w/index.php?title=Benutzer_Diskussion:Damian-s&diff=38498Benutzer Diskussion:Damian-s2023-07-19T16:28:17Z<p>Damian-s: Neuer Abschnitt /* Duplikate */</p>
<hr />
<div>== Willkommen! ==<br />
{| width="100%" cellspacing="0" cellpadding="6" style="line-height: 20px; background: #E0E0E0; border: 2px solid #1874CD;"<br />
|-<br />
| colspan="4" style="background:#1874CD;" |<big><span style="color: #FAFAFA">'''Hallo Damian-s,''' willkommen im FHEM Wiki!</span></big><br />
|-<br />
| colspan="4" | Danke für dein Interesse an unserem Projekt, ich freue mich schon auf deine weiteren Beiträge. Die folgenden Seiten sollten dir die ersten Schritte erleichtern, bitte nimm dir daher etwas Zeit, sie zu lesen.<br />
<br />
----<br />
'''FHEM-spezifische Informationen'''<br />
<br />
|-<br />
| width="8%" | &nbsp;<br />
| width="38%" | '''[[Systemübersicht]]'''<br />''FHEM Systemübersicht''<br />
| width="8%" | &nbsp;<br />
| width="38%" | '''[[FHEMWiki:Über FHEMWiki]]'''<br />''Informationen über dieses Wiki''<br />
<!-- Abschnitt auf Kommentar gesetzt<br />
|-<br />
| colspan="4" |<br />
----<br />
<br />
{{Todo|FHEM-spezifische Anleitungen und Regeln.}}<br />
<br />
---- <br />
Ende von 'Abschnitt auf Kommentar gesetzt' --><br />
|-<br />
| colspan="4" | <br />
----<br />
'''Generelle Informationen über (Media)Wikis'''<br />
|-<br />
| width="8%" | [[Datei:Crystal Clear app kedit.svg|rechts|30px|link=Hilfe:Bearbeiten]]<br />
| width="38%" | '''[[Hilfe:Bearbeiten]]'''<br />''Zugang zu allen wichtigen Informationen.''<br />
| width="8%" | [[Datei:X-office-presentation.svg|rechts|30px|link=Wikipedia:Tutorial]]<br />
| width="38%" | <!-- '''[[Wikipedia:Tutorial]]'''-->'''[http://de.wikipedia.org/wiki/Wikipedia:Tutorial Wikipedia:Tutorial]'''<br />''Schritt-für-Schritt-Anleitung für Einsteiger.''<br />
|-<br />
| [[Datei:Applications-system.svg|rechts|30px|link=Wikipedia:Grundprinzipien]]<br />
| '''<!--[[Wikipedia:Grundprinzipien]]-->[http://de.wikipedia.org/wiki/Wikipedia:Grundprinzipien Wikipedia:Grundprinzipien]'''<br />''Die grundlegende Philosophie unseres Projekts.''<br />
| [[Datei:MentorenProgrammLogo-7.svg|rechts|60px|link=Wikipedia:Mentorenprogramm]]<br />
| '''<!--[[Wikipedia:Mentorenprogramm]]-->[http://de.wikipedia.org/wiki/Wikipedia:Mentorenprogramm Wikipedia:Mentorenprogramm]'''<br />''Persönliche Einführung in die Beteiligung bei Wikipedia.''<br />
|-<br />
| colspan="4" |<br />
----<br />
Bitte beachte, <!--[[Wikipedia:Was Wikipedia nicht ist|was Wikipedia nicht ist]]-->[http://de.wikipedia.org/wiki/Wikipedia:Was_Wikipedia_nicht_ist was Wikipedia nicht ist], und "unterschreibe" deine Diskussionsbeiträge durch Eingabe von <code>--<nowiki>~~~~</nowiki></code> oder durch Drücken der Schaltfläche [[Datei:button_sig.png|Signaturknopf|20px|link=Hilfe:Signatur]] über dem Bearbeitungsfeld. Artikel werden jedoch nicht unterschrieben, und wofür die Zusammenfassungszeile da ist, erfährst du unter <!--[[wikipedia:Hilfe:Zusammenfassung und Quellen|Hilfe:Zusammenfassung und Quellen]]-->[http://de.wikipedia.org/wiki/Hilfe:Zusammenfassung_und_Quellen Zusammenfassung und Quellen]. <br /><br /><br />
[[Datei:Nuvola apps ksirc.png|25px|link=Benutzer Diskussion:Ph1959de]] &nbsp;&nbsp; '''Hast du Fragen an mich?''' Schreib mir auf [[Benutzer Diskussion:Ph1959de|<u>meiner</u> Diskussionsseite]]! Viele Grüße, [[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 13:31, 26. Dez. 2017 (CET)<br />
|}<br />
<br />
== Hochgeladene Dateien vom 10.7. ==<br />
<br />
Damian, Du hast gestern einige neue Dateien hochgeladen, es sind aber auch "ungenutzte Duplikate" dabei. Könntest Du bitte kontrollieren welche davon wirklich benötigt werden und die anderen löschen lassen?<br />
* DOIF-hover.gif - Duplikat von Datei:Hover.gif - Keine Seiten verwenden diese Datei<br />
* Hover.png - Keine Seiten verwenden diese Datei<br />
--[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 11:11, 11. Jul. 2023 (CEST)<br />
<br />
== Duplikate ==<br />
<br />
Offenbar kann ich mit meinen Rechten die Überflüssigen Grafiken nicht löschen.</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Perl-Modus&diff=38457DOIF/Perl-Modus2023-07-10T19:13:21Z<p>Damian-s: /* Eigener Namensraum: DOIF */</p>
<hr />
<div>[[Datei:Licht-Szenarien.png|600px|rechts|Licht-Automatisierung]]<br />
<br />
Das DOIF-Modul arbeitet im DOIF-Perl-Modus, wie auch im DOIF-FHEM-Modus, ereignisgesteuert. Ein Steuerungsablauf wird in Perl in DOIF-Perl-Blöcken programmiert. Innerhalb eines DOIF-Devices können mehrere DOIF-Perl-Blöcke programmiert werden, die durch passende Event- oder Zeittrigger unabhängig von einander zur Ausführung gebracht werden.<br />
<br />
Die Abläufe lassen sich, wie in höheren Programmiersprachen üblich, strukturiert programmieren. Es können innerhalb eines DOF-Devices eigene Perlfunktionen definiert und genutzt werden. Es werden ebenfalls sog. Templates (deutsch: Schablonen) unterstützt. Mit Hilfe eines Templates kann ein bestimmter Automatisierungsablauf für mehrere Szenarien in einem DOIF-Device erstellt werden.<br />
<br />
Zum Zeitpunkt der Definition werden alle DOIF-spezifischen Angaben in Perl übersetzt. Das garantiert zur Laufzeit eine maximal mögliche Performance.<br />
<br />
Genauso wie der DOIF-FHEM-Modus, lässt sich der DOIF-Perl-Modus mit Hilfe des [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg uiTable-Attributes] um eine Web-Oberfläche ergänzen. Auf diese Weise kann sowohl die Steuerung als auch die Benutzeroberfläche innerhalb eines Devices erstellt werden. In der Abbildung rechts sieht man eine [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien_mit_tabellarischer_.C3.9Cbersicht helligkeitsabhängige Lichtsteuerung für mehrere Szenarien] erstellt im DOIF-Perl-Modus mit einer Benutzeroberfläche.<br />
<br />
==Aufbau einer Definition im DOIF-Perl-Modus==<br />
<br />
Der Aufbau der Definition im DOIF-Perl-Modus wird in drei Bereiche unterteilt: '''DOIF-Perl-Blöcke''', '''Template-Definitionen''' und '''Template-Aufrufe'''. Die letzten beiden Bereiche sind optional, die Reihenfolge der drei Bereiche ist frei wählbar.<br />
<br />
<syntaxhighlight lang="perl"><br />
define <name> DOIF<br />
<DOIF-Perl-Blöcke><br />
<Template-Definitionen (optional)> <br />
<Aufrufe zuvor definierter Templates (optional)><br />
</syntaxhighlight><br />
<br />
===Aufbau eines DOIF-Perl-Blocks===<br />
<br />
<syntaxhighlight lang="perl"><br />
<Blockname (optional)> {<Perlcode mit Ereignis-/Zeittriggern>}<br />
</syntaxhighlight><br />
<br />
Ein DOIF-Perl-Block wird in Perl programmiert. Dabei muss man [https://wiki.fhem.de/wiki/DOIF/Perl-Modus#Ereignistrigger Ereignis-]/[https://wiki.fhem.de/wiki/DOIF/Perl-Modus#Zeittrigger Zeittrigger] in einer DOIF-spezifischen Syntax in eckigen Klammern im Programmcode einsetzen. Bei der Definition werden diese Angaben vom Modul ausgewertet, es werden intern entsprechende Trigger aufgesetzt, anschließend werden die Trigger-Angaben gegen interne Perlfunktionen ersetzt. So entsteht intern ein reiner Perl-Block, der zur Laufzeit ausgeführt wird, wenn ein Ereignis im System auftritt, welches zu den definierten Triggern des Blocks passt. Es können beliebig viele voneinander unabhängige Perl-Blöcke innerhalb eines DOIF-Devices definiert werden. Wird kein Name eines Perl-Blocks definiert, so wird der Block unter dem Namen '''block_<nr>''' intern geführt.<br />
<br />
'''Beispiel'''<br />
<br />
Definition eines DOIF-Perl-Blocks mit einem Ereignistrigger und einer Fallunterscheidung<br />
<br />
<syntaxhighlight lang="perl"><br />
<br />
defmod di_rc_tv DOIF \<br />
{ ## Beginn eines Perlblocks ohne Namen\<br />
if ([remotecontol:"on"]) ## Das Device "remotecontrol" triggert das Modul, wenn im Event "on" vorkommt\<br />
{fhem_set"tv on"} ## wird der Befehl "set tv on" ausgeführt\ <br />
else ## sonst\ <br />
{fhem_set"tv off"} ## wenn im Event "on" nicht kommt, wird "set tv off" ausgeführt\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Definition von zwei benannten DOIF-Perl-Blöcken mit Zeittriggern<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_clock_radio DOIF \<br />
radio_on { ## Beginn eines Perlblocks namens radio_on\ <br />
if ([06:30|Mo Di Mi] or [08:30|Do Fr Sa So]) ## zu definierten Zeitpunkten wird der Block getriggert\<br />
{fhem_set"radio on"} ## der Befehl "set radio on" wird ausgeführt\ <br />
} ## Ende des Perlblocks namens radio_on\<br />
\<br />
radio_off { ## Beginn eines Perlblocks namens radio_off\<br />
if ([08:00|Mo Di Mi] or [09:30|Do Fr Sa So]) ## zu definierten Zeitpunkten wird der Block getriggert\ <br />
{fhem_set"radio off"} ## der Befehl "set radio off" wird ausgeführt\ <br />
} ## Ende des Perlblocks namens radio_off<br />
</syntaxhighlight><br />
<br />
===Aufbau einer Template-Definition===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
[https://wiki.fhem.de/wiki/DOIF/Templates DOIF-Templates]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<DOIF-Block-Definition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
<br />
Die Definition eines Templates ist optional. Sie bietet sich dann an, wenn mehrere gleich aufgebaute Abläufe (hier Szenen) definiert werden sollen. Eine Template-Definition beginnt mit '''DEF''' gefolgt vom Namen des Templates welches mit '''TPL_''' beginnen muss. Anschließend wird eingefasst in runde Klammern ein Perl-Block programmiert. Variable Stellen innerhalb des Perl-Blocks werden mit Platzhaltern: $1, $2, usw. angegeben. Diese werden beim Aufruf des Templates gegen konkrete Angaben ersetzt. Insbesondere können so verschiedene Ereignis- oder Zeittrigger in den zuvor programmierten Ablauf eingesetzt werden.<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block namens light_<Szene>\<br />
## Platzhalter für: Szenennamen Daemmerungssensor Zeitspanne on-Befehl(e) off-Befehl(e)\<br />
## Nr. des Platzhalters: $1 $2 $3 $4 $5\<br />
if (($3) and [$2] eq "on") { ## Innerhalb Zeitspanne (hier $3) und wenn Dämmerung (hier $2) gleich on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls auf den Szenennamen\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
} ## Ende des Perl-Blocks\<br />
) ## Ende der Templatedefinition\<br />
</syntaxhighlight><br />
<br />
===Aufruf eines Templates===<br />
<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...>)<br />
</syntaxhighlight><br />
<br />
Ein Template wird durch die Angabe des zuvor definierten Template-Namens aufgerufen. Hinter dem Template-Namen werden in runden Klammern kommagetrennten Angaben für die Platzhalter $1, $2, usw. gemacht. Durch den Aufruf wird intern ein Perl-Block generiert, bei dem alle Platzhalter im definierten Perl-Block des Templates gegen konkrete Angaben getauscht wurden.<br />
<br />
'''Beispiele'''<br />
<br />
Das oben definierte Beispiel-Template wird für zwei verschiedene Szenarien benutzt. Hierbei entstehen mit dem im Template definierten Ablauf zwei Perl-Blöcke, die unabhängig von einander arbeiten.<br />
<br />
<syntaxhighlight lang="perl"><br />
TPL_light (Erdgeschoss,Daemmerung2,[06:25-08:00|8] or [15:00-23:00],"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off")\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off")<br />
</syntaxhighlight><br />
<br />
===Ereignistrigger===<br />
In einem DOIF-Perl-Block sollte mindestens eine Ereignis- oder Zeittriggerangabe vorkommen. Diese Angabe ist erforderlich, damit der Perl-Block beim passenden Event oder der angegeben Zeit ausgeführt wird. Sie wird grundsätzlich in eckigen Klammern angegeben und bei der Definition intern gegen eine Perlfunktion ersetzt, die einen Rückgabewert bei ihrer Ausführung liefert. <br />
<br />
====Eventtrigger mit Inhalt====<br />
'''Inhalt des Internals STATE'''<br />
<syntaxhighlight lang="perl"><br />
[<device>] reagiert auf alle Events vom angegebenen Device, Rückgabewert: STATE des Devices (nicht das Reading state des Devices)<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_lamp DOIF {if ([lamp] eq "on) {fhem("push lamp on")}}<br />
</syntaxhighlight><br />
'''Inhalt eines Readings'''<br />
<syntaxhighlight lang="perl"><br />
[<device>:<reading>] reagiert auf alle Events vom angegebenen Device mit dem angegebenen Reading, Rückgabewert: Inhalt des Readings des Devices<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_lamp DOIF {if ([lamp:state] eq "on) {fhem("push lamp on")}}<br />
</syntaxhighlight><br />
<br />
====Eventtrigger mit Rückgabewert wahr/falsch====<br />
'''Eventtrigger für ein bestimmtes Device'''<br />
<syntaxhighlight lang="perl"><br />
[<device>:"<Regex-Events>"] reagiert auf alle Events vom angegebenen Device, Rückgabewert: wahr (true) zum Zeitpunkt des Events, wenn der Regex-Ausdruck passt, sonst falsch (false)<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_button DOIF {if ([button:"^btn1:"]) {fhem_set("lamp on")}} # die if-Bedingung ist wahr und führt zur Ausführung, wenn vom Device button, das Event beginnend mit btn1: vorkommt<br />
</syntaxhighlight><br />
'''Eventtrigger für mehrere Devices'''<br />
<syntaxhighlight lang="perl"><br />
["<Regex-Devices>:<Regex-Events>"] reagiert auf Events mit Devices mit Events, die den jeweiligen Regex-Angaben entsprechen, Rückgabewert: wahr (true) zum Zeitpunkt des Events, sonst falsch (false)<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_window DOIF {if (["^window:on$"]) {fhem("push window $device on")}} # die Bedingung ist wahr und führt zur Ausführung, wenn ein Devices beginnend mit window ein Event endend mit on liefert<br />
</syntaxhighlight><br />
<br />
===Zeittrigger===<br />
====Zeittrigger zu einer bestimmten Uhrzeit====<br />
<syntaxhighlight lang="perl"><br />
[<time>] der Zeitpunkt-Trigger mit <time>: HH:MM, HH:MM:SS triggert seinen Perl-Block zum angegebenen Zeitpunkt, Rückgabewert: wahr (true) zum Triggerzeitpunkt, sonst falsch (false)<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_pump DOIF {if ([10:00] or [11:00:30]) {fhem_set("pump on-for-timer 300")}} # um 10:00 Uhr und um 11:00:30 wird der entsprechende Perl-Block ausgeführt, die if-Bedingung ist zu diesen beiden Zeitpunkten wahr und führt zur Ausführung der Anweisung<br />
<br />
</syntaxhighlight><br />
<br />
====Zeitintervalle====<br />
<syntaxhighlight lang="perl"><br />
[<begin>-<end>] <begin>, <end> als HH:MM, HH:MM:SS, triggert seinen Perl-Block zu <begin>-Zeit und zu <end>-Zeit, das Intervall ist ab <begin>-Zeitpunkt wahr und ab <end>-Zeitpunkt falsch<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_lamp_on_off DOIF {if ([10:00-22:00]) {fhem_set("lamp on")} else {fhem_set("lamp off")}} # um 10:00 Uhr und um 22:00 Uhr wird der entsprechende Perl-Block getriggert, die if-Bedingung ist ab 10:00 Uhr wahr, lamp wird eingeschaltet, um 22:00 uhr ist die if-Bedingung nicht mehr wahr, lamp wird ausgeschaltet<br />
</syntaxhighlight><br />
<br />
====indirekte Zeitangaben====<br />
'''Zeittrigger, deren Zeitangabe in einem Reading gespeichert wird'''<br />
<syntaxhighlight lang="perl">[[<device>:<reading>]] im angegebenen Reading muss eine gültige Zeitangabe als HH:MM, HH:MM:SS stehen, um diese Zeit wird der entsprechende Perl-Block ausgeführt, die Bedingung ist dann wahr, sonst falsch<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
{if ([[mydevice:time]]) {fhem_set("lamp on")}} # zum Zeitpunkt, der sich im Reading time des Devices mydevice wird der Perl-Block getriggert, die if-Bedingung ist wahr und lamp wird eingeschaltet<br />
<br />
{if ([[mydevice:from]-[mydevice:to]]) {fhem_set("lamp on")} else {fhem_set("lamp off")}} # im Zeitintervall from-to brennt lamp, sonst ist sie aus<br />
</syntaxhighlight><br />
<br />
====relative Zeitangaben====<br />
'''Zyklischer Trigger im zeitlichen Abstand'''<br />
<syntaxhighlight lang="perl"><br />
[+<time>] <time> als HH:MM, HH:MM:SS oder Zahl in Sekunden<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
{[+00:30];fhem("save")} # sichern der Konfiguration alle 30 Minuten<br />
</syntaxhighlight><br />
<br />
====ausgerichtete Zeittrigger====<br />
'''X-Minuten nach einer vollen Stunde'''<br />
<syntaxhighlight lang="perl"><br />
[:MM] mit MM sind Minutenangaben zwischen 00 und 59<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
{[:15];[:45];fhem_set("pump on-for-timer 300")} # Pumpe 15 und 45 Minuten nach einer vollen Stunde für 5 Minuten einschalten<br />
</syntaxhighlight><br />
'''Alle X-Minuten ab einer vollen Stunde'''<br />
<syntaxhighlight lang="perl"><br />
[+:MM] mit MM in Minuten als Teiler von 60, sinnvolle Angaben sind: 02, 03, 04, 05, 06, 10, 12, 15, 20, 30<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
{[+:15];fhem_set("pump on-for-timer 300")} # Pumpe um HH:00, HH:15, HH:30, HH:45 für fünf Minuten einschalten <br />
</syntaxhighlight><br />
'''X-Minuten nach einer vollen Stunde, alle X-Stunden'''<br />
<syntaxhighlight lang="perl"><br />
[+[h]:MM] mit MM in Minuten zwischen 1 und 59, h in Stunden als Teiler von 24, sinnvolle Angaben für h sind: 2, 3, 4, 6, 8, 12<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
{[+[4]:05]; fhem_set("pump on-for-timer 300")} # Pumpe um 00:05, 04:05, 08:05, 12:05, 16:05, 20:05 Uhr für fünf Minuten einschalten<br />
</syntaxhighlight><br />
<br />
====Wochentagsteuerung====<br />
'''Zeittrigger an bestimmen Wochen-/Ferientagen'''<br />
<syntaxhighlight lang="perl"><br />
[<time-trigger>|0123456789] Bedeutung: 0 bis 6 für So. bis Sa., 7 Wochenende oder Feiertag, 8 Werktags, 9 Wochenende oder Feiertag am kommenden Tag<br />
alternativ <br />
[<time-trigger>|So Mo Di Mi Do Fr Sa WE AT MWE] WE entspricht der Ziffer 7, AT der Ziffer 8 und MWE der Ziffer 9<br />
oder<br />
[<time-trigger>|Su Mo Tu We Th Fr Sa WE WD TWE] WE entspricht der Ziffer 7, WD der Ziffer 8 und TWE der Ziffer 9<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_lamp DOIF\<br />
{[22:00|Sa];;fhem_set("lamp on")}\<br />
{[08:00|Mo];;fhem_set("lamp off")}<br />
</syntaxhighlight><br />
<br />
====Intervall-Timer====<br />
'''Zyklischer Zeittrigger innerhalb einer Zeitspanne'''<br />
<syntaxhighlight lang="perl"><br />
[<begin>-<end>,<relativ timer>] triggert zu den aus <relativ timer> berechneten Zeitpunkten im angegebenen Zeitintervall <begin>-<end><br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_pump DOIF {[08:00-22:00,+:30];;fhem_set("pump on-for-timer 300")} # von 08:00 Uhr bis 22:00 Uhr wird Pumpe alle 30 Minuten eingeschaltet, erste Schaltpunkt ist um 08:00 Uhr, der letzte um 21:30 Uhr<br />
</syntaxhighlight><br />
<br />
===Trigger unterbinden===<br />
<br />
Soll eine Ereignis-/Zeitangabe nicht triggern, so lässt sich die Triggerung durch ein vorangestelltes Fragezeichen unterbinden.<br />
<br />
<syntaxhighlight lang="perl"><br />
[?<Triggerangabe>] <Triggerangabe> kann eine Ereignis- oder Zeitangabe sein<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_lamp DOIF \<br />
{ # hier triggert nur [darkness:state], dagegen wird das Zeitintervall nur abgefragt, \<br />
if ([darkness:state] eq "on" and [?15:00-22:00]) { # es gibt keinen Trigger um 15:00 Uhr bzw. um 22:00 Uhr \<br />
fhem_set("lamp on") \ <br />
} else { \<br />
fhem_set("lamp off") \<br />
} \<br />
} <br />
</syntaxhighlight><br />
<br />
===Aggregationsfunktionen===<br />
{{Randnotiz|RNText=Aggregationsfunktion<br />
<syntaxhighlight lang="perl"><br />
[<function>:<format>:"<regex device>:<regex event>":<reading>:<condition>,<default>]<br />
<br />
<function>: #, @, #sum, #max, #min, #average, #median, @max, @min<br />
# Anzahl der betroffenen Devices, @ kommagetrennte Liste Devices<br />
#sum Summe, #max höchster Wert, #min niedrigster Wert, #average Durchschnitt, #median Medianwert<br />
@max Device des höchsten Wertes, @min Device des niedrigsten Wertes<br />
<br />
<format>: d<number>, a, s(<splittoken>)<br />
d<number> zum Runden des Wertes mit Nachkommastellen, a für Aliasnamen bei Devicelisten, s(<splittoken>) <splittoken> sind Trennzeichen in der Device-Liste<br />
<br />
"<regex Device>:<regex Event>" spezifiziert sowohl die betroffenen Devices, als auch den Ereignistrigger, die Syntax entspricht der DOIF-Syntax für Ereignistrigger.<br />
<br />
<reading> konkretes Reading, welches überprüft werden soll<br />
alternativ eine Regex in Anführungszeichen<br />
"<regex reading>" Regex für Readings, die überprüft werden sollen<br />
<br />
<condition> Aggregationsbedingung<br />
wird <condition> in Anführungszeichen gesetzt, so werden Reading mit eq mit dem angegebenen Wert verglichen. Sonst kann ein Perlausdruck angegeben werden. Folgende Variablen sind vorbelegt und können im Perlausdruck benutzt werden:<br />
<br />
$_ Inhalt des Readings<br />
$number Nach Zahl gefilteres Reading<br />
$name Name des Devices<br />
$reading Name des Readings<br />
$TYPE Devices-Typ<br />
$STATE Status des Devices (nicht das Reading state)<br />
$room Raum des Devices<br />
$group Gruppe des Devices<br />
<br />
<default> Default-Wert, falls kein Device gefunden wird, entspricht der Syntax des Default-Wertes bei Readingangaben<br />
<br />
<format>, <reading>, <condition>, <default> sind optional<br />
<br />
</syntaxhighlight><br />
}}<br />
Mit Hilfe einer Aggregationsfunktion können mehrere Readings im System ausgewertet werden, die einem bestimmten Kriterium entsprechen. Die Filterkriterien können mit Hilfe von Regex-Ausdrücken für Devices, Events und Readings angegeben werden. Die Aggregationsangabe wirkt triggernd, soll sie nicht triggern, so muss ein Fragezeichen vorangestellt werden, siehe [https://wiki.fhem.de/wiki/DOIF/Perl-Modus#Trigger_unterbinden Trigger unterbinden]<br />
<br />
<syntaxhighlight lang="perl"><br />
[<function>:<format>:"<regex device>:<regex event>":<reading>:<condition>,<default>]<br />
</syntaxhighlight><br />
<br />
'''Beispiele'''<br />
<br />
Offene Fenster anzeigen. Wenn ein Device beginnend mit "window" im Namen ein Event sendet, dann wird bei allen Devices im System, deren Name mit "window" beginnt, status auf "open" geprüft. Diese werden im Status von di_windows angezeigt. Wird kein Device mit status "open" gefunden, so wird der Default-Wert "keine" übernommen. <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_windows DOIF init {set_State([@:"^window":state:"open","keine"])}<br />
</syntaxhighlight><br />
<br />
Durchschnittstemperatur aller Temperatursensoren in der Gruppe "livingroom" gerundet auf 2 Nachkommastellen. Wenn ein Event von irgendeinem Device beginnend mit "temperature" auftritt, dann werden alle Devices im System durchsucht, die ein Reading namens "temperature" besitzen und sich in der Gruppe "livingroom" befinden. <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_average_temp DOIF init {set_State ([#average:d2:":^temperature":temperature:$group eq "livingroom"])}<br />
</syntaxhighlight><br />
<br />
Um 18:00 Uhr werden alle Devices im System durchsucht, deren Reading "battery" nicht "ok" ist. Damit die Aggregationsangabe den DOIF-Perl-Block nicht triggert, muss am Anfang der Angabe ein Fragezeichen vorangestellt werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_batterie_not_ok DOIF init {[18:00];;set_State([?@:":battery":battery:$_ ne "ok","alle OK"])}<br />
</syntaxhighlight><br />
<br />
Um 18:00 Uhr werden alle Devices im System durchsucht, die ein Reading namens "Battery" oder "battery" haben. Bei diesen Readings wird die letzte Aktualisierung geprüft. Wenn sie älter als 24 Stunden ist, dann wird dessen Device in die Liste aufgenommen. Im Status des Moduls befinden sich danach alle Devices, deren Batterie-Reading länger nicht aktualisiert wurde.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_batteriecheck DOIF init {[18:00];;set_State([?@:"":"^[Bb]attery$":ReadingsAge($name,$reading,0) > 3600*24,"keine"])}<br />
</syntaxhighlight><br />
<br />
Das Modul wird getriggert wenn ein beliebiges Device ein Event beginnend mit "temperature" sendet, es werden daraufhin alle Devices nach dem Reading "temperature" durchsucht und der maximale/minimale Wert im Reading max/min von di_min_max gespeichert.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_min_max DOIF\<br />
{set_Reading("max",[#max:":^temperature":temperature])}\<br />
{set_Reading("min",[#min:":^temperature":temperature])}<br />
</syntaxhighlight><br />
<br />
==Für Umsteiger vom DOIF-FHEM-Modus==<br />
Der Status des Moduls wird nicht vom Modul gesetzt, er kann vom Anwender mit Hilfe der Funktion '''set_State''' verändert werden, siehe spezifische Perl-Funktionen im Perl-Modus. FHEM-Befehle werden durch den Aufruf der Perlfunktion fhem("...") ausgeführt. Für den häufig genutzten fhem-Befehl '''set''' wurde eine kompatible Perlfunktion namens '''fhem_set''' definiert. Sie ist performanter und sollte bevorzugt verwendet werden, da das Parsen nach dem FHEM set-Befehl entfällt.<br />
<br />
Der Benutzer kann mit der Funktion '''set_Exec''' beliebig viele eigene Timer definieren, die unabhängig voneinander gesetzt und ausgewertet werden können, siehe spezifische Perl-Funktionen im Perl-Modus.<br />
<br />
Definitionen im FHEM-Modus mit do always-Attribut der Form:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF (<Bedingung mit Trigger>) (<FHEM-Befehle>) DOELSE (<FHEM-Befehle>)<br />
</syntaxhighlight><br />
<br />
lassen sich wie folgt in Perl-Modus übertragen:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF {if (<Bedingung mit Trigger>) {fhem("<FHEM-Befehle>")} else {fhem("<FHEM-Befehle>")}}<br />
</syntaxhighlight><br />
<br />
Im Gegensatz zum FHEM-Modus arbeitet der Perl-Modus ohne Auswertung des eigenen Status (Zustandsauswertung), daher muss der Anwender selbst darauf achten, wiederholende Ausführungen zu vermeiden. Elegant lässt sich das Problem der wiederholenden Ausführung bei zyklisch sendenden Sensoren mit Hilfe des Attributes '''DOIF_Readings''' lösen.<br />
<br />
'''Beispiel'''<br />
<br />
Heizung soll bei einer Temperatur unter 21 Grad eingeschaltet werden, sonst soll sie ausgeschaltet werden. Das Unterschreiten bzw. Überschreiten der Wunschtemperatur wird über die Definition des Readings '''cold''' realisiert. Obwohl der Temperatursensor zyklisch seine Daten sendet, triggert das Reading '''cold''' das eigene Modul und führt zum Schalten der Heizung nur wenn sich sein Zustand (on/off) ändert.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Threshold DOIF { \<br />
if ([$SELF:cold] eq "on") { # wenn es kalt ist\<br />
fhem_set("heating on");; # Heizung einschalten\<br />
set_State ("heating");; # Status auf 'heating' setzen\<br />
} else { # sonst\<br />
fhem_set("heating off");; # Heizung ausschalten\<br />
set_State ("not heating");;# Status auf 'not heating' setzen\<br />
} \<br />
}<br />
attr di_Threshold DOIF_Readings cold: ([room:temperature] < 21 ? "on" : "off")<br />
</syntaxhighlight><br />
<br />
<br />
Es können beliebig viele Perl-Blöcke definiert werden, die unabhängig von einander durch einen oder mehrere Trigger ausgewertet und zur Ausführung führen können:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF<br />
{ if (<Bedingung mit Triggern>) ... } ## erster Block<br />
{ if (<Bedingung mit Triggern>) ... } ## zweiter Block<br />
...<br />
</syntaxhighlight><br />
<br />
Einzelne Ereignis-/Zeittrigger, die nicht logisch mit anderen Bedingungen oder Triggern ausgewertet werden müssen, können auch ohne if-Anweisung angegeben werden, z. B.:<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_einschalten DOIF\<br />
{["Daemmerung:on"];;fhem_set("lamp on")}\<br />
{[08:00];;fhem_set("radio on")}<br />
</syntaxhighlight><br />
<br />
Ereignis-/Zeittrigger sind intern Perlfunktionen, daher können sie an beliebiger Stelle im Perlcode angegeben werden, wo Perlfunktionen vorkommen dürfen.<br />
<br />
'''Beispiele'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_log DOIF {Log 1,"state of lamp: ".[lamp:state]}<br />
<br />
defmod di_set_lamp DOIF {fhem_set("lamp ".[remote:state])}<br />
</syntaxhighlight><br />
<br />
Innerhalb eines Perlblocks sind beliebige Hierarchietiefen möglich, dabei kann der Trigger irgendwo innerhalb des Blocks vorkommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF<br />
{ if (<Bedingung>) {<br />
if (<Bedingung>) {<br />
if (<Bedingung mit Triggern>...<br />
...<br />
}<br />
}<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
'''Bemerkung'''<br />
<br />
Innerhalb eines DOIF-Perl-Blocks muss mindestens ein Trigger definiert werden. Zu beachten ist, dass beim passenden Trigger nicht nur ein Zweig, sondern der gesamte Block ausgeführt wird.<br />
<br />
==Eigene Funktionen==<br />
<br />
Ein besonderer Perl-Block ist der Block namens '''subs'''. In diesem Block werden Perlfunktionen definiert, die innerhalb des DOIFs genutzt werden, sie befinden sich im Package DOIF und können in den folgenden Perl-Blöcken benutzt werden. Um eine möglichst hohe Kompatibilität zu Perl sicherzustellen, wird im '''subs-Block''' keine DOIF-Syntax in eckigen Klammern unterstützt, insb. gibt es keine Trigger, die den Block ausführen können.<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF subs { ## Definition von Perlfunktionen lamp_on und lamp_off<br />
sub lamp_on {<br />
fhem_set("lamp on");<br />
set_State("on");<br />
}<br />
sub lamp_off {<br />
fhem_set("lamp off");<br />
set_State("off");<br />
}<br />
}<br />
{[06:00];lamp_on()} ## Um 06:00 Uhr wird die Funktion lamp_on aufgerufen<br />
{[08:00];lamp_off()} ## Um 08:00 Uhr wird die Funktion lamp_off aufgerufen<br />
</syntaxhighlight><br />
<br />
'''Eigene Funktionen mit Parametern'''<br />
<br />
Unter Verwendung von Funktionsparameter lassen sich Definitionen oft vereinfachen, das obige Beispiel lässt sich mit Hilfe nur einer Funktion kürzer wie folgt definieren:<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF subs { ## Definition der Perlfunktion lamp<br />
sub lamp {<br />
my ($state)=@_; # Variable $state mit dem Parameter belegen<br />
fhem_set("lamp $state");<br />
set_State($state);<br />
}<br />
}<br />
{[06:00];lamp("on")} ## Um 06:00 Uhr wird die Funktion lamp mit Parameter "on" aufgerufen<br />
{[08:00];lamp("off")} ## Um 08:00 Uhr wird die Funktion lamp mit dem Parameter "off" aufgerufen<br />
</syntaxhighlight><br />
<br />
==Eigener Namensraum: DOIF==<br />
<br />
Der Namensraum im DOIF-Perl-Modus ist gekapselt. Selbstdefinierte Funktionen im DOIF-Device können nicht bereits existierende Perlfunktionen in FHEM (Namensraum main) überschreiben. Funktionen aus dem Namensraum '''main''' müssen mit vorangestelltem Doppelpunkt angegeben werden: '''::<perlfunction>'''. Variablen aus dem Namensraum '''main''' werden wie folgt angegeben: '''$::<Variablenname>'''-<br />
<br />
Eigene Perlfunktionen, die in myutils ausgelagert sind, befinden sich ebenfalls im Namensraum main. Wenn sie ausschließlich in DOIF-Devices benutzt werden sollen, so kann am Anfang vor deren Definition in myutils '''package DOIF;''' angegeben werden. In diesen Fall sind auch diese Funktion im DOIF-Device bekannt - sie können dann ohne vorangestellten Doppelpunkt genutzt werden.<br />
<br />
Folgende FHEM-Perlfunktionen wurden ebenfalls im DOIF-Namensraum definiert, sie können, wie gewohnt ohne Doppelpunkt genutzt werden:<br />
<br />
'''fhem, Log, Log3, InternVal, InternalNum, OldReadingsVal, OldReadingsNum, OldReadingsTimestamp, OldReadingsAge, ReadingsVal, ReadingsNum, ReadingsTimestamp, ReadingsAge, Value, OldValue, OldTimestamp, AttrVal, AttrNum<br />
'''<br />
<br />
==Spezifische Perl-Funktionen im Perl-Modus==<br />
Die folgenden Perl-Funktionen befinden sich im Package DOIF, sie können in der DOIF-Definition unmittelbar genutzt werden.<br />
===FHEM-set-Befehl ausführen: '''fhem_set()'''===<br />
<syntaxhighlight lang="perl"><br />
fhem_set(<content>); mit <content> Angaben des FHEM-set-Befehls<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Lampe namens '''lamp''' ausschalten:<br />
<br />
<syntaxhighlight lang="perl"><br />
fhem_set("lamp off");<br />
</syntaxhighlight><br />
<br />
entspricht:<br />
<br />
<syntaxhighlight lang="perl"><br />
fhem("set lamp off");<br />
</syntaxhighlight><br />
<br />
Der Aufruf der fhem_set-Funktion ist performanter, da das Parsen nach dem set-Befehl mit Hilfe der Funktion '''fhem''' entfällt.<br />
<br />
===Ein FHEM-Event auslösen: '''set_Event()'''===<br />
<syntaxhighlight lang="perl"><br />
set_Event(<Event>); mit <Event> das zu generierende FHEM-Event<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<br />
Generiere das Event '''on''':<br />
<br />
<syntaxhighlight lang="perl"><br />
set_Event("on");<br />
</syntaxhighlight><br />
<br />
===Eigenen Status setzen: '''set_State()'''===<br />
<syntaxhighlight lang="perl"><br />
set_State(<value>,<trigger>); mit <trigger>: 0 ohne Trigger, 1 mit Trigger, <trigger> ist optional, default ist 1<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Status des eignen DOIF-Device auf '''on''' setzen:<br />
<br />
<syntaxhighlight lang="perl"><br />
set_State("on");<br />
</syntaxhighlight><br />
<br />
===Status des eigenen DOIF-Devices auslesen: '''get_State()'''===<br />
Die Funktion besitzt keine Parameter.<br />
<br />
'''Beispiel'''<br />
<br />
Schalte Lampe namens '''lamp''' mit dem Status des eigenen DOIF-Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
fhem_set("lamp ".get_State());<br />
</syntaxhighlight><br />
<br />
===Reading des eigenen DOIF-Devices setzen: '''set_Reading()'''===<br />
<syntaxhighlight lang="perl"><br />
set_Reading(<readingName>,<value>,<Event>); mit <Event>: 0 ohne Eventgenerierung, 1 mit Eventgenerierung, <Event> ist optional, default ist 0<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
set_Reading("weather","cold");<br />
</syntaxhighlight><br />
<br />
===Reading des eigenen DOIF-Devices auslesen: '''get_Reading()'''===<br />
<br />
'''Beispiel'''<br />
<br />
Schalte Lampe mit dem Inhalt des Readings namens '''dim''':<br />
<syntaxhighlight lang="perl"><br />
fhem_set("lamp ".get_Reading("dim"));<br />
</syntaxhighlight><br />
<br />
===Setzen mehrerer Readings des eigenen DOIF-Devices in einem Eventblock===<br />
<syntaxhighlight lang="perl"><br />
set_Reading_Begin();<br />
set_Reading_Update(<readingName>,<value>,<change>); <change> ist optional<br />
set_Reading_End(<Event>); mit <Event>: 0 ohne Eventgenerierung, 1 mit Eventgenerierung<br />
</syntaxhighlight><br />
<br />
Die obigen Funktionen entsprechen den FHEM-Perlfunktionen: '''readingsBegin, readingsBulkUpdate, readingsEndUpdate'''.<br />
<br />
'''Beispiel'''<br />
<br />
Die Readings '''temperature''' und '''humidity''' sollen in einem Eventblock mit dem zuvor belegten Inhalt der Variablen '''$temp''' bzw. '''$hum''' belegt werden:<br />
<syntaxhighlight lang="perl"><br />
set_Reading_Begin;<br />
set_Reading_Update("temperature",$temp);<br />
set_Reading_Update("humidity",$hum);<br />
set_Reading_End(1);<br />
</syntaxhighlight><br />
<br />
==Interne Timer==<br />
<br />
Mit Hilfe von Timern können Perl-Anweisungen verzögert ein- oder mehrmalig ausgeführt werden. Im Gegensatz zum wait-Timer im DOIF-FHEM-Modus, können beliebig viele Timer gleichzeitig genutzt werden. Ein Timer wird mit einem Timer-Namen eindeutig definiert. Über den Timer-Namen kann die Restlaufzeit abgefragt werden, ebenfalls kann er vor seinem Ablauf gelöscht werden.<br />
<br />
===Timer setzen: '''set_Exec()'''===<br />
<syntaxhighlight lang="perl"><br />
set_Exec(<timerName>, <seconds>, <perlCode>, <paramRef>, <condition>);<br />
<br />
<timerName>: beliebige Angabe, sie spezifiziert eindeutig einen Timer<br />
<br />
<seconds>: Verzögerungszeit, sie wird per eval-Perlbefehl ausgewertet und kann daher Perlcode zur Bestimmung der Verzögerungszeit beinhalten<br />
<br />
<perlCode>: Perl-Anweisung, die nach Ablauf der Verzögerungszeit per eval-Perlbefehl ausgeführt wird<br />
<br />
<paramRef>: wird unter <perlCode> eine Perlfunktion angegeben, so kann optional hier eine Referenz auf den Übergabeparameter der Perlfunktion angegeben werden<br />
<br />
<condition>: optionale Bedingung zur Wiederholung der Perl-Ausführung. Sie wird per eval-Perlbefehl vor dem Setzen des Timers und vor der Ausführung der Perl-Anweisung auf wahr geprüft. Bei falsch wird die Wiederholung der Ausführungskette beendet. Wird <condition> nicht angegeben, so erfolgt keine Wiederholung der Perl-Anweisung.<br />
</syntaxhighlight><br />
<br />
Wird '''set_Exec''' mit dem gleichen Timer-Namen '''<timerName>''' vor seinem Ablauf erneut aufgerufen, so wird der laufender Timer gelöscht und neugesetzt.<br />
<br />
===Anwendungsbeispiele für einmalige verzögerte Ausführung===<br />
<br />
'''Beispiel'''<br />
<br />
Funktion namens '''lamp''' mit dem Übergabeparameter '''on''' 30 Sekunden verzögert aufrufen:<br />
<br />
<syntaxhighlight lang="perl"><br />
set_Exec("lamp_timer",30,'lamp("on")');<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Lampe verzögert um 30 Sekunden ausschalten:<br />
<br />
<syntaxhighlight lang="perl"><br />
set_Exec("off_timer",30,'fhem_set("lamp off")');<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Das Event '''off''' 30 Sekunden verzögert generieren:<br />
<br />
<syntaxhighlight lang="perl"><br />
set_Exec("Event_timer",30,'set_Event("off")');<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Funktion namens '''check_shutters''' wird mit einer Referenz auf ein zuvor definiertes Array namens '''shutters''' um 5 Sekunden verzögert ausgeführt:<br />
<br />
<syntaxhighlight lang="perl"><br />
set_Exec("check_timer",5,"check_shutters",\@shutters);<br />
</syntaxhighlight><br />
<br />
===Anwendungsbeispiele mit bedingter Wiederholung einer Ausführung===<br />
<br />
'''Beispiel'''<br />
<br />
Wenn Alarm ausgelöst wird, soll eine Benachrichtigung gesendet werden und alle 60 Sekunden wiederholt werden, solange Alarmanlage auf '''on''' steht:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_alarm DOIF {["alarm:on"];;fhem("send myphone alarm!");;set_Exec("timer",60,'fhem("send myphone alarm!")','ReadingsVal("alarm","state","on") eq "on"')}<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Wenn Taster auslöst, Lampe auf '''on''' schalten und noch zwei mal im Abstand von einer Sekunde wiederholt auf '''on''' schalten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_lamp_on DOIF {["button:on"];;fhem_set"lamp on";;set_Exec("timer",1,'fhem_set("lamp on")','$count < 2')}<br />
</syntaxhighlight><br />
<br />
alternativ:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_lamp_on DOIF {["button:on"];;set_Exec("timer",'$count == 0 ? 0 : 1','fhem_set("lamp on")','$count < 2')}<br />
</syntaxhighlight><br />
'''$count''' ist eine interne Variable, die beginnend bei 0 nach jedem Durchlauf um eins erhöht wird.<br />
<br />
'''Beispiel'''<br />
<br />
Wenn Fenster geöffnet wird, dann soll eine Benachrichtigung erfolgen, dabei soll die Benachrichtigung bis zu 10 mal jeweils um weitere 60 Sekunden verzögert werden: erste Benachrichtigung nach 5 Minuten, zweite Benachrichtigung nach weiteren 6 Minuten, dritte Benachrichtigung nach weiteren 7 Minuten usw.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_window DOIF {if ([window:state] eq "open") {\<br />
set_Exec("timer",'300+$count*60','fhem("echo speak window open")','$count < 9')\<br />
} else {\<br />
del_Exec("timer")\<br />
}\<br />
}<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Pumpe alle zwei Stunden im Abstand von fünf Minuten 3 mal einschalten, beim ersten mal für 60 Sekunden, beim zweiten mal für 80 Sekunden und beim dritten mal für 100 Sekunden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_pump DOIF {[08:00-20:00,+[2]:00];;set_Exec("timer",300,'fhem_set("pump on-for-timer ".60+$count*20)','$count < 3')}<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Hochdimmen beim Tastendruck im Sekundentakt.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_dimm DOIF {["button:on"];;@{$_pct}=(10,35,65,80,90,100);;set_Exec("timer",1,'fhem_set"lamp pct ".$_pct[$count]','$count < 6')}<br />
</syntaxhighlight><br />
<br />
'''$_pct''' ist hier ein Array mit Helligkeitswerten, auf das innerhalb des Devices zu jedem Zeitpunkt zugegriffen werden kann.<br />
<br />
===Restzeit des Timers bestimmen: '''get_Exec()'''===<br />
<syntaxhighlight lang="perl"><br />
get_Exec(<timerName>); Returnwert: 0, wenn Timer abgelaufen oder nicht gesetzt ist, sonst Anzahl der Sekunden bis zum Ablauf des Timers<br />
</syntaxhighlight><br />
<br />
===Laufenden Timer löschen: '''del_Exec()'''===<br />
<syntaxhighlight lang="perl"><br />
del_Exec(<timerName>); <timeName> Name des Timers<br />
</syntaxhighlight><br />
<br />
==init-Block==<br />
<br />
Wird ein DOIF-Perl-Block mit dem Namen '''init''' benannt, so wird dieser Block beim Systemstart von FHEM ausgeführt.<br />
<br />
'''Beispiel'''<br />
<br />
Lampe um 22:00 Uhr oder wenn das FHEM-System hochgefahren wird ausschalten:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_lamp_off DOIF init {[22:00];;fhem_set("lamp off")}<br />
</syntaxhighlight><br />
<br />
==Device-Variablen==<br />
<br />
Device-Variablen sind sogenannte Instanzvariablen, die global innerhalb eines DOIF-Devices genutzt werden können. Deren Inhalt bleibt von Trigger zu Trigger während der Laufzeit des System erhalten. Sie beginnen mit '''$_''' und müssen nicht mit '''my''' deklariert werden. Intern handelt es sich um hash-Variablen des jeweiligen DOIF-Devices.<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_var DOIF\<br />
init {$_myvalue=10} ## nach dem Starten des FHEM-System Variable namens $_myvalue mit dem Wert 10 initialisieren\<br />
{[+:30];;fhem_set("mydevice $_myvalue");;$_myvalue++} ## alle 30 Minuten set mydevice mit dem Wert von $_myvalue ausführen und diesen anschließend um eins erhöhen<br />
</syntaxhighlight><br />
<br />
Wenn eine Instanzvariable nicht initialisiert wird, gilt sie als nicht definiert. Das lässt sich mit dem Perlbefehl '''define''' abfragen.<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
if (!defined $_value) ($_value=30);<br />
</syntaxhighlight><br />
<br />
Instanzvariablen überleben nicht den Neustart, sie können jedoch z.B. im init-Block, der beim Systemstart von FHEM ausgewertet wird, mit Inhalten aus Readings initialisiert werden.<br />
<br />
'''Beispiel'''<br />
<br />
Initialisierung einer Instanzvariablen namens '''$_status''' beim Systemstart mit dem Status des Moduls:<br />
<br />
<syntaxhighlight lang="perl"><br />
init {$_status=get_State()}<br />
</syntaxhighlight><br />
<br />
Instanzvariablen lassen sich wie Perl-Hashes indizieren:<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
my $i=0;<br />
$_betrag{$i}=100;<br />
</syntaxhighlight><br />
<br />
oder mit konkreten Angaben hier '''heute''':<br />
<br />
<syntaxhighlight lang="perl"><br />
$_betrag{heute}=100;<br />
</syntaxhighlight><br />
<br />
==Blockierende Funktionsaufrufe (blocking calls)==<br />
<br />
DOIF verwaltet blockierende Funktionsaufrufe, d.h. die in diesem Zusammenhang gestarteten FHEM-Instanzen werden gelöscht, beim Herunterfahren ('''shutdown'''), Wiedereinlesen der Konfiguration ('''rereadcfg''') Änderung der Konfiguration ('''modify''') und Deaktivieren des Gerätes ('''disabled''').<br />
<br />
Die Handhabung von blockierenden Funktionsaufrufen ist im FHEMwiki erklärt, s. Blocking Call.<br />
<br />
Der von der Funktion BlockingCall zurückgegebene Datensatz ist unterhalb von '''$_blockingcalls''' abzulegen, z.B.<br />
<br />
<syntaxhighlight lang="perl"><br />
$_blockingcalls{<blocking call name>} = ::BlockingCall(<blocking function>, <argument>, <finish function>, <timeout>, <abort function>, <abort argument>) unless(defined($_blockingcalls{<blocking call name>}));<br />
</syntaxhighlight><br />
<br />
Für unterschiedliche blockierende Funktionen ist jeweils ein eigener Name ('''<blocking call name>''') unterhalb von '''$_blockingcalls''' anzulegen.<br />
<br />
Wenn '''<blocking function>''', '''<finish function>''' und '''<abort function>''' im Package DOIF definiert werden, dann ist dem Funktionsnamen DOIF:: voranzustellen, im Aufruf der Funktion BlockingCall, z.B. '''DOIF::<blocking function>'''<br />
<br />
'''$_blockingcalls''' ist eine für DOIF reservierte Variable und darf nur in der beschriebener Weise verwendet werden.<br />
<br />
==Nutzbare Attribute im Perl-Modus==<br />
Folgende Auswahl an Attributen ist im DOIF-Perl-Modus nutzbar:<br />
<br />
'''addStateEvent checkReadingEvent DOIF_Readings disable event_Readings notexist readingList setList uiTable uiState weekdays readingFnAttributes'''<br />
<br />
Die Funktionsweise der Attribute kann im DOIF-FHEM-Modus nachgeschlagen werden.<br />
<br />
==set-Befehle im Perl-Modus==<br />
===set <name> disable===<br />
<br />
blockiert die Befehlsausführung<br />
<br />
===set <name> enable===<br />
<br />
aktiviert die Befehlsausführung<br />
<br />
===set <name> <Blockname>===<br />
<br />
führt den entsprechenden DOIF-Perl-Block unmittelbar aus<br />
==FOR-Schleife==<br />
Mit Hilfe der FOR-Schleife kann ein Template in einer Schleife mehrfach aufgerufen werden. Damit können mit einer Parameterliste gleiche Abläufe für verschiedene Szenarien erstellt werden.<br />
<syntaxhighlight lang="perl"><br />
FOR (<Array>,<Template>($_$1,$_$2,...)) mit $_$1 erstes Element des Arrays, $_$2 zweites Element des Arrays usw. der jeweiligen Zeile<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Lichtsteuerung für mehrere Szenarien<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_light DOIF subs {\<br />
## In einem Array namens $_sc wird pro Szenario eine Definitionszeile mit Parametern erstellt \<br />
## Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["[06:25-08:00|8] or [18:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["[06:25-08:00|8] or [18:00-22:10]", "schrank2 on", "schrank2 off"]);;\<br />
## Das Array kann um weitere Szenarien mit Hilfe des push-Befehls erweitert werden \<br />
} \<br />
## Template zur Steuerung des Lichtes für ein Szenario\<br />
DEF TPL_light ( \<br />
{ ## Perl-Block \<br />
if ($1) { ## In der Zeitspanne \<br />
fhem_set("$2") ## Licht einschalten \<br />
} else { \<br />
fhem_set("$3") ## Licht ausschalten \<br />
} \<br />
} ## Ende des Perl-Blocks \<br />
) ## Ende von TPL_light \<br />
\<br />
## Mit Hilfe der FOR-Schleife wird das Array $_sc durchlaufen, für jede Szene (Zeile des Arrays) wird das oben definierte Template mit den Parametern der Szene: Zeitspanne $_$1, Einschaltbefehl $_$2 und Ausschaltbefehl $_$2 aufgerufen \<br />
\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3)) \<br />
\<br />
## Die FOR-Schleife ruft auf: \<br />
## TPL_light("[06:25-08:00|8] or [18:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off") \<br />
## TPL_light("[06:25-08:00|8] or [18:00-22:10]", "schrank2 on", "schrank2 off")<br />
</syntaxhighlight><br />
<br />
Bei dieser Vorgehensweise können weitere Szenarien durch Hinzufügen einer Array-Zeile erstellt werden, ohne den restlichen Code anpassen zu müssen. Desweitern können die Elemente des Arrays für Visualisierungszwecke über das [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg uiTable-Attribut] genutzt werden, siehe: [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien_mit_tabellarischer_.C3.9Cbersicht Helligkeitsabhängige Lichtsteuerung mit Web-Oberfläche]<br />
<br />
==Einfache Anwendungsbeispiele==<br />
<br />
===Treppenhauslicht mit Bewegungsmelder===<br />
<syntaxhighlight lang="perl"><br />
defmod di_light DOIF {\<br />
if (["FS:motion"]) { # bei Bewegung\<br />
fhem_set("lamp on") if ([?lamp] ne "on");; # Lampe einschalten, wenn sie nicht an ist\<br />
set_Exec("off",30,'fhem_set("lamp off")');; # Timer namens "off" für das Ausschalten der Lampe auf 30 Sekunden setzen bzw. verlängern\<br />
}\<br />
}<br />
</syntaxhighlight><br />
<br />
===Einknopf-Fernbedienung===<br />
<br />
'''Beispiel'''<br />
<br />
Wenn eine Taste innerhalb von zwei Sekunden zwei mal betätig wird, soll der Rollladen nach oben, bei einem Tastendruck nach unten:<br />
<syntaxhighlight lang="perl"><br />
defmod di_shutter DOIF {\<br />
if (["FS:^on$"] and !get_Exec("shutter")){ # wenn Taste betätigt wird und kein Timer läuft\<br />
set_Exec("shutter",2,'fhem_set("shutter down")');;#Timer zum shutter down auf zwei Sekunden setzen\<br />
} else { # wenn Timer läuft, d.h. ein weitere Tastendruck innerhalb von zwei Sekunden\<br />
del_Exec("shutter");; # Timer löschen\<br />
fhem_set("shutter up");; # Rollladen hoch\<br />
}\<br />
}<br />
</syntaxhighlight><br />
<br />
'''Aktion auslösen, wenn innerhalb einer bestimmten Zeitspanne ein Ereignis x mal auftritt'''<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_count DOIF {\<br />
if (["FS:on"] and !get_Exec("counter")) { # wenn Ereignis (hier "FS:on") eintritt und kein Timer läuft\<br />
$_my_count=1;; # setze count-Variable auf 1\<br />
set_Exec("counter",3600,'Log (3,"count: $_my_count action") if ($_my_count > 10)');; # setze Timer auf eine Stunde zum Protokollieren der Anzahl der Ereignisse, wenn sie über 10 ist\<br />
} else {\<br />
$_my_count++;; # wenn Timer bereits läuft zähle Ereignis\<br />
}\<br />
}<br />
</syntaxhighlight><br />
<br />
==Weitere Anwendungsbeispiele im DOIF-Perl-Modus==<br />
===[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien Lichtsteuerung für mehrere Szenarien]===<br />
===[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Zeitgesteuerte_Heizungsregelung_mit_Hilfe_von_Raumthermostaten Steuerung von Raumthermostaten für mehrere Räume]===<br />
===[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien Beschattungssteuerung für mehrere Szenarien]===<br />
===[https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzahl_der_Tage_bis_zur_Abfall-Entsorgung Abfallentsorgung]===<br />
===[https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme Heiztherme]===<br />
===[https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Visualisierung:_Anwesenheitsstatus Anwesenheitsstatus]===<br />
[[Kategorie:HOWTOS]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Perl-Modus&diff=38456DOIF/Perl-Modus2023-07-10T19:13:01Z<p>Damian-s: /* Eigener Namensraum: DOIF */</p>
<hr />
<div>[[Datei:Licht-Szenarien.png|600px|rechts|Licht-Automatisierung]]<br />
<br />
Das DOIF-Modul arbeitet im DOIF-Perl-Modus, wie auch im DOIF-FHEM-Modus, ereignisgesteuert. Ein Steuerungsablauf wird in Perl in DOIF-Perl-Blöcken programmiert. Innerhalb eines DOIF-Devices können mehrere DOIF-Perl-Blöcke programmiert werden, die durch passende Event- oder Zeittrigger unabhängig von einander zur Ausführung gebracht werden.<br />
<br />
Die Abläufe lassen sich, wie in höheren Programmiersprachen üblich, strukturiert programmieren. Es können innerhalb eines DOF-Devices eigene Perlfunktionen definiert und genutzt werden. Es werden ebenfalls sog. Templates (deutsch: Schablonen) unterstützt. Mit Hilfe eines Templates kann ein bestimmter Automatisierungsablauf für mehrere Szenarien in einem DOIF-Device erstellt werden.<br />
<br />
Zum Zeitpunkt der Definition werden alle DOIF-spezifischen Angaben in Perl übersetzt. Das garantiert zur Laufzeit eine maximal mögliche Performance.<br />
<br />
Genauso wie der DOIF-FHEM-Modus, lässt sich der DOIF-Perl-Modus mit Hilfe des [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg uiTable-Attributes] um eine Web-Oberfläche ergänzen. Auf diese Weise kann sowohl die Steuerung als auch die Benutzeroberfläche innerhalb eines Devices erstellt werden. In der Abbildung rechts sieht man eine [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien_mit_tabellarischer_.C3.9Cbersicht helligkeitsabhängige Lichtsteuerung für mehrere Szenarien] erstellt im DOIF-Perl-Modus mit einer Benutzeroberfläche.<br />
<br />
==Aufbau einer Definition im DOIF-Perl-Modus==<br />
<br />
Der Aufbau der Definition im DOIF-Perl-Modus wird in drei Bereiche unterteilt: '''DOIF-Perl-Blöcke''', '''Template-Definitionen''' und '''Template-Aufrufe'''. Die letzten beiden Bereiche sind optional, die Reihenfolge der drei Bereiche ist frei wählbar.<br />
<br />
<syntaxhighlight lang="perl"><br />
define <name> DOIF<br />
<DOIF-Perl-Blöcke><br />
<Template-Definitionen (optional)> <br />
<Aufrufe zuvor definierter Templates (optional)><br />
</syntaxhighlight><br />
<br />
===Aufbau eines DOIF-Perl-Blocks===<br />
<br />
<syntaxhighlight lang="perl"><br />
<Blockname (optional)> {<Perlcode mit Ereignis-/Zeittriggern>}<br />
</syntaxhighlight><br />
<br />
Ein DOIF-Perl-Block wird in Perl programmiert. Dabei muss man [https://wiki.fhem.de/wiki/DOIF/Perl-Modus#Ereignistrigger Ereignis-]/[https://wiki.fhem.de/wiki/DOIF/Perl-Modus#Zeittrigger Zeittrigger] in einer DOIF-spezifischen Syntax in eckigen Klammern im Programmcode einsetzen. Bei der Definition werden diese Angaben vom Modul ausgewertet, es werden intern entsprechende Trigger aufgesetzt, anschließend werden die Trigger-Angaben gegen interne Perlfunktionen ersetzt. So entsteht intern ein reiner Perl-Block, der zur Laufzeit ausgeführt wird, wenn ein Ereignis im System auftritt, welches zu den definierten Triggern des Blocks passt. Es können beliebig viele voneinander unabhängige Perl-Blöcke innerhalb eines DOIF-Devices definiert werden. Wird kein Name eines Perl-Blocks definiert, so wird der Block unter dem Namen '''block_<nr>''' intern geführt.<br />
<br />
'''Beispiel'''<br />
<br />
Definition eines DOIF-Perl-Blocks mit einem Ereignistrigger und einer Fallunterscheidung<br />
<br />
<syntaxhighlight lang="perl"><br />
<br />
defmod di_rc_tv DOIF \<br />
{ ## Beginn eines Perlblocks ohne Namen\<br />
if ([remotecontol:"on"]) ## Das Device "remotecontrol" triggert das Modul, wenn im Event "on" vorkommt\<br />
{fhem_set"tv on"} ## wird der Befehl "set tv on" ausgeführt\ <br />
else ## sonst\ <br />
{fhem_set"tv off"} ## wenn im Event "on" nicht kommt, wird "set tv off" ausgeführt\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Definition von zwei benannten DOIF-Perl-Blöcken mit Zeittriggern<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_clock_radio DOIF \<br />
radio_on { ## Beginn eines Perlblocks namens radio_on\ <br />
if ([06:30|Mo Di Mi] or [08:30|Do Fr Sa So]) ## zu definierten Zeitpunkten wird der Block getriggert\<br />
{fhem_set"radio on"} ## der Befehl "set radio on" wird ausgeführt\ <br />
} ## Ende des Perlblocks namens radio_on\<br />
\<br />
radio_off { ## Beginn eines Perlblocks namens radio_off\<br />
if ([08:00|Mo Di Mi] or [09:30|Do Fr Sa So]) ## zu definierten Zeitpunkten wird der Block getriggert\ <br />
{fhem_set"radio off"} ## der Befehl "set radio off" wird ausgeführt\ <br />
} ## Ende des Perlblocks namens radio_off<br />
</syntaxhighlight><br />
<br />
===Aufbau einer Template-Definition===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
[https://wiki.fhem.de/wiki/DOIF/Templates DOIF-Templates]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<DOIF-Block-Definition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
<br />
Die Definition eines Templates ist optional. Sie bietet sich dann an, wenn mehrere gleich aufgebaute Abläufe (hier Szenen) definiert werden sollen. Eine Template-Definition beginnt mit '''DEF''' gefolgt vom Namen des Templates welches mit '''TPL_''' beginnen muss. Anschließend wird eingefasst in runde Klammern ein Perl-Block programmiert. Variable Stellen innerhalb des Perl-Blocks werden mit Platzhaltern: $1, $2, usw. angegeben. Diese werden beim Aufruf des Templates gegen konkrete Angaben ersetzt. Insbesondere können so verschiedene Ereignis- oder Zeittrigger in den zuvor programmierten Ablauf eingesetzt werden.<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block namens light_<Szene>\<br />
## Platzhalter für: Szenennamen Daemmerungssensor Zeitspanne on-Befehl(e) off-Befehl(e)\<br />
## Nr. des Platzhalters: $1 $2 $3 $4 $5\<br />
if (($3) and [$2] eq "on") { ## Innerhalb Zeitspanne (hier $3) und wenn Dämmerung (hier $2) gleich on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls auf den Szenennamen\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
} ## Ende des Perl-Blocks\<br />
) ## Ende der Templatedefinition\<br />
</syntaxhighlight><br />
<br />
===Aufruf eines Templates===<br />
<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...>)<br />
</syntaxhighlight><br />
<br />
Ein Template wird durch die Angabe des zuvor definierten Template-Namens aufgerufen. Hinter dem Template-Namen werden in runden Klammern kommagetrennten Angaben für die Platzhalter $1, $2, usw. gemacht. Durch den Aufruf wird intern ein Perl-Block generiert, bei dem alle Platzhalter im definierten Perl-Block des Templates gegen konkrete Angaben getauscht wurden.<br />
<br />
'''Beispiele'''<br />
<br />
Das oben definierte Beispiel-Template wird für zwei verschiedene Szenarien benutzt. Hierbei entstehen mit dem im Template definierten Ablauf zwei Perl-Blöcke, die unabhängig von einander arbeiten.<br />
<br />
<syntaxhighlight lang="perl"><br />
TPL_light (Erdgeschoss,Daemmerung2,[06:25-08:00|8] or [15:00-23:00],"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off")\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off")<br />
</syntaxhighlight><br />
<br />
===Ereignistrigger===<br />
In einem DOIF-Perl-Block sollte mindestens eine Ereignis- oder Zeittriggerangabe vorkommen. Diese Angabe ist erforderlich, damit der Perl-Block beim passenden Event oder der angegeben Zeit ausgeführt wird. Sie wird grundsätzlich in eckigen Klammern angegeben und bei der Definition intern gegen eine Perlfunktion ersetzt, die einen Rückgabewert bei ihrer Ausführung liefert. <br />
<br />
====Eventtrigger mit Inhalt====<br />
'''Inhalt des Internals STATE'''<br />
<syntaxhighlight lang="perl"><br />
[<device>] reagiert auf alle Events vom angegebenen Device, Rückgabewert: STATE des Devices (nicht das Reading state des Devices)<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_lamp DOIF {if ([lamp] eq "on) {fhem("push lamp on")}}<br />
</syntaxhighlight><br />
'''Inhalt eines Readings'''<br />
<syntaxhighlight lang="perl"><br />
[<device>:<reading>] reagiert auf alle Events vom angegebenen Device mit dem angegebenen Reading, Rückgabewert: Inhalt des Readings des Devices<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_lamp DOIF {if ([lamp:state] eq "on) {fhem("push lamp on")}}<br />
</syntaxhighlight><br />
<br />
====Eventtrigger mit Rückgabewert wahr/falsch====<br />
'''Eventtrigger für ein bestimmtes Device'''<br />
<syntaxhighlight lang="perl"><br />
[<device>:"<Regex-Events>"] reagiert auf alle Events vom angegebenen Device, Rückgabewert: wahr (true) zum Zeitpunkt des Events, wenn der Regex-Ausdruck passt, sonst falsch (false)<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_button DOIF {if ([button:"^btn1:"]) {fhem_set("lamp on")}} # die if-Bedingung ist wahr und führt zur Ausführung, wenn vom Device button, das Event beginnend mit btn1: vorkommt<br />
</syntaxhighlight><br />
'''Eventtrigger für mehrere Devices'''<br />
<syntaxhighlight lang="perl"><br />
["<Regex-Devices>:<Regex-Events>"] reagiert auf Events mit Devices mit Events, die den jeweiligen Regex-Angaben entsprechen, Rückgabewert: wahr (true) zum Zeitpunkt des Events, sonst falsch (false)<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_window DOIF {if (["^window:on$"]) {fhem("push window $device on")}} # die Bedingung ist wahr und führt zur Ausführung, wenn ein Devices beginnend mit window ein Event endend mit on liefert<br />
</syntaxhighlight><br />
<br />
===Zeittrigger===<br />
====Zeittrigger zu einer bestimmten Uhrzeit====<br />
<syntaxhighlight lang="perl"><br />
[<time>] der Zeitpunkt-Trigger mit <time>: HH:MM, HH:MM:SS triggert seinen Perl-Block zum angegebenen Zeitpunkt, Rückgabewert: wahr (true) zum Triggerzeitpunkt, sonst falsch (false)<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_pump DOIF {if ([10:00] or [11:00:30]) {fhem_set("pump on-for-timer 300")}} # um 10:00 Uhr und um 11:00:30 wird der entsprechende Perl-Block ausgeführt, die if-Bedingung ist zu diesen beiden Zeitpunkten wahr und führt zur Ausführung der Anweisung<br />
<br />
</syntaxhighlight><br />
<br />
====Zeitintervalle====<br />
<syntaxhighlight lang="perl"><br />
[<begin>-<end>] <begin>, <end> als HH:MM, HH:MM:SS, triggert seinen Perl-Block zu <begin>-Zeit und zu <end>-Zeit, das Intervall ist ab <begin>-Zeitpunkt wahr und ab <end>-Zeitpunkt falsch<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
define di_lamp_on_off DOIF {if ([10:00-22:00]) {fhem_set("lamp on")} else {fhem_set("lamp off")}} # um 10:00 Uhr und um 22:00 Uhr wird der entsprechende Perl-Block getriggert, die if-Bedingung ist ab 10:00 Uhr wahr, lamp wird eingeschaltet, um 22:00 uhr ist die if-Bedingung nicht mehr wahr, lamp wird ausgeschaltet<br />
</syntaxhighlight><br />
<br />
====indirekte Zeitangaben====<br />
'''Zeittrigger, deren Zeitangabe in einem Reading gespeichert wird'''<br />
<syntaxhighlight lang="perl">[[<device>:<reading>]] im angegebenen Reading muss eine gültige Zeitangabe als HH:MM, HH:MM:SS stehen, um diese Zeit wird der entsprechende Perl-Block ausgeführt, die Bedingung ist dann wahr, sonst falsch<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
{if ([[mydevice:time]]) {fhem_set("lamp on")}} # zum Zeitpunkt, der sich im Reading time des Devices mydevice wird der Perl-Block getriggert, die if-Bedingung ist wahr und lamp wird eingeschaltet<br />
<br />
{if ([[mydevice:from]-[mydevice:to]]) {fhem_set("lamp on")} else {fhem_set("lamp off")}} # im Zeitintervall from-to brennt lamp, sonst ist sie aus<br />
</syntaxhighlight><br />
<br />
====relative Zeitangaben====<br />
'''Zyklischer Trigger im zeitlichen Abstand'''<br />
<syntaxhighlight lang="perl"><br />
[+<time>] <time> als HH:MM, HH:MM:SS oder Zahl in Sekunden<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
{[+00:30];fhem("save")} # sichern der Konfiguration alle 30 Minuten<br />
</syntaxhighlight><br />
<br />
====ausgerichtete Zeittrigger====<br />
'''X-Minuten nach einer vollen Stunde'''<br />
<syntaxhighlight lang="perl"><br />
[:MM] mit MM sind Minutenangaben zwischen 00 und 59<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
{[:15];[:45];fhem_set("pump on-for-timer 300")} # Pumpe 15 und 45 Minuten nach einer vollen Stunde für 5 Minuten einschalten<br />
</syntaxhighlight><br />
'''Alle X-Minuten ab einer vollen Stunde'''<br />
<syntaxhighlight lang="perl"><br />
[+:MM] mit MM in Minuten als Teiler von 60, sinnvolle Angaben sind: 02, 03, 04, 05, 06, 10, 12, 15, 20, 30<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
{[+:15];fhem_set("pump on-for-timer 300")} # Pumpe um HH:00, HH:15, HH:30, HH:45 für fünf Minuten einschalten <br />
</syntaxhighlight><br />
'''X-Minuten nach einer vollen Stunde, alle X-Stunden'''<br />
<syntaxhighlight lang="perl"><br />
[+[h]:MM] mit MM in Minuten zwischen 1 und 59, h in Stunden als Teiler von 24, sinnvolle Angaben für h sind: 2, 3, 4, 6, 8, 12<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
{[+[4]:05]; fhem_set("pump on-for-timer 300")} # Pumpe um 00:05, 04:05, 08:05, 12:05, 16:05, 20:05 Uhr für fünf Minuten einschalten<br />
</syntaxhighlight><br />
<br />
====Wochentagsteuerung====<br />
'''Zeittrigger an bestimmen Wochen-/Ferientagen'''<br />
<syntaxhighlight lang="perl"><br />
[<time-trigger>|0123456789] Bedeutung: 0 bis 6 für So. bis Sa., 7 Wochenende oder Feiertag, 8 Werktags, 9 Wochenende oder Feiertag am kommenden Tag<br />
alternativ <br />
[<time-trigger>|So Mo Di Mi Do Fr Sa WE AT MWE] WE entspricht der Ziffer 7, AT der Ziffer 8 und MWE der Ziffer 9<br />
oder<br />
[<time-trigger>|Su Mo Tu We Th Fr Sa WE WD TWE] WE entspricht der Ziffer 7, WD der Ziffer 8 und TWE der Ziffer 9<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_lamp DOIF\<br />
{[22:00|Sa];;fhem_set("lamp on")}\<br />
{[08:00|Mo];;fhem_set("lamp off")}<br />
</syntaxhighlight><br />
<br />
====Intervall-Timer====<br />
'''Zyklischer Zeittrigger innerhalb einer Zeitspanne'''<br />
<syntaxhighlight lang="perl"><br />
[<begin>-<end>,<relativ timer>] triggert zu den aus <relativ timer> berechneten Zeitpunkten im angegebenen Zeitintervall <begin>-<end><br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_pump DOIF {[08:00-22:00,+:30];;fhem_set("pump on-for-timer 300")} # von 08:00 Uhr bis 22:00 Uhr wird Pumpe alle 30 Minuten eingeschaltet, erste Schaltpunkt ist um 08:00 Uhr, der letzte um 21:30 Uhr<br />
</syntaxhighlight><br />
<br />
===Trigger unterbinden===<br />
<br />
Soll eine Ereignis-/Zeitangabe nicht triggern, so lässt sich die Triggerung durch ein vorangestelltes Fragezeichen unterbinden.<br />
<br />
<syntaxhighlight lang="perl"><br />
[?<Triggerangabe>] <Triggerangabe> kann eine Ereignis- oder Zeitangabe sein<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_lamp DOIF \<br />
{ # hier triggert nur [darkness:state], dagegen wird das Zeitintervall nur abgefragt, \<br />
if ([darkness:state] eq "on" and [?15:00-22:00]) { # es gibt keinen Trigger um 15:00 Uhr bzw. um 22:00 Uhr \<br />
fhem_set("lamp on") \ <br />
} else { \<br />
fhem_set("lamp off") \<br />
} \<br />
} <br />
</syntaxhighlight><br />
<br />
===Aggregationsfunktionen===<br />
{{Randnotiz|RNText=Aggregationsfunktion<br />
<syntaxhighlight lang="perl"><br />
[<function>:<format>:"<regex device>:<regex event>":<reading>:<condition>,<default>]<br />
<br />
<function>: #, @, #sum, #max, #min, #average, #median, @max, @min<br />
# Anzahl der betroffenen Devices, @ kommagetrennte Liste Devices<br />
#sum Summe, #max höchster Wert, #min niedrigster Wert, #average Durchschnitt, #median Medianwert<br />
@max Device des höchsten Wertes, @min Device des niedrigsten Wertes<br />
<br />
<format>: d<number>, a, s(<splittoken>)<br />
d<number> zum Runden des Wertes mit Nachkommastellen, a für Aliasnamen bei Devicelisten, s(<splittoken>) <splittoken> sind Trennzeichen in der Device-Liste<br />
<br />
"<regex Device>:<regex Event>" spezifiziert sowohl die betroffenen Devices, als auch den Ereignistrigger, die Syntax entspricht der DOIF-Syntax für Ereignistrigger.<br />
<br />
<reading> konkretes Reading, welches überprüft werden soll<br />
alternativ eine Regex in Anführungszeichen<br />
"<regex reading>" Regex für Readings, die überprüft werden sollen<br />
<br />
<condition> Aggregationsbedingung<br />
wird <condition> in Anführungszeichen gesetzt, so werden Reading mit eq mit dem angegebenen Wert verglichen. Sonst kann ein Perlausdruck angegeben werden. Folgende Variablen sind vorbelegt und können im Perlausdruck benutzt werden:<br />
<br />
$_ Inhalt des Readings<br />
$number Nach Zahl gefilteres Reading<br />
$name Name des Devices<br />
$reading Name des Readings<br />
$TYPE Devices-Typ<br />
$STATE Status des Devices (nicht das Reading state)<br />
$room Raum des Devices<br />
$group Gruppe des Devices<br />
<br />
<default> Default-Wert, falls kein Device gefunden wird, entspricht der Syntax des Default-Wertes bei Readingangaben<br />
<br />
<format>, <reading>, <condition>, <default> sind optional<br />
<br />
</syntaxhighlight><br />
}}<br />
Mit Hilfe einer Aggregationsfunktion können mehrere Readings im System ausgewertet werden, die einem bestimmten Kriterium entsprechen. Die Filterkriterien können mit Hilfe von Regex-Ausdrücken für Devices, Events und Readings angegeben werden. Die Aggregationsangabe wirkt triggernd, soll sie nicht triggern, so muss ein Fragezeichen vorangestellt werden, siehe [https://wiki.fhem.de/wiki/DOIF/Perl-Modus#Trigger_unterbinden Trigger unterbinden]<br />
<br />
<syntaxhighlight lang="perl"><br />
[<function>:<format>:"<regex device>:<regex event>":<reading>:<condition>,<default>]<br />
</syntaxhighlight><br />
<br />
'''Beispiele'''<br />
<br />
Offene Fenster anzeigen. Wenn ein Device beginnend mit "window" im Namen ein Event sendet, dann wird bei allen Devices im System, deren Name mit "window" beginnt, status auf "open" geprüft. Diese werden im Status von di_windows angezeigt. Wird kein Device mit status "open" gefunden, so wird der Default-Wert "keine" übernommen. <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_windows DOIF init {set_State([@:"^window":state:"open","keine"])}<br />
</syntaxhighlight><br />
<br />
Durchschnittstemperatur aller Temperatursensoren in der Gruppe "livingroom" gerundet auf 2 Nachkommastellen. Wenn ein Event von irgendeinem Device beginnend mit "temperature" auftritt, dann werden alle Devices im System durchsucht, die ein Reading namens "temperature" besitzen und sich in der Gruppe "livingroom" befinden. <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_average_temp DOIF init {set_State ([#average:d2:":^temperature":temperature:$group eq "livingroom"])}<br />
</syntaxhighlight><br />
<br />
Um 18:00 Uhr werden alle Devices im System durchsucht, deren Reading "battery" nicht "ok" ist. Damit die Aggregationsangabe den DOIF-Perl-Block nicht triggert, muss am Anfang der Angabe ein Fragezeichen vorangestellt werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_batterie_not_ok DOIF init {[18:00];;set_State([?@:":battery":battery:$_ ne "ok","alle OK"])}<br />
</syntaxhighlight><br />
<br />
Um 18:00 Uhr werden alle Devices im System durchsucht, die ein Reading namens "Battery" oder "battery" haben. Bei diesen Readings wird die letzte Aktualisierung geprüft. Wenn sie älter als 24 Stunden ist, dann wird dessen Device in die Liste aufgenommen. Im Status des Moduls befinden sich danach alle Devices, deren Batterie-Reading länger nicht aktualisiert wurde.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_batteriecheck DOIF init {[18:00];;set_State([?@:"":"^[Bb]attery$":ReadingsAge($name,$reading,0) > 3600*24,"keine"])}<br />
</syntaxhighlight><br />
<br />
Das Modul wird getriggert wenn ein beliebiges Device ein Event beginnend mit "temperature" sendet, es werden daraufhin alle Devices nach dem Reading "temperature" durchsucht und der maximale/minimale Wert im Reading max/min von di_min_max gespeichert.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_min_max DOIF\<br />
{set_Reading("max",[#max:":^temperature":temperature])}\<br />
{set_Reading("min",[#min:":^temperature":temperature])}<br />
</syntaxhighlight><br />
<br />
==Für Umsteiger vom DOIF-FHEM-Modus==<br />
Der Status des Moduls wird nicht vom Modul gesetzt, er kann vom Anwender mit Hilfe der Funktion '''set_State''' verändert werden, siehe spezifische Perl-Funktionen im Perl-Modus. FHEM-Befehle werden durch den Aufruf der Perlfunktion fhem("...") ausgeführt. Für den häufig genutzten fhem-Befehl '''set''' wurde eine kompatible Perlfunktion namens '''fhem_set''' definiert. Sie ist performanter und sollte bevorzugt verwendet werden, da das Parsen nach dem FHEM set-Befehl entfällt.<br />
<br />
Der Benutzer kann mit der Funktion '''set_Exec''' beliebig viele eigene Timer definieren, die unabhängig voneinander gesetzt und ausgewertet werden können, siehe spezifische Perl-Funktionen im Perl-Modus.<br />
<br />
Definitionen im FHEM-Modus mit do always-Attribut der Form:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF (<Bedingung mit Trigger>) (<FHEM-Befehle>) DOELSE (<FHEM-Befehle>)<br />
</syntaxhighlight><br />
<br />
lassen sich wie folgt in Perl-Modus übertragen:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF {if (<Bedingung mit Trigger>) {fhem("<FHEM-Befehle>")} else {fhem("<FHEM-Befehle>")}}<br />
</syntaxhighlight><br />
<br />
Im Gegensatz zum FHEM-Modus arbeitet der Perl-Modus ohne Auswertung des eigenen Status (Zustandsauswertung), daher muss der Anwender selbst darauf achten, wiederholende Ausführungen zu vermeiden. Elegant lässt sich das Problem der wiederholenden Ausführung bei zyklisch sendenden Sensoren mit Hilfe des Attributes '''DOIF_Readings''' lösen.<br />
<br />
'''Beispiel'''<br />
<br />
Heizung soll bei einer Temperatur unter 21 Grad eingeschaltet werden, sonst soll sie ausgeschaltet werden. Das Unterschreiten bzw. Überschreiten der Wunschtemperatur wird über die Definition des Readings '''cold''' realisiert. Obwohl der Temperatursensor zyklisch seine Daten sendet, triggert das Reading '''cold''' das eigene Modul und führt zum Schalten der Heizung nur wenn sich sein Zustand (on/off) ändert.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Threshold DOIF { \<br />
if ([$SELF:cold] eq "on") { # wenn es kalt ist\<br />
fhem_set("heating on");; # Heizung einschalten\<br />
set_State ("heating");; # Status auf 'heating' setzen\<br />
} else { # sonst\<br />
fhem_set("heating off");; # Heizung ausschalten\<br />
set_State ("not heating");;# Status auf 'not heating' setzen\<br />
} \<br />
}<br />
attr di_Threshold DOIF_Readings cold: ([room:temperature] < 21 ? "on" : "off")<br />
</syntaxhighlight><br />
<br />
<br />
Es können beliebig viele Perl-Blöcke definiert werden, die unabhängig von einander durch einen oder mehrere Trigger ausgewertet und zur Ausführung führen können:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF<br />
{ if (<Bedingung mit Triggern>) ... } ## erster Block<br />
{ if (<Bedingung mit Triggern>) ... } ## zweiter Block<br />
...<br />
</syntaxhighlight><br />
<br />
Einzelne Ereignis-/Zeittrigger, die nicht logisch mit anderen Bedingungen oder Triggern ausgewertet werden müssen, können auch ohne if-Anweisung angegeben werden, z. B.:<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_einschalten DOIF\<br />
{["Daemmerung:on"];;fhem_set("lamp on")}\<br />
{[08:00];;fhem_set("radio on")}<br />
</syntaxhighlight><br />
<br />
Ereignis-/Zeittrigger sind intern Perlfunktionen, daher können sie an beliebiger Stelle im Perlcode angegeben werden, wo Perlfunktionen vorkommen dürfen.<br />
<br />
'''Beispiele'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_log DOIF {Log 1,"state of lamp: ".[lamp:state]}<br />
<br />
defmod di_set_lamp DOIF {fhem_set("lamp ".[remote:state])}<br />
</syntaxhighlight><br />
<br />
Innerhalb eines Perlblocks sind beliebige Hierarchietiefen möglich, dabei kann der Trigger irgendwo innerhalb des Blocks vorkommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF<br />
{ if (<Bedingung>) {<br />
if (<Bedingung>) {<br />
if (<Bedingung mit Triggern>...<br />
...<br />
}<br />
}<br />
}<br />
}<br />
</syntaxhighlight><br />
<br />
'''Bemerkung'''<br />
<br />
Innerhalb eines DOIF-Perl-Blocks muss mindestens ein Trigger definiert werden. Zu beachten ist, dass beim passenden Trigger nicht nur ein Zweig, sondern der gesamte Block ausgeführt wird.<br />
<br />
==Eigene Funktionen==<br />
<br />
Ein besonderer Perl-Block ist der Block namens '''subs'''. In diesem Block werden Perlfunktionen definiert, die innerhalb des DOIFs genutzt werden, sie befinden sich im Package DOIF und können in den folgenden Perl-Blöcken benutzt werden. Um eine möglichst hohe Kompatibilität zu Perl sicherzustellen, wird im '''subs-Block''' keine DOIF-Syntax in eckigen Klammern unterstützt, insb. gibt es keine Trigger, die den Block ausführen können.<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF subs { ## Definition von Perlfunktionen lamp_on und lamp_off<br />
sub lamp_on {<br />
fhem_set("lamp on");<br />
set_State("on");<br />
}<br />
sub lamp_off {<br />
fhem_set("lamp off");<br />
set_State("off");<br />
}<br />
}<br />
{[06:00];lamp_on()} ## Um 06:00 Uhr wird die Funktion lamp_on aufgerufen<br />
{[08:00];lamp_off()} ## Um 08:00 Uhr wird die Funktion lamp_off aufgerufen<br />
</syntaxhighlight><br />
<br />
'''Eigene Funktionen mit Parametern'''<br />
<br />
Unter Verwendung von Funktionsparameter lassen sich Definitionen oft vereinfachen, das obige Beispiel lässt sich mit Hilfe nur einer Funktion kürzer wie folgt definieren:<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF subs { ## Definition der Perlfunktion lamp<br />
sub lamp {<br />
my ($state)=@_; # Variable $state mit dem Parameter belegen<br />
fhem_set("lamp $state");<br />
set_State($state);<br />
}<br />
}<br />
{[06:00];lamp("on")} ## Um 06:00 Uhr wird die Funktion lamp mit Parameter "on" aufgerufen<br />
{[08:00];lamp("off")} ## Um 08:00 Uhr wird die Funktion lamp mit dem Parameter "off" aufgerufen<br />
</syntaxhighlight><br />
<br />
==Eigener Namensraum: DOIF==<br />
<br />
Der Namensraum im DOIF-Perl-Modus ist gekapselt. Selbstdefinierte Funktionen im DOIF-Device können nicht bereits existierende Perlfunktionen in FHEM (Namensraum main) überschreiben. Funktionen aus dem Namensraum '''main''' müssen mit vorangestelltem Doppelpunkt angegeben werden: '''::<perlfunction>'''. Variablen aus dem Namensraum '''main''' werden wie folgt angegeben: '''$::<perlfunction>'''-<br />
<br />
Eigene Perlfunktionen, die in myutils ausgelagert sind, befinden sich ebenfalls im Namensraum main. Wenn sie ausschließlich in DOIF-Devices benutzt werden sollen, so kann am Anfang vor deren Definition in myutils '''package DOIF;''' angegeben werden. In diesen Fall sind auch diese Funktion im DOIF-Device bekannt - sie können dann ohne vorangestellten Doppelpunkt genutzt werden.<br />
<br />
Folgende FHEM-Perlfunktionen wurden ebenfalls im DOIF-Namensraum definiert, sie können, wie gewohnt ohne Doppelpunkt genutzt werden:<br />
<br />
'''fhem, Log, Log3, InternVal, InternalNum, OldReadingsVal, OldReadingsNum, OldReadingsTimestamp, OldReadingsAge, ReadingsVal, ReadingsNum, ReadingsTimestamp, ReadingsAge, Value, OldValue, OldTimestamp, AttrVal, AttrNum<br />
'''<br />
<br />
==Spezifische Perl-Funktionen im Perl-Modus==<br />
Die folgenden Perl-Funktionen befinden sich im Package DOIF, sie können in der DOIF-Definition unmittelbar genutzt werden.<br />
===FHEM-set-Befehl ausführen: '''fhem_set()'''===<br />
<syntaxhighlight lang="perl"><br />
fhem_set(<content>); mit <content> Angaben des FHEM-set-Befehls<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Lampe namens '''lamp''' ausschalten:<br />
<br />
<syntaxhighlight lang="perl"><br />
fhem_set("lamp off");<br />
</syntaxhighlight><br />
<br />
entspricht:<br />
<br />
<syntaxhighlight lang="perl"><br />
fhem("set lamp off");<br />
</syntaxhighlight><br />
<br />
Der Aufruf der fhem_set-Funktion ist performanter, da das Parsen nach dem set-Befehl mit Hilfe der Funktion '''fhem''' entfällt.<br />
<br />
===Ein FHEM-Event auslösen: '''set_Event()'''===<br />
<syntaxhighlight lang="perl"><br />
set_Event(<Event>); mit <Event> das zu generierende FHEM-Event<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<br />
Generiere das Event '''on''':<br />
<br />
<syntaxhighlight lang="perl"><br />
set_Event("on");<br />
</syntaxhighlight><br />
<br />
===Eigenen Status setzen: '''set_State()'''===<br />
<syntaxhighlight lang="perl"><br />
set_State(<value>,<trigger>); mit <trigger>: 0 ohne Trigger, 1 mit Trigger, <trigger> ist optional, default ist 1<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Status des eignen DOIF-Device auf '''on''' setzen:<br />
<br />
<syntaxhighlight lang="perl"><br />
set_State("on");<br />
</syntaxhighlight><br />
<br />
===Status des eigenen DOIF-Devices auslesen: '''get_State()'''===<br />
Die Funktion besitzt keine Parameter.<br />
<br />
'''Beispiel'''<br />
<br />
Schalte Lampe namens '''lamp''' mit dem Status des eigenen DOIF-Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
fhem_set("lamp ".get_State());<br />
</syntaxhighlight><br />
<br />
===Reading des eigenen DOIF-Devices setzen: '''set_Reading()'''===<br />
<syntaxhighlight lang="perl"><br />
set_Reading(<readingName>,<value>,<Event>); mit <Event>: 0 ohne Eventgenerierung, 1 mit Eventgenerierung, <Event> ist optional, default ist 0<br />
</syntaxhighlight><br />
'''Beispiel'''<br />
<syntaxhighlight lang="perl"><br />
set_Reading("weather","cold");<br />
</syntaxhighlight><br />
<br />
===Reading des eigenen DOIF-Devices auslesen: '''get_Reading()'''===<br />
<br />
'''Beispiel'''<br />
<br />
Schalte Lampe mit dem Inhalt des Readings namens '''dim''':<br />
<syntaxhighlight lang="perl"><br />
fhem_set("lamp ".get_Reading("dim"));<br />
</syntaxhighlight><br />
<br />
===Setzen mehrerer Readings des eigenen DOIF-Devices in einem Eventblock===<br />
<syntaxhighlight lang="perl"><br />
set_Reading_Begin();<br />
set_Reading_Update(<readingName>,<value>,<change>); <change> ist optional<br />
set_Reading_End(<Event>); mit <Event>: 0 ohne Eventgenerierung, 1 mit Eventgenerierung<br />
</syntaxhighlight><br />
<br />
Die obigen Funktionen entsprechen den FHEM-Perlfunktionen: '''readingsBegin, readingsBulkUpdate, readingsEndUpdate'''.<br />
<br />
'''Beispiel'''<br />
<br />
Die Readings '''temperature''' und '''humidity''' sollen in einem Eventblock mit dem zuvor belegten Inhalt der Variablen '''$temp''' bzw. '''$hum''' belegt werden:<br />
<syntaxhighlight lang="perl"><br />
set_Reading_Begin;<br />
set_Reading_Update("temperature",$temp);<br />
set_Reading_Update("humidity",$hum);<br />
set_Reading_End(1);<br />
</syntaxhighlight><br />
<br />
==Interne Timer==<br />
<br />
Mit Hilfe von Timern können Perl-Anweisungen verzögert ein- oder mehrmalig ausgeführt werden. Im Gegensatz zum wait-Timer im DOIF-FHEM-Modus, können beliebig viele Timer gleichzeitig genutzt werden. Ein Timer wird mit einem Timer-Namen eindeutig definiert. Über den Timer-Namen kann die Restlaufzeit abgefragt werden, ebenfalls kann er vor seinem Ablauf gelöscht werden.<br />
<br />
===Timer setzen: '''set_Exec()'''===<br />
<syntaxhighlight lang="perl"><br />
set_Exec(<timerName>, <seconds>, <perlCode>, <paramRef>, <condition>);<br />
<br />
<timerName>: beliebige Angabe, sie spezifiziert eindeutig einen Timer<br />
<br />
<seconds>: Verzögerungszeit, sie wird per eval-Perlbefehl ausgewertet und kann daher Perlcode zur Bestimmung der Verzögerungszeit beinhalten<br />
<br />
<perlCode>: Perl-Anweisung, die nach Ablauf der Verzögerungszeit per eval-Perlbefehl ausgeführt wird<br />
<br />
<paramRef>: wird unter <perlCode> eine Perlfunktion angegeben, so kann optional hier eine Referenz auf den Übergabeparameter der Perlfunktion angegeben werden<br />
<br />
<condition>: optionale Bedingung zur Wiederholung der Perl-Ausführung. Sie wird per eval-Perlbefehl vor dem Setzen des Timers und vor der Ausführung der Perl-Anweisung auf wahr geprüft. Bei falsch wird die Wiederholung der Ausführungskette beendet. Wird <condition> nicht angegeben, so erfolgt keine Wiederholung der Perl-Anweisung.<br />
</syntaxhighlight><br />
<br />
Wird '''set_Exec''' mit dem gleichen Timer-Namen '''<timerName>''' vor seinem Ablauf erneut aufgerufen, so wird der laufender Timer gelöscht und neugesetzt.<br />
<br />
===Anwendungsbeispiele für einmalige verzögerte Ausführung===<br />
<br />
'''Beispiel'''<br />
<br />
Funktion namens '''lamp''' mit dem Übergabeparameter '''on''' 30 Sekunden verzögert aufrufen:<br />
<br />
<syntaxhighlight lang="perl"><br />
set_Exec("lamp_timer",30,'lamp("on")');<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Lampe verzögert um 30 Sekunden ausschalten:<br />
<br />
<syntaxhighlight lang="perl"><br />
set_Exec("off_timer",30,'fhem_set("lamp off")');<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Das Event '''off''' 30 Sekunden verzögert generieren:<br />
<br />
<syntaxhighlight lang="perl"><br />
set_Exec("Event_timer",30,'set_Event("off")');<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Funktion namens '''check_shutters''' wird mit einer Referenz auf ein zuvor definiertes Array namens '''shutters''' um 5 Sekunden verzögert ausgeführt:<br />
<br />
<syntaxhighlight lang="perl"><br />
set_Exec("check_timer",5,"check_shutters",\@shutters);<br />
</syntaxhighlight><br />
<br />
===Anwendungsbeispiele mit bedingter Wiederholung einer Ausführung===<br />
<br />
'''Beispiel'''<br />
<br />
Wenn Alarm ausgelöst wird, soll eine Benachrichtigung gesendet werden und alle 60 Sekunden wiederholt werden, solange Alarmanlage auf '''on''' steht:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_alarm DOIF {["alarm:on"];;fhem("send myphone alarm!");;set_Exec("timer",60,'fhem("send myphone alarm!")','ReadingsVal("alarm","state","on") eq "on"')}<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Wenn Taster auslöst, Lampe auf '''on''' schalten und noch zwei mal im Abstand von einer Sekunde wiederholt auf '''on''' schalten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_lamp_on DOIF {["button:on"];;fhem_set"lamp on";;set_Exec("timer",1,'fhem_set("lamp on")','$count < 2')}<br />
</syntaxhighlight><br />
<br />
alternativ:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_lamp_on DOIF {["button:on"];;set_Exec("timer",'$count == 0 ? 0 : 1','fhem_set("lamp on")','$count < 2')}<br />
</syntaxhighlight><br />
'''$count''' ist eine interne Variable, die beginnend bei 0 nach jedem Durchlauf um eins erhöht wird.<br />
<br />
'''Beispiel'''<br />
<br />
Wenn Fenster geöffnet wird, dann soll eine Benachrichtigung erfolgen, dabei soll die Benachrichtigung bis zu 10 mal jeweils um weitere 60 Sekunden verzögert werden: erste Benachrichtigung nach 5 Minuten, zweite Benachrichtigung nach weiteren 6 Minuten, dritte Benachrichtigung nach weiteren 7 Minuten usw.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_window DOIF {if ([window:state] eq "open") {\<br />
set_Exec("timer",'300+$count*60','fhem("echo speak window open")','$count < 9')\<br />
} else {\<br />
del_Exec("timer")\<br />
}\<br />
}<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Pumpe alle zwei Stunden im Abstand von fünf Minuten 3 mal einschalten, beim ersten mal für 60 Sekunden, beim zweiten mal für 80 Sekunden und beim dritten mal für 100 Sekunden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_pump DOIF {[08:00-20:00,+[2]:00];;set_Exec("timer",300,'fhem_set("pump on-for-timer ".60+$count*20)','$count < 3')}<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Hochdimmen beim Tastendruck im Sekundentakt.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_dimm DOIF {["button:on"];;@{$_pct}=(10,35,65,80,90,100);;set_Exec("timer",1,'fhem_set"lamp pct ".$_pct[$count]','$count < 6')}<br />
</syntaxhighlight><br />
<br />
'''$_pct''' ist hier ein Array mit Helligkeitswerten, auf das innerhalb des Devices zu jedem Zeitpunkt zugegriffen werden kann.<br />
<br />
===Restzeit des Timers bestimmen: '''get_Exec()'''===<br />
<syntaxhighlight lang="perl"><br />
get_Exec(<timerName>); Returnwert: 0, wenn Timer abgelaufen oder nicht gesetzt ist, sonst Anzahl der Sekunden bis zum Ablauf des Timers<br />
</syntaxhighlight><br />
<br />
===Laufenden Timer löschen: '''del_Exec()'''===<br />
<syntaxhighlight lang="perl"><br />
del_Exec(<timerName>); <timeName> Name des Timers<br />
</syntaxhighlight><br />
<br />
==init-Block==<br />
<br />
Wird ein DOIF-Perl-Block mit dem Namen '''init''' benannt, so wird dieser Block beim Systemstart von FHEM ausgeführt.<br />
<br />
'''Beispiel'''<br />
<br />
Lampe um 22:00 Uhr oder wenn das FHEM-System hochgefahren wird ausschalten:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_lamp_off DOIF init {[22:00];;fhem_set("lamp off")}<br />
</syntaxhighlight><br />
<br />
==Device-Variablen==<br />
<br />
Device-Variablen sind sogenannte Instanzvariablen, die global innerhalb eines DOIF-Devices genutzt werden können. Deren Inhalt bleibt von Trigger zu Trigger während der Laufzeit des System erhalten. Sie beginnen mit '''$_''' und müssen nicht mit '''my''' deklariert werden. Intern handelt es sich um hash-Variablen des jeweiligen DOIF-Devices.<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_var DOIF\<br />
init {$_myvalue=10} ## nach dem Starten des FHEM-System Variable namens $_myvalue mit dem Wert 10 initialisieren\<br />
{[+:30];;fhem_set("mydevice $_myvalue");;$_myvalue++} ## alle 30 Minuten set mydevice mit dem Wert von $_myvalue ausführen und diesen anschließend um eins erhöhen<br />
</syntaxhighlight><br />
<br />
Wenn eine Instanzvariable nicht initialisiert wird, gilt sie als nicht definiert. Das lässt sich mit dem Perlbefehl '''define''' abfragen.<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
if (!defined $_value) ($_value=30);<br />
</syntaxhighlight><br />
<br />
Instanzvariablen überleben nicht den Neustart, sie können jedoch z.B. im init-Block, der beim Systemstart von FHEM ausgewertet wird, mit Inhalten aus Readings initialisiert werden.<br />
<br />
'''Beispiel'''<br />
<br />
Initialisierung einer Instanzvariablen namens '''$_status''' beim Systemstart mit dem Status des Moduls:<br />
<br />
<syntaxhighlight lang="perl"><br />
init {$_status=get_State()}<br />
</syntaxhighlight><br />
<br />
Instanzvariablen lassen sich wie Perl-Hashes indizieren:<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
my $i=0;<br />
$_betrag{$i}=100;<br />
</syntaxhighlight><br />
<br />
oder mit konkreten Angaben hier '''heute''':<br />
<br />
<syntaxhighlight lang="perl"><br />
$_betrag{heute}=100;<br />
</syntaxhighlight><br />
<br />
==Blockierende Funktionsaufrufe (blocking calls)==<br />
<br />
DOIF verwaltet blockierende Funktionsaufrufe, d.h. die in diesem Zusammenhang gestarteten FHEM-Instanzen werden gelöscht, beim Herunterfahren ('''shutdown'''), Wiedereinlesen der Konfiguration ('''rereadcfg''') Änderung der Konfiguration ('''modify''') und Deaktivieren des Gerätes ('''disabled''').<br />
<br />
Die Handhabung von blockierenden Funktionsaufrufen ist im FHEMwiki erklärt, s. Blocking Call.<br />
<br />
Der von der Funktion BlockingCall zurückgegebene Datensatz ist unterhalb von '''$_blockingcalls''' abzulegen, z.B.<br />
<br />
<syntaxhighlight lang="perl"><br />
$_blockingcalls{<blocking call name>} = ::BlockingCall(<blocking function>, <argument>, <finish function>, <timeout>, <abort function>, <abort argument>) unless(defined($_blockingcalls{<blocking call name>}));<br />
</syntaxhighlight><br />
<br />
Für unterschiedliche blockierende Funktionen ist jeweils ein eigener Name ('''<blocking call name>''') unterhalb von '''$_blockingcalls''' anzulegen.<br />
<br />
Wenn '''<blocking function>''', '''<finish function>''' und '''<abort function>''' im Package DOIF definiert werden, dann ist dem Funktionsnamen DOIF:: voranzustellen, im Aufruf der Funktion BlockingCall, z.B. '''DOIF::<blocking function>'''<br />
<br />
'''$_blockingcalls''' ist eine für DOIF reservierte Variable und darf nur in der beschriebener Weise verwendet werden.<br />
<br />
==Nutzbare Attribute im Perl-Modus==<br />
Folgende Auswahl an Attributen ist im DOIF-Perl-Modus nutzbar:<br />
<br />
'''addStateEvent checkReadingEvent DOIF_Readings disable event_Readings notexist readingList setList uiTable uiState weekdays readingFnAttributes'''<br />
<br />
Die Funktionsweise der Attribute kann im DOIF-FHEM-Modus nachgeschlagen werden.<br />
<br />
==set-Befehle im Perl-Modus==<br />
===set <name> disable===<br />
<br />
blockiert die Befehlsausführung<br />
<br />
===set <name> enable===<br />
<br />
aktiviert die Befehlsausführung<br />
<br />
===set <name> <Blockname>===<br />
<br />
führt den entsprechenden DOIF-Perl-Block unmittelbar aus<br />
==FOR-Schleife==<br />
Mit Hilfe der FOR-Schleife kann ein Template in einer Schleife mehrfach aufgerufen werden. Damit können mit einer Parameterliste gleiche Abläufe für verschiedene Szenarien erstellt werden.<br />
<syntaxhighlight lang="perl"><br />
FOR (<Array>,<Template>($_$1,$_$2,...)) mit $_$1 erstes Element des Arrays, $_$2 zweites Element des Arrays usw. der jeweiligen Zeile<br />
</syntaxhighlight><br />
<br />
'''Beispiel'''<br />
<br />
Lichtsteuerung für mehrere Szenarien<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_light DOIF subs {\<br />
## In einem Array namens $_sc wird pro Szenario eine Definitionszeile mit Parametern erstellt \<br />
## Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["[06:25-08:00|8] or [18:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["[06:25-08:00|8] or [18:00-22:10]", "schrank2 on", "schrank2 off"]);;\<br />
## Das Array kann um weitere Szenarien mit Hilfe des push-Befehls erweitert werden \<br />
} \<br />
## Template zur Steuerung des Lichtes für ein Szenario\<br />
DEF TPL_light ( \<br />
{ ## Perl-Block \<br />
if ($1) { ## In der Zeitspanne \<br />
fhem_set("$2") ## Licht einschalten \<br />
} else { \<br />
fhem_set("$3") ## Licht ausschalten \<br />
} \<br />
} ## Ende des Perl-Blocks \<br />
) ## Ende von TPL_light \<br />
\<br />
## Mit Hilfe der FOR-Schleife wird das Array $_sc durchlaufen, für jede Szene (Zeile des Arrays) wird das oben definierte Template mit den Parametern der Szene: Zeitspanne $_$1, Einschaltbefehl $_$2 und Ausschaltbefehl $_$2 aufgerufen \<br />
\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3)) \<br />
\<br />
## Die FOR-Schleife ruft auf: \<br />
## TPL_light("[06:25-08:00|8] or [18:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off") \<br />
## TPL_light("[06:25-08:00|8] or [18:00-22:10]", "schrank2 on", "schrank2 off")<br />
</syntaxhighlight><br />
<br />
Bei dieser Vorgehensweise können weitere Szenarien durch Hinzufügen einer Array-Zeile erstellt werden, ohne den restlichen Code anpassen zu müssen. Desweitern können die Elemente des Arrays für Visualisierungszwecke über das [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg uiTable-Attribut] genutzt werden, siehe: [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien_mit_tabellarischer_.C3.9Cbersicht Helligkeitsabhängige Lichtsteuerung mit Web-Oberfläche]<br />
<br />
==Einfache Anwendungsbeispiele==<br />
<br />
===Treppenhauslicht mit Bewegungsmelder===<br />
<syntaxhighlight lang="perl"><br />
defmod di_light DOIF {\<br />
if (["FS:motion"]) { # bei Bewegung\<br />
fhem_set("lamp on") if ([?lamp] ne "on");; # Lampe einschalten, wenn sie nicht an ist\<br />
set_Exec("off",30,'fhem_set("lamp off")');; # Timer namens "off" für das Ausschalten der Lampe auf 30 Sekunden setzen bzw. verlängern\<br />
}\<br />
}<br />
</syntaxhighlight><br />
<br />
===Einknopf-Fernbedienung===<br />
<br />
'''Beispiel'''<br />
<br />
Wenn eine Taste innerhalb von zwei Sekunden zwei mal betätig wird, soll der Rollladen nach oben, bei einem Tastendruck nach unten:<br />
<syntaxhighlight lang="perl"><br />
defmod di_shutter DOIF {\<br />
if (["FS:^on$"] and !get_Exec("shutter")){ # wenn Taste betätigt wird und kein Timer läuft\<br />
set_Exec("shutter",2,'fhem_set("shutter down")');;#Timer zum shutter down auf zwei Sekunden setzen\<br />
} else { # wenn Timer läuft, d.h. ein weitere Tastendruck innerhalb von zwei Sekunden\<br />
del_Exec("shutter");; # Timer löschen\<br />
fhem_set("shutter up");; # Rollladen hoch\<br />
}\<br />
}<br />
</syntaxhighlight><br />
<br />
'''Aktion auslösen, wenn innerhalb einer bestimmten Zeitspanne ein Ereignis x mal auftritt'''<br />
<br />
'''Beispiel'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_count DOIF {\<br />
if (["FS:on"] and !get_Exec("counter")) { # wenn Ereignis (hier "FS:on") eintritt und kein Timer läuft\<br />
$_my_count=1;; # setze count-Variable auf 1\<br />
set_Exec("counter",3600,'Log (3,"count: $_my_count action") if ($_my_count > 10)');; # setze Timer auf eine Stunde zum Protokollieren der Anzahl der Ereignisse, wenn sie über 10 ist\<br />
} else {\<br />
$_my_count++;; # wenn Timer bereits läuft zähle Ereignis\<br />
}\<br />
}<br />
</syntaxhighlight><br />
<br />
==Weitere Anwendungsbeispiele im DOIF-Perl-Modus==<br />
===[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien Lichtsteuerung für mehrere Szenarien]===<br />
===[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Zeitgesteuerte_Heizungsregelung_mit_Hilfe_von_Raumthermostaten Steuerung von Raumthermostaten für mehrere Räume]===<br />
===[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien Beschattungssteuerung für mehrere Szenarien]===<br />
===[https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzahl_der_Tage_bis_zur_Abfall-Entsorgung Abfallentsorgung]===<br />
===[https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme Heiztherme]===<br />
===[https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Visualisierung:_Anwesenheitsstatus Anwesenheitsstatus]===<br />
[[Kategorie:HOWTOS]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38455DOIF/uiTable Schnelleinstieg2023-07-10T18:59:57Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik lässt sich beim Überstreichen mit dem Mauszeiger vergrößert darstellen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices wird für diesen Zweck folgende Zeile eingefügt:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden. Mögliche Klassen sind: DOIF_card, DOIF_ring, DOIF_bar, DOIF_cylinder.<br />
<br />
Es sollen nur Cards vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Es können ebenfalls mehrere Klassen mit Komma angegeben werden. Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_ring:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden. <br />
<br />
Auf Tablets und Smartphones wird im Browser die hover-Eigenschaft oft durch Antippen der Grafik ausgelöst.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht eines PCs:''<br />
[[Datei:hover.gif|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38454DOIF/uiTable Schnelleinstieg2023-07-10T18:59:32Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik lässt sich beim Überstreichen mit dem Mauszeiger vergrößert darstellen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices wird für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden. Mögliche Klassen sind: DOIF_card, DOIF_ring, DOIF_bar, DOIF_cylinder.<br />
<br />
Es sollen nur Cards vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Es können ebenfalls mehrere Klassen mit Komma angegeben werden. Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_ring:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden. <br />
<br />
Auf Tablets und Smartphones wird im Browser die hover-Eigenschaft oft durch Antippen der Grafik ausgelöst.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht eines PCs:''<br />
[[Datei:hover.gif|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38453DOIF/uiTable Schnelleinstieg2023-07-10T18:56:41Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden. Mögliche Klassen sind: DOIF_card, DOIF_ring, DOIF_bar, DOIF_cylinder.<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Es können ebenfalls mehrere Klassen mit Komma angegeben werden. Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_ring:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden. <br />
<br />
Auf Tablets und Smartphones wird im Browser die hover-Eigenschaft oft durch Antippen der Grafik ausgelöst.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht eines PCs:''<br />
[[Datei:hover.gif|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38452DOIF/uiTable Schnelleinstieg2023-07-10T18:53:32Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden. Mögliche Klassen sind: DOIF_card, DOIF_ring, DOIF_bar, DOIF_cylinder.<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Es können ebenfalls mehrere Klassen mit Komma angegeben werden. Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_ring:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hover.gif|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38451DOIF/uiTable Schnelleinstieg2023-07-10T18:51:47Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden. Mögliche Klassen sind: DOIF_card, DOIF_ring, DOIF_bar, DOIF_cylinder<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Es können ebenfalls mehrere Klassen mit Komma angegeben werden. Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_ring:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hover.gif|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38450DOIF/uiTable Schnelleinstieg2023-07-10T18:51:02Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden. Mögliche Klassen sind: DOIF_card, DOIF_ring, DOIF_bar, DOIF_cylinder<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Es können ebenfalls mehrere Klassen mit Komma angegeben werden. Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_ring:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
<br />
Anwendungsbeispiel<br />
[[Datei:hover.gif|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38449DOIF/uiTable Schnelleinstieg2023-07-10T18:50:38Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden. Mögliche Klassen sind: DOIF_card, DOIF_ring, DOIF_bar, DOIF_cylinder<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Es können ebenfalls mehrere Klassen mit Komma angegeben werden. Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_ring:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
Anwendungsbeispiel<br />
[[Datei:hover.gif|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=Datei:Hover.gif&diff=38448Datei:Hover.gif2023-07-10T18:46:07Z<p>Damian-s: Damian-s lud eine neue Version von Datei:Hover.gif hoch</p>
<hr />
<div></div>Damian-shttp://wiki.fhem.de/w/index.php?title=Datei:DOIF-hover.gif&diff=38447Datei:DOIF-hover.gif2023-07-10T18:42:46Z<p>Damian-s: Damian-s lud eine neue Version von Datei:DOIF-hover.gif hoch</p>
<hr />
<div>== Beschreibung ==<br />
Anwendungsbeispiel</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38446DOIF/uiTable Schnelleinstieg2023-07-10T18:41:36Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden.<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Weitere Klassen der anderen SVG-Grafiken sind: DOIF_ring, DOIF_bar, DOIF_cylinder <br />
<br />
Es können auch mehrere Klassen mit Komma kombiniert werden. <br />
<br />
Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_card:ring {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
[[Datei:hover.gif|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38445DOIF/uiTable Schnelleinstieg2023-07-10T18:33:39Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden.<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Weitere Klassen der anderen SVG-Grafiken sind: DOIF_ring, DOIF_bar, DOIF_cylinder <br />
<br />
Es können auch mehrere Klassen mit Komma kombiniert werden. <br />
<br />
Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_card:ring {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
[[Datei:hover|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38444DOIF/uiTable Schnelleinstieg2023-07-10T18:33:10Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden.<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Weitere Klassen der anderen SVG-Grafiken sind: DOIF_ring, DOIF_bar, DOIF_cylinder <br />
<br />
Es können auch mehrere Klassen mit Komma kombiniert werden. <br />
<br />
Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_card:ring {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
[[Datei:hover.gif|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38443DOIF/uiTable Schnelleinstieg2023-07-10T18:32:39Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden.<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Weitere Klassen der anderen SVG-Grafiken sind: DOIF_ring, DOIF_bar, DOIF_cylinder <br />
<br />
Es können auch mehrere Klassen mit Komma kombiniert werden. <br />
<br />
Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_card:ring {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
[[Datei:hover.gif|1000px|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38442DOIF/uiTable Schnelleinstieg2023-07-10T18:30:20Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden.<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Weitere Klassen der anderen SVG-Grafiken sind: DOIF_ring, DOIF_bar, DOIF_cylinder <br />
<br />
Es können auch mehrere Klassen mit Komma kombiniert werden. <br />
<br />
Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_card:ring {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
[[Datei:hover.gif|ohne]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38441DOIF/uiTable Schnelleinstieg2023-07-10T18:29:46Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden.<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Weitere Klassen der anderen SVG-Grafiken sind: DOIF_ring, DOIF_bar, DOIF_cylinder <br />
<br />
Es können auch mehrere Klassen mit Komma kombiniert werden. <br />
<br />
Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_card:ring {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
[[Datei:hover.gif|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=Datei:Hover.png&diff=38440Datei:Hover.png2023-07-10T18:28:47Z<p>Damian-s: </p>
<hr />
<div></div>Damian-shttp://wiki.fhem.de/w/index.php?title=Datei:DOIF-hover.gif&diff=38439Datei:DOIF-hover.gif2023-07-10T18:22:43Z<p>Damian-s: Anwendungsbeispiel</p>
<hr />
<div>== Beschreibung ==<br />
Anwendungsbeispiel</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38438DOIF/uiTable Schnelleinstieg2023-07-10T18:17:31Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden.<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Weitere Klassen der anderen SVG-Grafiken sind: DOIF_ring, DOIF_bar, DOIF_cylinder <br />
<br />
Es können auch mehrere Klassen mit Komma kombiniert werden. <br />
<br />
Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_card:ring {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
[[Datei:hover|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=Datei:Hover.gif&diff=38437Datei:Hover.gif2023-07-10T18:16:18Z<p>Damian-s: </p>
<hr />
<div></div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38436DOIF/uiTable Schnelleinstieg2023-07-10T18:15:15Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden.<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Weitere Klassen der anderen SVG-Grafiken sind: DOIF_ring, DOIF_bar, DOIF_cylinder <br />
<br />
Es können auch mehrere Klassen mit Komma kombiniert werden. <br />
<br />
Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_card:ring {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
[[Datei:hover|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38435DOIF/uiTable Schnelleinstieg2023-07-10T16:35:36Z<p>Damian-s: /* SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann für diesen Zweck folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden, so muss deren Klasse angegeben werden:<br />
<br />
Es sollen nur Cards sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Weitere Klassen der anderen SVG-Grafiken sind: DOIF_ring, DOIF_bar, DOIF_cylinder <br />
<br />
Es können auch mehrere Klassen mit Komma kombiniert werden. <br />
<br />
Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_card:ring {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38434DOIF/uiTable Schnelleinstieg2023-07-10T16:34:11Z<p>Damian-s: /* Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion cylinder_bars */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
====<big>SVG-Grafiken beim Überstreichen mit dem Mauszeiger vergrößern</big>====<br />
Eine SVG-Grafik kann beim Überstreichen mit dem Mauszeiger vergrößert darstellen lassen. Dazu kann die hover-HTML-Eigenschaft genutzt werden.<br />
<br />
Im Css-Attribut des FHEMWEB-Devices kann folgende Zeile eingefügt werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
svg:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Sollen nur bestimmte SVG-Grafiken vergrößert werden so muss deren Klasse angegeben werden:<br />
<br />
Nur cards sollen vergrößert werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Weitere Klassen der anderen SVG-Grafiken sind: DOIF_ring, DOIF_bar, DOIF_cylinder <br />
<br />
Es können auch mehrere Klassen mit Komma kombiniert werden. <br />
<br />
Cards und Ringe sollen vergrößert werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
.DOIF_card:hover,.DOIF_card:ring {transition: transform 0.3s ease; transform: scale(2.0); transform-origin: 0 0;z-index: 9999; position:relative}<br />
</syntaxhighlight><br />
<br />
Da es sich um eine allgemeingültige CSS-Definition handelt, können mit CSS-Kenntnissen durch Anpassung der Definition ebenfalls auch andere Transformationen der Grafiken vorgenommen werden.<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38410DOIF/uiTable Schnelleinstieg2023-06-08T07:56:22Z<p>Damian-s: </p>
<hr />
<div>[[Datei:UiTable state state.jpg|1000px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38409DOIF/uiTable Schnelleinstieg2023-06-08T07:53:12Z<p>Damian-s: /* Visualisierung und Steuerung: Heiztherme */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|800px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38408DOIF/uiTable Schnelleinstieg2023-06-08T07:52:27Z<p>Damian-s: /* Visualisierung: Wetterstation */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|800px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|800px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|800px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38407DOIF/uiTable Schnelleinstieg2023-06-08T07:50:40Z<p>Damian-s: /* Anwendungsbeispiele mit card */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|800px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|500px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38406DOIF/uiTable Schnelleinstieg2023-06-08T07:50:21Z<p>Damian-s: /* Anwendungsbeispiele mit card */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|800px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|600px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38405DOIF/uiTable Schnelleinstieg2023-06-08T07:49:58Z<p>Damian-s: /* Energieverbrauch verschiedener Zeiträume */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|800px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|400px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|800px]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38404DOIF/uiTable Schnelleinstieg2023-06-08T07:49:09Z<p>Damian-s: /* Anwendungsbeispiele mit card */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|800px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|400px]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|mini]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38403DOIF/Automatisierung2023-06-08T07:43:46Z<p>Damian-s: /* Steuerung von Raumthermostaten für mehrere Räume mit GUI */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|600px|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|600px|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|800px|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, des letzten Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|1000px|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38402DOIF/Automatisierung2023-06-08T07:43:20Z<p>Damian-s: /* Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|600px|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|600px|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|600px|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, des letzten Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|1000px|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38401DOIF/Automatisierung2023-06-08T07:42:48Z<p>Damian-s: /* Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|600px|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|600px|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|600px|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, des letzten Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|800px|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38400DOIF/Automatisierung2023-06-08T07:41:38Z<p>Damian-s: /* Steuerung von Raumthermostaten für mehrere Räume mit GUI */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|600px|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|600px|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|600px|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, des letzten Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|mini|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38399DOIF/Automatisierung2023-06-08T07:41:01Z<p>Damian-s: /* Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|600px|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|600px|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|mini|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, des letzten Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|mini|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38398DOIF/Automatisierung2023-06-08T07:39:51Z<p>Damian-s: /* Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|600px|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|mini|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|mini|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, des letzten Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|mini|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38397DOIF/Automatisierung2023-06-08T07:39:24Z<p>Damian-s: /* Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|400px|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|mini|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|mini|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, des letzten Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|mini|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38396DOIF/Automatisierung2023-06-08T07:36:56Z<p>Damian-s: /* Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|mini|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|mini|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|mini|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, des letzten Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|mini|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38395DOIF/Automatisierung2023-06-08T07:36:15Z<p>Damian-s: /* Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|mini|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|mini|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, des letzten Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|mini|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38363DOIF/uiTable Schnelleinstieg2023-05-14T12:32:42Z<p>Damian-s: </p>
<hr />
<div>[[Datei:UiTable state state.jpg|800px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|mini]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|mini]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=Datei:UiTable_state_state.jpg&diff=38362Datei:UiTable state state.jpg2023-05-14T12:14:28Z<p>Damian-s: Damian-s lud eine neue Version von Datei:UiTable state state.jpg hoch</p>
<hr />
<div></div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38360DOIF/uiTable Schnelleinstieg2023-05-11T19:12:34Z<p>Damian-s: </p>
<hr />
<div>[[Datei:UiTable state state.jpg|700px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition [https://wiki.fhem.de/wiki/Import_von_Code_Snippets] ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|mini]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|mini]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=Datei:Di_counter.png&diff=38355Datei:Di counter.png2023-05-06T19:19:30Z<p>Damian-s: Damian-s lud eine neue Version von Datei:Di counter.png hoch</p>
<hr />
<div></div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38354DOIF/Automatisierung2023-05-06T19:18:33Z<p>Damian-s: /* Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|mini|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|mini|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|mini|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, des letzten Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|mini|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/Automatisierung&diff=38353DOIF/Automatisierung2023-05-06T19:17:49Z<p>Damian-s: /* Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler */</p>
<hr />
<div>An dieser Stelle werden Lösungen für praxisrelevante Automatisierungsaufgaben mit Hilfe des DOIF-Moduls vorgestellt. Insbesondere werden mit Hilfe von Templates generische DOIF-Lösungen an konkreten Beispielen dargestellt, die für mehrere Szenarien nutzbar sind.<br><br />
<br><br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden.<br><br />
<br><br />
== Licht ==<br />
=== Einfache Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Zeitsteuerung siehe Commandref: Zeitsteuerung]<br />
}}<br />
Anforderung: Lichter sollen in einem bestimmten Zeitraum leuchten.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([21:00-23:00])\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für ein Szenario ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Kombination_von_Ereignis_und_Zeitsteuerung_mit_logischen_Abfragen siehe Commandref: logische Abfragen]<br />
}}<br />
Anforderung: Lichter sollen innerhalb eines Zeitraums leuchten, aber nur wenn es dunkel ist.<br />
<br />
'''Beispieldefinition für Dunkelheit'''<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches mit Hilfe eines Helligkeitssensors den Zustand "on" bei Dunkelheit annimmt, sonst "off"<br />
<syntaxhighlight lang="perl"><br />
defmod Dunkelheit DOIF ([Helligkeitssensor:brightness] < 100) DOELSE<br />
attr Dunkelheit cmdState on|off<br />
</syntaxhighlight><br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_licht DOIF ([16:00-23:00] and [Dunkelheit] eq "on")\<br />
(set Lampeflur on, set Lampekueche on)\<br />
DOELSE\ <br />
(set Lampeflur off, set Lampekueche off)<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für alle Lichtszenarien programmiert werden.<br />
* Verschiedene Lichtszenarien sollen über Angabe bestimmter Parameter generiert werden. <br />
* Eine Lichtszene soll durch folgende Angaben definierbar sein: Szenenname, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl, Zeitraum des Jahres. <br />
* Eine neue Szene soll durch Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_tpl DOIF DEF TPL_light ( ## Definition des Templates namens TPL_light zur Steuerung einer Lichtszene\<br />
light_$1 { ## DOIF Block\<br />
## Parameter: Szene Daemmerungssensor Zeitspanne on off von bis\<br />
## Nr.: $1 $2 $3 $4 $5 $6 $7\<br />
if ($md ge "$6" or $md le "$7") { ## wenn innerhalb der Jahreszeit (von bis)\<br />
if (($3) and [$2] eq "on") { ## wenn in der Zeitspanne und Dämmerung on\<br />
fhem_set($4);; ## schalte on-Befehle\<br />
set_State("Szene: $1");; ## Setze Status des DOIF-Moduls\<br />
} else {\<br />
fhem_set ($5);; ## sonst, schalte off-Befehle\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Beschattungsszene mit Hilfe des obigen Templates\<br />
TPL_light (Erdgeschoss,Daemmerung2,([06:25-08:00|8] or [15:00-23:00]),"Lampekueche,LampeFlur on","Lampekueche,LampeFlur off",01-01, 12-31)\<br />
TPL_light (Kind2,Daemmerung2,[06:25-08:00|8] or [15:00-23:10],"schrank2 on","schrank2 off",12-01,03-31)\<br />
TPL_light (Terrasse,Dunkelheit,[17:00-23:05],"Terrasse on","Terrasse off",01-01,12-31)\<br />
TPL_light (Garten,Dunkelheit,[16:00-23:30],"Garten pct 50","Garten off",01-01,12-31)\<br />
## ... hier können weitere Szenarien durch hinzufügen weiterer Zeilen generiert werden<br />
</syntaxhighlight><br />
<br />
=== Helligkeitsabhängige Zeitsteuerung für mehrere Szenarien mit tabellarischer Übersicht===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Helligkeitsabh.C3.A4ngige_Zeitsteuerung_f.C3.BCr_mehrere_Szenarien siehe Zeitsteuerung für mehrere Szenarien ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg siehe Tabellendefinitionen mit Attribut uiTable]<br />
}}<br />
Anforderung:<br />
* Es soll nur eine Steuerung für mehrere Lichtszenarien programmiert werden.<br />
* Ein Lichtszenario soll durch folgende Angaben definierbar sein: Szenario-Name, Daemmerungssensor (on/off), Zeitspanne, Einschaltbefehl, Ausschaltbefehl<br />
* Ein neues Szenario soll durch hinzufügen einer Parameterzeile erstellt werden können. <br />
* Erstellte Lichtszenarien sollen tabellarisch dargestellt werden und über Weboberfläche einzeln schaltbar sein: auto/on/off<br />
<br />
'''Beispieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Licht_all DOIF subs {\<br />
## Ein Szenario wird durch Hinzufügen einer Definitionszeile erstellt\<br />
## Szene Dämmerungssensor Zeitspanne Einschaltbefehl Ausschaltbefehl\<br />
push (@{$_sc},["Erdgeschoss","Daemmerung2", "[06:25-08:00|8] or [15:00-23:30]", "Lampekueche,Lampeflur on", "Lampekueche,Lampeflur off"]);;\<br />
push (@{$_sc},["Kinderz_2", "Daemmerung2", "[06:25-08:00|8] or [15:00-23:10]", "schrank2 on", "schrank2 off"]);;\<br />
push (@{$_sc},["Terrasse", "Dunkelheit", "[16:00-23:30]", "Terrasse on", "Terrasse off"]);;\<br />
push (@{$_sc},["Garten", "Dunkelheit", "[16:00-23:30]", "Garten pct 50", "Garten off"]);;\<br />
push (@{$_sc},["Strauch1", "Dunkelheit", "[17:00-23:05]", "Strauch1 on", "Strauch1 off"]);;\<br />
push (@{$_sc},["Strauch2", "Dunkelheit", "[17:00-23:05]", "Strauch2 on", "Strauch2 off"]);;\<br />
push (@{$_sc},["Eingang", "Dunkelheit", "[17:00-23:35]", "Aussenbeleuchtung on", "Aussenbeleuchtung off"]);;\<br />
\<br />
\<br />
## Bei Änderung der Definition werden erfoderliche Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");;\<br />
set_State("initialized");;\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading ($_sc[$i][0].".Status","off");;\<br />
set_Reading ($_sc[$i][0].".aktiv","off");;\<br />
}\<br />
}\<br />
} ## end of subs\<br />
\<br />
DEF TPL_light ( ## Definition des Templates namens TPL_light\<br />
light_$1 { ## Parameter: Szene Daemmerung Zeitspanne on off \<br />
## $1 $2 $3 $4 $5\<br />
if ([$SELF:$1.aktiv] eq "auto") {\<br />
if (($3) and [$2] eq "on") {\<br />
fhem_set($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
} else {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
}\<br />
} ## Ende des light-Blocks\<br />
\<br />
active_$1 {\<br />
if ([$SELF:$1.aktiv] eq "on") {\<br />
fhem_set ($4);;\<br />
set_Reading("$1.Status","on",1);;\<br />
}\<br />
if ([$SELF:$1.aktiv] eq "off") {\<br />
fhem_set ($5);;\<br />
set_Reading("$1.Status","off",1);;\<br />
}\<br />
} ## Ende des active-Blocks \<br />
) ## Ende der Templatedefinition\<br />
\<br />
## Generierung der Steuerung pro Licht-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_light($_$1,$_$2,$_$3,"$_$4","$_$5"))<br />
attr di_Licht_all room Licht<br />
attr di_Licht_all uiTable {\<br />
package ui_Table;;\<br />
$TC{1..5}="style='padding-left: 2px;; padding-right: 2px;;' align='center'";;\<br />
\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Dämmerung"|"Zeitspanne"|"Status"|"ausgeführt"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Licht-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|icon([$_$2])|"$_$3"|icon([$SELF:$_$1.Status])|::ReadingsTimestamp("$SELF","$_$1.Status",0)|WID([$SELF:$_$1.aktiv],"select,auto,on,off"))<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Licht_Szenarien.png|mini|ohne]]<br />
<br />
== Beschattung ==<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien ===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
* [https://forum.fhem.de/index.php/topic,111266.msg1054775.html#msg1054775 siehe Forum-Beitrag: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor, von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren. <br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen eines Template-Aufrufs erstellt werden können.<br />
<br />
Zunächst wird ein DOIF-Modul definiert, welches verzögert mit Hilfe einer PV-Anlage den Zustand "on" bei Sonneneinstrahlung annimmt, sonst "off".<br />
<br />
'''Beispieldefinition für Sonneneinstrahlung'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sonne_s DOIF ([zaehler:PV-Leistung] > 2.5)<br />
attr Sonne_s cmdState on|off<br />
attr Sonne_s wait 1800:7200<br />
</syntaxhighlight><br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung1 DOIF DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter\<br />
## Parameternummer $1 $2 $3 $4 $5 $6 $7 $8 \<br />
## Bedeutung Name der Szene Temperatursensor des Zimmers Sonnensensor von Uhrzeit bis Uhrzeit Rollladen Befehl zum Herunterfahren Befehl zum Hochfahren\<br />
shutter_$1 { ## DOIF Block\<br />
if ([$4-$5]) { ## innerhalb des Zeitfensters \<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and !$VAR{$1}) { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und die Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$6 $7");; ## Fenster herunterfahren\<br />
set_State("Szene: $1 Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=1;; ## Merker setzen, dass Fenster bereits heruntergefahren wurde\<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and $VAR{$1}) { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und die Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$6 $8");; ## Fenster hochfahren\<br />
set_State("Szene: $1 keine Beschattung");; ## Status mit letztem Befehl belegen \<br />
$VAR{$1}=0;; ## Merker zurücksetzen\<br />
}\<br />
} \<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];;delete $VAR;;} ## DOIF-Block namens reset um nachts alle Merker zu löschen\<br />
\<br />
## Definition einzelner DOIF-Blöcke pro Fenstergruppe mit Hilfe des Templates\<br />
## $1 $2 $3 $4 $5 $6 $7 $8\<br />
TPL_shutter (Dachgeschoss,TH_DG_HM,Sonne_s,12:00,21:00,R_DG,30,on)\<br />
TPL_shutter (Kueche,TH_Kueche_HM,Sonne_s,09:00,14:00,R_Kueche,50,on)\<br />
TPL_shutter (Kinderzimmer1_ost,TH_Kz_o_HM,Sonne_s,09:00,14:00,R_Kinderzimmer1_O,30,on)\<br />
TPL_shutter (Kinderzimmer1_sued,TH_Kz_o_HM,Sonne_s,12:00,21:00,R_Kinderzimmer1_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_sued,TH_Kz_w_HM,Sonne_s,12:00,21:00,R_Kinderzimmer2_S,25,on)\<br />
TPL_shutter (Kinderzimmer2_west,TH_Kz_w_HM,Sonne_w,15:30,22:00,R_Kinderzimmer2_W.*,25,on)\<br />
TPL_shutter (Wohnzimmmer_sued,TH_WZ_HM,Sonne_s,12:30,21:00,R_W_S,25,on)\<br />
TPL_shutter (Wohnzimmer_west,TH_WZ_HM,Sonne_w,15:30,22:00,R_W_W[23],25,on)\<br />
## hier können weitere Szenarien für weitere Fenster hinzugefügt werden<br />
</syntaxhighlight><br />
<br />
=== Beschattungssteuerung abhängig von der Zimmertemperatur und Sonneneinstrahlung für mehrere Szenarien mit Visualisierung===<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus siehe Commandref: DOIF-Perlmodus]<br />
*[https://wiki.fhem.de/wiki/DOIF/Automatisierung#Beschattungssteuerung_abh.C3.A4ngig_von_der_Zimmertemperatur_und_Sonneneinstrahlung_f.C3.BCr_mehrere_Szenarien siehe: Beschattungssteuerung ohne Visualisierung]<br />
* [https://wiki.fhem.de/wiki/DOIF/Templates siehe: Generalisierung mit Templates]<br />
}}<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für alle Beschattungsszenarien erstellt werden.<br />
* Ein Beschattungsszenario soll durch folgende Angaben definierbar sein: Name der Szene, Temperatursensor des Zimmers, Sonnensensor(on/off), von Uhrzeit, bis Uhrzeit, Rollläden, Befehl zum Herunterfahren, Befehl zum Hochfahren, Status, Modus(aktiv/deaktiv)<br />
* Ein neues Beschattungsszenario soll nur durch das Hinzufügen einer Parameter-Zeile erstellt werden können.<br />
* Erstellte Beschattungsszenarien sollen automatisch tabellarisch dargestellt werden und einzeln abschaltbar sein.<br />
'''Beispieldefinition des Steuermoduls'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_beschattung2 DOIF subs {\<br />
@{$_params}= qw( Szene Temperatursensor Sonnensensor Rollladen runter hoch von bis Status aktiv);;\<br />
\<br />
## Definition einzelner Datensätze pro Szene, Szenen können zeilenweise gelöscht bzw. hinzugefügt werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM Sonne_s R_Bad 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM Sonne_s R_Dachboden 30 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM Sonne_s R_Kueche 50 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_ost TH_Kz_o_HM Sonne_s R_Kinderzimmer1_O 30 on 09:00 14:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_1_sued TH_Kz_o_HM Sonne_s R_Kinderzimmer1_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_sued TH_Kz_w_HM Sonne_s R_Kinderzimmer2_S 25 on 13:00 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Kinderzimmer_2_west TH_Kz_w_HM Sonne_w R_Kinderzimmer2_W.* 25 on 15:30 22:00 off on)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer_west TH_WZ_HM Sonne_w R_W_W[23] 25 on 15:30 22:00 off on)]);;\<br />
\<br />
if ($::init_done) { ## Bei Änderung der Definition werden alle erfoderlichen Readings erstellt und vorbelegt\<br />
fhem("deletereading $SELF .*");; ## alle Readings des Moduls löschen\<br />
set_State("initialized");; ## Status setzen\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
for (my $j=6;;$j < @{$_sc[$i]};;$j++) { ## für Parameter 7 bis 10 Readings anlegen\<br />
set_Reading ($_sc[$i][0].".".$_params[$j],$_sc[$i][$j]);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub reset_state {\<br />
for (my $i=0;;$i < @{$_sc};;$i++) {\<br />
set_Reading($_sc[$i][0].".Status","off",1);;\<br />
}\<br />
\<br />
}\<br />
}\<br />
\<br />
DEF TPL_shutter ( ## Definition des Templates namens TPL_shutter, Parameter: $1:Szenenname, $2:Temperatursensor, $3:Sonnensonsor, $4:Rollläden, $5:runter, $6:hoch, $7:von, $8:bis, $9:Status, $10:aktiv \<br />
shutter_$1 { \<br />
if ($10 eq "on" and [$7-$8]) { ## wenn Szene aktiv und innerhalb des Zeitfensters\<br />
if ([$2:measured-temp] > 24 and [$3] eq "on" and get_Reading("$9") eq "off") { ## Wenn die Zimmertemperatur über 24 und Sonne scheint und Rollläden noch nicht heruntergefahren wurden\<br />
fhem_set("$4 $5");; ## Rollläden herunterfahren\<br />
set_State("Szene: $1 $5");; ## Status setzen\<br />
set_Reading("$1.Status","on",1);; ## Status für Szene im Reading ablegen \<br />
} elsif ([$2:measured-temp] < 23.5 and [$3] eq "off" and get_Reading("$9") eq "on") { ## Wenn die Zimmertemperatur unter 23.5 und Sonne scheint nicht und Rollläden bereits heruntergefahren wurden\<br />
fhem_set("$4 $6");; ## Rollläden hochfahren\<br />
set_State("Szene: $1 $6");; ## Status mit letzer Szene belegen\<br />
set_Reading("$1.Status","off",1);; ## Status für Szene im Reading ablegen\<br />
}\<br />
}\<br />
}\<br />
) ## Ende der Templatedefinition\<br />
\<br />
reset {[00:01];; reset_state();;} ## nachts alle Status zurücksetzen\<br />
\<br />
## Generierung der Steuerung pro Beschattung-Szene mit Hilfe des obigen Templates\<br />
FOR (@{$_sc},TPL_shutter($_$1,$_$2,$_$3,$_$4,$_$5,$_$6,[$SELF:$_$1.von],[$SELF:$_$1.bis],$_$1.Status,[$SELF:$_$1.aktiv]))\<br />
<br />
attr di_beschattung2 uiTable {\<br />
package ui_Table;;\<br />
$TC{1..10}="style='padding-left: 10px;; padding-right: 10px;; padding-top: 3px;; padding-bottom: 3px;;' align='center'";;\<br />
}\<br />
\<br />
## Überschrift der Parameter\<br />
"Szene"|"Temperatur"|"Einstrahlung"|"von"|"bis"|"Status"|"aktiv"\<br />
\<br />
## Pro Datensatz einer Beschattungs-Szene wird eine Zeile mit Werten und Widgets generiert\<br />
FOR (@{$VAR{sc}},"$_$1"|temp_ring([$_$2:measured-temp])|icon([$_$3:state],"fa_cloud","weather_sun\@yellow")|[$SELF:$_$1.von]|[$SELF:$_$1.bis]|icon([$SELF:$_$1.Status],"fts_shutter_10","fts_shutter_80").substr(::ReadingsTimestamp("$SELF","$_$1.Status",0),11,5)|WID([$SELF:$_$1.aktiv],"select,on,off"))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:beschattung2.png|mini|ohne]]<br />
<br />
== Zeitgesteuerte Heizungsregelung mit Hilfe von Raumthermostaten ==<br />
Die folgenden Beispiele funktioniert mit HM-Wandthermostaten. Sie können ebenso für andere Thermostate oder Module wie THRESHOLD entsprechend angepasst werden.<br />
=== Steuerung von Raumthermostaten für mehrere Räume ohne GUI ===<br />
'''Beispieldefinition mit einem Template im DOIF-Perlmodus'''<br />
<br />
Zeiten, Raumthermostate und Temperaturen werden in der Definition selbst festgelegt und werden dort geändert. Im Status des Moduls werden zur Laufzeit die aktuell gesetzten Temperaturen festgehalten.<br />
<syntaxhighlight lang="perl"><br />
defmod di_Thermostate DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\<br />
{$1;; ## Zeitangabe\<br />
set_State("KU $2, BA $3, DG $4, WZ $5, KO $6, KW $7,Ke $8");;\<br />
fhem_set"TH_Kueche_HM desired-temp $2";;\<br />
fhem_set"TH_Bad_HM desired-temp $3";;\<br />
fhem_set"TH_DG_HM desired-temp $4";;\<br />
fhem_set"TH_WZ_HM desired-temp $5";;\<br />
fhem_set"TH_Kz_o_HM desired-temp $6";;\<br />
fhem_set"TH_Kz_w_HM desired-temp $7";;\<br />
fhem_set"TH_Keller_HM desired-temp $8";;\<br />
}\<br />
)\<br />
## Zeit Ku,Ba,DG,Wz,Ko,Kw,Ke\<br />
## $1 $2 $3 $4 $5 $6 $7 $8<br />
morgens_ein TPL_set_temp ([05:00|8] or [05:30|7],21,21,21,21,21,21,22)\<br />
morgens_aus TPL_set_temp ([08:00|8] or [09:00|7],20,20,20,21,20,20,21)\<br />
mittags_ein TPL_set_temp ([12:00], 21,20,21,22,19,21.5,21.5)\<br />
abends_aus TPL_set_temp ([20:00], 21,20,20,20,20,20,21)<br />
</syntaxhighlight><br />
<br />
=== Steuerung von Raumthermostaten für mehrere Räume mit GUI ===<br />
<br />
Anforderung: <br />
* Es soll nur eine zentrale Steuerungslogik für das Setzen der Temperaturen für alle Räume mit einer Fußbodenheizung erstellt werden.<br />
* Anzahl der Zeitpunkte zum Setzen der Vorgabetemperaturen soll einfach veränderbar sein.<br />
* Das Hinzufügen bzw. Löschen von Räumen soll durch Hinzufügen oder Löschen jeweils einer Zeile möglich sein.<br />
* Das Ändern der Temperaturen sowie das Ändern der Schaltzeitpunkte soll über WEB-Oberfläche möglich sein.<br />
* Das temporäre Ändern der aktuellen Vorgabetemperatur bis zum nächsten Schaltzeitpunkt soll über WEB-Oberfläche möglich sein.<br />
* Die aktuelle Temperatur des Zimmers und der Zustand der Thermostats (on/off) soll visualisiert werden.<br />
* Schaltzeiten sollen für Wochentage und Wochenende (Ferien) separat einstellbar sein.<br />
* Das Setzen der Wunschtemperatur soll pro Raum abschaltbar sein.<br />
<br />
Das folgende Beispiel wurde für eine Fußbodenheizung mit Stellantrieben programmiert. Die Thermostate sind jeweils direkt mit einem Schalter gepeert. Die Schalter schalten ihrerseits per ON/OFF-Befehl die Stellantriebe des Raumes.<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Therm DOIF subs {\<br />
## Schaltzeitpunkte, Liste kann angepasst werden \<br />
@{$_Timer}= qw(morgens vormittags nachmittags abends);;\<br />
@{$_Timer_default_at} = qw(04:30 08:00 13:00 22:00);;\<br />
@{$_Timer_default_we} = qw(05:30 09:00 13:00 22:00);;\<br />
$_temp_default_at=20;; ## Wunschtemperaturvorgabe für Arbeitstage\<br />
$_temp_default_we=20;; ## Wunschtemperaturvorgabe fürs Wochenende\<br />
$_temp_default_diff=1;; ## Reduzierung der Wunschtemperatur außerhalb der Heizzeiten um X-Grad\<br />
\<br />
\<br />
## Angaben: Raumbezeichnung, Thermostat, Schalter;; Angaben können zweilenweise erweitert werden\<br />
push (@{$_sc},[qw(Bad TH_Bad_HM H_Bad)]);;\<br />
push (@{$_sc},[qw(Dachgeschoss TH_DG_HM H_DG)]);;\<br />
push (@{$_sc},[qw(Kueche TH_Kueche_HM H_Kueche)]);;\<br />
push (@{$_sc},[qw(Kinder_ost TH_Kz_o_HM H_Kz_o)]);;\<br />
push (@{$_sc},[qw(Kinder_west TH_Kz_w_HM H_Kz_w)]);;\<br />
push (@{$_sc},[qw(Wohnzimmer TH_WZ_HM H_WZ)]);;\<br />
push (@{$_sc},[qw(Schlafzimmer TH_Keller_HM H_Keller)]);;\<br />
push (@{$_sc},[qw(Keller TH_AKeller_HM H_AKeller)]);;\<br />
\<br />
## Bei Initialisierung oder Änderung der Definition werden Timer-Readings und Temperatur-Readings erstellt und vorbelegt\<br />
if ($::init_done) {\<br />
fhem("deletereading $SELF .*");; ## Lösche alle Readings\<br />
for (my $j=0;;$j<@{$_Timer};;$j++) { ## Für alle Timer\<br />
set_Reading($_Timer[$j],$_Timer_default_at[$j]);; ## Vorbelegung der Zeit für Arbeitstage\<br />
set_Reading("$_Timer[$j]_WE",$_Timer_default_we[$j]);; ## Vorbelegung der Zeit für Wochenende\<br />
for (my $i=0;;$i < @{$_sc};;$i++) { ## Vorbelegung der Wunschtemperaturen für alle Räume\<br />
set_Reading("$_sc[$i][0]_mode","auto");;\<br />
set_Reading("$_sc[$i][0]_temp_at_$_Timer[$j]",$j % 2 ? $_temp_default_at-$_temp_default_diff: $_temp_default_at);;\<br />
set_Reading("$_sc[$i][0]_temp_we_$_Timer[$j]",$j % 2 ? $_temp_default_we-$_temp_default_diff: $_temp_default_we);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub temp_at_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt an Arbeitstagen\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_at_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
sub temp_we_set { ## Routine zum Setzen der Wunschtemperaturen aller Räume für einen Zeitpunkt am Wochenende\<br />
my ($timer)=@_;;\<br />
for (my $i=0;;$i< @{$_sc};;$i++) {\<br />
fhem_set("$_sc[$i][1] desired-temp ".get_Reading ("$_sc[$i][0]_temp_we_$timer")) if (get_Reading("$_sc[$i][0]_mode") eq "auto");;\<br />
}\<br />
}\<br />
} ## subs\<br />
\<br />
DEF TPL_set_temp ( ## Definition des Templates namens TPL_set_temp zum Setzen der Thermostat-Vorgabetemperatur\<br />
Timer_at_$1 {[$2|AT];;temp_at_set("$1")} ## Block zum Setzen der Wunschtemperatur an Arbeitstagen, Parameter: $1:Timername, $2:Time_AT\<br />
Timer_we_$1 {[$3|WE];;temp_we_set("$1")} ## Block zum Setzen der Wunschtemperatur am Wochenende, Parameter: $1:Timername, $3:Time_WE\<br />
) ## TPL_set_temp\<br />
\<br />
## Generierung der Steuerung pro Raum mit Hilfe des obigen Templates\<br />
FOR(@{$_Timer},TPL_set_temp($1,[$SELF:$_],[$SELF:$1_WE]))<br />
attr di_Therm room Heizung<br />
attr di_Therm uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:right;;';;\<br />
$TD{0}{2..6} = "align='center'";;\<br />
$TC{0}="align='left'";;\<br />
\<br />
sub onoff_hue {\<br />
my($redblue)=@_;;\<br />
return ($redblue == 0 ? 240 : 0);; \<br />
}\<br />
}\<br />
\<br />
""|""|""|FOR (@{$_Timer},"$1"|)""\<br />
""|""|"Arbeitstage"|FOR (@{$_Timer},WID([$SELF:$1],"time")|)""\<br />
""|""|"Wochenende"|FOR (@{$_Timer},WID([$SELF:$1_WE],"time")|)""\<br />
FOR (@{$_sc},\<br />
("$1$1"|\<br />
card([$1$2:measured-temp:col1d],undef,\<br />
[$1$3:state] eq "off" ? "sani_floor_heating_neutral\@silver" : "sani_floor_heating\@red" ,15,25,\<br />
undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,1,1,1,1,,200",\<br />
undef,undef,[$1$3:state:col1d:$_ eq "on" ? 1:0],0,5,0,0,"I-O",\&onoff_hue,"0,,fill:silver")|\<br />
"Modus:".widget([$SELF:$1$1_mode],"select,auto,off"),,"aktuell:".widget([$1$2:desired-temp],"selectnumbers,18,0.5,22,1,lin","set")|\<br />
FOR(@{$_Timer},\<br />
("AT: ".widget([$SELF:$1$1_temp_at_$2],"selectnumbers,18,0.5,22,1,lin"),,"WE: ".widget([$SELF:$1$1_temp_we_$2],"selectnumbers,18,0.5,22,1,lin")|))\<br />
""\<br />
)\<br />
)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Raumthermostate.png|mini|ohne]]<br />
<br />
== Tages-, Monats- und Jahresstatistik für Strom-, Gas-, Wasserzähler und andere Zähler==<br />
<br />
Anforderung: <br />
* Zähler sollen durch Angabe des Devicenamens und Readings des Zählers hinzugefügt werden können<br />
* Es soll der aktuelle Stunden-, Tages-, Monats- und Jahreswert berechnet werden<br />
* Es soll der Wert der letzten Stunde, Tages, Monats und Jahres berechnet werden<br />
* Die Werte sollen geloggt werden<br />
* Die Werte sollen im DOIF visualisiert werden können<br />
<br />
'''Beispieldefinition im DOIF-Perlmodus'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_counter_new DOIF subs {\<br />
## Device Reading hier die push-Zeilen löschen bzw. durch eigene Readings ersetzen\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_w"]);; ## Wasserzähler\<br />
push (@{$_counter},["counter_rw","total_l"]);; ## Leitungswasser\<br />
push (@{$_counter},["counter_rw","total_z"]);; ## Regenwasser\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_pv"]);; ## Solarenergie\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_c"]);; ## Bezugszähler\<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_f"]);; ## Einspeisezähler \<br />
push (@{$_counter},["MQTT2_DVES_C58DCB","total_gas"]);; ## Gaszähler \<br />
push (@{$_counter},["vaillant","total_h"]);; ## Gasverbrauch Heizung + Warmwasser\<br />
push (@{$_counter},["vaillant","total_hc"]);; ## Gasverbrauch Heizung\<br />
push (@{$_counter},["vaillant","total_hwc"]);; ## Gasverbrauch Warmwasser \<br />
push (@{$_counter},["di_tibber","costsSum"]);; ## Stromkosten \<br />
\<br />
## Die restliche Code-Definition muss nicht angepasst werden\<br />
## Anpassung der Visualisierung wird im uiTable-Attribut weiter unten vorgenommen\<br />
\<br />
sub hour { ## Diese Funktion wird zur vollen Stunde ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading ("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading ("$device.$reading.last_hour",get_Reading("$device.$reading.hour",0),1);;\<br />
set_Reading ("$device.$reading.hour",0,1);;\<br />
set_Reading ("$device.$reading.day",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.day_counter",0)))*1000)/1000,1);;\<br />
\<br />
}\<br />
\<br />
sub midnight { ## Diese Funktion wird um Mitternacht ausgeführt\<br />
my ($device,$reading,$mday,$yday)=@_;;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.last_day",get_Reading("$device.$reading.day",0),1);;\<br />
set_Reading("$device.$reading.day",0,1);;\<br />
set_Reading ("$device.$reading.month",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.month_counter",0)))*1000)/1000,1);;\<br />
set_Reading ("$device.$reading.year",int((ReadingsVal($device, $reading,0)-(get_Reading("$device.$reading.year_counter",0)))*1000)/1000,1);;\<br />
\<br />
if ($mday == 1) {\<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_month",get_Reading("$device.$reading.month",0),1);;\<br />
set_Reading("$device.$reading.month",0,1);;\<br />
if ($yday == 0) {\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.last_year",get_Reading("$device.$reading.year",0),1);;\<br />
set_Reading("$device.$reading.year",0,1);;\<br />
}\<br />
}\<br />
}\<br />
\<br />
sub init_readings {\<br />
my ($device,$reading)=@_;;\<br />
if (get_Reading("$device.$reading.day_counter","") eq "") { ## Initialisierung der Readings\<br />
## aktuellen Zählerstand initialisieren\<br />
set_Reading("$device.$reading.last_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.hour_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.day_counter",ReadingsVal($device, $reading,0));; \<br />
set_Reading("$device.$reading.month_counter",ReadingsVal($device, $reading,0));;\<br />
set_Reading("$device.$reading.year_counter",ReadingsVal($device, $reading,0));;\<br />
\<br />
set_Reading ("$device.$reading.hour",0);; ## aktueller Stundenverbrauch\<br />
set_Reading ("$device.$reading.day",0);; ## aktueller Tagesverbrauch\<br />
set_Reading ("$device.$reading.month",0);; ## aktueller Monatsverbrauch\<br />
set_Reading ("$device.$reading.year",0);; ## aktueller Jahresverbrauch\<br />
set_Reading ("$device.$reading.last_hour",0);; ## Verbrauch der letzten Stunde\<br />
set_Reading ("$device.$reading.last_day",0);; ## Verbrauch des letzten Tages\<br />
set_Reading ("$device.$reading.last_month",0);; ## Verbrauch des letzten Monats\<br />
set_Reading ("$device.$reading.last_year",0);; ## Verbrauch des letzten Jahres\<br />
## Log definieren\<br />
fhem ("defmod log.counter.$device.$reading FileLog ./log/counter.$device.$reading.log $SELF:$device.$reading.last_.*");;\<br />
fhem ("attr log.counter.$device.$reading room Filelogs");;\<br />
}\<br />
}\<br />
\<br />
} ## Ende subs-Block\<br />
\<br />
get_data { ## Optionale Übernahme bestehender Daten aus dem Log\<br />
for (my $i=0;;$i<@{$_counter};;$i++) \<br />
{ ## my $i=3;;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_hour","bar2day",-10,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_hour"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_day","bar2month",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_day"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_month","bar2year",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_month"));;\<br />
::DOIF_set_card_data ("$SELF","$SELF","$_counter[$i][0].$_counter[$i][1].last_year","bar2decade",-300,fhem("get log.counter.$_counter[$i][0].$_counter[$i][1] ./log/counter.$_counter[$i][0].$_counter[$i][1].log - 2000 3000 4:last_year"));;\<br />
}\<br />
}\<br />
\<br />
hour {[:00];; ## Sicherung der Daten der letzten Stunde\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion hour aufgerufen\<br />
hour($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
midnight {[00:01];; ## Sicherung der Daten um Mitternacht\<br />
for (my $i=0;;$i<@{$_counter};;$i++) { ## Für jeden Zähler wird die Funktion midnight aufgerufen\<br />
midnight($_counter[$i][0],$_counter[$i][1],$mday,$yday);;\<br />
}\<br />
}\<br />
\<br />
init { ## initialisierung aller Readings\<br />
for (my $i=0;;$i<@{$_counter};;$i++) {## Für jeden Zähler werden Readings über die Funktion init_readings initialisiert\<br />
init_readings($_counter[$i][0],$_counter[$i][1]);;\<br />
}\<br />
}\<br />
\<br />
DEF TPL_stat (\<br />
day_count_$1_$2 { ## bei einem Event des Zählers, wird der tägliche, monatliche und jährliche Verbrauch im jeweiligen Reading festgehalten\<br />
## $1 Zählerdevice, $2 Zählerreading\<br />
\<br />
# my $diff = int(([$1:$2,0]-(get_Reading("$1.$2.last_counter",0)))*1000)/1000;;\<br />
set_Reading ("$1.$2.last_counter",[$1:$2,0]);;\<br />
set_Reading ("$1.$2.hour",int(([$1:$2,0]-(get_Reading("$1.$2.hour_counter",0)))*1000)/1000,1);;\<br />
}\<br />
)\<br />
\<br />
## Pro Zähler wird über eine FOR-Schleife ein day_count_<Device>_<Reading>-Block generiert\<br />
FOR(@{$_counter},TPL_stat($1$1,$1$2)) ## $1$1 entspricht dem Device, $1$2 entspricht dem Reading<br />
attr di_counter_new room Verbrauch<br />
attr di_counter_new uiTable {package ui_Table;;} ## Optionale Visualisierung der Energie-Verbräuche/-Produktion im DOIF-Device\<br />
\<br />
## Template für die Darstellung eines Wertes, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_single (\<br />
##card([$SELF:$2.$3.day:col1w],"$1",undef,$4,$5,$10,$11,"$12",undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$2.$3.last_hour:bar2day-10],[$SELF:$2.$3.hour]],"$1 in $12/h",undef,$4/12,$5/12,$10,$11,["letzte","aktuell"],undef,"2","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_day:bar2month-300],[$SELF:$2.$3.day]],"$12/Tag",undef,$4,$5,$10,$11,["letzter","aktuell"],undef,"1","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_month:bar2year-300],[$SELF:$2.$3.month]],"$12/Monat",undef,$6,$7,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")|\<br />
card([[$SELF:$2.$3.last_year:bar2decade-300],[$SELF:$2.$3.year]],"$12/Jahr",undef,$8,$9,$10,$11,["letzter","aktuell"],undef,"0","130,fixedscaling,,footer,noycolor,halfring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Template für die Darstellung von zwei Werten, einzelne card-Aufrufe können auskommentiert werden\<br />
DEF TPL_double (\<br />
##card([[$SELF:$3.$4.day:col1w],[$SELF:$6.$7.day:col1w]],"$1",undef,$8,$9,$14,$15,["$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")| Wochendarstellung\<br />
card([[$SELF:$3.$4.last_hour:bar2day-10],[$SELF:$6.$7.last_hour:bar2day-10],[$SELF:$3.$4.hour],[$SELF:$6.$7.hour]],"$1/h",undef,$8/12,$9/12,$14,$15,["$2","$5","$2","$5"],undef,"2","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_day:bar2month-300],[$SELF:$6.$7.last_day:bar2month-300],[$SELF:$3.$4.day],[$SELF:$6.$7.day]],"pro Tag",undef,$8,$9,$14,$15,["$2","$5","$2","$5"],undef,"1","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_month:bar2year-300],[$SELF:$6.$7.last_month:bar2year-300],[$SELF:$3.$4.month],[$SELF:$6.$7.month]],"pro Monat",undef,$10,$11,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")|\<br />
card([[$SELF:$3.$4.last_year:bar2decade-300],[$SELF:$6.$7.last_year:bar2year-300],[$SELF:$3.$4.year],[$SELF:$6.$7.year]],"pro Jahr",undef,$12,$13,$14,$15,["$2","$5","$2","$5"],undef,"0","130,fixedscaling,,footer,noycolor,noring,220","0,0,0,0,2")\<br />
)\<br />
\<br />
## Die Visualisierung einer Tabellenzeile wird über die obigen beiden Templates vorgenommen, hier zeilenweise anpassen/löschen:\<br />
\<br />
## Über das Template TPL_single wird jeweils pro card ein Wert visualisiert\<br />
## Überschrift,Device,Reading,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
TPL_single (Frischwasser,MQTT2_DVES_C58DCB,total_w,0,500,0,10000,0,80000,90,0,Liter)\<br />
TPL_single (Gas,MQTT2_DVES_C58DCB,total_gas,0,10,0,250,0,2000,90,0,m³)\<br />
TPL_single (Einspeisung,MQTT2_DVES_C58DCB,total_f,0,30,0,600,0,5000,0,90,kWh)\<br />
TPL_single (Bezug,MQTT2_DVES_C58DCB,total_c,-10,0,-300,0,-3000,0,0,90,kWh)\<br />
TPL_single (Stromkosten,di_tibber,costsSum,0,4,0,90,0,1200,90,0,€)\<br />
\<br />
## Über das Template TPL_double werden jeweils pro card zwei Werte visualisiert\<br />
## Überschrift,Bezeichnung1,Device1,Reading1,Bezeichnung2,Device2,Reading2,minTag,maxTag,minMonat,maxMonat,minJahr,maxJahr,minColor,maxColor,Einheit\<br />
##TPL_double (Heizenergie,Gesamt,vaillant,total_h,Wasser,vaillant,total_hwc,0,100,0,2000,0,20000,90,0,kWh)\<br />
\<br />
##TPL_double (Stromeinspeisung/Strombezug,Bezug,MQTT2_DVES_C58DCB,total_c,Einsp.,MQTT2_DVES_C58DCB,total_f,-10,25,-300,600,-3000,5000,0,90,kWh)<br />
<br />
</syntaxhighlight><br />
<br />
Bemerkungen:<br />
* Die Visualisierung der Verläufe über das Attribut uiTable ist optional. <br />
* Die Verlaufswerte der grafischen Darstellung mit Hilfe der card-Funktion werden im DOIF-Device gespeichert. Bereits geloggte Daten können mit '''set di_counter_new get_data''' importiert werden, [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Import.2C_.C3.84nderung_und_L.C3.B6schung_von_Diagrammdaten siehe dazu auch Datenimport] <br />
* Die obige Definition funktioniert nur mit Zählern, die mit aufsteigenden Werten (positiv/negativ) arbeiten, wie z. B. Stromverbrauch in kWh, Wasserverbrauch in Litern usw.. Es funktioniert nicht mit momentanen Werten, wie z. B. aktuelle Leistungsaufnahme eines Verbrauchers in Watt, diese müssten zunächst kumuliert werden.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_counter.png|mini|ohne]]<br />
<br />
== Weiterführende Links ==<br />
* Dokumentation [[DOIF/Perl-Modus]]<br />
* DOIF-WEB-Interface [[DOIF/uiTable Schnelleinstieg]]<br />
<br />
[[Category:Examples]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38320DOIF/uiTable Schnelleinstieg2023-04-18T15:38:29Z<p>Damian-s: /* Darstellung fortlaufender Daten als Säulen */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|700px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|mini]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten mit Visualisierung]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|mini]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-shttp://wiki.fhem.de/w/index.php?title=DOIF/uiTable_Schnelleinstieg&diff=38319DOIF/uiTable Schnelleinstieg2023-04-18T15:37:08Z<p>Damian-s: /* Darstellung fortlaufender Daten als Säulen */</p>
<hr />
<div>[[Datei:UiTable state state.jpg|700px|rechts|Webansicht bestehend aus mehreren DOIF/uiTable-Definitionen]]<br />
An dieser Stelle wird das DOIF-Web-Interface erklärt, welches über das DOIF-Attribut '''uiTable''' realisiert wurde. <br />
<br />
Abhängig von der Art der Funktion können in einer tabellarischen Darstellung FHEM-Geräte visualisiert und über die Web-Oberfläche bedient werden. Eventbasierte Änderungen visualisierter Readings werden unmittelbar in der Web-Ansicht aktualisiert. Eine erstellte Tabelle erscheint unterhalb der Statuszeile eines DOIF-Devices. Das uiTable-Attribut kann in bereits bestehenden DOIFs oder in funktionslosen DOIFs, wie in den unteren Beispielen, als reines WEB-Interface erstellt werden. In der Abbildung rechts ist ein Statusbildschirm aus vier Spalten mit mehreren DOIF/uiTable-Definitionen aufgebaut worden.<br><br />
<br />
Die Darstellungsmöglichkeiten werden anhand von Beispielen insb. mit Hilfe bereits im DOIF-Modul vordefinierter uiTable-Funktionen aufgezeigt. Diese Perlfunktionen sind in einem eigenen Package namens 'ui_Table' definiert worden. Mit Hilfe dieser Funktionen lassen sich recht einfach, ohne tiefere HTML/CSS-Kenntnisse, eigene Übersichten definieren. Im Anschluss werden typische '''[[DOIF/uiTable Schnelleinstieg#Anwendungsbeispiele|Anwendungsbeispiele]]''' aufgezeigt.<br />
<br />
Die folgenden Beispieldefinitionen arbeiten mit konkreten Geräten und Readings, sie können als RAW-Definition ins eigene System übernommen werden, dazu müssen die Gerätenamen, Readings, ggf. auch Icons den existierenden Namen des eigenen Systems angepasst werden. Zum Ausprobieren der Beispiele können statt echter Geräte auch Dummys benutzt werden. <br />
<br />
Es gibt ebenfalls das Attribut '''uiState''', welches die gleiche Syntax wie uiTable nutzt. Die definierte Tabelle erscheint im Gegensatz zu uiTable jedoch im Status des DOIF-Devices. uiState und uiTable können gleichzeitig in einem DOIF-Device definiert werden. <br />
<br />
== Aufbau des uiTable-Attributs ==<br />
Im uiTable-Attribut wird in erster Linie die zu visualisierende Tabelle definiert. Optional können zuvor ein Perlblock sowie Templates definiert werden.<br />
{{Randnotiz|RNText='''Aufbau des Attributs'''<br />
* das uiTable-Attribut besteht aus drei Bereichen:<br />
* [[DOIF/uiTable Schnelleinstieg#Der Perlblock|Perlblock]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates-Definitionen]] <br />
* [[DOIF/uiTable Schnelleinstieg#Die Tabellendefinition|Tabellendefinition]]<br />
}}<br />
'''Aufbaustruktur''' <br />
<syntaxhighlight lang="perl"><br />
{<br />
<Perlblock, optional><br />
}<br />
<br />
<Templates-Definitionen, optional><br />
<br />
<Tabellendefinition><br />
</syntaxhighlight><br />
=== Der Perlblock ===<br />
Der Perlblock dient dazu, das Layout der Tabelle zu beeinflussen sowie eigene uiTable-Funktionen zu definieren. Hier wird insb. das Package definiert, welches für die Tabellendefinition gilt. Ebenfalls können CSS-Variablen sowie Steuerungsattribute gesetzt werden. Der Perlblock beginnt und endet mit einer geschweiften Klammer.<br />
<br />
==== CSS-Variablen und Steuerungsattribute ====<br />
Mit Hilfe von CSS-Variablen kann das Layout der Tabelle beeinflusst werden. Die Steuerungsattribute beeinflussen die Statuszeile sowie die Detailansicht des DOIF-Moduls.<br />
{{Randnotiz|RNText='''CSS-Variablen und Steuerungsattribute'''<br />
*Das Layout der gesamten Tabelle wird beeinflusst über die Variablendefinition: '''$TABLE="<CSS-Attribute der Tabelle>"'''<br />
*Spaltenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TC{<Zellenbereich für Spalten>}="<CSS-Attribute der Spalten>"''' <br />
*Zeilenformatierungen werden beeinflusst mit Hilfe der Variablendefinition: '''$TR{Zeilenbereich}="<CSS-Attribute der Zeilen>"'''<br />
*einzelne Zellen werden beeinflusst mit Hilfe der Variablen: '''$TD{<Zellenbereich für Zeilen>}{<Zellenbereich für Spalten>}="<CSS-Attribute der Zellen>"'''<br />
*für Zellen-, Spalten- und Zeilen-Bereich gilt: '''<Zahl><nowiki>|</nowiki><kommagetrennte Aufzählung><nowiki>|</nowiki><Bereich von..bis>'''<br />
*Der Status in der Statuszeile des DOIFs wird ausgeblendet mit '''$SHOWNOSTATE=1'''<br />
*Die Gerätezeile des DOIFs wird ausgeblendet mit '''$SHOWNODEVICELINE = "<regex room>"'''<br />
*Die Tabelle des DOIFs wird ausgeblendet mit '''$SHOWNOUITABLE = "<regex room>"'''<br />
*Die Detailansicht wird umorganisiert mit '''$ATTRIBUTESFIRST=1'''<br />
}}<br />
'''Bespieldefinition'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_bsp_layout DOIF ##<br />
attr di_bsp_layout uiTable { ## Beginn des Perlblocks\<br />
## CSS-Variablen\<br />
\<br />
## Die Tabelle soll ein Hintergrundbild der Größe 300x300 Pixel haben\<br />
$TABLE = "width:300px;; height:300px;; background-image:url(/fhem/www/pgm2/images/Grundriss.png);; background-size: 300px 300px;;";;\<br />
\<br />
## die Zelle der ersten Zeile und der ersten Spalte soll rechts eine Rahmenlinie haben\<br />
$TD{0}{0} = "style='border-right-style:solid;; border-right-width:10px'";;\<br />
\<br />
## Die erste Zeile soll aus der Klasse 'odd' sein und fett-Schrift haben\<br />
$TR{0} = "class='odd' style='font-weight:bold'";;\<br />
\<br />
## die Spalten 2 bis 6 sollen zentriert sein\<br />
$TC{1..5} = "align='center'";;\<br />
\<br />
## die Spalten 2, 4 und 5 sollen zentriert sein\<br />
$TC{1,3,5} = "align='center'";;\<br />
\<br />
## die letzte Spalte der Tabelle soll fett sein\<br />
$TC{last} = "style='font-weight:bold'";;\<br />
\<br />
\## Steuerungsattribute\<br />
\<br />
\## Ausblenden des Status in der Statuszeile\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
## Die Gerätezeile wird ausgeblendet in allen Räumen\<br />
$SHOWNODEVICELINE = '.*';;\<br />
\<br />
## Die Tabelle wird im Raum info ausgeblendet\<br />
$SHOWNOUITABLE = '^info$';;\<br />
\<br />
## Die Detailansicht wird umorganisiert, hilfreich beim Editieren längerer uiTable-Definitionen\<br />
$ATTRIBUTESFIRST = 1;;\<br />
} ## Ende des Perlblocks<br />
</syntaxhighlight><br />
<br />
=== Die Tabellendefinition ===<br />
==== Einfache Tabellendefinition ohne Funktionen ====<br />
{{Randnotiz|RNText='''Tabellendefinition'''<br />
* eine Tabelle wird aus Zellen zusammengebaut<br />
* mehrere Zellen werden mit <nowiki>|</nowiki> von einander getrennt, sie bilden eine Tabellenzeile<br />
* eine neue Tabellenzeile beginnt mit einer neuen Zeile in der Tabellendefinition<br />
* eine Tabellenzeile kann auch in mehreren Zeilen definiert werden, diese müssen dann mit <nowiki>|</nowiki> enden<br />
* Texte werden in Anführungszeichen angegeben<br />
* Readings werden in der Form [<device>:<reading>] angegeben<br />
* Kommentare beginnen mit ## und enden mit Zeilenende<br />
* Events eines definierten Readings, führen sofort zu Aktualisierung seines Inhalts in der visualisierten Tabelle<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_definition DOIF ##<br />
attr ui_Table_definition uiTable { ## Perlblock für globale Tabellendefinitionen\<br />
\<br />
$TC{1..2}="align='center'" ## zentrierte Ausrichtung der zweiten und dritten Spalte\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Warmwasser"|"Vorlauf"|"Rücklauf" ## erste Tabellenzeile\<br />
## zweite Tabellenzeile\<br />
[T_Warmwasserspeicher:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Vorlauf:temperature]| ## Zeile wird fortgesetzt, da sie mit | endet\<br />
[T_Ruecklauf:temperature]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Definition.png|mini|ohne]]<br />
<br />
==== Tabellendefinition mit Berechnungen ====<br />
{{Randnotiz|RNText='''Zellenauswertung'''<br />
* jede Zelle der Tabelle wird über Perl ausgewertet<br />
* Readingangaben der Form [<device>:<reading>] werden in eine Perlfunktion übersetzt<br />
* das Ergebnis des ausgewerteten Perlausdrucks wird ausgegeben<br />
* in einer Zelle können beliebige Perlfunktionen genutzt werden<br />
* Texte oder Funktionen können mit Punkt aneinander gehängt werden<br />
* mit Komma werden Texte oder Werte untereinander dargestellt<br />
* wird eine Zeile mit < abgeschlossen, so wird die aktuelle Tabelle abgeschlossen, die nächste Zeile beginnt in einer neuen Tabelle<br />
* in einer Berechnung sollte ein Trigger in Form einer Readingangabe [<device>:<reading>] vorkommen, sonst wäre das Ergebnis statisch und würde sich nicht ändern <br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_calc DOIF ##<br />
attr di_uiTable_calc uiTable ## Tabellendefinition\<br />
"Differenz"|[T_Ruecklauf:temperature]-[T_Vorlauf:temperature]\<br />
"Minimum"|minNum([TH_WZ_HM:measured-temp],[TH_Keller_HM:measured-temp])\<br />
"Durchschnitt"|([T_Ruecklauf:temperature]+[T_Vorlauf:temperature])/2<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable calc.png|mini|ohne]]<br />
<br />
== Vordefinierte uiTable-Funktionen ==<br />
Typische Widgets bzw. Styles wurden als Perl-Funktionen im package ui_Table für eine einfache Tabellendefinition programmiert. Im folgenden wird näher auf die einzelnen uiTable-Funktionen eingegangen.<br />
<br />
=== FHEM-Widgets mit der Funktion '''widget''' ===<br />
Alle in FHEM vorhanden Widgets können mit Hilfe der Perlfunktion '''widget''' genutzt werden. Bei häufiger Nutzung eines bestimmten Widgets bietet sich alternativ die Definition einer uiTable-Funktion (Typ 3) mit dem jeweiligen Widget an, siehe: [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
{{Randnotiz|RNText=Funktion '''widget'''<br />
<syntaxhighlight lang="perl"><br />
widget(<Reading>,$fhem_widget,$set)<br />
<br />
Reading # [<device>:<reading>]<br />
$fhem_widget # Angabe des FHEM-Widgets<br />
$set # optional, undef zum Setzen beliebiger Readings (entspricht setreading), "set" wenn das Reading per set-Befehl gesetzt wird (siehe Attribut ReadingList), "set <Befehl>", wenn sich der Befehl vom Reading unterscheidet, default undef<br />
</syntaxhighlight><br />
<br />
'''nützliche Links'''<br />
* [[FHEMWEB/Widgets|Fhem-Widgets]]<br />
* Fhem-Widgets als [[DOIF/uiTable Schnelleinstieg#Eigene uiTable-Funktionen programmieren|uiTable-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_widget DOIF ##<br />
attr di_uiTable_widget uiTable ## FHEM-Widgets mit Hilfe der WID-Funktion\<br />
{package ui_Table}\<br />
"Widget"\<br />
"Select"| widget([uhr:wochentag],"select,Montag,Dienstag,Mittwoch,Donnerstag,Freitag,Samstag,Sonntag")\<br />
"Selectnumbers"| widget([motor:spannung],"selectnumbers,0,0.5,12,1,lin")\<br />
"Slider"| widget([bla:wert],"slider,0,5,100,1")\<br />
"Colorpicker RGB"| widget([Lampe:farbe],"colorpicker,RGB")\<br />
"Colorpicker HSV"| widget([Lampe:farbe],"colorpicker,HSV")\<br />
"Colorpicker CT"| widget([Lampe:waerme],"colorpicker,CT,2000,10,6500")\<br />
"Colorpicker HUE"| widget([Lampe:farbe],"colorpicker,HUE,0,1,359")\<br />
"Colorpicker BRI"| widget([Lampe:helligkeit],"colorpicker,BRI,0,1,100")\<br />
"Time"| widget([start:zeit],"time")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable WID.png|mini|ohne]]<br />
<br />
=== SVG-uiTable-Funktionen ===<br />
SVG-uiTable-Funktionen sind skalierbare Widgets, die auf SVG-Elementen basieren. Diese Funktionen befinden sich im Namensraum '''ui_Table''', daher muss vor deren Nutzung der Namensraum im Perlblock mit '''package ui_Table''' festgelegt werden (siehe Beispiele unten). Funktionen aus dem Namensraum '''main''' - das ist der Standard-Namensraum in FHEM - müssen in diesem Fall mit vorangestelltem Namensraum angegeben werden: '''main::<perlfunction>''' oder kürzer '''::<perlfunction>'''.<br />
<br />
==== '''ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit Hilfe der SVG-Funktionen '''temp_ring/temp_mring''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_ring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_ring/temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
temp_ring/temp_mring ($temp_value,$temp_min,$temp_max,$sizeHalf, $lightring,$lightnumber,$decFont) <br />
<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_ring DOIF ##<br />
attr di_temp_ring uiTable {package ui_Table}\<br />
"außen (standard)"|temp_ring([Aussensensor:temperature])\<br />
"Warmwasser (größer,aufgehellt,Normalschrift)" |temp_mring([vaillant:WWSpeicher],15,70,110,90,100,"1,font-weight:normal")\<br />
"Vorlauf (größer)"| temp_mring([ESPEasy_ESP_Temp_Vorlauf:Temperature],15,45,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der SVG-Funktionen '''hum_ring/hum_mring''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mring'''-SVG-Funktion wird der Ring einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_ring'''-SVG-Funktion: <br />
[[Datei:Farbskalierung hum_ring_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mring'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_ring/hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
hum_ring/hum_mring ($hum_value,$sizeHalf,$lightring,$lightnumber,$decFont) <br />
$hum_value # Feuchtigkeit<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 80, half ring: 1 für Halbring<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_ring DOIF ##<br />
attr di_hum_ring room test2<br />
attr di_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|hum_mring([Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|hum_ring([Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|hum_mring([Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''ring''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden. Dabei wird die Farbe mit Anleihen aus dem [https://de.wikipedia.org/wiki/HSV-Farbraum HSV-Farbraum] bestimmt. Dieser Farbraum benötigt eigentlich drei Werte, wobei die erste den Farbton (hue) bestimmt; hier wird nur dieser Wert verwendet (Sättigung und Hellwert sind nicht einstellbar). Der Farbton geht von rot (hue-Wert = 0) über gelb (hue-Wert = 60), dann grün (hue-Wert = 120) und blau (hue-Wert = 240) zurück zu rot (hue-Wert = 360), siehe dazu auch die [https://de.wikipedia.org/wiki/HSV-Farbraum#/media/Datei:HueScale.svg Farbtontafel] auf der Wikipedia-Seite.<br />
Die unten $colorRef genannte Funktion kann zum Beispiel in der Tabelle selbst definiert werden, beispielsweise kann man in dem device &onoff_hue verwenden, wenn man es vorab definiert (siehe [https://forum.fhem.de/index.php/topic,120088.msg1204341.html#msg1204341 Link zum Forum]):<blockquote><syntaxhighlight lang="perl"><br />
attr <ui device Name> {<br />
package ui_Table;<br />
sub onoff_hue {<br />
my($irgendeinVariablenname)=@_;<br />
return ($irgendeinVariablenname == 0 ? 240 : 0); <br />
}<br />
## Tabellendefinition<br />
...<br />
}<br />
</syntaxhighlight></blockquote>{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring'''<br />
<syntaxhighlight lang="perl"><br />
ring ($value,$min,$max,$minColor,$maxColor,$desc, $sizeHalf,$colorRef,$decFontUnit,$model,$lightness)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc # Beschreibung des Wertes, optional, default = undef<br />
$sizeHalf # "<size>,<half ring>" size: Größe der Grafik, optional, default = 100, half ring: 1 für Halbring<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$decFontUnit # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>", optional, default: "50,50,50,40,50"<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring DOIF (1)<br />
attr di_ring room test20,test5<br />
attr di_ring uiTable {package ui_Table;; \<br />
$SHOWNOSTATE=1}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|ring([heating:pump],0,20,120,0,"l/min",100)\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180), eine Nachkommastelle, Schriftgröße 170%\<br />
## Innenring mit Min-, Max-Beschriftung\<br />
"Wasserdruck"|ring([heating:pressure],0,3,0,180,"bar",100,undef,"1,font-size:170%,fill:silver;;font-size:50%","0,1,1")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_ring ([outdoor:temperature],-20,60,100,"1,font-weight:normal;;font-size:140%")\<br />
## Eine Nachkommastelle, Normalschrift, Schriftgröße 140%\<br />
"Temperatur"|ring([outdoor:temperature,-20,60,undef,undef,"°C",100,\&temp_hue,"1,font-weight:normal;;font-size:140%")\<br />
\<br />
## Lufdruck als Halbring\<br />
"Luftdruck"|ring([weather:barometer],970,1045,30,90,"hPa","100,1",undef,0)\<br />
\<br />
## Co2 als Halbring, Farbgebung als Array mit drei Bereichen, Innenring mit Zeiger\<br />
"Co2"|ring([livingroom:co2],400,1200,undef,undef,'ppm',"100,1",[(600,120,1000,60,1200,0)],0,'0,0,1,5')<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit Hilfe der SVG-Funktion '''temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_hum_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_hum_ring ($temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_hum_ring DOIF ##<br />
attr di_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"klein"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,60)\<br />
"normal"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity])\<br />
"größer, aufgehellt"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,undef,80)\<br />
"größer, Ring aufgehellt, Normalschrift"|temp_hum_ring([Aussensensor:temperature],[Aussensensor:humidity],undef,undef,100,80,50,"1,font-weight:normal","0,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit Hilfe der SVG-Funktion '''temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
[[Datei:Farbskalierung temp_temp_ring_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
temp_temp_ring ($temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_temp_ring DOIF ##<br />
attr di_temp_temp_ring uiTable {package ui_Table}\<br />
"klein, Ring augehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,60,80,50)\<br />
"normal"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60)\<br />
"groß, Zahlen aufgehellt"|temp_temp_ring([Vorlauf:Temperature],[Ruecklauf:Temperature],15,60,100,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_hum_temp_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit Hilfe der universellen SVG-Funktion '''ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''ring2'''<br />
<syntaxhighlight lang="perl"><br />
ring2 ($value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2, $lightness,$icon,$model)<br />
<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFontUnit1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$value2 # darzustellender Wert2<br />
...<br />
$decFontUnit2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_ring2 DOIF ##<br />
attr di_ring2 uiTable {package ui_Table;;}\<br />
## Leistungsaufnahme von 0 kW bis 3,6 kW in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Kapazität von 0 % bis 100 % V in Farben von rot (hue:0) bis grün (hue:120)\<br />
"Wallbox"| ring2([tesla:Leistung],0,3.6,120,0,"kW",undef,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
## Stromstärke von 0 A bis 2 A in Farben von grün (hue:120) bis rot (hue:0)\<br />
## Spannung von 1 V bis 1.5 V in Farben von rot (hue:0) bis grün (hue:120)\<br />
## 3 Nachkommastellen, Normalschrift, Schriftgröße 80% \<br />
"Akku"| ring2([akku:Strom],0,2,120,0,"A",undef,undef,"3,font-weight:normal;;font-size:80%",[akku:Spannung],1,1.5,0,120,"V",undef,"3,font-weight:normal;;font-size:80%")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_bsp.png|ohne|mini]]<br />
<br />
'''<big>Beispieldefinition Innenring, Farb-Array, Ringmodi</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_solar DOIF {}<br />
attr di_solar uiTable {package ui_Table}\<br />
"Farb-Array, ringMode 1"|\<br />
ring2([zaehler:Produktion],-20,30,undef,undef,"PV kWh",130,[(-10,0,-0.001,30,10,60,30,90)],"2",[test:Bezug],-20,30,undef,undef,"Bezug",[(-10,0,-0.001,30,10,60,30,90)],"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 1"|\<br />
ring2([zeahler:Produktion],-20,30,0,120,"PV kWh",130,undef,"2",[test:Bezug],-20,30,0,120,"Bezug",undef,"2",undef,undef,"0,1,1,0,1")\<br />
"Farbe linear, ringMode 2"|\<br />
ring2([zaehler:Produktion],0,30,60,120,"PV kWh",130,undef,"2",[test:Bezug],-20,0,0,120,"Bezug",undef,"2",undef,undef,"0,,,0,2")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:ring2_ringMode.png|ohne|mini]]<br />
<br />
<br clear="all"><br />
<br />
==== '''icon_ring'''-Funktionen ====<br />
===== Farbskalierte Temperaturanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_temp_ring/icon_temp_mring''' =====<br />
Diese Funktionen basieren auf den obigen temp_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Temperatur für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_ring/icon_temp_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_ring/icon_temp_mring ($icon,$temp_value,$temp_min,$temp_max,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$temp_value # Temperatur<br />
$temp_min, # minimale Temperatur, optional, default=-20<br />
$temp_max, # maximale Temperatur, optional, default=60<br />
$size, # Größe der Grafik, optional, default=80<br />
$lightring, # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Heizung_temp DOIF ##<br />
attr di_Heizung_temp uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70)|\<br />
icon_temp_mring(([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),[ESPEasy_ESP_Temp_Zirkulation:Temperature],15,70)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],15,70)|\<br />
icon_temp_mring("sani_floor_heating_neutral\@white",[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70)|""<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktionen '''icon_hum_ring/icon_hum_mring''' =====<br />
Diese Funktionen basieren auf den obigen hum_ring-Funktionen, zusätzlich wird ein SVG-Icon dargestellt. Die Farbe des Icons kann mit @ an den Iconnamen angehängt werden, ansonsten wird die Farbe der Feuchtigkeit für das Icon verwendet. Die Größe des Icons kann skaliert werden, ebenso kann die Positionen des Icons verschoben werden. <br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_ring/icon_hum_mring'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_ring/icon_hum_mring ($icon,$hum_value,$size,$lightring,$lightnumber,$decFont) <br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$hum_value # Feuchtigkeit<br />
$size # Größe der Grafik, optional, default=80<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_ring DOIF ##<br />
attr di_icon_hum_ring room test5<br />
attr di_icon_hum_ring uiTable {package ui_Table}\<br />
"klein ohne Farbverlauf"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],60)\<br />
"normal groß mit Farbverlauf"|icon_hum_ring("weather_humidity",[Aussensensor:humidity])\<br />
"groß ohne Farbverlauf aufgehellt"|icon_hum_mring("weather_humidity",[Aussensensor:humidity],100,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_ring_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Icons mit einem Zahlenwert mit Hilfe der universellen SVG-Funktion '''icon_ring/icon_mring/icon_uring''' =====<br />
Diese Funktionen basieren auf der universellen ring-Funktion. Die Farbe des dargestellten Icons und des Wertes kann abhängig vom Wert bestimmt werden. Die Funktion '''icon_ring''' stellt den Farbring mit Farbverlauf dar, die Funktion '''icon_mring''' stellt den Farbring einfarbig dar. Die universelle Funktion '''icon_uring''' kann über den Parameter '''$model''' das Erscheinungsbild der Grafik verändern.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring/icon_mring/icon_uring'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness,$model)<br />
<br />
icon_mring ($icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
icon_uring ($model,$icon,$value,$min,$max,$minColor,$maxColor, $unit,$decFont,$size,$colorRef,$lightness)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>", optional<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorRef # Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
<br />
<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring DOIF ##<br />
attr di_icon_ring uiTable {package ui_Table}\<br />
\<br />
icon_ring ('sani_floor_heating_neutral',[Heizenergie:Vortag_hc],0,150,120,0,'kWh')|\<br />
icon_mring ('fuel',[Tankstelle:Diesel],1.10,1.30,120,0,'€',2)|\<br />
icon_uring ('0,1,1',"air",[ESPEasy_Eingang_CO2:PPM],400,1200,undef,undef,'ppm',0,100,[(600,120,1000,60,1200,0)])|\<br />
icon_uring ('0,1','Zisterne',([Wasserzisterne]/3.4),0,100,0,120,'%',0)##/\<br />
\<br />
icon_uring ('1,1,0,8',"measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,'l',0)|\<br />
icon_uring ('0,fill:white,opacity:0.4',([vaillant:Pumpenstatus] eq '4' ? 'sani_buffer_temp_down@Darkorange' : 'sani_buffer_temp_down@white'),[vaillant:Umlaufmenge],0,20,120,0,'l/min')|\<br />
icon_uring('0,1,1,4','weather_barometric_pressure',[vaillant:Wasserdruck],0,3,undef,undef,'bar',1,100,[(0.8,0,1,60,1.5,120,1.7,60,3,0)])|\<br />
icon_uring('0,opacity:0.8,1,6','sani_water_tap',[vaillant:HwcHours_hoursum2_value],0,2000,120,0,'h',0)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring_bsp.png|ohne|mini]]<br />
<br clear="all"><br />
<br />
===== Farbskalierte Temperatur- und Feuchtigkeitsanzeige mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_hum_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperatur- bzw. Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_hum_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_hum_ring ($icon,$temp_value,$hum_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp,$decFontHum)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp_value # Temperatur<br />
$hum_value # Feuchtigkeit<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp # Temperatur: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontHum # Feuchtigkeit: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_hum_ring DOIF ##<br />
attr di_icon_temp_hum_ring uiTable {package ui_Table}\<br />
\<br />
"normal"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity])\<br />
"mit Normalschrift"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,undef,undef,undef,"1,font-weight:normal","0,font-weight:normal")\<br />
"größer aufgehellt"|icon_temp_hum_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:humidity], undef,undef,120,undef,80)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_hum_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Temperaturwerten mit einem Icon mit Hilfe der SVG-Funktion '''icon_temp_temp_ring''' =====<br />
Die Farbe ist jeweils abhängig vom dargestellten Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar:<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_temp_ring'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_temp_ring ($icon,$temp1_value,$temp2_value,$temp_min,$temp_max,$size, $lightring,$lightnumber,$decFontTemp1,$decFontTemp2)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$temp1_value # erster Temperaturwert<br />
$temp2_value # zweiter Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$size # Größe der Grafik, optional, default=90<br />
$lightring # Helligkeit des Ringes (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFontTemp1 # Temperatur1: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
$decFontTemp2 # Temperatur2: "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_temp_ring DOIF ##<br />
attr di_icon_temp_temp_ring uiTable {package ui_Table}\<br />
## Größe 120%\<br />
"FB-Heizung"|icon_temp_temp_ring(([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),[ESPEasy_ESP_Temp_Vorlauf:Temperature],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature],15,70,120)\<br />
\<br />
## Größe 120%, Normalschrift\<br />
"Temperatur","Taupunkt"|icon_temp_temp_ring("temp_outside",[Aussensensor:temperature],[Aussensensor:dewpoint],undef,undef,120,undef,undef,"1,font-weight:normal","1,font-weight:normal")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_temp_ring.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige von zwei Zahlenwerten mit einem Icon mit Hilfe der universellen SVG-Funktion '''icon_ring2''' =====<br />
Die Farbe der dargestellten Werte kann abhängig vom Wert bestimmt werden.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_ring2'''<br />
<syntaxhighlight lang="perl"><br />
icon_ring2 ($icon,$value1,$min1,$max1,$minColor1,$maxColor1,$desc1,$size,$colorFunc1,$decFont1, $value2,$min2,$max2,$minColor2,$maxColor2,$desc2,$colorFunc2,$decFont2,$lightnesss,$model)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$value1 # darzustellender Wert1<br />
$min1 # minimaler Wert, optional, default=0<br />
$max1 # maximaler Wert, optional, default=100<br />
$minColor1 # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor1 # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$desc1 # Beschreibung des Wertes, optional, default = undef<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc1 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont1 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$value2 ## darzustellender Wert2<br />
...<br />
$desc2 # Beschreibung des Wertes, optional, default = undef<br />
$colorFunc2 # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont2 # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>","<Einheit hinter dem Zahlenwert>" optional<br />
$lightness # Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
$model # '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
Argumente für den zweiten Wert entsprechend den Argumenten des ersten Wertes<br />
</syntaxhighlight><br />
Wird '''$colorFunc...''' nicht angegeben, so wird der Farbwert zwischen '''$minColor...''' und '''$maxColor...''' linear interpoliert.<br />
<br />
Bei der Farbangabe des Icons beim Übergabeparameter $icon wird mit '''\@colorVal2''' das Icon mit der Farbe des zweiten Wertes eingefärbt. Bei keiner Farbangabe oder '''\@colorVal1''' wird das Icon mit der Farbe des ersten Wertes eingefärbt. Ansonsten gilt die allgemeine FHEM-Syntax für Farbgebung von Icons angehängt mit '''\@'''.<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_ring2 DOIF ##<br />
attr di_icon_ring2 uiTable {package ui_Table;;\<br />
\<br />
sub himmelsrichtung {\<br />
my ($richtung)=@_;;\<br />
my $element=int($richtung/22.5);;\##/<br />
my @h=(qw"N NNO NO ONO O OSO SO SSO S SSW SW WSW W WNW NW NNW");;\<br />
return($h[$element]);;\<br />
}\<br />
}\<br />
"Wallbox"| icon_ring2("car,1.5,0,-3",[tesla:Leistung],0,3.6,120,0,"kW",120,undef,"1,font-weight:normal",[tesla:Kapazitaet],0,100,0,120,"%",undef,"0,font-weight:normal")\<br />
\<br />
"Wind"|icon_ring2(([Wind:Geschwindigkeit]>0 ? "wind":"no_wind").",1,0,0,".[Wind:Richtung],[Wind:Geschwindigkeit],0,50,120,0,"km/h",120,undef,1,[Wind:Richtung],361,361,220,220,([Wind:Geschwindigkeit]>0?himmelsrichtung([Wind:Richtung]):"--"),undef,0)\<br />
\<br />
"Strom"|icon_ring2([zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",[zaehler:l-Produktion],0,3.6,20,120,"PV kW",150,undef,"1,,font-size:50%;fill:white",[zaehler:l-Bezug,0],0,2,120,0,"Netz kW",undef,"1,,font-size:50%;fill:white")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_ring2.png|ohne|mini]]<br />
<br />
==== '''bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktionen '''temp_bar/temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''temp_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''temp_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung temp_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''temp_bar/temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
temp_bar/temp_mbar ($temp_value,$temp_min,$temp_max, $header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=60<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_temp_bar DOIF ##<br />
attr di_temp_bar uiTable {package ui_Table}\<br />
"standard"|temp_bar([Aussensensor:temperature])\<br />
"heller"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|temp_mbar([Aussensensor:temperature])\<br />
"kleiner"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|temp_bar([Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|temp_bar([Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''hum_bar/hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
Farbskalierung der '''hum_bar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_bar_scaling.png|600px|ohne]]<br />
<br />
Farbskalierung der '''hum_mbar'''-SVG-Funktion:<br />
[[Datei:Farbskalierung hum_mbar_scaling.png|600px|ohne]]<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''hum_bar/hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
hum_bar/hum_mbar ($hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$hum_value # Feuchtigkeitswert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=80<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 0<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_hum_bar DOIF ##<br />
attr di_hum_bar uiTable {package ui_Table}\<br />
"standard"|hum_bar([Aussensensor:humidity])\<br />
"heller"|hum_bar([Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|hum_mbar([Aussensensor:humidity])\<br />
"kleiner"|hum_bar([Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|hum_bar([Aussensensor:humidity],"Außen")\<br />
"hoch"|hum_bar([Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktion '''bar''' =====<br />
Die Farbe des dargestellten Wertes kann abhängig vom Wert bestimmt werden.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''bar'''<br />
<syntaxhighlight lang="perl"><br />
bar ($value,$min,$max,$header,$minColor,$maxColor,$unit,$width, $height,$size,$colorFunc,$decFont,$gradient,$light,$lightnumber)<br />
<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 60<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$gradient # Farbverlauf, optional, undef mit Farbverlauf, 1 ohne Farbverlauf, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
{package ui_Table}<br />
defmod di_bar DOIF ##<br />
attr di_bar uiTable {package ui_Table}\<br />
## von 0 bis 20 in Farben von grün (hue:120) bis rot (hue:0)\<br />
"Umlaufmenge"|bar([heizung:Umlaufmenge],0,20,"Umlauf",120,0,"l/min")\<br />
\<br />
## von 0 bis 3 in Farben von rot (hue:0) bis türkis (hue:180)\<br />
"Wasserdruck"|bar([heizung:Wasserdruck],0,3,undef,0,180,"bar"undef,70,undef,undef,"1,font-size:130%;;font-weight:normal")\<br />
\<br />
## Temperaturdarstellung, entspricht dem Funktionsaufruf:\<br />
## temp_bar ([Aussensensor:temperature],-20,60)\<br />
"Temperatur"|bar([Aussensensor:temperature],-20,60,undef,undef,undef,"°C",undef,undef,undef,\&temp_hue)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:bar_bsp.png|ohne|mini]]<br />
<br />
==== '''icon_bar'''-Funktionen ====<br />
===== Farbskalierte Anzeige der Temperatur in Balkenform mit Hilfe der SVG-Funktion '''icon_temp_bar/icon_temp_mbar''' =====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_temp_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_temp_bar/icon_temp_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_temp_bar/icon_temp_mbar ($icon,$temp_value,$temp_min,$temp_max, $header,$width,$height,$size,$light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$temp_value # Temperaturwert<br />
$temp_min # minimale Temperatur, optional, default=-20<br />
$temp_max # maximale Temperatur, optional, default=60<br />
$header # Überschrift, optional, default= undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_temp_bar DOIF ##<br />
attr di_icon_temp_bar room test10<br />
attr di_icon_temp_bar uiTable {package ui_Table}\<br />
"standard"|icon_temp_bar("temp_outside",[Aussensensor:temperature])\<br />
"heller"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,undef,80)\<br />
"monochrom"|icon_temp_mbar("temp_outside",[Aussensensor:temperature])\<br />
"kleiner"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,undef,80)\<br />
"mit Überschrift"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,"Außen")\<br />
"hoch"|icon_temp_bar("temp_outside",[Aussensensor:temperature],undef,undef,undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_temp_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige der Feuchtigkeit in Balkenform mit Hilfe der SVG-Funktionen '''icon_hum_bar/icon_hum_mbar''' =====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert. Die Helligkeit der Farbgebung ist einstellbar. Bei der '''icon_hum_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_hum_bar/icon_hum_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_hum_bar/icon_hum_mbar ($icon,$hum_value,$header,$width,$height,$size, $light,$lightnumber,$decFont)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position", \@Farbe, Skalierungsfaktor, x-Position, y-Position sind optional<br />
$hum_value # Temperaturwert<br />
$header # Überschrift, optional, default = undef (keine)<br />
$width # Breite der Grafik, optional, default=63<br />
$height # Höhe der Grafik, optional, default=75<br />
$size # Größe der Grafik, optional, default=100<br />
$light # Helligkeit des der Grafik (0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (0-100), optional, default=50<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_hum_bar DOIF ##<br />
attr di_icon_hum_bar uiTable {package ui_Table}\<br />
"standard"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity])\<br />
"heller"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,undef,80)\<br />
"monochrom"|icon_hum_mbar("temperature_humidity",[Aussensensor:humidity])\<br />
"kleiner"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,undef,80)\<br />
"mit Überschrift"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],"Außen")\<br />
"hoch"|icon_hum_bar("temperature_humidity",[Aussensensor:humidity],undef,undef,100)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_hum_bar_bsp.png|ohne|mini]]<br />
<br />
===== Farbskalierte Anzeige eines Zahlenwertes mit Hilfe der universellen SVG-Funktionen '''icon_bar/icon_mbar''' =====<br />
Die Farbe des dargestellten Wertes und des Icons kann abhängig vom Wert bestimmt werden. Bei der '''icon_mbar'''-SVG-Funktion wird der Balken einfarbig dargestellt.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''icon_bar/icon_mbar'''<br />
<syntaxhighlight lang="perl"><br />
icon_bar ($icon,$value,$min,$max,$minColor,$maxColor,$unit,$decfont,$header,$width,$height,$size, $colorFunc,$light,$lightnumber)<br />
<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation (0-360) sind optional<br />
$value # darzustellender Wert<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$header # Überschrift, optional, default = undef (keine)<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = undef<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = undef<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$decFont # "<Anzahl der Nachkommastellen>,<Schrift-SVG-Attribute Wert>,<Schrift-SVG-Attribute Einheit>", optional, default = 1<br />
$width # Breite der Grafik, optional, default = 63<br />
$height # Höhe der Grafik, optional, default = 75<br />
$size # Größe der Grafik, optional, default = 100<br />
$colorFunc # Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, optional, default = undef<br />
$light # Helligkeit der Grafik (light:0-100), optional, default=50<br />
$lightnumber # Helligkeit der Zahl (light:0-100), optional, default=50<br />
</syntaxhighlight><br />
Wird '''$colorFunc''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_icon_bar_bsp DOIF ##<br />
attr di_icon_bar_bsp uiTable {package ui_Table;;\<br />
}\<br />
icon_bar ("fuel",[Tankstelle:Diesel],1.10,1.30,120,0,"€",2)|\<br />
icon_bar ("air",[ESPEasy_Eingang_CO2:PPM],400,1200,120,0,"ppm",0)|\<br />
icon_bar ("Zisterne",([Wasserzisterne]/3.4),0,100,0,120,"%",0)|\<br />
icon_bar (([vaillant:Pumpenstatus] eq "off" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:Umlaufmenge],0,20,120,0,"l/min")\<br />
icon_bar ("measure_water_meter",[Wasserverbrauch:heute],0,600,120,0,"l",0)|\<br />
icon_bar ("weather_barometric_pressure",[vaillant:Wasserdruck],0,3,0,180,"bar")|\<br />
icon_bar ("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0)|\<br />
icon_bar ("sani_floor_heating_neutral",[Heizenergie:Vortag_hc],0,150,120,0,"kWh")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:icon_bar_bsp.png|ohne|mini]]<br />
<br />
<br />
==== Anzeige eines Werteverlaufs und des aktuellen Wertes mit Hilfe der SVG-Funktion '''card''' ====<br />
Es wird der aktuelle Wert eines Readings, sein zeitlicher Verlauf sowie der maximale und minimale Wert in Form einer Informationskarte visualisiert. Das Erscheinungsbild kann über zahlreiche Parameter individualisiert werden. Die Besonderheit ist das Argument '''<collect type>''' bei der Angabe des Readings der Form '''[<Device>:<Reading>:<collect type]'''. Dadurch werden Daten des Readings im DOIF-Modul gesammelt und für die Erzeugung eines Graphen zur Verfügung gestellt - es sind keine weiteren Definitionen erforderlich. Dabei wird besonders sparsam mit der Datensammlung umgegangen. Die gesammelten Daten werden über den FHEM-Befehl '''save''' in versteckten Readings des jeweiligen DOIF-Moduls gespeichert.<br />
<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''card'''<br />
<syntaxhighlight lang="perl"><br />
card ($collect,$header,$icon,$min,$max,$minColor,$maxColor, $desc,$colorRef,$decFontUnit,$prop,$ringModel,$lightness, $collect2,$min2,$max2,$minColor2,$maxColor2,$desc2,$func2,$decFontUnit2)<br />
<br />
$collect/$collect2 <br />
# Angabe eines Readings oder eines Arrays mit mehreren Readings der Form [<Device>:<Reading>:<collect type>:<output>], mit Hilfe des Argumentes <collect type> wird das Modul angewiesen Daten des Readings über einen bestimmten Zeitraum zu sammeln. Sollen Werte aus einem Array nur im Ring angezeigt werden und nicht Diagramm visualisiert werden, so wird das <collect type> nicht angegeben. Dabei können pro Wert eigene ring-Formatierungen vorgenommen werden. Mindestens ein Reading muss mit <collect type> angegeben werden.<br />
<br />
<collect type><br />
# Darstellung kontinuierlicher Daten als Linie<br />
col<number><timeFormat> <br />
# <timeFormat>: d Tage, w Wochen, ohne Angabe des Zeitformates wird <Anzahl> in Stunden interpretiert. <br />
# Beispiele: col (entspricht col24), col1, col12, col1d, col3d, col1w, col4w, col52w usw.<br />
<br />
# Darstellung eines Wertes als Säule eines bestimmten Zeitraum (Stunde, Tag, Monat, Jahr)<br />
bar/barAvg<number><period><timeOffset><br />
# <number>: Anzahl der Perioden<br />
# <period>: Art der Periode: day, week, month, year, decade<br />
# bei day werden 24 Stunden als Balken dargestellt,<br />
# bei week werden 7 Tage (Mo bis So) der Woche dargestellt,<br />
# bei month werden bis 31 Tage des Monats dargestellt,<br />
# bei year werden 12 Monate des Jahres dargestellt,<br />
# bei decade werden 10 Jahre eines Jahrzehnts (Dekade) dargestellt.<br />
# <timeOffset>: Zeitverschiebung in Sekunden (positive Zahlen in die Zukunft, neg. Zahlen in die Vergangenheit)<br />
# Anmerkung: Im optimalen Fall wird im angegebenen Zeitraum (Stunde (Periode day), Tag (Periode week oder month), Monat (Periode year), Jahr (Periode decade)) nur ein Wert per Event geliefert, werden mehrere Events geliefert, so wird der letzte Wert des Zeitraum übernommen. Bei barAvg werden wird dagegen der Mittelwert der gelieferten Daten einer Periode gebildet.<br />
<br />
<output> <br />
# Der Wert des Readings kann über den optionalen output-Parameter mit Hilfe von Perl verändert werden<br />
# Beispiel, der Wert on des Readings soll auf 1 abgebildet werden, sonst auf 0: $_ eq "on" ? 1 : 0<br />
<br />
$header # "<Überschrifttext,<Style-SVG-Text-Attribute>", optional<br />
$icon # "Iconname\@Farbe,Skalierungsfaktor,x-Position,y-Position,Rotation", \@Farbe, Skalierungsfaktor, x-Position, y-Position, Rotation sind optional<br />
$min # minimaler Wert, optional, default=0<br />
$max # maximaler Wert, optional, default=100<br />
$minColor # Farbe (hue: 0-360) des kleinsten Wertes, optional, default = 0 (rot)<br />
$maxColor # Farbe (hue: 0-360) des maximalen Wertes, optional, default = 120 (grün)<br />
$desc <br />
# Beschreibung des Wertes, optional, default = undef, falls unter $collect ein Array für mehrere Readings angegeben wurde, so werden hier als Array die entsprechenden Beschreibungen angegeben, zusätzlich kann kommagetrennt pro Einheit Farbe des Graphen angegeben werden<br />
<br />
$colorRef <br />
# Referenz auf eine Funktion, die zu einem Wert einen Farbwert (hue: 0-360) bestimmt, oder eine Referenz auf eine Arrayliste mit Grenzwerten und Farben, optional, default = undef<br />
<br />
$decFontUnit<br />
# "<Anzahl der Nachkommastellen>,<Style-SVG-Attribute Wert>,<Style-SVG-Attribute Einheit>,<Einheit hinter dem Zahlenwert>", optional<br />
<br />
$prop <br />
# Eigenschaft von card: "<size>,<y-scaling>,<steps>,<footer>,<color_y_scale>,<ring>,<width>", optional<br />
<br />
# <size>: Größe der der Karte, default = 130,<br />
# <y-scaling>: "fixedscaling" (1), "autoscaling" (undef)<br />
# <steps>: "steps" (1),"nosteps" (undef)<br />
# <footer>: "footer" (undef),"nofooter" (1)<br />
# <color_y_scale>: "ycolor" (undef), "noycolor" (1)<br />
# <ring>: "ring" (undef), "noring" (0), "halfring" (1)<br />
# <width>: Breite der Karte, default: 160<br />
<br />
$ringModel<br />
# '<color gradient>,<min/max>,<inner ring>,<pointer>,<mode>'<br />
<br />
# <color gradient>: "gradient" (undef),"nogradient" (1)<br />
# <min/max>: Style-SVG-Attribute oder "nominmaxvalue" (undef), "minmaxvalue" (1)<br />
# <inner ring>: Style-SVG-Attribute oder "innerring" (1), "noinnerring" (undef)<br />
# <pointer>: Breite des Zeigers in Pixel, "nopointer" (undef)<br />
# <mode>: "minmax" (undef), "negzeropos" (1), "zeronegpos" (2)<br />
# alle Parameter sind optional, default keine Angaben: ',,,,,,'<br />
<br />
$lightness <br />
# Helligkeit einzelner Elemente (0-100) "<ring>,<inner ring>,<minMax>,<unit>,<value>,<icon>", optional, default: "50,50,50,40,50,40"<br />
<br />
$collect2 # optionale Angaben für ein zweites Reading<br />
$min # restliche Parameter<br />
$max # entsprechen der Syntax<br />
... # des ersten Sensors<br />
$decFontUnit2 # <br />
</syntaxhighlight><br />
Wird '''$colorRef''' nicht angegeben, so wird der Farbwert zwischen '''$minColor''' und '''$maxColor''' linear interpoliert<br />
Werden mehrere Readings angegeben, so müssen sie alle die gleiche Zeitspanne besitzen (Zeitangabe bei col)<br />
<br />
'''nützliche Links'''<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_Wetterstation|Wetterstation]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung:_aktueller_Spritpreis|Spritpreise]]<br />
* Anwendungsbeispiel [[DOIF/uiTable_Schnelleinstieg#Visualisierung_und_Steuerung:_Heiztherme|Heiztherme]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Farbskalierte_Anzeige_eines_Icons_mit_einem_Zahlenwert_mit_Hilfe_der_universellen_SVG-Funktion_icon_ring.2Ficon_mring.2Ficon_uring|icon_ring]] <br />
}}<br />
<br />
=====<big>Darstellung kontinuierlicher Daten als Linie</big>=====<br />
Es folgen einige Beispiele für die Darstellung von Readings mit Hilfe des Darstellungstyps '''col''', deren Werte sich per Event kontinuierlich verändern.<br />
<br />
======<big>Darstellung eines Readingwertes</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF ##<br />
attr di_collect uiTable {package ui_Table;;}\<br />
card([Aussensensor:temperature:col12],"Außen","temp_outside",-10,45,undef,undef,"°C",\&temp_hue,undef)|\<br />
card([Tankstelle:Diesel:col12],"Sprit,fill:darkorange","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([zaehler:l-Produktion:col12],undef,[zaehler:l-Produktion] > 0 ? "sani_solar\@colorVal1":"fa_bolt\@colorVal2",0,3.6,30,60,"PV kW",undef,"1,,font-size:50%")|\<br />
card([ESPEasy_Eingang_CO2:PPM:col12],undef,"air",400,1200,120,0,"ppm",[600,120,1000,60,1200,0],0,undef,'0,1,1',"50,35,45,35,50,35")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:svgcard.png|ohne|mini]]<br />
<br />
======<big>Anpassung des Layouts</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130")\<br />
"mit Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,1")\<br />
"mit Halbring","ohne Fußzeile","Breite 110"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1,110")\<br />
"Standard","Breite 200"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,50,undef,undef,"°C",\&temp_hue,"1","130,,,,,,200")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_variations.png|ohne|mini]]<br />
<br />
======<big>Darstellung zwei Readingwerte mit unterschiedlichen Einheiten</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod di_cards DOIF {}<br />
attr di_cards uiTable {package ui_Table;;}\<br />
"Standard"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header"|\<br />
card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Header","ohne Fußzeile"|card([Aussensensor:temperature:col],undef,"temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"Als Halbring"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")\<br />
"ohne Fußzeile"|\<br />
card([Aussensensor:temperature:col],"Außen","temp_outside",-10,60,undef,undef,"°C",\&temp_hue,"1","130,,,1,,1",undef,undef,[outsensor:humidity:col],0,100,undef,undef,"%",\&hum_hue,"0")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_collect2.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit gleicher Einheit</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Sprit DOIF ##<br />
attr Sprit uiTable {package ui_Table;;}\<br />
card([[Tankstelle:SuperE5:col24],[Tankstelle:Diesel:col24]],"Sprit","fuel","1.20","1.60",120,0,["E5","Diesel"],undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_Sprit2.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod PV DOIF {}<br />
attr PV DOIF_Readings l_Eigenv: [zaehler:l-Produktion]-[zaehler:l-Lieferung],\<br />
Eigenv:[zaehler:Produktion]-[zaehler:Lieferung],\<br />
l_Verbrauch: [zaehler:l-Bezug,0]+[$SELF:l_Eigenv,0],\<br />
Verbrauch:[zaehler:Bezug]+[$SELF:Eigenv],\<br />
l_Bezug:-[zaehler:l-Bezug]<br />
attr PV uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
card([[zaehler:l-Produktion:col],[$SELF:l_Eigenv:col],[$SELF:l_Bezug:col]],"kW","fa_bolt\@silver",-3.6,3.6,0,90,["Solar","Eigen.","Bezug"],[(-1,0,0,30,1,60,3.6,90)],"2","167,,1,,,1",",,1,6")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrerer Readingwerte mit einfarbigen Graphen</big>======<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_heating DOIF {}<br />
attr di_heating uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[ESPEasy_ESP_Temp_Vorlauf:Temperature:col],[ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col]],"Umwälzpumpe",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,["Vor. °C,red","Rück. °C,#287afc"],\&temp_hue,undef,",,1,,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_pump.png|ohne|mini]]<br />
<br />
======<big>Darstellung mehrere Readingwerte mit und ohne Verlaufvisualisierung</big>======<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen'''<br />
*Die col-Angabe kann bei Readingsangaben ausgelassen werden, dann werden die Daten dieses Readings nicht gesammelt und erscheinen nur in den Ringen in der Kopfzeile, nicht aber im Hauptring, nicht im Plot und nicht in der Fußzeile. Mindestens ein Reading einer card muss col-Angaben beinhalten.<br />
*Für collect bzw. collect2 können beliebig viele Werte angegeben werden.<br />
*In card gibt es nur einen Hauptring mit einem Wert oder als Doppelring mit zwei Werten, alle weiteren Werte landen als Halbringe in der Kopfzeile. Wenn eine 1 beim Parameter hring angegeben wird, so werden alle Werte als Halbring in der Kopfzeile dargestellt, es gibt dann keinen Hauptring.<br />
*Die ersten beiden Werte mit col-Angaben aus collect werden im Doppelring angezeigt, alle weiteren landen in Halbringen in der Kopfzeile; wenn collect nur einen Wert hat und collect2 mehrere, dann wird der erste Wert von collect und der erste Wert von collect2 im Doppelring angezeigt, die restlichen von collect2 landen in Halbringen der Kopfzeile.<br />
*Bei einer Card mit Standardbreite können maximal 6 Werte angezeigt werden. Zwei im Doppelring und vier in Halbringen in der Kopfzeile. Möchte man mehr als 6 Werte anzeigen, dann muss man die Breite von card vergrößern, damit mehr als vier Halbringe in der Kopfzeile Platz finden.<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[$SELF:power_pv:144col1d],[$SELF:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver, kW","130,,1,0,1","1,,1,0,negzeropos",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"1,,fill:silver, kWh")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_energie2.png|ohne|mini]]<br />
<br />
{{Randnotiz|RNText='''card mit Zusatzinformationen, die nicht im Plot erscheinen mit eigenen Formatierungsangaben zum Ring'''<br />
<br />
Sollen Zusatzinformationen, die nicht im Plot erscheinen, in der Kopfzeile mit eigenen Formatierungsangaben im Ring dargestellt werden, dann können sie beim $collect/$collec2-Parameter als Array mit zusätzlichen Parametern angegeben werden. Diese Angaben übersteuern die Formatierungsangaben, die für den Hauptring gelten. Die Bedeutung der Parameter entspricht der der card-Parameter.<br />
<br />
<syntaxhighlight lang="perl"><br />
Syntax für $collect/$collect2<br />
[...,[[<Device>:<Reading>],$min,$max,$minColor,$maxColor,$desc, $colorRef,$decFontUnit,$ringModel],...]<br />
</syntaxhighlight><br />
<br />
*Beschreibung der Parameter siehe card-Funktion <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_gas DOIF {}<br />
attr di_gas uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([[di_counter:gas.day:col1w],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"],[[di_counter:gas.year],0,1500,90,0,"Jahr","","0,,fill:silver, m³"]],"Gas", undef,0,10,90,0,"Tag", undef,"1,,fill:silver, m³","130,1,1,0,1,halfring,180")\<br />
\<br />
card([[di_counter:gas.last_day:bar2month-300],[[di_counter:gas.last_month],0,250,90,0,"letzter","","0,,fill:silver, m³"],[[di_counter:gas.month],0,250,90,0,"Monat","","0,,fill:silver, m³"]],"Gasverbrauch", undef,0,10,90,0,"Tag", undef,"2,,fill:silver, m³","130,1,1,0,1,noring,180")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_gas.png|ohne|mini]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_wetter DOIF {}<br />
attr di_wetter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
card([Aussen:temperature:col2d],"","temp_outside\@silver",-10,50,undef,undef,"Temp.",\&temp_hue,"1,,fill:silver,°C","130,,,0,1,,",undef,undef,[[Aussen:humidity:col2d],[[Wetter:WindboeenKm],0,30,90,30,"Wind","","1,,fill:silver, km/h",",,,0"],[[Wetter:LuftdruckHpa],980,1047,30,90,"Luftdr.","","0,,fill:silver,hPa",",,,0"],[[Wetter:RegenMm],0,10,180,270,"Regen","","1,,fill:silver, mm",",,,0"]],0,100,undef,undef,"Feuchte",\&hum_hue,"0,,fill:silver, %")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_wetter.png|ohne|mini]]<br />
<br />
======<big>Anwendungsbeispiele mit card</big>======<br />
<syntaxhighlight lang="perl"><br />
defmod Aktuell DOIF {}<br />
attr Aktuell alias Übersicht<br />
attr Aktuell uiTable {package ui_Table;;\<br />
\<br />
$TC{0..1} = "style='vertical-align:top'"\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNOSTATE=1;;\<br />
}\<br />
## $prop: "<size>,<y-scaling>,<steps>,<noFooter>,<noColor>,<hring>,<width>"\<br />
"<div class='doifclock'style='font-size:25pt;;color:silver'>wait</div>"<\<br />
style([wetter_com_broich:Ansage],[wetter_com_broich:Ansage] eq "Kein Niederschlag in Sicht" ? "silver":"red")<\<br />
\<br />
card([Aussen:temperature:col2d],undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,[Aussen:humidity:col2d],0,100,undef,undef,"%",\&hum_hue,"0,,fill:silver")|\<br />
card([Wetter:RegenGesamtMm:col3d],undef,"weather_rain_gauge\@silver",0,10,180,270,"mm",undef,"1,,fill:silver","130,1,1,0,1",undef,undef,[di_Regen:state:col3d],0,5,230,290,"Regen",undef,"1,,fill:silver")\<br />
\<br />
card([MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,,1,0,1",'0,,1')|\<br />
card([Wetter:WindboeenKm:col2d],undef,"weather_wind\@silver",0,40,120,0,"km/h",undef,"1,,fill:silver","130,,,0,1")\<br />
\<br />
card([[Tankstelle:SuperE5:col3d],[Tankstelle:Diesel:col3d]],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,,1,0,1",undef,undef)|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_w.last_day:col4w],undef,"measure_water_meter\@silver",0,600,120,0,"Verbr.",undef,"0,,fill:silver","130,1,1,0,1",undef,undef,[Wasserzisterne:Stand:col4w],0,100,240,180,"Zisterne",undef,"0,,fill:silver")\<br />
\<br />
card([RKI7:Dueren:col1w],undef,"coronavirus\@silver",0,200,120,0,"Fälle",undef,"0,,fill:silver","130,,1,0,1")|\<br />
card([[di_counter_new:vaillant.total_h.last_day:col4w],[di_counter_new:vaillant.total_hwc.last_day:col4w]],undef,([vaillant:Pumpenstatus] eq "on" ? "sani_boiler_temp\@red" : "sani_boiler_temp\@silver"),0,50,90,0,["Gesamt","Wasser"],undef,"1,,fill:silver","130,1,1,0,1","0,0,0,0,2")\<br />
\<br />
card([[MQTT2_DVES_C58DCB:power_pv:144col1d],[MQTT2_DVES_C58DCB:power_fc:144col1d]],"","fa_bolt\@silver",-3.6,3.6,0,90,["PV","Netz"],[(-1,0,-0.01,30,1,60,3.6,90)],"2,,fill:silver","130,,1,0,1","1,,1,0,1",undef, [[di_counter_new:MQTT2_DVES_C58DCB.total_pv.day],[di_counter_new:MQTT2_DVES_C58DCB.total_c.day],[di_counter_new:MQTT2_DVES_C58DCB.total_f.day]],-25,25,0,90,["PV","Bezug","Einsp."],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:col4w],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:col4w]],"kWh","fa_bolt\@silver",-25,25,0,90,["PV","Bezug"],[(-10,0,-0.01,30,10,60,25,90)],"2,,fill:silver","130,,1,0,1,1","1,,1,0,1")\<br />
\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.day:200col4w],"Gas Tagesverlauf",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:col4w],"Gas in m³ pro Tag",undef,0,5,90,0,"m³",undef,"2","130,1,1,0,1,1,180","0,0,0,0,2")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_card_uebersicht.png|ohne|mini]]<br />
<br />
=====<big>Darstellung fortlaufender Daten als Säulen</big>=====<br />
Die Darstellung von fortlaufenden Daten kann mit Hilfe von Säulendiagrammen über den Darstellungstyp '''bar''' oder '''barAvg''' erfolgen. Werden die Reading-Werte innerhalb der definierten Periode öfters geschrieben, so wird bei der Angabe '''bar''' der letzte Wert des jeweiligen Zeitraums übernommen, bei der Angabe '''barAvg''' wird dagegen der Mittelwert der Werte gebildet und als Säule dargestellt. Die Werte der aktuellen Periode werden in hellen Farben dargestellt, die der vorherigen Perioden sind abgedunkelt. Der aktuelle Tag wird im Diagramm gekennzeichnet. Ebenso wird der minimale, maximale und der durchschnittlicher Wert errechnet und im Diagramm per Symbol bzw. Linie gekennzeichnet.<br />
======<big>Energieverbrauch verschiedener Zeiträume</big>======<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card siehe Syntax zu bar/barAvg beim card-Parameter <collect type>]<br />
* [https://wiki.fhem.de/wiki/DOIF/Automatisierung#Tages-.2C_Monats-_und_Jahresstatistik_f.C3.BCr_Strom-.2C_Gas-.2C_Wasserz.C3.A4hler_und_andere_Z.C3.A4hler siehe Statistik zu Zählerdaten]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_energie DOIF {}<br />
attr di_energie uiTable {package ui_Table}\<br />
"Darstellung eines Monats"|"Darstellung eines Jahres"|"Darstellung einer Dekade"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1month],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_month:bar1year],"Gas in m³ pro Monat",undef,0,100,90,0,"m³",undef,"0","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_year:bar1decade],"Gas in m³ pro Jahr",undef,0,20000,90,0,"m³",undef,"0","130,1,1,0,1,0,200")\<br />
"Darstellung einer Woche"|"Darstellung zwei Wochen"|"Darstellung vier Wochen"\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar1week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar2week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")|\<br />
card([di_counter_new:MQTT2_DVES_C58DCB.total_gas.last_day:bar4week],"Gas in m³ pro Tag",undef,0,10,90,0,"m³",undef,"1","130,1,1,0,1,0,200")\<br />
"Darstellung von zwei Werten"|"Darstellung mit Halbringen"|"Darstellung von zwei Monaten"\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"Elektrizität in kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,0,200","0,0,0,0,2")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar1month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar1month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")|\<br />
card([[di_counter_new:MQTT2_DVES_C58DCB.total_pv.last_day:bar2month],[di_counter_new:MQTT2_DVES_C58DCB.total_c.last_day:bar2month]],"kWh pro Tag",undef,-15,15,0,90,["Ertrag","Bezug"],undef,"1","130,1,1,0,1,halfring,200")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:di_energie_bar.png|ohne|mini]]<br />
<br />
=====<big>Import, Änderung und Löschung von Diagrammdaten</big>=====<br />
{{Randnotiz|RNText='''card-data-Funktionen'''<br />
<br />
Gesammelte card-Daten löschen.<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data (<card device>,<reading device>,<reading>,<col/bar specification>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<br />
Daten aus einer Logdatei oder einer Liste übernehmen. Vorhandene card-Daten werden zuvor nicht gelöscht.<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data (<card device>,<reading device>,<reading>,<col/bar specification>,<time offset>,<data list>)<br />
</syntaxhighlight><br />
<syntaxhighlight lang="perl"><br />
#<card device> DOIF-Device, wo die Definition der zu sammelnden Daten vorgenommen wurde<br />
#<reading device> Device des Readings<br />
#<reading> Readingname<br />
#<col/bar specification> die dazugehörige Spezifikation des collect Typs, z. B. "col1w", "bar1month" usw.<br />
#<time offset> Angabe in Sekunden.<br />
Der Zeitstempel der Daten wird zeitlich (positiv - in die Zukunft, negativ - in die Vergangenheit) verschoben. Damit kann man erreichen, dass Daten, die nach Mitternacht entstanden sind, dem Tag zuvor zugeordnet werden (negative Sekundenangabe).<br />
#<data list> Liste von Datensätzen, die importiert werden sollen<br />
das Format eines Datensatzes ist:<br />
#YYYY.MM.DD_HH:MM:SS<separator><value>, mit<br />
#<separator> Leerzeichen oder Semikolon<br />
#<value> Zahl<br />
#ebenfalls ist das deutsche Zeitformat erlaubt<br />
#DD.MM.YYYY HH:MM:SS<br />
Die Datensätze können durch Komma oder Zeilenumbruch (newline) voneinander getrennt werden. Werden Zahlen mit Komma statt mit Punkt angegeben, so müssen die Datensätze durch Zeilenumbrüche getrennt werden.<br />
Bei Datumsangaben kann der Tag und der Monat weggelassen werden, ebenfalls können Zeitangaben weggelassen werden.<br />
Beispiel: "2023.02.21_15:01 10,2023.02.21 20,2023 15" oder "15.02.2023 15:01 10,21.02.2023 20,2023 15"<br />
Die Liste kann ebenfalls von einer Funktion geliefert werden, wie z. B. Filelog oder DOIF_get_file_data.<br />
</syntaxhighlight><br />
}}<br />
Die Daten der zu visualisierenden Readings werden event-gesteuert im DOIF-Device gesammelt und in versteckten Readings gespeichert. Bei Neudefinition von card oder nach einem Systemcrash kann es sinnvoll sein, vorhandene Daten aus dem Log oder einer Liste für die Visualisierung zu übernehmen. Ebenfalls können gesammelte Daten gelöscht oder einzeln modifiziert werden. All das lässt sich mit den card-data-Funktionen umsetzen.<br />
<br />
'''Beispiele'''<br />
<br />
Ausgangssituation: Im DOIF-Device '''di_pv''' werden Daten mit Angabe '''[energie:pv:col4w]''' über card-Funktion visualisiert.<br />
<br />
Löschen der visualisierten Daten:<br />
<syntaxhighlight lang="perl"><br />
DOIF_delete_card_data ("di_pv","energie","pv","col4w")<br />
</syntaxhighlight><br />
<br />
Übernehmen von Daten eines bestimmten Zeitraums aus dem Log namens '''pv.energie.log''', dort wurden die Daten des Readings '''pv''' geloggt:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,fhem("get pv.energie.log - - 2022-11-01 2023-02-03 4:pv"))<br />
</syntaxhighlight><br />
<br />
get-Filelog-Syntax bitte in der Dokumentation zu Filelog entnehmen.<br />
<br />
Statt Log-Daten können ebenfalls Daten in einer kommagetrennten Liste angegeben übernommen werden.<br />
<br />
Es sollen zwei Datensätze übernommen werden:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_modify_card_data ("di_pv","energie","pv","col4w",0,"2023.02.04_11:00 10,2023.02.04_11:02 5.6")<br />
</syntaxhighlight><br />
<br />
Eine Liste aus einer Datei, z. B. aus einer csv-Excel-Datei, kann mit der Funktion '''DOIF_get_file_data (<file>)''' übernommen werden. Dabei ist es unerheblich, ob die Daten im deutschen oder im internationalen Zeitformat vorliegen, ebenso wird das Kommazeichen statt Punkt bei Zahlen erkannt.<br />
<br />
Ausgangssituation: Die Datei ''gas_jan.csv'' wurde in das log-Verzeichnis kopiert. Sie beinhaltet u.a. folgende Datensätze (Nachkommastellen wurden mit Komma getrennt):<br />
<br />
<syntaxhighlight lang="perl"><br />
2023;4,142<br />
02.01.2023 00:01:00;5,159<br />
03.01.2023 00:01;3,170<br />
04.01.2023;5,420<br />
</syntaxhighlight><br />
<br />
Der Import der Daten:<br />
<br />
<syntaxhighlight lang="perl"><br />
DOIF_set_card_data ("di_pv","energie","pv","col4w",0,DOIF_get_file_data("./log/gas_jan.csv")))<br />
</syntaxhighlight><br />
<br />
=====<big>card im Status des Originaldevices</big>=====<br />
Soll im Status des Originaldevices eine Visualisierung mit Hilfe der card-Funktion vorgenommen werden, so kann wie folgt vorgegangen werden.<br />
<br />
Definition eines DOIF-Devices mit dem Attribut DOIF_Readings zum Sammeln der zu visualisierenden Daten.<br />
<br />
Beispieldefintion für fünf Readings aus unterschiedlichen Devices:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_collect DOIF {}<br />
attr di_collect DOIF_Readings temperature:[Aussen:temperature:col2d],\<br />
humidity:[Aussen:humidity:col2d],\<br />
co2:[MQTT2_DVES_D90D08:MHZ19B_CarbonDioxide:col2d],\<br />
SuperE5:[Tankstelle:SuperE5:col3d],\<br />
Diesel:[Tankstelle:Diesel:col3d],\<br />
full:[GasInStorageDE:full:bar1month]<br />
</syntaxhighlight><br />
<br />
Im ursprünglichen Device wird jeweils über das Attribut devStateIcon der Aufruf von card vorgenommen:<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Aussen CUL_WS 5<br />
attr Aussen alias Schuppen<br />
attr Aussen devStateIcon {ui_Table::card(ReadingsVal("di_collect","temperature",""),undef,"temp_outside\@silver",-10,50,undef,undef,"°C",\&ui_Table::temp_hue,"1,,fill:silver","130,,,0,1,,",undef,undef,ReadingsVal("di_collect","humidity",""),0,100,undef,undef,"%",\&ui_Table::hum_hue,"0,,fill:silver")}<br />
<br />
defmod GasInStorageDE JsonMod https://agsi.gie.eu/api?country=de&date=now<br />
attr GasInStorageDE comment Status: \<br />
E - Estimated - Geschätzt\<br />
C - Confirm - Bestätigt<br />
attr GasInStorageDE devStateIcon {ui_Table::card(ReadingsVal("di_collect","full",""),undef,"",0,100,0,120,"full in %",undef,"1",",fixedscaling,,,,halfring")}<br />
attr GasInStorageDE httpHeader x-key: 08154711<br />
attr GasInStorageDE interval 0 6 * * *<br />
attr GasInStorageDE readingList single(jsonPath('$.gas_day'), 'gas_Day', 'N/A');;\<br />
single(jsonPath('$.data.0.gasInStorage'), 'gasInStorage', 'N/A');;\<br />
single(jsonPath('$.data.0.consumption'), 'consumption', 'N/A');;\<br />
single(jsonPath('$.data.0.consumptionFull'), 'consumptionFull', 'N/A');;\<br />
single(jsonPath('$.data.0.injection'), 'injection', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawal'), 'withdrawal', 'N/A');;\<br />
single(jsonPath('$.data.0.workingGasVolume'), 'workingGasVolume', 'N/A');;\<br />
single(jsonPath('$.data.0.injectionCapacity'), 'injectionCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.withdrawalCapacity'), 'withdrawalCapacity', 'N/A');;\<br />
single(jsonPath('$.data.0.status'), 'status', 'N/A');;\<br />
single(jsonPath('$.data.0.trend'), 'trend', 'N/A');;\<br />
single(jsonPath('$.data.0.full'), 'full', 'N/A');;<br />
<br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/24198 300<br />
attr Tankstelle devStateIcon {ui_Table::card([ReadingsVal("di_collect","SuperE5",""),ReadingsVal("di_collect","Diesel","")],undef,"fuel\@silver","1.50","2.00",120,0,["E10","Diesel"],undef,"2,,fill:silver","130,1,1,0,1",undef,undef)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle timeout 10<br />
<br />
defmod MQTT2_DVES_D90D08 MQTT2_DEVICE DVES_D90D08<br />
attr MQTT2_DVES_D90D08 devStateIcon {ui_Table::card(ReadingsVal("di_collect","co2",""),undef,"air\@silver",400,1200,120,0,"ppm",[(600,120,1000,60,1200,0)],"0,,fill:silver","130,autoscaling,nosteps,footer,noycolor",'nogradient,nominmaxvalue,innerring,nopointer,minmax')}<br />
</syntaxhighlight><br />
<br />
Die Visualisierung wird automatisch aktualisiert. Mit Hilfe dieser Vorgehensweise lassen sich cards über den Status des jeweiligen Devices oder den direkten Aufruf der card-Funktion auch in anderen Frontends wie z. B. Floorplan oder TabletUI darstellen.<br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:card_im_Status.png|ohne|mini]]<br />
<br />
====<big>3d-Balkendarstellung mehrerer Zahlenwerten mit Hilfe der universellen SVG-Funktion '''cylinder/cylinder_s''' </big> ====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Bei cylinder_s werden die Balken aufeinander gestapelt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder/cylinder_s'''<br />
<syntaxhighlight lang="perl"><br />
cylinder/cylinder_s ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
}}<br />
=====<big>cylinder mit verschiedenen Layouts</big>=====<br />
<syntaxhighlight lang="perl"><br />
defmod di_cylinder DOIF ##<br />
attr di_cylinder room Test,wiki<br />
attr di_cylinder uiTable {package ui_Table}\<br />
"normal"|cylinder("",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Überschrift"|cylinder("Zisterne",0,100,"%",80,undef,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"kleiner"|cylinder("Zisterne",0,100,"%",80,undef,80,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"hoch"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,undef)\<br />
\<br />
"mit Beschriftung"|cylinder("Zisterne",0,100,"%",undef,100,undef,0,[Wasserzisterne:state],200,"Wasserstand")\<br />
\<br />
"mit mehreren Informationen"|cylinder("Energie",-20,30,"kWh",undef,undef,undef,1,[zaehler:Bezug],0,"Bezug",[zaehler:Produktion],60,"Produktion",[zaehler:Eigenverbrauch],30,"Eigenverbrauch")\<br />
\<br />
"mit hellen Farben"| cylinder("Tag",0,100,"kWh",undef,undef,undef,1,[Heizenergie:Tagesverbrauch_hc]/100000,"30.100.70","letzter",[Heizenergie:heute_hc]/100000,"60.100.70","aktuell")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bsp.png|ohne|mini]]<br />
<br />
=====<big>Gestapelte Werte mit cylinder_s</big>=====<br />
Gegenüberstellung cylinder und cylinder_s<br />
[[Datei:cylinder_s.png|ohne|mini]]<br />
<br />
====<big>Balkendarstellung mehrerer Zahlenwerte mit Hilfe der universellen SVG-Funktion '''cylinder_bars''' </big>====<br />
Es können mehrere Zahlenwerte mit Legende farbig in Balkenform visualisiert werden. Negative Werte werden als Balken nach unten dargestellt, positive nach oben, der Nullpunkt wird automatisch berechnet. Die '''cylinder_bars'''-SVG-Funkton besitzt die gleichen Argumente, wie die obige '''cylinder'''-SVG-Funktion, mehrerer Balken werden jedoch nicht übereinander, sondern nebeneinander dargestellt.<br />
{{Randnotiz|RNText=SVG-uiTable-Funktion '''cylinder_bars'''<br />
<syntaxhighlight lang="perl"><br />
cylinder_bars ($header,$min,$max,$unit,$width,$height,$size,$dec,($value1,$color1,$text1),($value2,$color2,$text2),...<br />
<br />
$header # Überschrift<br />
$min # minimaler Wert, optional, default = 0<br />
$max # maximaler Wert, optional, default = 100<br />
$unit # Einheit des Wertes, optional, default = undef<br />
$width # Breite der Grafik, optional, default = wird bei Beschriftungen automatisch angepasst<br />
$height # Höhe der Grafik, optional, default = wird automatisch berechnet<br />
$size # Größe der Grafik, optional, default = 100<br />
$dec # Anzahl der Nachkommastellen, optional, default=1<br />
$value1 # erster Zahlenwert<br />
$color1 # HSL-Farbe des ersten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text1 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
$value2 # zweiter Zahlenwert, optional<br />
$color2 # HSL-Farbe des zweiten Balkens: "<hue>.<saturation>.<lightness>" (hue:0-360,saturation:0-100,lightness:0-100), saturation (default:100) und lightness (default:50) sind optional<br />
$text2 # Beschriftung des Zahlenwertes in der Legende, optional, default = undef<br />
...<br />
Es können weitere Zahlenwerte jeweils mit Farbe und Beschriftung optional angegeben werden <br />
</syntaxhighlight><br />
* [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Darstellung_fortlaufender_Daten_als_S.C3.A4ulen siehe auch card bar]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_wasserverbrauch DOIF ##<br />
attr di_wasserverbrauch uiTable {package ui_Table;;}\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:monatsdurchschnitt],30,"Durchschnitt",[Wasserverbrauch:monatsverbrauch]/1000,220,"letzter",[Wasserverbrauch:monat]/1000,180,"aktuell")\<br />
\<br />
cylinder_bars("Monat",0,15,"m³",undef,undef,undef,1,[Wasserverbrauch:jan],30,"Januar",[Wasserverbrauch:feb],220,"Februar",[Wasserverbrauch:mrz],180,"März",[Wasserverbrauch:apr],30,"April",[Wasserverbrauch:mai],220,"Mai",[Wasserverbrauch:jun],180,"Juni",[Wasserverbrauch:jul],30,"Juli",[Wasserverbrauch:aug],220,"August",[Wasserverbrauch:sep],180,"September",[Wasserverbrauch:okt],30,"Oktober",[Wasserverbrauch:nov],220,"November",[Wasserverbrauch:dez],180,"Dezember")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:cylinder_bars_bsp.png|ohne|mini]]<br />
<br />
=== Einfache uiTable-Funktionen ===<br />
==== Farbskalierte Temperaturanzeige mit Hilfe der Funktion '''temp''' ====<br />
Die Farbe der dargestellten Temperatur ist abhängig vom Temperaturwert:<br />
[[Datei:Farbskalierung temp.png|600px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp'''<br />
<syntaxhighlight lang="perl"><br />
temp ($temp,$size,$icon)<br />
<br />
$temp # Temperatur<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_temp DOIF ##<br />
attr di_uiTable_temp uiTable {\<br />
package ui_Table;; ## Package für uiTable-Funktionen\<br />
$TC{0..2}="align='center'";; ## zentrierte Darstellung aller Tabellenspalten\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
"Aussen"|"Bad"|"Warmwasser" ## mit | werden Tabellenzellen voneinander getrennt \<br />
temp([Aussensensor:temperature])| ## Anzeige des Readings 'temperature' des Gerätes 'Aussensensor' \<br />
temp([TH_Bad_HM:measured-temp],24,"temp_temperature")| ## Schriftgröße 24pt, mit Icon namens temp_temperature\<br />
temp([T_Warmwasserspeicher:temperature:d1],20) ## Schriftgröße 20pt<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Temp.png|ohne|mini]]<br />
<br />
==== Farbskalierte Feuchtigkeitsanzeige mit Hilfe der Funktion '''hum''' ====<br />
Die Farbe der dargestellten Feuchtigkeit ist abhängig vom Feuchtigkeitswert:<br />
[[Datei:Farbskalierung hum.png|350px|ohne]]<br />
{{Randnotiz|RNText=uiTable-Funktion '''hum'''<br />
<syntaxhighlight lang="perl"><br />
hum ($hum,$size,$icon)<br />
<br />
$hum # Feuchtigkeit<br />
$size # Schriftgröße in Pixel (pt), optional<br />
$icon # Icon, welches vorangestellt wird, optional<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hum DOIF ##<br />
attr di_uiTable_hum uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";; ## zweite Spalte der Tabelle zentriert\<br />
}\<br />
## Tabellendefinition \<br />
\<br />
## Anzeige des Readings 'humidity' des Thermostats 'TH_Bad_HM' \<br />
"Bad"|hum ([TH_Bad_HM:humidity])\<br />
\<br />
## Feuchtigkeit in Größe 10pt mit Temperatur in einer Tabellenzelle\<br />
"Aussen"|temp ([Aussensensor:temperature]),hum ([Aussensensor:humidity],10)\<br />
\<br />
## Feuchtigkeit in Größe 26pt mit Icon namens 'temperature_humidity'\<br />
"Keller"|hum ([TH_Keller_HM:humidity],26,"temperature_humidity")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Funktion hum.png|ohne|mini]]<br />
<br />
==== Textformatierungen mit Hilfe der Funktion '''style''' ====<br />
Texte werden in Farbe, Größe und Schriftart statisch oder dynamisch formatiert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''style'''<br />
<syntaxhighlight lang="perl"><br />
style ($text,$color,$font_size,$font_weight)<br />
<br />
$text # anzuzeigender Text<br />
$color # CSS color, optional<br />
$font_size # Schriftgröße in Pixel (pt), optional<br />
$font_weight # CSS Schriftart, optional<br />
</syntaxhighlight><br />
Mögliche Werte für '''''color''''' und '''''font_weight''''' können in einschlägiger Dokumentation zu CSS nachgeschlagen werden<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_style DOIF ##<br />
attr di_uiTable_style uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## statische Farbgebung, Größe, Schriftart \<br />
style("Montag","orange")\<br />
style("Dienstag","red",14)\<br />
style("Mittwoch","#00FFFF",20)\<br />
style("Donnerstag","blue",23,"bold")\<br />
\<br />
## dynamische Farbgebung abhängig vom Zustand des Gerätes 'Alarm'\<br />
style("Alarm",([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## dynamische Farbgebung des Zustands des Gerätes 'Alarm'\<br />
style([Alarm:state],([Alarm:state] eq "on" ? "red":"green"))\<br />
\<br />
## variabler Text abhängig vom Zustand des Gerätes 'Alarm'\<br />
style(([Alarm:state] eq "on" ? "Alarm aktiv":"Alarm deaktiviert"),"red")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Style.png|ohne|mini]]<br />
<br />
==== Icon-Darstellung mit Hilfe der Funktion '''ICON''' ====<br />
Mit Hilfe der Funktion '''ICON''' kann ein FHEM-Icon dargestellt werden<br />
{{Randnotiz|RNText=uiTable-Funktion '''ICON'''<br />
<syntaxhighlight lang="perl"><br />
ICON ($icon)<br />
<br />
$icon # Icon mit Farbgebung<br />
</syntaxhighlight><br />
<br />
'''ICON''' benutzt die Funktion [[DevelopmentFHEMWEB-API#FW_makeImage|FW_makeImage]]<br />
<br />
'''nützliche Links'''<br />
* [[DOIF/uiTable Schnelleinstieg#hsv-Funktion für Farbskalierungen|hsv-Funktion]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_Table_ICON DOIF ##<br />
attr di_Table_ICON uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
ICON("temp_frost") | ## Icon ohne Einfärbung\<br />
ICON("temp_frost\@blue") | ## Icon in CSS-Farbe blau\<br />
ICON("temp_frost\@#8A2BE2") | ## Icon in CSS-Farbe #8A2BE2\<br />
ICON("temp_frost\@".([Aussensensor:temperature] > 0 ? "orange":"blue"))| ## Icon in CSS-Farbe orange über Null Grad, sonst in CSS-Farbe blau\<br />
ICON("temp_frost\@".hsv ([Aussensensor:temperature],-20,40,320,0)) ## Icon in Farbskalierung von violett (-20 °C) bis rot (40 °C) mit Hilfe der Funktion hsv<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_IC.png|mini|ohne]]<br />
<br />
==== Icon-Darstellung mit Text mit Hilfe der Funktion '''icon_label''' ====<br />
Mit Hilfe der Funktion '''icon_label''' kann ein FHEM-Icon mit einem angehängten Text/Wert dargestellt werden.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon_label'''<br />
<syntaxhighlight lang="perl"><br />
icon_label ($icon,$text,$color,$color_bg,$pos_left,$pos_top)<br />
$icon # FHEM-Icon mit Farboption<br />
$text # dargestellter Text<br />
$color # Farbe des Textes, optional<br />
$color # Hintergrundfarbe des Textes, optional<br />
$pos_left # horizontale Position des Textes in px, default -5, optional<br />
$pos_top # vertikale Position des Textes in px, default -8, optional<br />
</syntaxhighlight><br />
<br />
'''Anwendungsbeispiele'''<br />
* [[DOIF/uiTable Schnelleinstieg#Anzahl der Tage bis zur Abfall-Entsorgung|Abfall]]<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung: aktueller Spritpreis|Sprit]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon_label DOIF ##<br />
attr di_uiTable_icon_label uiTable { package ui_Table;;\<br />
}\<br />
\<br />
icon_label("fuel",[Tankstelle:Diesel])|\<br />
icon_label("fuel",[Tankstelle:Diesel],"red")|\<br />
icon_label("fuel\@blue",[Tankstelle:Diesel],"blue","#999999")|\<br />
icon_label("fuel\@red",[Tankstelle:Diesel],"red","white",-10)|\<br />
icon_label("fuel",[Tankstelle:Diesel],"white","red",-5,8)\<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable_icon_label.png|mini|ohne]]<br />
<br />
==== Visualisierung eines Gerätes mit Hilfe der Funktion '''icon''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt.<br />
{{Randnotiz|RNText=uiTable-Funktion '''icon'''<br />
<syntaxhighlight lang="perl"><br />
icon ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # Wert <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_icon DOIF ##<br />
attr di_uiTable_icon uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## Tabellendefinition\<br />
\<br />
## Standard-Icon off/on für Standardwert off/on \<br />
"Lampe"|icon([Lampe:state]) ## entspricht icon([Lampe:state],"off","on","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'hue_room_hallway', für Zustand 'on' 'hue_room_hallway\@DarkOrange'\<br />
"Flur"|icon([Lampeflur:state],"hue_room_hallway") ## entspricht icon([Lampeflur:state],"hue_room_hallway","hue_room_hallway\DarkOrange","off","on")\<br />
\<br />
## Icon für Zustand 'off' ist 'status_away_2', für Zustand 'on' 'status_available\@DarkOrange'\<br />
"Anwesenheit"|icon([Anwesenheit:state],"status_away_2","status_available\@DarkOrange") \<br />
\<br />
## Icon für Zustand 'closed' ist "status_locked", für Zustand 'open' 'status_open\@DarkOrange'\<br />
"Haus"|icon([Schloss:state],"status_locked","status_open\@DarkOrange","closed","open") <br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable icon.png|mini|ohne]]<br />
<br />
==== Schaltbares Icon mit Hilfe der Funktion '''switch''' ====<br />
Der Zustand eines Gerätes/Readings wird mit Hilfe eines Icons dargestellt, er kann über die WEB-Oberfläche durch Anklicken geschaltet werden. Damit der Zustand des Gerätes geschaltet werden kann, muss das Gerät den set-Befehl unterstützen.<br />
<br />
{{Randnotiz|RNText=uiTable-Funktion '''switch'''<br />
<syntaxhighlight lang="perl"><br />
switch ($value,$icon_off,$icon_on,$state_off,$state_on)<br />
<br />
$value # [<device>:<reading>] <br />
$icon_off # Icon für den Wert off, default "off"<br />
$icon_on # Icon für den Wert on, default Icon für Wert 'off' in Farbe 'DarkOrange', sonst Icon 'on', wenn $icon_off nicht definiert ist<br />
$state_off # Wert zugehörig zum Icon off, default "off"<br />
$state_on # Wert zugehörig zum Icon on, default "on"<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_switch DOIF ##<br />
attr di_uiTable_switch uiTable {\<br />
package ui_Table;;\<br />
}\<br />
## schaltbares Icons in der Webansicht \<br />
switch([Lampe:state]) | \<br />
switch([Lampeflur:state],"hue_room_hallway") |\<br />
switch([Anwesenheit:state],"status_away_2","status_available\@DarkOrange")|\<br />
switch([Haus:state],"status_locked","status_open\@DarkOrange","closed","open")\<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable switch.png|mini|ohne]]<br />
<br />
==== Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion '''shutter''' ====<br />
Die aktuelle Position des Rollladens (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Symbols steuert den Rollladen auf die entsprechende Position. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''shutter'''<br />
<syntaxhighlight lang="perl"><br />
shutter ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Rollladenposition, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # optional, Anzahl der Symbole 2 bis 6, 3 ist default<br />
</syntaxhighlight><br />
<br />
* [[DOIF/uiTable Schnelleinstieg#Visualisierung und Steuerung von Rollläden|Anwendungsbeispiel]]<br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_shutter DOIF ##<br />
attr ui_Table_shutter uiTable {\<br />
package ui_Table;;\<br />
}\<br />
shutter([R_Keller:pct],"\@yellow",2) ## zwei Symbole für 0 % und 100 %\<br />
shutter([R_Wohnzimmer_S:pct]) ## entspricht shutter ([R_Wohnzimmer_S:pct],"\@DarkOrange",3) \<br />
shutter([R_Wohnzimmer_W1:pct],"blue",4) ## vier Symbole \<br />
shutter([R_Wohnzimmer_W2:pct],"\@red",5) ## fünf Symbole\<br />
shutter([R_Wohnzimmer_W3:pct],"red",6 ## sechs Symbole)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable shutter.png|mini|ohne]]<br />
<br />
==== Helligkeit: Visualisierung und Steuerung mit Hilfe der Funktion '''dimmer''' ====<br />
Die aktuelle Helligkeit (0 % - 100 %) wird über Icons visualisiert. Das Anklicken eines Icons bestimmt die Helligkeit der Leuchte. Prozentwerte zwischen zwei Icon-Werten werden dem nächsthöheren Icon-Wert zugeordnet.<br />
{{Randnotiz|RNText=uiTable-Funktion '''dimmer'''<br />
<syntaxhighlight lang="perl"><br />
dimmer ($value,$color,$type)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der aktuellen Helligkeit, vorangestelltes @ verändert die Farbe des Icons, ohne @ wird der Hintergrund des Icons eingefärbt, default ist @DarkOrange<br />
$type # Anzahl der Symbole 2 bis 7, 3 ist default<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_dimmer DOIF ##<br />
attr di_uiTable_dimmer uiTable {\<br />
package ui_Table;;\<br />
}\<br />
dimmer([Strauch3:pct],"\@yellow",2)\<br />
dimmer([Strauch3:pct]) ## entspricht dimmer([Strauch3:pct],"\@DarkOrange",3) \<br />
dimmer([Strauch3:pct],"blue",4)\<br />
dimmer([Strauch3:pct],"\@red",5)\<br />
dimmer([Strauch3:pct],"red",6)\<br />
dimmer([Strauch3:pct],"DarkOrange",7)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable dimmer.png|mini|ohne]]<br />
<br />
==== Vorgabetemperatur eines Thermostats mit Hilfe der Funktion '''temp_knob''' ====<br />
Die aktuelle Vorgabetemperatur eines Thermostats wird über ein Icons visualisiert. Durch Anklicken des Ringes wird die Vorgabetemperatur verändert.<br />
{{Randnotiz|RNText=uiTable-Funktion '''temp_knob'''<br />
<syntaxhighlight lang="perl"><br />
temp_knob ($value,$color,$set)<br />
<br />
$value # [<device>:<reading>] <br />
$color # Farbe der voreingestellten Temperatur, default "Darkorange"<br />
$set # set-Befehl, default "set", sonst muss "set <Readingname>" angegeben werden, falls sich das Reading vom set-Befehl vom angezeigten Reading unterscheidet, wie beim THRESHOLD-Modul<br />
</syntaxhighlight><br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_temp_knob DOIF ##<br />
attr ui_Table_temp_knob uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## HM-EU-Thermostat, angezeigt wird das Reading "desired-temp", geschaltet wird über "set desired-temp" \<br />
"Dachgeschoss"|temp_knob([TH_DG_HM:desired-temp]) ## entspricht temp_knob([TH_DG_HM:desired-temp],"Darkorange","set") \<br />
\<br />
## HM-EU-Thermostat Temperaturanzeige in gelb \ <br />
"Wohnzimmer"|temp_knob([TH_WZ_HM:desired-temp],"yellow") \<br />
\<br />
## Beim THRESHOLD-Modul wird das Reading "desired_value" angezeigt, geändert wird die Temperatur per "set desired" \<br />
"Küche"|temp_knob([TH_Kueche:desired_value],"red","set desired")<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable temp knob.png|mini|ohne]]<br />
<br />
== uiTable-'''Templates''' ==<br />
Die Definition einer oder mehrere Zellen kann zu einem Template zusammengefasst werden. Durch die Nutzung von Templates kann die Definition einer Tabelle erheblich vereinfacht werden. Insb. bei gleichartigen Zellen/Zeilen für verschiedene Geräte/Readings braucht eine aufwendige Definition nicht immer wieder wiederholt werden, sondern kann jeweils mit dem Aufruf eines zuvor definierten Templates realisiert werden.<br />
{{Randnotiz|RNText='''Templates'''<br />
* Die Definition von Templates muss vor der Tabellendefinition vorgenommen werden<br />
* Eine Template-Definition beginnt mit dem Schlüsselwort '''DEF'''<br />
* Der Template-Name muss mit '''TPL_''' beginnen<br />
* '''Template-Definition'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
DEF TPL_<Template-Name>(<Zellendefinition mit Platzhaltern: $1,$2,...>)<br />
</syntaxhighlight><br />
* Templates-Definitionen können in externe Dateien ausgelagert werden<br />
* Templates-Definitionen können per IMPORT-Befehl aus externen Dateien importiert werden<br />
* '''Template-Import'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
IMPORT <Pfad mit Dateinamen><br />
</syntaxhighlight><br />
* Innerhalb einer Tabellendefinition können zuvor definierte oder importierte Templates mehrfach genutzt werden<br />
* '''Template-Aufruf'''-Syntax<br />
<syntaxhighlight lang="perl"><br />
TPL_<Template-Name>(<Übergabeparameter für $1>,<Übergabeparameter für $2>,...)<br />
</syntaxhighlight><br />
}}<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod ui_Table_Template DOIF ##<br />
attr ui_Table_Template uiTable {\<br />
package ui_Table;;\<br />
$TC{1..3}="align='center'";; ## Spalten 1 bis 3 werden zentriert\<br />
}\<br />
\<br />
## Template-Definitionen beginnen vor der Tabellendefinition\<br />
\<br />
## Das Template TPL_raum stellt eine Tabellenzeile dar, die mit Hilfe von uiTable-Funktionen mehrere Tabellenzellen definiert\<br />
DEF TPL_raum ("$1" | temp([TH_$2_HM:measured-temp]),hum([TH_$2_HM:humidity]) | switch([H_$2:state],"fa_off") | temp_knob([TH_$2_HM:desired-temp]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## pro Tabellenzeile wird ein Raum mit Hilfe des oben definierten Templates "TPL_raum" dargestellt\<br />
"Raum"|"Temp./Feuchte"|"Ventil"|"Vorgabetemp."\<br />
TPL_raum (Dachgeschoss,DG) ## der Übergabeparameter "Dachgeschoss" wird im Template "TPL_raum" anstelle von $1 eingesetzt, "DG" wird anstelle von $2 eingesetzt\<br />
TPL_raum (Bad,Bad)\<br />
TPL_raum (Kinderzimmer ost,Kz_o)\<br />
TPL_raum (Kinderzimmer west,Kz_w)\<br />
TPL_raum (Wohnzimmer,WZ)\<br />
TPL_raum (Keller,Keller)<br />
<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable Templates.png|mini|ohne]]<br />
<br />
== Eigene uiTable-Funktionen programmieren ==<br />
Für die eigenen Bedürfnisse können eigene uiTable-Funktionen programmiert werden. In der Datei [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DOIF/uiTable.tpl contrib/DOIF/uiTable.tpl] befinden sich alle intern definierten uiTable-Funktion aus dem package ui_Table als Kopie. Diese Funktionen können als Inspiration für eigene Entwicklung dienen. <br />
{{Randnotiz|RNText='''uiTable-Funktionen'''<br />
* Es gibt drei Arten von uiTable-Funktionen, sie werden intern anhand der Rückgabewerte unterschieden<br />
* uiTable-Funktionen vom Typ 1: '''HTML''', ein Rückgabewert<br />
<syntaxhighlight lang="perl"><br />
return(<HTML-code>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 2: '''Style''' (entspricht der '''STY'''-Funktion), zwei Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return(<value>,<CSS-style>)<br />
</syntaxhighlight><br />
* uiTable-Funktionen vom Typ 3: '''Widget''' (entspricht der '''WID'''-Funktion), vier Rückgabewerte<br />
<syntaxhighlight lang="perl"><br />
return (<value>,<>,<FHEM-widget>,<set-command: "" or "set" or "set <Readingname>">)<br />
</syntaxhighlight><br />
* uiTable-Funktionen sind reine Perlfunktionen<br />
* uiTable-Funktionen sollten im eigenen Package definiert werden, sonst könnten bestehende Perlfunktionen im System überschrieben werden<br />
* uiTable-Funktionen können in Template-Dateien ausgelagert werden und über IMPORT-Befehl importiert werden, siehe Templates<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_function DOIF ##<br />
attr di_uiTable_function uiTable {\<br />
package my_uiTable;; ## eigenes Package mit selbstdefinierten Funktionen\<br />
\<br />
## uiTable-Funktion vom Typ "HTML", Rückgabewert: (HTML-code)\<br />
\<br />
sub clock { ## Anzeige aktueller Uhrzeit mit Datum\<br />
## Voraussetzung: contrib/DOIF/doifclock.js muss ins www/pgm2-Verzeichnis kopiert werden\<br />
## Attribut setzen in der Webinstanz: attr <WEB-Instanz> JavaScripts pgm2/doifclock.js \<br />
my ($color,$size)=@_;;\<br />
$color="darkorange" if (!defined ($color));; ## $color ist optional, default Darkorange\<br />
$size="20" if (!defined ($size));; ## $size ist optional, default 20pt\<br />
return("<div class='doifclock'style='font-weight:bold;;font-size:".$size."pt;;color:".$color.";;'>error</div>")\<br />
}\<br />
\<br />
## uiTable-Funktion vom Typ Style, Rückgabewerte (Wert,CSS-style)\<br />
\<br />
sub red_green { ## Farbige Skalierung von Zahlen mit Hilfe der DOIF_hsv-Funktion: von 0 - rot bis 10 - grün\<br />
my ($value)=@_;;\<br />
return ($value." KW", ## Wert/Text\<br />
"font-weight:bold;;color:".::DOIF_hsv ($value,0,10,0,120,70,100) ## CSS-Style\<br />
);;\<br />
} \<br />
\<br />
## uiTable-Funktion vom Typ Widget, Rückgabewerte (Wert,Leer,FHEM-Widget,set-Befehl)\<br />
\<br />
sub slider { ## FHEM-Widget Slider, weitere FHEM-Widgets siehe: https://wiki.fhem.de/wiki/FHEMWEB/Widgets\<br />
my ($value,$set)=@_;;\<br />
$set="" if (!defined $set);;\<br />
return ($value, ## Zahlenwert\<br />
"", ## leer\<br />
"slider,0,0.5,100,1", ## FHEM-Widget\<br />
$set ## set-Befehl des FHEM-Widgets\<br />
) \<br />
}\<br />
\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
"Uhrzeit/Datum"\<br />
clock("yellow",30) ## obige Funktion clock\<br />
"Dimmer"\<br />
slider([Wohnzimmer:pct]) ## obige Funktion slider\<br />
"Leistung"\<br />
red_green([Leistung:state]) ## obige Funktion red_green<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-functions.png|mini|ohne]]<br />
<br />
== Package-Konzept, Auslagerung eigener Funktionen, der '''IMPORT'''-Befehl==<br />
uiTable arbeitet mit Packages. In einem Package sind definierte Funktionen gekapselt, sie kollidieren nicht mit bereits definierten Funktionen in FHEM.<br />
{{Randnotiz|RNText='''Package'''<br />
* das für die Definition der Tabelle gültige Package wird im Perlblock des uiTable-Attributes angegeben<br />
* interne uiTable-Funktionen befinden sich im Package '''ui_Table'''<br />
* ohne eine Angabe eines Package befindet man sich im Package '''main'''<br />
* Funktionen außerhalb des gültigen Package müssen mit <package-Name>::<Funktion> angegeben werden<br />
* externe uiTable-Funktionen können per IMPORT-Befehl importiert werden<br />
}} <br />
=== Tabellendefinition im Package main ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel1 DOIF ##<br />
attr beispiel1 uiTable ## keine Package-Definition im Perlblock\<br />
\<br />
## Tabellendefinition befindet sich im Package main\<br />
\<br />
## Funktionen aus dem main-Package können unmittelbar angegeben werden\<br />
FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package angegeben werden\<br />
ui_Table::temp ([Aussensensor:tempaerature])<br />
</syntaxhighlight><br />
<br />
=== Tabellendefinition im Package ui_Table ===<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel2 DOIF ##<br />
attr beispiel2 uiTable {\<br />
package ui_Table; ## Package-Angabe im Perlblock\<br />
}\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem package angegeben werden, der Name main kann weggelassen werden\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])<br />
</syntaxhighlight><br />
<br />
=== Eigene uiTable-Funktionen im eigenen Package ===<br />
Diese Art der Definition bietet sich dann an, wenn man eine eigene uiTable-Funktion nur in einem DOIF nutzen möchte.<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel3 DOIF ##<br />
attr beispiel3 uiTable {\<br />
package $SELF;; ## Package-Name ist der Name des DOIF-Moduls, dadurch ist der Package-Name eindeutig\<br />
sub scene_day { ## eigene Funktion befindet sich im eigenen Package beispiel3\<br />
return (::FW_makeImage("scene_day"));;\<br />
}\<br />
}\<br />
## Tabellendefinition befindet sich im Package beispiel3\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne Funktionen aus dem ui_Table-Package müssen mit vorangestelltem Package ui_Table angegeben werden\<br />
ui_Table::temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden\<br />
scene_day()<br />
</syntaxhighlight><br />
<br />
=== Eigene ausgelagerte uiTable-Funktionen ===<br />
Möchte man das ui_Table-Package um eigene Funktionen erweitern, die man in verschiedenen DOIFs nutzen möchte, so sollte man diese in eine eigene Datei auslagern, die man mit dem IMPORT-Befehl vor der Definition der Tabelle importieren kann.<br />
<br />
Ausgelagerte Funktion in einer eigenen Datei z. B. my_uiTable.tpl:<br />
<br />
<syntaxhighlight lang="perl"><br />
{ ## Inhalt der Datei my_uiTable.tpl<br />
package ui_Table; ## das aktuelle Package ist ui_Table<br />
sub scene_day { ## eigene Funktion wird zum Package ui_Table hinzugefügt <br />
return (::FW_makeImage("scene_day"));<br />
}<br />
## die Datei kann alle Funktionen beinhalten, die man in diversen DOIFs nutzen möchte<br />
}<br />
</syntaxhighlight><br />
<br />
<syntaxhighlight lang="perl"><br />
defmod beispiel4 DOIF ##<br />
attr beispiel4 uiTable ##\<br />
\<br />
IMPORT ./contrib/DOIF/my_uiTable.tpl ## nach dem Import befindet man sich in Package ui_Table erweitert um eigene Funktionen\<br />
\<br />
## Tabellendefinition befindet sich im Package ui_Table\<br />
\<br />
## Funktionen aus dem main-Package müssen mit vorangestelltem Package angegeben werden (der Name main kann weggelassen werden)\<br />
::FW_makeImage("scene_day")\<br />
\<br />
## interne uiTable-Funktionen aus dem ui_Table-Package können direkt angegeben werden\<br />
temp ([Aussensensor:temperature])\<br />
\<br />
## eigene Funktionen können direkt angegeben werden, da man sich bereits im Package uiTable befinden\<br />
scene_day()\<br />
</syntaxhighlight><br />
<br />
== '''hsv'''-Funktion für Farbskalierungen==<br />
Mit Hilfe der hsv-Funktion können Texte, Werte oder Icons abhängig vom Wert eingefärbt werden. Es wird durch Vorgabe von Farbsättigung (saturation) und Helligkeit (lightness), linear ein Farbton für einen bestimmten Wert errechnet. Den Farbwert HUE (0 - 360) für den kleinsten sowie größten Wert kann man mit Hilfe eines Color-Pickers bestimmen. Der Rückgabewert ist ein Farbwert in der CSS-Notation.<br />
{{Randnotiz|RNText='''hsv-Funktion für Farbskalierungen'''<br />
<syntaxhighlight lang="perl"><br />
hsv ($value,$min_value,$max_value,$min_hue,$max_hue,$saturation,$lightness)<br />
$value # Wert, Reading<br />
$min_value # der kleinste Wert, dieser entspricht dem Farbwert $min_hue<br />
$max_value # der größte Wert, dieser entspricht dem Farbwert $max_hue<br />
$min_hue # Farbwert für den kleinsten Wert $min_value<br />
$max_hue # Farbwert für den größten Wert $max_value<br />
$saturation # Farbsättigung, default 100, optional<br />
$lightness # Farbhelligkeit, default 100, optional<br />
</syntaxhighlight><br />
Die Funktion befindet sich im ui_Table-Package<br />
}}<br />
<br />
'''<big>Beispieldefinition</big>'''<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_hsv DOIF ##<br />
attr di_uiTable_hsv uiTable {\<br />
package ui_Table;;\<br />
## eigene uiTable-Funktionen vom Typ 1 mit einem Rückgabewert als HTML-Code\<br />
\<br />
sub bat_icon { ## färbt das Icon 'measure_battery_100' abhängig vom Wert mit Hilfe der Funktion hsv \<br />
my ($value)=@_;;\<br />
return(ICON("measure_battery_100\@".hsv($value,0,100,0,120,100,100)))\<br />
}\<br />
\<br />
sub bat_icon2 {## zusätzlich zum Farbwert wird ein entsprechendes Icon bestimmt\<br />
my($val)=@_;;\<br />
my $icon;;\<br />
if ($val==0) {\<br />
$icon="measure_battery_0";;\<br />
} elsif ($val<=25) {\<br />
$icon="measure_battery_25";;\<br />
} elsif ($val<=50) {\<br />
$icon="measure_battery_50";;\<br />
} elsif ($val<=75) {\<br />
$icon="measure_battery_75";;\<br />
} else {\<br />
$icon="measure_battery_100";;\<br />
}\<br />
\<br />
my $output=ICON("$icon\@".hsv ($val,0,100,0,120,90,100));;\<br />
return($output);;\<br />
}\<br />
}\<br />
\<br />
## Tabellendefinition\<br />
\<br />
## eingefärbtes Icon 0 % entspricht rot (HSV-Wert 0), 100 % entspricht grün (HSV-Wert 120) mit Direktangabe\<br />
1|ICON("measure_battery_100\@".hsv([bat:level],0,100,0,120,100,100))\<br />
\<br />
## gleiche Funktionalität mit Hilfe der oben definierten Funktion bat_icon \<br />
2|bat_icon([bat:level])\<br />
\<br />
## Icon mit Hilfe der oben definierten Funktion bat_icon2\<br />
3|bat_icon2([bat:level])\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon\<br />
4|bat_icon(0)|bat_icon(10)|bat_icon(20)|bat_icon(30)|bat_icon(40)|bat_icon(50)|bat_icon(60)|bat_icon(70)|bat_icon(80)|bat_icon(90)|bat_icon(100)\<br />
\<br />
## Beispiel für die Farbskaliereung von 0 bis 100 % mit der obigen Funktion bat_icon2\<br />
5|bat_icon2(0)|bat_icon2(10)|bat_icon2(20)|bat_icon2(30)|bat_icon2(40)|bat_icon2(50)|bat_icon2(60)|bat_icon2(70)|bat_icon2(80)|bat_icon2(90)|bat_icon2(100)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable DOIF hsv.png|mini|ohne]]<br />
<br />
== Eine for-Schleife mit Hilfe des '''FOR'''-Befehls ==<br />
Mit Hilfe des '''FOR'''-Befehls können über eine Schleife aus einer Liste mit Elementen mehrere Tabellenzellen definiert werden. Die Elementenliste (Array) kann über eine Funktion bestimmt werden. Auf diese Weise kann z. B. eine Tabelle für mehrere Geräte einfach definiert werden.<br />
{{Randnotiz|RNText='''FOR-Befehl'''<br />
* Der FOR-Befehl entspricht einer foreach-Schleife in Perl<br />
* Syntax: '''FOR (<Array>,<Zellendefinitionen>)'''<br>'''<Array>''' eine gültige Angabe eines Arrays oder eine Perlfunktion, die ein Array liefert<br>'''<Zellendefinitionen>''' Definition einer oder mehrerer Zellen, die Angabe $_ wird durch das jeweilige Element des Arrays ersetzt<br />
*'''nützliche Links'''<br />
**{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=DOIF Aggregationsfunktionen mit Perlfunktion AggrDoIf}}<br />
**[[DevelopmentModuleAPI#devspec2array|devspec2array]]<br />
}}<br />
'''<big>Beispieldefinitionen</big>'''<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Temperaturen aller Geräte, die mit 'T' beginnen und ein Reading 'temperature' haben, sollen in einer Tabelle visualisiert werden\<br />
FOR(::AggrDoIf('@','^T_','temperature'),"$_"|temp([$_:temperature:d2]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-temperature.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Batteriestatus aller Geräte, bei denen das Wort 'Fenster' vorkommt, die das Readings 'battery' haben\ <br />
FOR(::AggrDoIf('@','Fenster','battery'),"$_"|bat([$_:battery]))<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-battery.png|200px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Anzeige des Status aller Geräte im System vom Typ 'HMS'\<br />
FOR(::devspec2array("TYPE=HMS"),"$_"|[$_])<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-HMS.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Elemente einer kommagetrennten Liste sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(split(",","Mo,Di,Mi,Do,Fr,Sa,So"),ui_Table::style("$_","Darkorange")|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-split.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## Durch Leerzeichen getrennte Zeichenketten sollen jeweils in einer Tabellenzelle in einer Tabellenzeile angezeigt werden\<br />
FOR(qw/Montag Dienstag Mittwoch Donnerstag Freitag/,"$_"|)<br />
</syntaxhighlight><br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR-qw.png|300px|ohne]]<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_for DOIF ##<br />
attr di_for uiTable \<br />
## das Templates TPL_raum, soll vier mal aufgerufen werden: TPL_raum(1), TPL_raum(2)...\<br />
## das Templates TPL_raum muss vorher definiert worden sein\<br />
FOR(1..4,TPL_raum($_))<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable-FOR TPL raum.png|600px|ohne]]<br />
<br />
== '''Anwendungsbeispiele''' ==<br />
=== '' Visualisierung und Steuerung von '''Rollläden''''' ===<br />
Im folgenden Beispiel werden Rollläden morgens hochgefahren, ebenso wird die Position aller Rollläden visualisiert. Durch Anklicken eines Icons wird der Rollladen auf die entsprechende Position bewegt. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* {{Link2CmdRef|Anker=DOIF_Zeitsteuerung_mit_Zeitintervallen|Lang=de|Label=Zeitsteuerung}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Rollladen: Visualisierung und Steuerung mit Hilfe der Funktion shutter|shutter]]<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Textformatierungen mit Hilfe der Funktion style|style]]<br />
* [[DOIF/uiTable Schnelleinstieg#uiTable-Templates|Templates]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod DI_Rollladen DOIF (([Dunkelheit] eq "off" and [06:25-09:00|8]) or [09:00|7]) \<br />
((set R_W_S,R_W_W[1-3] on)) ## Hochfahren der Rollläden im Erdgeschoss morgens\<br />
DOELSEIF ([Dunkelheit] eq "on")<br />
attr DI_Rollladen cmdState oben|unten<br />
attr DI_Rollladen devStateIcon unten:status_night oben:scene_day<br />
attr DI_Rollladen icon fts_shutter_automatic<br />
attr DI_Rollladen uiTable {\<br />
package ui_Table;;\<br />
}\<br />
\<br />
## Template für ein Fenster\<br />
DEF TPL_shutter("$1"|shutter([$1:pct]))\<br />
\<br />
## Tabellendefinition\<br />
\<br />
style("Dachgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Dachboden)\<br />
style("erstes Geschoss","Darkorange")|""\<br />
TPL_shutter(R_Bad)\<br />
TPL_shutter(R_Kinderzimmer1_O)\<br />
TPL_shutter(R_Kinderzimmer1_S)\<br />
TPL_shutter(R_Kinderzimmer2_S)\<br />
TPL_shutter(R_Kinderzimmer2_W1)\<br />
TPL_shutter(R_Kinderzimmer2_W2)\<br />
style("Erdgeschoss","Darkorange")|""\<br />
TPL_shutter(R_Kueche)\<br />
TPL_shutter(R_W_S)\<br />
TPL_shutter(R_W_W1)\<br />
TPL_shutter(R_W_W2)\<br />
TPL_shutter(R_W_W3)\<br />
style("Keller","Darkorange")|""\<br />
TPL_shutter(R_Keller)\<br />
</syntaxhighlight><br />
''Ergebnis des Anwendungsbeispiels in der Webansicht:''<br />
[[Datei:UiTable Rollladen.png|mini|ohne]]<br />
<br />
=== ''Anzahl der Tage bis zur '''Abfall-Entsorgung''''' ===<br />
Mit Hilfe des Kalender-Moduls werden die verbleibenden Tage bis zur Abfall-Entsorgung der jeweiligen Tonne berechnet und mit Hilfe von uiTable visualisiert. Wenn der Tag der Entsorgung bevorsteht, wird er farbig gekennzeichnet. Vorausgesetzt wird die Definition des Kalenders namens 'cal' mit Hilfe des Moduls [[Calendar]]. Dieser muss die Termine der Abfallentsorgung der Tonnen beinhalten. Im Beispiel wird nach Stichwörtern: "Altpapier", "Restmüll", "Bio", "Gelber" und "Grünschnitt" im Kalender gesucht. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* FHEM-Modul [[Calendar]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod Abfall DOIF subs {\<br />
sub days \<br />
{\<br />
my ($event,$reading)=@_;;\<br />
my $days=fhem('get cal events timeFormat:"%j" filter:field(summary)=~"'.$event.'" limit:count=1,from=0 format:custom="$T1"');;\<br />
my $diff;;\<br />
if (defined($days) and $days ne "") {\<br />
my $now=::strftime ('%j', localtime());;\<br />
my $year=::strftime ('%Y', localtime());;\<br />
$diff=$days-$now;;\<br />
if ($diff < 0) {\<br />
$diff+=(365+($year % 4 eq 0 and $year % 100 ne 0 or $year % 400 eq 0 ? 1: 0));;\<br />
}\<br />
} else {\<br />
$diff="N/A"\<br />
}\<br />
set_Reading($reading,$diff,1);;\<br />
}\<br />
sub update\<br />
{\<br />
days("Altpapier","altpapier");;days("Restmüll","restmuell");;days("Bio","bio");;days("Gelber","gelbe_tonne");;days("Grünschnitt","gruenschnitt");;\<br />
}\<br />
}\<br />
init{[:01];;set_Exec("Timer",200,'update()');;}\<br />
update{update()}<br />
attr Abfall uiTable {\<br />
package ui_Table;;\<br />
$TC{0..4}="align='center'";;\<br />
$SHOWNOSTATE=1;;\<br />
\<br />
sub ic\<br />
{\<br />
my ($icon,$days)=@_;;\<br />
icon_label($icon,$days,"white",$days eq "N/A" ? "blue" : $days > 1 ? "#606060" : "red")\<br />
}\<br />
}\<br />
\<br />
ic ("Abfalltonne-Recycling-Logo\@yellow",[$SELF:gelbe_tonne])|\<br />
ic ("Abfalltonne-Recycling-Logo\@blue",[$SELF:altpapier])|\<br />
ic ("Abfalltonne\@gray",[$SELF:restmuell])|\<br />
ic ("Abfalltonne-Recycling-Logo\@green",[$SELF:bio])|\<br />
ic ("Gartenabfall\@green",[$SELF:gruenschnitt])<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Anwendungsbeispiel Abfall.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''offene Fenster''''' ===<br />
Alle offenen Fenster werden aufgelistet und mit entsprechendem Icon visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Attribut {{Link2CmdRef|Anker=DOIF_DOIF_Readings|Lang=de|Label=DOIF_Readings}}<br />
* DOIF-{{Link2CmdRef|Anker=DOIF_aggregation|Lang=de|Label=Aggregationsfunktionen}}<br />
* uiTable-Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Hilfe der Funktion icon|icon]]<br />
}}<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_windows DOIF ## Visualisierung offener Fenster, Fenster-Devices enden mit "Fenster" im Namen<br />
attr di_uiTable_windows DOIF_Readings windows:[@as(<br>)"Fenster$":state:"open","keine"]<br />
attr di_uiTable_windows uiTable {package ui_Table;;}\<br />
icon([$SELF:windows],"fts_window_1w_open\@DarkOrange","fts_window_1w",".*","keine")|[$SELF:windows]<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable windows closed.png|mini|ohne]]<br />
[[Datei:UiTable windows open.png|mini|ohne]]<br />
<br />
=== ''Visualisierung: '''aktuelle Wetterlage''''' ===<br />
Regenrader animiert, aktuelle Temperatur und Feuchte vom Sensor, aktuelle Wetterlage sowie Wettervorhersage der nächsten Tage. Über entsprechende Weblinks werden Bilder aus dem WWW in der Tabelle visualisiert. Im Gegensatz zu lokalen Sensoren, muss für die Aktualisierung der WWW-Elemente in der jeweiligen Webinstanz (FHEMWEB) das refresh-Attribut gesetzt werden. <br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* DWD [https://www.dwd.de/DE/Home/home_node.html Homepage]<br />
* Regenradar [https://www.dwd.de/DE/wetter/wetterundklima_vorort/_node.html Radarfilm BRD]<br />
* aktuelles Wetter [https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/nrw_node.html NRW]<br />
* Wetteronline [https://www.wetteronline.de/wetter-widget eignes Widget]<br />
* <br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_uiTable_wetter DOIF ##<br />
attr di_uiTable_wetter uiTable {\<br />
package ui_Table;;\<br />
$TC{1}="align='center'";;\<br />
}\<br />
## das Attribut 'refresh' der Webinstanz für ein Wandtablet wurde auf 900 gesetzt, damit die Bilder alle 15 Minuten aktualisiert werden \<br />
## Tabellendefinition\<br />
\<br />
## Regenradar BRD\<br />
'<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="365px" width="365px">'|\<br />
\<br />
## Aktuelle Temperatur und Feuchtigkeit vom lokalen sensor\<br />
temp([Aussensensor:temperature],40),hum ([Aussensensor:humidity],30),\<br />
\<br />
## aktuelle Wetterlage NRW\<br />
"<img src ='https://www.dwd.de/DE/wetter/wetterundklima_vorort/nordrhein-westfalen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561200' height='255px' width='255px'>"|\<br />
\<br />
## Wettervorhersage\<br />
"<iframe marginheight='0' marginwidth='0' scrolling='no' width='300' height='365' name='FC3' style='border:1px solid;;border-color:#00537f;;' src='https://api.wetteronline.de/wetterwidget?gid=x0677&modeid=FC3&seourl=juelich&locationname=Jülich&lang=de'></iframe>"\<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable wetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Wetterstation''''' ===<br />
Die vorgestellte Lösung funktioniert ohne Anmeldung beim Wetterdienst und ohne Nutzung von API.<br />
Über den Wetterdienst: https://www.wunderground.com/ werden sehr viele private Wifi-Wetterstationen eingebunden. Das kann man sich zunutze machen, indem man zunächst in seiner Umgebung nach Wetterstationen des Dienstes sucht - oft findet man im Umkreis von wenigen Kilometern schon einige Stationen, die rege Wetterdaten liefern. Danach definiert man über HTTPMOD seine Station und visualisiert diese anschließend.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* Wunderground [https://wunderground.com/ Homepage]<br />
* svg-Funktion [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card card]<br />
* svg-Funktionen [https://wiki.fhem.de/wiki/DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen icon_ring]<br />
}}<br />
Definition einer Station in der Nachbarschaft. <StationsID> muss gegen die korrekte Stationsnummer ersetzt werden.<br />
<syntaxhighlight lang="perl"><br />
defmod Wetter HTTPMOD https://www.wunderground.com/dashboard/pws/<StationsID><br />
attr Wetter enableControlSet 1<br />
attr Wetter reading01Name Wind<br />
attr Wetter reading01Regex wu-unit .{109}>(\d+\.\d)<br />
attr Wetter reading02Name Windboeen<br />
attr Wetter reading02Regex wu-unit-speed .{109}>(\d+\.\d)<br />
attr Wetter reading03Name Windrichtung<br />
attr Wetter reading03Regex (\d+)deg\).{84}Wind-Marker<br />
attr Wetter reading04Name Regen<br />
attr Wetter reading04Regex wu-unit-rainRate .{109}>(\d+\.\d\d)<br />
attr Wetter reading05Name RegenGesamt<br />
attr Wetter reading05Regex wu-unit-rain .{109}>(\d+\.\d\d)<br />
attr Wetter reading06Name Temperatur<br />
attr Wetter reading06Regex wu-unit-temperature .{127}>(\d+.\d)<br />
attr Wetter reading07Name Feuchtigkeit<br />
attr Wetter reading07Regex wu-unit-humidity .{109}>(\d\d)<br />
attr Wetter reading08Name UV<br />
attr Wetter reading08Regex UV<.{268}>(\d)<br />
attr Wetter reading09Name Luftdruck<br />
attr Wetter reading09Regex PRESSURE<.{285}>(\d+.\d+)<br />
attr Wetter reading10Name TemperaturGefuehlt<br />
attr Wetter reading10Regex wu-unit is-degree-visible .{109}>(\d+.\d)<br />
attr Wetter reading11Name TaupunktTemp<br />
attr Wetter reading11Regex DEWPOINT.{306}>(\d+.\d)<br />
attr Wetter reading12Name Sonnenstrahlung<br />
attr Wetter reading12Regex Solar radiation<.{549}>(\d+.\d+)<br />
attr Wetter timeout 10<br />
attr Wetter userReadings WindKm {sprintf("%1.1f",ReadingsVal($name,"Wind",0)*1.60934)},\<br />
WindboeenKm {sprintf("%1.1f",ReadingsVal($name,"Windboeen",0)*1.60934)},\<br />
WindrichtungGrad {ReadingsVal($name,"Windrichtung",0)-180},\<br />
RegenMm {ReadingsVal($name,"Regen",0)*25.4},\<br />
RegenGesamtMm {ReadingsVal($name,"RegenGesamt",0)*25.4},\<br />
TemperaturC {sprintf("%1.1f",(ReadingsVal($name,"Temperatur",0)-32)*5/9)},\<br />
TaupunktTempC {sprintf("%1.1f",(ReadingsVal($name,"TaupunktTemp",0)-32)*5/9)},\<br />
LuftdruckHpa {sprintf("%d",ReadingsVal($name,"Luftdruck",0)*33.8639)},\<br />
TemperaturGefuehltC {sprintf("%1.1f",(ReadingsVal($name,"TemperaturGefuehlt",0)-32)*5/9)}<br />
</syntaxhighlight><br />
<br />
Nun erfolgt die Visualisierung der Daten.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter_ring DOIF ##<br />
attr di_Wetter_ring uiTable {package ui_Table;;}\<br />
\<br />
icon_temp_hum_ring("temp_outside",[Wetter:TemperaturC],[Wetter:Feuchtigkeit],undef,undef,150)|\<br />
icon_temp_ring ("temp_windchill",[Wetter:TemperaturGefuehltC],undef,undef,150) |\<br />
icon_temp_ring ("temperature_humidity",[Wetter:TaupunktTempC],undef,undef,150) |\<br />
icon_ring2([Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",[Wetter:WindKm],0,50,120,0,"km/h",150,undef,1,[Wetter:WindboeenKm],0,50,120,0,"km/h",undef,1) |\<br />
icon_ring2("weather_rain_gauge",[Wetter:RegenMm],0,10,180,270,"mm/h",150,undef,1,[Wetter:RegenGesamtMm],0,50,180,270,"mm",undef,1)|\<br />
icon_ring2("sani_solar",[Wetter:UV],0,10,100,30,"UV",150,undef,0,[Wetter:Sonnenstrahlung],0,1000,100,30,"Watt/m²",undef,0)|\<br />
icon_ring ("weather_barometric_pressure",[Wetter:LuftdruckHpa],980,1047,0,120,"hPa",0,150)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable ringwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Hier ein Beispiel der Visualisierung mit Verlauf der letzten drei Tage mit Hilfe der svg-Funktion '''card''':<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_Wetter DOIF ##<br />
attr di_Wetter icon weather_wind<br />
attr di_Wetter uiTable {package ui_Table;;}\<br />
## card ($collect,$header,$icon,$min,$max,$minColor,$maxColor,$unit,$func,$decfont,$size,$model,$lightness)\<br />
\<br />
card([Wetter:TemperaturC:col3d],"Außentemperatur","temp_outside",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TemperaturGefuehltC:col3d],"gefühlte Temperatur","temp_windchill",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:TaupunktTempC:col3d],"Taupunkttemperatur","temperature_humidity",-10,60,undef,undef,"°C",\&temp_hue)|\<br />
card([Wetter:Feuchtigkeit:col3d],"Außenfeuchtigkeit","temperature_humidity",0,100,undef,undef,"%",\&hum_hue)|\<br />
card([Wetter:WindKm:col3d],"Wind",[Wetter:WindKm] > 0 ? "wind".",1,0,0,".[Wetter:WindrichtungGrad]:"no_wind",0,30,90,30,"km/h",undef,1)\<br />
card([Wetter:WindboeenKm:col3d],"Windböen","weather_wind",0,30,90,30,"km/h",undef,1)|\<br />
card([Wetter:RegenMm:col3d],"Regen","weather_rain_gauge",0,10,180,270,"mm/h")|\<br />
card([Wetter:RegenGesamtMm:col3d],"Regengesamt","weather_rain_gauge",0,50,180,270,"mm")|\<br />
##card([Wetter:UV:col3d],"UV-Strahlung","sani_solar",0,7,100,30,"UV",undef,0)|\<br />
card([Wetter:Sonnenstrahlung:col3d],"Sonnenstrahlung","sani_solar",0,1000,30,90,"Watt/m²",undef,0)|\<br />
card([Wetter:LuftdruckHpa:col3d],"Luftdruck","weather_barometric_pressure",980,1047,30,90,"hPa",undef,0)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable svgwetter.png|600px|links]]<br />
<br clear="all"><br />
<br />
Ohne Angabe der Überschrift (undef für $header setzen) lässt sich eine kompaktere Darstellung erzielen:<br />
<br />
[[Datei:UiTable svgwetteroh.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''aktueller Spritpreis''''' ===<br />
Der aktuelle Spritpreis einer Tankstelle wird ermittelt und mit seinem zeitlichen Verlauf visualisiert.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Tankstelle bestimmen [https://www.clever-tanken.de/ Clever tanken]<br />
* Modul [[HTTPMOD]]<br />
}}<br />
<br />
Zunächst wird ein HTTPMOD-Modul für den aktuellen Spritpreis definiert, dabei ist <Stations-ID> durch die ID der Tankstelle zu ersetzen.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod Tankstelle HTTPMOD http://www.clever-tanken.de/tankstelle_details/<Stations-ID> 300<br />
attr Tankstelle devStateIcon {ui_Table::ring(ReadingsVal("$name","Diesel",0),1.00,1.40,120,0,"Diesel",90,undef,2)." ".ui_Table::ring(ReadingsVal("$name","SuperE5",0),1.10,1.60,120,0,"E5",90,undef,2)}<br />
attr Tankstelle enableControlSet 1<br />
attr Tankstelle event-on-change-reading .*<br />
attr Tankstelle group Spritpreise<br />
attr Tankstelle reading01Name Diesel<br />
attr Tankstelle reading01Regex "current-price-1">(\d.\d{2})<br />
attr Tankstelle reading02Name SuperE5<br />
attr Tankstelle reading02Regex "current-price-2">(\d.\d{2})<br />
attr Tankstelle room Spritpreise<br />
attr Tankstelle timeout 10<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Tankstelle.png|ohne|mini]]<br />
<br />
Visualisierung der Preisentwicklung der letzten 24 Stunden: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod sprit DOIF ##<br />
attr sprit uiTable {package ui_Table;;}\<br />
card([Tankstelle:Diesel:col24],"Diesel","fuel","1.00","1.40",120,0,"Diesel €",undef,"2",",,1")\<br />
card([Tankstelle:SuperE5:col24],"Super E5","fuel","1.10","1.60",120,0,"Super €",undef,"2",",,1")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable sprit.png|ohne|mini]]<br />
<br />
=== ''Visualisierung: '''aktuelle Corona-7-Tage-Inzidenz''''' ===<br />
Die aktuellen Inzidenzwerte werden vom RKI ausgelesen und deren Verlauf visualisiert.<br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#ring-Funktionen|ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Modul [[JsonMod]]<br />
}}<br />
<br />
Zunächst wird ein JsonMod Device für das Auslesen der Inzidenzzahlen definiert. Die gewünschten Regionen müssen für eigene Bedürfnisse angepasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod RKI7 JsonMod https://services7.arcgis.com/mOBPykOjAyBO2ZKk/arcgis/rest/services/RKI_Landkreisdaten/FeatureServer/0/query?where=1%3D1&outFields=last_update,cases7_per_100k,BEZ,BEM,GEN,BL,county&returnGeometry=false&outSR=4326&f=json<br />
attr RKI7 readingList multi(jsonPath("\$.features[?(\@.attributes.GEN in ['Städteregion Aachen', 'Düren', 'Heinsberg'])]"), property('attributes.GEN'), sprintf('%.1f', property('attributes.cases7_per_100k')));;<br />
</syntaxhighlight><br />
<br />
Visualisierung der Inzidenzzahlen der letzten sieben Tage: <br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_corona DOIF ##<br />
attr di_corona uiTable {package ui_Table}\<br />
card([RKI7:Duren:col1w],"Düren","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Heinsberg:col1w],"Heinsberg","coronavirus",0,200,120,0,"Fälle")|\<br />
card([RKI7:Stadteregion_Aachen:col1w],"Aachen","coronavirus",0,200,120,0,"Fälle")<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:uiTable_Inzidenz.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== '' Visualisierung und Steuerung: '''Heiztherme''''' ===<br />
Im folgenden Beispiel wurde eine Heiztherme über einen ebus-Adapter in FHEM eingebunden. Die Heizungsdaten werden über MQTT ausgelesen und anschließend visualisiert. Die vorgestellten Visualisierungsbeispiele können ebenso im funktionslosen DOIF mit Hilfe des uiTable-Attriutes auf bereits existierende Readings des eigenen Systems angewendet werden. <br />
<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#icon_ring-Funktionen|icon_ring]]<br />
* svg-Funktion [[DOIF/uiTable_Schnelleinstieg#Anzeige_eines_Werteverlaufs_und_des_aktuellen_Wertes_mit_Hilfe_der_SVG-Funktion_card|card]]<br />
* Commandref [https://fhem.de/commandref_DE.html#DOIF_Perl_Modus DOIF Perl-Modus]<br />
* ebus-Adapter [https://ebusd.de/ ebusd]<br />
* ebus-Wiki [[EBUS|ebus]]<br />
}}<br />
<br />
Definition eines MQTT2-Devices für die Kommunikation mit der Therme über einen ebus-Adapter.<br />
<br />
Im diesem Fall wurde eine Vaillanttherme eingebunden, die meisten Readings wurden automatisch vom MQTT2-Server angelegt. Die Anbindung ist gerätespezifisch und unterscheidet sich je nach Gerättyp.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod vaillant MQTT2_DEVICE ebusd_bai<br />
attr vaillant IODev MQTT2_FHEM_Server<br />
attr vaillant devStateStyle style="text-align:left"<br />
attr vaillant event-on-change-reading .*<br />
attr vaillant group Ebus<br />
attr vaillant icon sani_boiler_temp<br />
attr vaillant jsonMap Status01_0_value:Vorlauf Status01_0_name:0\<br />
Status01_1_value:Ruecklauf Status01_1_name:0\<br />
Status01_2_value:Aussentemp Status01_2_name:0\<br />
Status01_3_value:Warmwasser Status01_3_name:0\<br />
Status01_4_value:WWSpeicher Status01_4_name:0\<br />
Status01_5_value:Pumpenstatus Status01_5_name:0\<br />
Flame_0_value:Flame Flame_0_name:0\<br />
Storageloadpump_percent0_value:Storageloadpump\<br />
FlowTempDesired_temp_value:VorlaufSoll\<br />
Hc1HeatCurve_0_value:HeizKennlinie Hc1HeatCurve_0_name:0\<br />
HolidayEndPeriod_hto_value:FerienEnde\<br />
HolidayStartPeriod_hfrom_value:FerienBeginn\<br />
PumpPower_0_value:PumpenLeistung PumpPower_0_name:0\<br />
PrimaryCircuitFlowrate_uin100_value:Umlaufmenge\<br />
z1DayTemp_tempv_value:TagSolltemp\<br />
z1NightTemp_tempv_value:NachtSolltemp\<br />
FanSpeed_0_value:LuefterDrehzahl FanSpeed_0_name:0\<br />
WaterPressure_pressv_value:Wasserdruck\<br />
z1OpMode_opmode_value:Heizmodus<br />
attr vaillant model eBus_bai_jsonmap<br />
attr vaillant readingList ebusd/bai/PumpHours:.* { json2nameValue($EVENT, 'PumpHours_', $JSONMAP) }\<br />
ebusd/bai/WPPostrunTime:.* { json2nameValue($EVENT, 'WPPostrunTime_', $JSONMAP) }\<br />
ebusd/bai/PowerValue:.* { json2nameValue($EVENT, 'PowerValue_', $JSONMAP) }\<br />
ebusd/bai/StorageExitTemp:.* { json2nameValue($EVENT, 'StorageExitTemp_', $JSONMAP) }\<br />
ebusd/global/version:.* version\<br />
ebusd/global/running:.* running\<br />
ebusd/scan\x5c\x2e08/:.* { json2nameValue($EVENT, 'scan.08_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e08/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/global/uptime:.* uptime\<br />
ebusd/global/signal:.* signal\<br />
ebusd/scan\x5c\x2e15/:.* { json2nameValue($EVENT, 'scan.15_', $JSONMAP) }\<br />
ebusd/scan\x5c\x2e15/id:.* { json2nameValue($EVENT, 'id_', $JSONMAP) }\<br />
ebusd/bai/FanSpeed:.* { json2nameValue($EVENT, 'FanSpeed_', $JSONMAP) }\<br />
ebusd/bai/PumpPower:.* { json2nameValue($EVENT, 'PumpPower_', $JSONMAP) }\<br />
ebusd/broadcast/vdatetime:.* { json2nameValue($EVENT, 'vdatetime_', $JSONMAP) }\<br />
ebusd/broadcast/outsidetemp:.* { json2nameValue($EVENT, 'outsidetemp_', $JSONMAP) }\<br />
ebusd/bai/DateTime:.* { json2nameValue($EVENT, 'DateTime_', $JSONMAP) }\<br />
ebusd/global/updatecheck:.* updatecheck\<br />
ebusd/bai/DCFTimeDate:.* { json2nameValue($EVENT, 'DCFTimeDate_', $JSONMAP) }\<br />
ebusd/bai/PumpPowerDesired:.* { json2nameValue($EVENT, 'PumpPowerDesired_', $JSONMAP) }\<br />
ebusd/bai/HwcImpellorSwitch:.* { json2nameValue($EVENT, 'HwcImpellorSwitch_', $JSONMAP) }\<br />
ebusd/bai/ReturnTemp:.* { json2nameValue($EVENT, 'ReturnTemp_', $JSONMAP) }\<br />
ebusd/700/HwcStorageTempBottom:.* { json2nameValue($EVENT, 'HwcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HwcTempDesired:.* { json2nameValue($EVENT, 'HwcTempDesired_', $JSONMAP) }\<br />
ebusd/bai/FanPWMSum:.* { json2nameValue($EVENT, 'FanPWMSum_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HoursTillService:.* { json2nameValue($EVENT, 'HoursTillService_', $JSONMAP) }\<br />
ebusd/bai/PumpHwcFlowNumber:.* { json2nameValue($EVENT, 'PumpHwcFlowNumber_', $JSONMAP) }\<br />
ebusd/bai/WP:.* { json2nameValue($EVENT, 'WP_', $JSONMAP) }\<br />
ebusd/700/WaterPressure:.* { json2nameValue($EVENT, 'WaterPressure_', $JSONMAP) }\<br />
ebusd/bai/PrimaryCircuitFlowrate:.* { json2nameValue($EVENT, 'PrimaryCircuitFlowrate_', $JSONMAP) }\<br />
ebusd/bai/Flame:.* { json2nameValue($EVENT, 'Flame_', $JSONMAP) }\<br />
ebusd/bai/Storageloadpump:.* { json2nameValue($EVENT, 'Storageloadpump_', $JSONMAP) }\<br />
ebusd/bai/Status01:.* { json2nameValue($EVENT, 'Status01_', $JSONMAP) }\<br />
ebusd/bai/FlowTempDesired:.* { json2nameValue($EVENT, 'FlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/FrostOverRideTime:.* { json2nameValue($EVENT, 'FrostOverRideTime_', $JSONMAP) }\<br />
ebusd/700/Hc1ActualFlowTempDesired:.* { json2nameValue($EVENT, 'Hc1ActualFlowTempDesired_', $JSONMAP) }\<br />
ebusd/700/Hc1AutoOffMode:.* { json2nameValue($EVENT, 'Hc1AutoOffMode_', $JSONMAP) }\<br />
ebusd/700/Hc1CircuitType:.* { json2nameValue($EVENT, 'Hc1CircuitType_', $JSONMAP) }\<br />
ebusd/700/Hc1HeatCurve:.* { json2nameValue($EVENT, 'Hc1HeatCurve_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempBottom:.* { json2nameValue($EVENT, 'HcStorageTempBottom_', $JSONMAP) }\<br />
ebusd/700/HcStorageTempTop:.* { json2nameValue($EVENT, 'HcStorageTempTop_', $JSONMAP) }\<br />
ebusd/700/HolidayTemp:.* { json2nameValue($EVENT, 'HolidayTemp_', $JSONMAP) }\<br />
ebusd/700/OpMode:.* { json2nameValue($EVENT, 'OpMode_', $JSONMAP) }\<br />
ebusd/700/z1RoomTemp:.* { json2nameValue($EVENT, 'z1RoomTemp_', $JSONMAP) }\<br />
ebusd/700/z1SFMode:.* { json2nameValue($EVENT, 'z1SFMode_', $JSONMAP) }\<br />
ebusd/700/z1OpMode:.* { json2nameValue($EVENT, 'z1OpMode_', $JSONMAP) }\<br />
ebusd/700/Time:.* { json2nameValue($EVENT, 'Time_', $JSONMAP) }\<br />
ebusd/bai/EbusVoltage:.* { json2nameValue($EVENT, 'EbusVoltage_', $JSONMAP) }\<br />
ebusd/bai/extWP:.* { json2nameValue($EVENT, 'extWP_', $JSONMAP) }\<br />
ebusd/bai/FanStarts:.* { json2nameValue($EVENT, 'FanStarts_', $JSONMAP) }\<br />
ebusd/700/z1NightTemp:.* { json2nameValue($EVENT, 'z1NightTemp_', $JSONMAP) }\<br />
ebusd/700/z1DayTemp:.* { json2nameValue($EVENT, 'z1DayTemp_', $JSONMAP) }\<br />
ebusd/700/HolidayStartPeriod:.* { json2nameValue($EVENT, 'HolidayStartPeriod_', $JSONMAP) }\<br />
ebusd/700/HolidayEndPeriod:.* { json2nameValue($EVENT, 'HolidayEndPeriod_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Monday:.* { json2nameValue($EVENT, 'z1Timer.Monday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Tuesday:.* { json2nameValue($EVENT, 'z1Timer.Tuesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Wednesday:.* { json2nameValue($EVENT, 'z1Timer.Wednesday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Thursday:.* { json2nameValue($EVENT, 'z1Timer.Thursday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Friday:.* { json2nameValue($EVENT, 'z1Timer.Friday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Sunday:.* { json2nameValue($EVENT, 'z1Timer.Sunday_', $JSONMAP) }\<br />
ebusd/700/z1Timer.Saturday:.* { json2nameValue($EVENT, 'z1Timer.Saturday_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHc1:.* { json2nameValue($EVENT, 'PrEnergyCountHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergyCountHwc1:.* { json2nameValue($EVENT, 'PrEnergyCountHwc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHc1:.* { json2nameValue($EVENT, 'PrEnergySumHc1_', $JSONMAP) }\<br />
ebusd/bai/PrEnergySumHwc1:.* { json2nameValue($EVENT, 'PrEnergySumHwc1_', $JSONMAP) }\<br />
ebusd/bai/FanHours:.* { json2nameValue($EVENT, 'FanHours_', $JSONMAP) }\<br />
ebusd/bai/HcHours:.* { json2nameValue($EVENT, 'HcHours_', $JSONMAP) }\<br />
ebusd/bai/HwcHours:.* { json2nameValue($EVENT, 'HwcHours_', $JSONMAP) }\<br />
ebusd/bai/HcStarts:.* { json2nameValue($EVENT, 'HcStarts_', $JSONMAP) }\<br />
ebusd/bai/HwcStarts:.* { json2nameValue($EVENT, 'HwcStarts_', $JSONMAP) }<br />
attr vaillant setList HeizKennlinie:selectnumbers,0,.1,2,1,lin ebusd/700/Hc1HeatCurve/set $EVTPART1\<br />
TagSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1DayTemp/set $EVTPART1\<br />
NachtSolltemp:selectnumbers,15,1,25,1,lin ebusd/700/z1NightTemp/set $EVTPART1<br />
</syntaxhighlight><br />
<br />
Definition eines DOIF-Devices zur Steuerung der Therme und Visualisierung der Daten. Es werden Readings und Befehle genutzt, die durch den MQTT2-Server der obigen Definition zur Verfügung gestellt werden. Einzelne Heizungswerte werden in bestimmten Intervallen über den publish-Befehl ausgelesen. Die Temperaturen der Zirkulation, des Vorlaufs und des Rücklaufs werden außerhalb der Therme mit 1-wire-Temperatursensoren über WLAN-ESP-Easy ausgelesen. Die Definition des Layouts über das Attribut uiTable ist unabhängig vom Auslesen der Werte, sie bezieht sich lediglich auf vorhandene Readings, die visualisiert werden sollen. Das Layout kann ebenso auf Readings aus anderen Devices der eigenen FHEM-Umgebung anpasst werden.<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod di_vaillant DOIF ##{[+00:01];;foreach (qw(FanSpeed Flame PumpPower Storageloadpump PrimaryCircuitFlowrate FlowTempDesired PumpHours HcHours HcPumpStarts)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[+[1]:01];;foreach (qw(PrEnergySumHc1 PrEnergySumHwc1 HcHours HwcHours z1OpMode WaterPressure z1NightTemp z1DayTemp Hc1HeatCurve HwcLockTime HolidayStartPeriod HolidayEndPeriod)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
}\<br />
\<br />
{[+00:00:30];;foreach (qw(Flame PrimaryCircuitFlowrate)) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}}\<br />
\<br />
{[00:01];;foreach (qw(FanHours HcStarts HwcStarts )) {fhem_set("MQTT2_FHEM_Server publish ebusd/bai/$_/get")}\<br />
set_Reading("gesamt_hc",int([?vaillant:PrEnergySumHc1_0_value]/10000)/10,0);;\<br />
set_Reading("gesamt_hwc",int([?vaillant:PrEnergySumHwc1_0_value]/10000)/10,0);;\<br />
set_Reading("diff_hc",0,1);;\<br />
set_Reading("diff_hwc",0,1);;\<br />
set_Reading("diff_h",0,1)\<br />
}\<br />
\<br />
{if ([00:05|WE]) {fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayStartPeriod/set $mday.$month.$year");;fhem_set("MQTT2_FHEM_Server publish ebusd/700/BankHolidayEndPeriod/set $mday.$month.$year")}}\<br />
\<br />
Timer {\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Monday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Tuesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Wednesday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Thursday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Friday/set 04:00;;09:00;;13:00;;22:00;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Sunday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
fhem_set "MQTT2_FHEM_Server publish ebusd/700/z1Timer.Saturday/set 05:00;;10:00;;12:00;;22:30;;-:-;;-:-"\<br />
}\<br />
\<br />
diff {\<br />
set_Reading("diff_hc",int(([vaillant:PrEnergySumHc1_0_value]/100000-get_Reading("gesamt_hc",0))*10)/10,1);;\<br />
set_Reading("diff_hwc",int(([vaillant:PrEnergySumHwc1_0_value]/100000-get_Reading("gesamt_hwc",0))*10)/10,1);;\<br />
set_Reading("diff_h",get_Reading("diff_hc")+get_Reading("diff_hwc"),1);;\<br />
}\<br />
\<br />
<br />
attr di_vaillant event-on-change-reading .*<br />
attr di_vaillant room Ebus<br />
attr di_vaillant uiTable {\<br />
package ui_Table;;\<br />
$TABLE='text-align:center;;';;\<br />
$SHOWNODEVICELINE = "test9|Damian";;\<br />
}\<br />
icon_temp_ring("temp_outside",[vaillant:Aussentemp],-15,40,130)|\<br />
icon_temp_mring(([vaillant:Flame] eq "off"?"sani_boiler_temp\@white":"sani_boiler_temp\@Darkorange"),[vaillant:Vorlauf],15,70,130)|\<br />
icon_temp_mring(([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),[vaillant:WWSpeicher],15,70,130)|\<br />
icon_uring("0,0,1","weather_barometric_pressure",[vaillant:Wasserdruck],0,3,undef,undef,"bar",1,130,[(0.8,0,1,60,1.5,120,1.7,60,3,0)],"50,35")|\<br />
icon_ring("sani_floor_heating_neutral",[vaillant:HcHours_hoursum2_value],0,10000,120,0,"h",0,130)|\<br />
icon_ring("sani_water_tap",[vaillant:HwcHours_hoursum2_value],0,2000,120,0,"h",0,130)|\<br />
\<br />
icon_ring("time_graph",[vaillant:HeizKennlinie],0.4,1,120,0,"HK",1,130)|\<br />
icon_temp_mring("scene_day\@yellow",[vaillant:TagSolltemp],undef,undef,130)|\<br />
icon_temp_mring("scene_night\@#3464eb",[vaillant:NachtSolltemp],undef,undef,130)\<br />
""|""|""|""|""|""|widget([vaillant:HeizKennlinie],"selectnumbers,0.4,.1,1,1,lin","set")|widget([vaillant:TagSolltemp],"selectnumbers,15,1,25,1,lin","set")|widget([vaillant:NachtSolltemp],"selectnumbers,15,1,25,1,lin","set")<\<br />
\<br />
card([vaillant:Aussentemp:col],"Außentemperatur","temp_outside",-15,35,undef,undef,"°C",\&temp_hue)|\<br />
card([vaillant:WWSpeicher:col],"WW-Speicher",([vaillant:Pumpenstatus] eq "4" ? "sani_buffer_temp_down\@Darkorange" : "sani_buffer_temp_down\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Vorlauf:Temperature:col],"Vorlauf",([vaillant:Pumpenstatus] eq "on" ? "sani_floor_heating\@Darkorange" : "sani_floor_heating_neutral\@white"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hc:col],"Energie Heizung","sani_floor_heating_neutral",0,100,120,0,"kWh",undef,1)\<br />
card([vaillant:Umlaufmenge:col],"Umlaufmenge","sani_pump",0,20,120,0,"l/min")|\<br />
card([ESPEasy_ESP_Temp_Zirkulation:Temperature:col],"Zirkulation",([Zirk] eq "off"?"sani_pump\@white":"sani_pump\@Darkorange"),15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([ESPEasy_ESP_Temp_Keller_Ruecklauf:Temperature:col],"Rücklauf","sani_floor_heating_neutral\@wite",15,70,undef,undef,"°C",\&temp_hue)|\<br />
card([$SELF:diff_hwc:col],"Energie Warmwasser","sani_water_tap",0,15,120,0,"kWh",undef,1)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:Di uiTable Heizung.png|600px|links]]<br />
<br />
<br clear="all"><br />
<br />
=== ''Visualisierung: '''Anwesenheitsstatus''''' ===<br />
Die aktuelle Anwesenheit von Heimbewohnern wird visualisiert.<br><br><br />
Zunächst wird mit Hilfe des Moduls [[FRITZBOX]] ein Device namens ''FritzBox'' erstellt. Dort werden die eingebuchten Smartphones der Bewohner mit Ihren MAC-Adressen in Readings abgelegt. Die folgende Definition wertet aus, ob die angegebenen MAC-Adressen als Readings vorhanden sind und erstellt für jeden Bewohner ein Reading mit den Zuständen on/off. Diese Readings werden dann über das Attribut uiTable visualisiert. Die anwesenden Personen werden farblich markiert. Die Namen der Personen sowie die MAC-Adressen sind fiktiv und müssen den eigenen Angaben entsprechend angepasst werden.<br />
{{Randnotiz|RNText='''nützliche Links'''<br />
* [[FRITZBOX|FritzBox-Modul]]<br />
* ui_Table Funktion [[DOIF/uiTable Schnelleinstieg#Icon-Darstellung mit Text mit Hilfe der Funktion icon_label|icon_label]]<br />
*[[DOIF/uiTable Schnelleinstieg#uiTable-Templates|uiTable-Templates]]<br />
}}<br />
<br />
<syntaxhighlight lang="perl"><br />
defmod myHome DOIF {\<br />
set_Reading_Begin;;\<br />
set_Reading_Update("Ernie",[FritzBox:mac_12_34_E0_00_CD_E4] ? "on":"off");;\<br />
set_Reading_Update("Bert", [FritzBox:mac_02_08_02_07_30_E3] ? "on":"off");;\<br />
set_Reading_Update("Grobi", [FritzBox:mac_00_08_01_0B_00_E7] ? "on":"off");; \<br />
set_Reading_Update("Kermit", [FritzBox:mac_01_30_A9_72_02_E3] ? "on":"off");; \<br />
set_Reading_End(1);;\<br />
}<br />
attr myHome checkReadingEvent 0<br />
attr myHome uiTable {\<br />
package ui_Table;;\<br />
$SHOWNOSTATE=1;;\<br />
$TC{0..4}="align='center'";;\<br />
}\<br />
## Template-Definition für die Visualisierung eines Bewohners mit Hilfe des Icons fa__508\<br />
DEF TPL_person (icon_label([$SELF:$1] eq "on" ? "fa__508\@DarkOrange":"fa__508","$1","#e67e00","white",-10))\<br />
\<br />
## Darstellung der Bewohner mit Hilfe des obigen Templates\<br />
TPL_person(Ernie)|TPL_person(Bert)|TPL_person(Grobi)|TPL_person(Kermit)<br />
</syntaxhighlight><br />
<br />
''Ergebnis der Beispieldefinition in der Webansicht:''<br />
[[Datei:UiTable myHome.png|ohne|mini]]<br />
<br />
=== Weiterführende Links ===<br />
* [[DOIF/Perl-Modus]]<br />
* [[DOIF/Automatisierung]]<br />
<br />
== Weiterführende Links ==<br />
* Weitere Beispiele für Fortgeschrittene, siehe "[[DOIF/uiTable|uiTable mit FHEM-Widgets und Styles]]"<br />
<br />
[[Kategorie:FHEM Frontends]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Code Snippets]]</div>Damian-s