Ziel: Das etwas in die Jahre gekommene Plotsystem von FHEM zu modernisieren. Dabei sollen alle vorhandenen Features von 98_SVG.pm und 98_logProxy.pm erhalten bleiben und ergänzt werden.
Zum Rendern bleibe ich erst einmal bei SVG, das kann aber problemlos durch andere Renderer (z.B. eCharts) ersetzt werden.
Zunächst bezieht sich das auf die Plotdefinition. Dafür schlage ich ein YAML-Format vor, mit den folgenden Grundsätzen:
- Ein einfacher Plot soll mit möglichst wenigen Angaben auskommen.
- Datenquellen und grafische Objekte bleiben voneinander getrennt.
- Achsen und Koordinatensysteme werden bei Bedarf automatisch ergänzt.
- Komplexe Darstellungen dürfen explizit konfiguriert werden.
- Die YAML-Datei enthält keine unmittelbar auszuführenden Perl-Anweisungen.
Drei Beispiele. Im ersten Beispiel soll ein Zeitreihendiagramm mit Außen- und Innentemperatur aus verschiedenen Quellen gezeichnet werden
Zitatversion: 1
plot:
title: Temperaturen
sources:
outdoor:
type: FileLog
device: FileLog_Wetter
reading: temperature
indoor:
type: DbLog
device: Wohnzimmer
reading: temperature
axes:
x:
type: time
y:
label: Temperatur
unit: °C
objects:
- type: line
source: outdoor
label: Außentemperatur
color: "#0088cc"
- type: line
source: indoor
label: Innentemperatur
color: "#cc4400"
Im zweiten Beispiel soll ein allgemeines x-y-Diagramm gezeichnet werden, aus statisch vorgegebenen Daten. Und zwar Linie zuzüglich Punkten
Zitatversion: 1
plot:
title: Strom-Spannungs-Kennlinie
sources:
characteristic:
type: static
columns: [voltage, current]
values:
- [0.0, 0.0]
- [0.5, 0.2]
- [1.0, 0.8]
- [1.5, 1.7]
- [2.0, 3.1]
- [2.5, 4.8]
axes:
x:
type: linear
label: Spannung
unit: V
min: 0
max: 3
y:
type: linear
label: Strom
unit: A
min: 0
max: 6
objects:
- type: line
source: characteristic
x: voltage
y: current
label: Kennlinie
color: "#0066cc"
width: 2
- type: points
source: characteristic
x: voltage
y: current
symbol: circle
size: 4
color: "#0066cc"
Selbstverständlich soll es auch möglich sein, die Datenwerte aus verschiedenen Readings gegeneinander zu plotten - in einer Datenaufbereitungsroutine werden unterschiedliche Zeitstempel behandelt.
Im dritten Beispiel soll für eine Wallbox dargestellt werden:
- Ladeleistung in kW.
- Netzbezug in kW.
- Batterieladezustand in Prozent.
- Eine horizontale Leistungsgrenze.
- Eine vertikale Markierung des Ladebeginns.
- Eine farbig hinterlegte Ladephase.
Zitatversion: 1
plot:
title: Wallbox – Ladevorgang
height: 400
legend: bottom
sources:
charging:
type: FileLog
device: FileLog_Wally
reading: power
grid:
type: DbLog
device: PowerFlow
reading: grid_power
soc:
type: DbLog
device: ID7
reading: soc
axes:
time:
type: time
position: bottom
format: "%H:%M"
grid: true
power:
type: linear
position: left
label: Leistung
unit: kW
min: 0
grid: true
battery:
type: linear
position: right
label: Ladezustand
unit: "%"
min: 0
max: 100
coordinates:
charging:
x: time
y: power
battery:
x: time
y: battery
objects:
- id: charging_power
type: line
source: charging
coordinates: charging
label: Ladeleistung
color: "#0088cc"
width: 2
- id: grid_power
type: line
source: grid
coordinates: charging
label: Netzbezug
color: "#cc4400"
width: 2
- id: soc
type: line
source: soc
coordinates: battery
label: Ladezustand
color: "#008800"
width: 2
- id: power_limit
type: hline
coordinates: charging
y: 11
label: Leistungsgrenze
color: red
dash: dashed
- id: charging_start
type: vline
coordinates: charging
x: "2026-11-20T10:30:00+01:00"
label: Ladebeginn
color: green
- id: charging_period
type: region
coordinates: charging
x:
from: "2026-11-20T10:30:00+01:00"
to: "2026-11-20T12:00:00+01:00"
fill: "#ccffcc"
opacity: 0.25
Das YAML-Konfigurationsformat umfasst also folgende Bereiche
Zitatversion: 1
plot: {}
sources: {}
datasets: {}
axes: {}
coordinates: {}
viewports: {}
objects: []
layout: {}
Davon wären lediglich version und objects grundsätzlich erforderlich. Das Definitionsformat unterstützt bereits
- Zeitreihen und allgemeine X/Y-Diagramme.
- Mehrere Datenquellen.
- Beliebig viele benannte Achsen.
- Unterschiedliche Koordinatensysteme.
- Mehrere grafische Objekte aus demselben Datensatz.
- Horizontale und vertikale Referenzlinien.
- Dynamische statistische Referenzwerte.
- Datenverarbeitung und mathematische Funktionen.
- Mehrere Viewports.
- Automatisches und explizites Layout.
LG
pah