Energiefluss (evcc)

PV-Erzeugung, Hausverbrauch, Netz und Hausbatterie als Energiefluss-Grafik. Die Werte kommen aus einer evcc-Instanz oder aus frei gewählten Datenpunkten — damit ist das Widget auch ohne evcc für jede PV-Anlage nutzbar. Mit evcc zusätzlich bis zu acht Ladepunkte, pro Ladepunkt Lademodus und Ziel-SoC direkt umschaltbar.

Datenquelle

Kein Haupt-Datenpunkt. Das Feld Quelle listet die erkannten Energie-Instanzen (evcc, SMA, Fronius, E3/DC, Kostal, SENEC, sonnen, Victron, Shelly …):

Auswahl	Wirkung
eine evcc-Instanz	liest alles unter dem Präfix, inklusive Ladepunkte und Tarif
eine andere Instanz	sucht deren Datenpunkte und trägt sie unten ein
evcc-Präfix von Hand	für eine umbenannte Instanz oder eine auf einem anderen Host
Manuell	Datenpunkte selbst wählen

Bei einer Nicht-evcc-Instanz wird einmalig durchsucht, was sie veröffentlicht, und der beste Treffer je Wert in die fünf Felder geschrieben. Das Panel meldet, wie viele Werte zugeordnet wurden und welche fehlen — die Felder bleiben editierbar, ein Fehlgriff ist also sichtbar und in einem Klick korrigiert. Erneut suchen wiederholt die Suche, etwa nach einem Adapter-Update.

Feld	Pflicht	Typ
evccPrefix	nein	—	evcc-Instanz, Standard evcc.0; leer = nur eigene Datenpunkte
sourceAdapter	nein	—	Instanz, aus der die Datenpunkte zugeordnet wurden
pvPowerDatapoint	nein	number	PV-Erzeugung
homePowerDatapoint	nein	number	Hausverbrauch
gridPowerDatapoint	nein	number	Netzleistung (positiv = Bezug, negativ = Einspeisung)
batterySocDatapoint	nein	—	Batterie-Ladestand (Prozent oder JSON {soc,power})
batteryPowerDatapoint	nein	number	Batterie-Leistung (negativ = laden)

Die Einheit der Leistungs-Datenpunkte wird aus common.unit gelesen: W, kW und mW werden umgerechnet, alles andere unverändert übernommen. Ein Wechselrichter, der in kW meldet, braucht also keine Einstellung.

Ohne eigenen Datenpunkt wird die Netzleistung automatisch aus der ersten passenden evcc-Quelle gelesen: status.gridPower · status.grid (JSON) · status.Grid.power (evcc-Adapter ≤ 0.2.8) · status.Grid.Power (evcc-Adapter ≥ 0.2.9).

Die Ladepunkte gibt es nur mit evcc — sie liegen unter loadpoint.N.*, Pfade, die kein anderer Adapter hat.

Lademodus

evcc	Knöpfe
bis 0.315	AUS · PV · MIN+PV · SOFORT
ab 0.316	AUS · SMART · SOFORT · ♾ (Immer laden)

Erkannt wird die Version an status.mode = smart bzw. am Datenpunkt status.alwaysCharge. Geschrieben wird immer control.pvControl: ♾ an = 2 (minpv), aus = 1 (pv) — beides schaltet auf Smart. Bei Heizstäben/Wärmepumpen (chargerFeatureHeating) fehlt ♾.

Layouts

Default

Energiefluss-Zeile (Sonne · Haus · Netz, darunter Batterie) plus Ladepunkt-Karten und Tarif-Zeile.

Card

Wie Default — gleicher Aufbau mit Energiefluss-Zeile und Ladepunkten.

Flow

Animiertes Energiefluss-Diagramm als SVG mit Sonne, Netz, Haus, Batterie und Ladepunkten.

Loadpoints

Nur die ausführlichen Ladepunkt-Karten, scrollbar.

Compact

Eine kompakte Werte-Zeile (Sonne · Haus · Netz · Batterie) plus schmale Ladepunkt-Zeilen.

Battery

Nur die Hausbatterie als großer Ladebalken mit SoC und Lade-/Entladeleistung.

Production

Nur die PV-Erzeugung groß, mit Einspeisung und Eigenanteil.

Consumption

Nur der Hausverbrauch groß, mit Netzbezug/-einspeisung und Tarif.

Custom

Felder pvPower, gridPower, homePower, batterySoc, batteryPower, gridImport, gridExport frei in einer Zellenmatrix platzieren — siehe Custom-Layout. Startet auf Wunsch aus dem bisherigen Layout (Aus Layout übernehmen); dafür die Komponenten header, flow-row, flow-diagram, compact-row, battery-view · production-view · consumption-view, loadpoints, loadpoints-compact und tariff — sie skalieren wie im Layout.

Einstellungen

Alle Optionen werden im Editor unter Widget bearbeiten gesetzt.

Quelle & Umfang

Option	Standard
evccPrefix	evcc.0	Adapter-Instanz
loadpointCount	1	Anzahl Ladepunkte (1–8)
showLoadpoints	true	Ladepunkte anzeigen
visibleLoadpoints	[]	angezeigte Ladepunkte (leer = alle)
showBattery	true	Hausbatterie anzeigen
batterySocDatapoint	—	eigener SoC-Datenpunkt
batteryPowerDatapoint	—	eigener Leistungs-Datenpunkt
gridPowerDatapoint	—	eigener Netzleistungs-Datenpunkt

Anzeige

Option	Standard
showTitle	true	Titel anzeigen
showIcon	true	Icon anzeigen
icon	Zap	Lucide-Icon
iconSize	20	px
titleAlign	left	left · center · right

Größe & Skalierung

Bei 1 entspricht die Darstellung der übrigen Widgets (12 px Titel, 20 px Icon). autoScale verkleinert nur — sobald das Widget schmaler als 280 px ist. Größer wird es über die Regler oder ein angehobenes autoScaleMax.

Option	Standard
autoScale	true	bei schmalem Widget verkleinern
autoScaleMin	0.6	untere Skalierungsgrenze
autoScaleMax	1	obere Skalierungsgrenze
sizeScale	1	globale Skalierung
headerScale	1	Kopfzeile
flowScale	1	Energiefluss
loadpointScale	1	Ladepunkte
mainScale	1	Haupt-Bereich (Akku/Erzeugung/Verbrauch/Kompakt)
tariffScale	1	Tarif-Zeile