Zum Inhalt springen

FHEMWEB/Gauge: Unterschied zwischen den Versionen

Aus FHEMWiki
Schwatter (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
Schwatter (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
Zeile 11: Zeile 11:
Das '''gauge'''-Widget visualisiert einen einzelnen numerischen Wert als bogenförmiges Instrument. Die Farbe des Fortschrittsbogens passt sich dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Überschreitung einen Pulse-Effekt auslösen.
Das '''gauge'''-Widget visualisiert einen einzelnen numerischen Wert als bogenförmiges Instrument. Die Farbe des Fortschrittsbogens passt sich dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Überschreitung einen Pulse-Effekt auslösen.


=== 1️⃣ Widget-Datei aus contrib laden ===
=== 1️⃣ Widget im Device einrichten ===
<syntaxhighlight lang="Perl">
{ Svn_GetFile('contrib/fhemweb_gauge.js', 'www/pgm2/fhemweb_gauge.js') }
</syntaxhighlight>
 
=== 2️⃣ Widget im Device einrichten ===
Die Einrichtung erfolgt über das Attribut `widgetOverride`.
Die Einrichtung erfolgt über das Attribut `widgetOverride`.


:<code>attr <devicename> widgetOverride cmd<X>:gauge,<Reading>,<Einheit>,<Min>,<Max>,<Farbe/Modus>,<Skalierung></code>
:<code>attr <devicename> widgetOverride cmd<X>:gauge,<Reading>,<Einheit>,<Min>,<Max>,<Farbe/Modus>,<Skalierung></code>


=== Parameter ===
=== 2️⃣ Parameter ===
{| class="wikitable"
{| class="wikitable"
! Parameter !! Beschreibung
! Parameter !! Beschreibung
Zeile 36: Zeile 31:
|}
|}


=== Beispiel ===
=== 3️⃣ Beispiel ===
<syntaxhighlight lang="Perl">
<syntaxhighlight lang="Perl">
attr <device> widgetOverride cmd1:gauge,kWh,kWh,0,10000,hue:0:120:3000:none,1.3
attr <device> widgetOverride cmd1:gauge,kWh,kWh,0,10000,hue:0:120:3000:none,1.3
Zeile 47: Zeile 42:
Das '''multigauge'''-Widget erlaubt die Anzeige von bis zu drei Werten in konzentrischen Bögen. Jedes Reading ist individuell konfigurierbar (Einheit, Farbverlauf, Alarmgrenzen).
Das '''multigauge'''-Widget erlaubt die Anzeige von bis zu drei Werten in konzentrischen Bögen. Jedes Reading ist individuell konfigurierbar (Einheit, Farbverlauf, Alarmgrenzen).


=== 1️⃣ Widget-Datei aus contrib laden ===
=== 1️⃣ Widget im Device einrichten ===
<syntaxhighlight lang="Perl">
{ Svn_GetFile('contrib/fhemweb_multigauge.js', 'www/pgm2/fhemweb_multigauge.js') }
</syntaxhighlight>
 
=== 2️⃣ Widget im Device einrichten ===
:<code>attr <devicename> widgetOverride cmd<X>:multigauge,<Ring1>,<Ring2>,<Ring3>,<Label>,<Skalierung></code>
:<code>attr <devicename> widgetOverride cmd<X>:multigauge,<Ring1>,<Ring2>,<Ring3>,<Label>,<Skalierung></code>


=== Parameter-Syntax der Ringe ===
=== 2️⃣ Parameter-Syntax der Ringe ===
Jeder Bogen folgt dem Schema: <code>Reading:Einheit:Farbe:Min-Max-AlarmMin-AlarmMax</code>
Jeder Bogen folgt dem Schema: <code>Reading:Einheit:Farbe:Min-Max-AlarmMin-AlarmMax</code>


Zeile 63: Zeile 53:
* '''Limits''': Min-Max-AlarmMin-AlarmMax (Werte mit <code>none</code> deaktivierbar).
* '''Limits''': Min-Max-AlarmMin-AlarmMax (Werte mit <code>none</code> deaktivierbar).


=== Beispiel ===
=== 3️⃣ Beispiel ===
<syntaxhighlight lang="Perl">
<syntaxhighlight lang="Perl">
attr <device> widgetOverride cmd:multigauge,humidity:%:hue-0-240:0-100-29-61,temperature:°C:hue-240-0:0-35-none-none,ppm:ppm:hue-120-0:0-5000-none-1401,Keller,1.1
attr <device> widgetOverride cmd:multigauge,humidity:%:hue-0-240:0-100-29-61,temperature:°C:hue-240-0:0-35-none-none,ppm:ppm:hue-120-0:0-5000-none-1401,Keller,1.1

Version vom 4. Juli 2026, 22:01 Uhr

Mini
Mini

Gauge – Bogen-Widgets für Werte

Die Gauge-Widgets visualisieren einen einzelnen oder mehrere numerische Werte als bogenförmige Instrumente im FHEMWEB (PGM2) Frontend. Die Farbe der Fortschrittsbögen passt sich dabei dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Unter- oder Überschreitung einen visuellen Pulse-Effekt auslösen.

Hilfe

gauge – Bogen-Widget für Einzelwerte

Das gauge-Widget visualisiert einen einzelnen numerischen Wert als bogenförmiges Instrument. Die Farbe des Fortschrittsbogens passt sich dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Überschreitung einen Pulse-Effekt auslösen.

1️⃣ Widget im Device einrichten

Die Einrichtung erfolgt über das Attribut `widgetOverride`.

attr <devicename> widgetOverride cmd<X>:gauge,<Reading>,<Einheit>,<Min>,<Max>,<Farbe/Modus>,<Skalierung>

2️⃣ Parameter

Parameter Beschreibung
Reading Name des Readings, dessen Wert angezeigt wird.
Einheit Anzeige-Einheit (z. B. kWh, %).
Min / Max Start- und Endpunkt der Skala.
Farbe/Modus Farbwert (z.B. #ff0000) ODER Hue-Modus: hue:start:ende:alarmMin:alarmMax
Skalierung Optional: Skalierungsfaktor (Standard: 1.0).

3️⃣ Beispiel

attr <device> widgetOverride cmd1:gauge,kWh,kWh,0,10000,hue:0:120:3000:none,1.3

---

multigauge – Mehrfach-Bogen-Widget

Das multigauge-Widget erlaubt die Anzeige von bis zu drei Werten in konzentrischen Bögen. Jedes Reading ist individuell konfigurierbar (Einheit, Farbverlauf, Alarmgrenzen).

1️⃣ Widget im Device einrichten

attr <devicename> widgetOverride cmd<X>:multigauge,<Ring1>,<Ring2>,<Ring3>,<Label>,<Skalierung>

2️⃣ Parameter-Syntax der Ringe

Jeder Bogen folgt dem Schema: Reading:Einheit:Farbe:Min-Max-AlarmMin-AlarmMax

  • Reading: Name des FHEM-Readings.
  • Einheit: Text (z.B. °C, %).
  • Farbe: Hex-Code oder HUE-Bereich hue-START-ENDE (z.B. hue-240-0).
  • Limits: Min-Max-AlarmMin-AlarmMax (Werte mit none deaktivierbar).

3️⃣ Beispiel

attr <device> widgetOverride cmd:multigauge,humidity:%:hue-0-240:0-100-29-61,temperature:°C:hue-240-0:0-35-none-none,ppm:ppm:hue-120-0:0-5000-none-1401,Keller,1.1

Hinweise

  • Nicht benötigte Alarme im `multigauge` auf `none` setzen.
  • Nach dem Update der JS-Dateien bitte den Browser-Cache leeren (z.B. Strg + F5).

Links