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