FHEMWEB/Gauge

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.

---

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-Datei aus contrib laden

{ Svn_GetFile('contrib/fhemweb_gauge.js', 'www/pgm2/fhemweb_gauge.js') }

2️⃣ Widget im Device einrichten

Die Einrichtung erfolgt über das Attribut `widgetOverride`.

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

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

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-Datei aus contrib laden

{ Svn_GetFile('contrib/fhemweb_multigauge.js', 'www/pgm2/fhemweb_multigauge.js') }

2️⃣ Widget im Device einrichten

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

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

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

Widget-Übersicht