Glossar
eedc Glossar & Support
Abschnitt betitelt „eedc Glossar & Support“Dieses Glossar ist Teil der eedc-Dokumentation. Siehe auch: Teil I: Installation | Teil II: Bedienung | Teil III: Einstellungen | Berechnungen | Prognosen | Wärme & Klima | Sensor-Referenz
Glossar
Abschnitt betitelt „Glossar“Energie & Bilanzen
Abschnitt betitelt „Energie & Bilanzen“| Begriff | Bedeutung |
|---|---|
| Autarkie | Grad der Unabhängigkeit vom Stromnetz: Eigenverbrauch / Gesamtverbrauch × 100 % |
| Eigenverbrauch | Selbst genutzter PV-Strom: Eigenverbrauch = Direktverbrauch + Speicher-Entladung (+ V2H) − Abgabe an Dritte. Steht in allen Bilanzen (Live, Tag, Monat, Jahr). Kann rechnerisch > 100 % der Tages-PV liegen, wenn Batterie-Entladung aus Vortagen einfließt — im Live-Dashboard auf 100 % gecappt. |
| Direktverbrauch | Sofort verbrauchter PV-Strom ohne Umweg über den Speicher |
| Einspeisung | Ins Netz abgegebener PV-Überschuss |
| Netzbezug | Aus dem Netz bezogener Strom |
| EV-Quote | Eigenverbrauchsquote = Eigenverbrauch / PV-Erzeugung × 100 % |
| Erzeugung hinter dem Zähler | Summe aller lokalen Erzeuger am EINEN Netzanschluss (PV + Balkonkraftwerk + sonstige Erzeuger wie BHKW). Sie geht in Eigenverbrauch/Autarkie ein, nicht nur die PV-Erzeugung. |
| Gesamtverbrauch | Was das Haus insgesamt verbraucht hat: Gesamtverbrauch = Eigenverbrauch + Netzbezug. Steht in der Live-Kachel „Gesamtverbrauch“, in der Stundentabelle von Cockpit → Tag und in den Bilanzen von Tag, Monat und Jahr. eedc bilanziert den Wert aus deinen Zähler- und Komponentenwerten, es gibt keinen eigenen Hausverbrauchs-Sensor. Messen Wechselrichter PV und Speicher DC-seitig, das Netz aber AC-seitig (z. B. E3DC), enthält der Gesamtverbrauch die Wandlungsverluste und liegt ~3–5 % der Erzeugung über dem „Hausverbrauch” im Herstellerportal — beide Werte sind richtig, sie beantworten verschiedene Fragen (siehe Berechnungsreferenz 3.1). Ersparnis, USt und CO₂ rechnen dagegen ohne die Wandlungsverluste, wo eedc sie kennt (siehe Wandlungsverluste). |
| Restverbrauch | Der Teil des Gesamtverbrauchs, den kein einzeln erfasstes Gerät erklärt: Restverbrauch = Gesamtverbrauch − separat erfasste Verbraucher (Wärmepumpe, Wallbox/E-Auto, sonstige Verbraucher mit eigenem Zähler). Er enthält alles, was nicht einzeln gemessen wird — Licht, Küche, Geräte. Steht in Cockpit → Live (Mitte des Energieflusses, Tagesverlauf, Verbrauchsprofil), in Cockpit → Tag (Stundentabelle, Stundenverlauf) und in der Monatsauswertung „Verbrauch nach Kategorie“. Je Monat oder Jahr als eigene Kachel gibt es ihn nicht. Bis Oktober 2026 hieß er „Haushalt“ bzw. in der Tagessicht „Hausverbrauch“. |
| Hausverbrauch (Herstellerbegriff) | Benutzt eedc nicht als eigene Größe, weil Wechselrichter und Smart Meter ihn verschieden definieren (mit oder ohne Wandlungsverluste, Wärmepumpe, Wallbox). eedc nennt stattdessen Gesamtverbrauch oder Restverbrauch, je mit Formel. Warum eedc keinen Hausverbrauchs-Sensor des Herstellers übernimmt: Berechnungsreferenz 3.1. |
| Wandlungsverluste | Was im Wechselrichter verloren geht: Summe der String-Zähler (DC, vor dem Wechselrichter) − Anlagenzähler (AC, dahinter), wenn positiv. eedc zeigt sie, wenn beide Seiten zugeordnet sind (Cockpit → Monat/Jahr unter „PV-Erzeugung“, Komponenten → PV-Anlage → Verlauf). Die Bilanz trägt sie (Eigenverbrauch, Autarkie, Eigenverbrauchsquote: „was musste die Anlage liefern“); Ersparnis, USt auf den Eigenverbrauch und CO₂ rechnen ohne sie — eine verlorene Kilowattstunde hättest du nie gekauft. Abgezogen wird nur, was eedc sicher als Wechselrichterverlust weiß (kein DC-gekoppelter Speicher, höchstens 10 % Differenz, Balkonkraftwerk im Anlagenzähler mitgemessen); sonst nennt der Hinweis den Grund und der Daten-Checker (Kategorie „PV – Messpunkt“) den Handgriff. Siehe Berechnungsreferenz §1. |
| PV-Anlage | Im Produkt immer die ganze Anlage: Wechselrichter, Module, Speicher und Balkonkraftwerk. So heißt auch der Komponenten-Hub. |
| PV-Module | Nur die Dach-/Fassaden-/Freiflächen-Module — ohne Balkonkraftwerk und ohne sonstige Erzeuger. Der Verlaufs-Wert dazu hieß bis v4.0.0 intern „PV-Anlage” und meinte damit das Gegenteil des Produktbegriffs; er heißt jetzt „PV-Module”. |
pv_erzeugung_kwh — ein Name, drei Bedeutungen | Je nachdem, wo der Begriff steht: (1) Monats-Gesamtwert der Anlage, manuell erfasst oder importiert — er steht für alle PV-Quellen (Module und Balkonkraftwerke); was die Quellen mit eigenem Wert nicht erklären, verteilt eedc nach kWp auf die Quellen ohne eigenen Wert — Strings und, wenn der Gesamtwert gespeichert ist, auch ein Balkonkraftwerk ohne eigenen Wert; (2) Erzeugung eines einzelnen Moduls in dessen Monatsdaten; (3) Auswertungs-Feld = PV-Module + Balkonkraftwerk. Der Name bleibt bewusst unverändert, weil er zugleich MQTT-Topic, CSV-Spalte und Backup-Feld ist. Siehe Berechnungen §1. |
| kWp | Kilowatt Peak — Nennleistung der PV-Anlage unter Standardtestbedingungen |
| kWh | Kilowattstunde — Energiemenge |
| Spezifischer Ertrag | kWh je kWp Nennleistung — die Vergleichsgröße zwischen Anlagen. eedc führt sie in zwei Ausprägungen: annualisiert (saisonal gewichtet, mit der im jeweiligen Monat installierten Leistung — in Cockpit, HA-Sensor und Community-Vergleich; über verschieden lange Zeiträume vergleichbar) und Zeitraum (Erzeugung des Berichtszeitraums ÷ Nennleistung, ohne Normierung — im PDF-Jahresbericht, dort als „Spez. Ertrag (Zeitraum)” beschriftet). Über mehrere Jahre summiert sich die Zeitraum-Größe auf; beide sind richtig, sie beantworten verschiedene Fragen. |
| Amortisation | Die Dauer bis zur Rückzahlung: Kapitaleinsatz ÷ Jahres-Ersparnis, in Auswertungen → ROI mit den tatsächlich erfassten Erträgen gerechnet und mit dem voraussichtlichen Break-Even-Jahr daneben (Anker = frühestes Anschaffungsjahr). Sie ist keine Messung, sondern eine Rechnung mit einer Annahme über die Zukunft — eedc unterstellt, dass keine weitere Instandhaltung anfällt, und schreibt diese Annahme neben jede Dauer. Wer an einer Komponente Kosten/Jahr pflegt, sieht sie dort als „inkl. … €/Jahr Betriebskosten” mitgenannt. PDF-Finanzbericht, Oberfläche und HA-Sensor amortisation_jahre nennen dieselbe Größe — bis August 2026 rechnete das PDF stattdessen Gesamtkosten ÷ eines Prognosefeldes, das sich nirgends pflegen ließ, und zeigte deshalb dauerhaft „—”. |
| Kapitaleinsatz | Der Betrag, der sich zurückverdienen muss — der Nenner jeder Amortisations- und ROI-Rechnung. Er besteht aus den relevanten Anschaffungskosten plus den einmaligen Ausgaben aus dem Monatsabschluss (Reparatur, Ersatzteil) minus den einmaligen Erträgen (Förderung, THG-Quote): Geld, das nie ausgegeben wurde, muss nicht zurückkommen. Positionen, die zur ganzen Anlage gebucht sind, wirken auf die Gesamtzahl, nicht auf eine einzelne Zeile. Alle vier Sichten teilen ihn — Auswertungen → ROI, Aussichten, PDF-Finanzbericht und HA-Sensoren. |
| Amortisations-Fortschritt | Die Messung neben der Dauer: „wie viel des Kapitaleinsatzes ist bereits zurückgeflossen?” in Prozent — ohne jede Annahme über die Zukunft, deshalb auch nicht zu optimistisch. Steht als Kachel und je Zeile in Auswertungen → ROI. Ein „—” heißt „dieser Komponente nicht zurechenbar” (z. B. eine anlagenweit gebuchte Förderung), nicht „null Euro”; negative Werte werden nicht auf 0 geschönt. |
Strahlung & Wetter
Abschnitt betitelt „Strahlung & Wetter“| Begriff | Bedeutung |
|---|---|
| GHI | Global Horizontal Irradiance — Globalstrahlung auf horizontaler Fläche (W/m²). In Open-Meteo das Feld shortwave_radiation. |
| GTI | Global Tilted Irradiance — auf die Modul-Fläche projizierte Globalstrahlung (mit Tilt + Azimut). Bei steilen Modulen und tiefstehender Wintersonne 2–3× höher als GHI. eedc nutzt GTI seit v3.20.0 für PV-Prognose und Performance Ratio. |
| TMY | Typical Meteorological Year — statistisches Durchschnittswetterjahr als Prognosebasis |
| Wettermodell-Kaskade | Bei spezifischer Modellauswahl versucht eedc zuerst das gewählte Modell und fällt bei fehlenden Daten auf den besten verfügbaren Anbieter zurück. Datenquelle pro Tag wird mit Kürzel angezeigt (MS/D2/EU/EC/BM). Wahl unter Einstellungen → Stammdaten → Anlage. |
| Solar Noon | Astronomische Tagesmitte — Zeitpunkt des höchsten Sonnenstands. Weicht je nach Standort und Datum bis ~30 min von 12:00 Clockzeit ab. eedc splittet VM/NM-Tageshälften daran. |
| Heizgradtage (Kd) | Maß für den Wetterbedarf eines Zeitraums: je Tag max(0; 15 °C − Tagesmittel der Außentemperatur), über die Tage summiert. 15 °C ist die Heizgrenze (Gradtag-Konvention) — nicht die Innenraum-Temperatur. eedc nutzt sie an zwei Stellen: für die Temperaturkorrektur der Verbrauchsprognose und für den wetternormierten Vergleich im Komponenten-Hub (Wärme & Klima → Vergleich). |
Prognosen & Genauigkeit
Abschnitt betitelt „Prognosen & Genauigkeit“| Begriff | Bedeutung |
|---|---|
| PVGIS | Photovoltaic Geographical Information System — EU-Dienst für standortbezogene PV-Ertragsprognosen (Langfrist-/Jahressicht) |
| Open-Meteo | Offene Wetter-API mit globaler Abdeckung. Liefert GHI, GTI, Temperatur, Cloud Cover für Live + Kurzfrist-Prognose. |
| Solcast | Kommerzielle PV-Prognose-Quelle. eedc unterstützt sowohl Solcast-API (Free/Paid Key) als auch HA-Integration (BJReplay). 30-Min-Buckets, p10/p50/p90-Konfidenzbänder. |
| SFML | Solar Forecast ML — KI-basierte Ertragsprognose eines externen Dienstes (HA-Integration von Tom-HA). In eedc als operative Prognosequelle wählbar, sobald Home Assistant verbunden ist (Add-on oder Token-Anbindung). Ist sie gewählt, erscheint SFML im Prognosen-Vergleich als Wert — aber bewusst ohne Abweichungs-Spalte und gar nicht im Genauigkeits-Tracking. Siehe Prognosen §2.5. |
| Lernfaktor | Anlagenspezifischer Korrekturfaktor IST / OpenMeteo-Roh-Prognose. Er ist die gröbste Stufe der Korrektur-Kaskade; feiner korrigiert eedc pro Sonnenstand × Wetterklasse und pro Stunden-Slot (siehe Korrekturprofil). |
| Aktive PVGIS-Prognose | Von beliebig vielen gespeicherten PVGIS-Abrufen ist genau einer aktiv — er liefert die SOLL-Werte in allen Sichten und Berichten. Die Wahl trifft der Anwender (Einstellungen → Solarprognose); eine bewusst aktivierte ältere Prognose gilt überall. Seit v4.0.1 datenbankseitig auf „genau eine” begrenzt; Bestände mit mehreren aktiven werden beim Start einmalig bereinigt (deaktiviert, nicht gelöscht). Siehe Prognosen §2.6. |
| Korrekturprofil | Mehrdimensionale Weiterentwicklung des Lernfaktors: pro Sonnenstand × Wetterklasse ein eigener Faktor — korrigiert den Tagesgang, nicht nur die Tagessumme. Siehe Prognosen §5.3. |
| Prognose-Kanon | EIN kanonischer Rechenweg (services/prognose_kanon.py) für die „PV-Tagesprognose heute” (+ Rest, morgen/übermorgen, VM/NM, Stundenprofil). Liefert allen Sichten denselben Wert — Cockpit/Live, Aussicht, Auswertungen, Vergleich-„eedc”-Spalte, persistierter Tageswert und MQTT-Sensoren. Multi-String-Fan-out pro Orientierung + Korrektur pro Energie-Slot; rollt synchron mit OpenMeteo. |
Tracking-Endwert (pv_prognose_final_kwh) | Der für das Genauigkeits-Ranking eingefrorene Tagesprognose-Wert: rollt mit, bis OpenMeteo nach Sonnenuntergang konvergiert ist, dann fix (pv_prognose_final_at). Trennt den rollenden Anzeige-Wert vom fertigen Vergleichswert. |
| MOS-Kaskade | Saisonale Lernfaktor-Berechnung: Monatsfaktor (≥ 15 Tage gleicher Kalendermonat) → Quartalsfaktor (≥ 15 Tage) → 30-Tage-Fenster (≥ 7 Tage). Aktive Stufe wird oberhalb der Genauigkeits-Card angezeigt. |
| MAE | Mean Absolute Error — `Ø |
| MBE / Bias | Mean Bias Error — Ø err_rel (mit Vorzeichen). Positiv = Prognose im Mittel zu hoch, negativ = im Mittel zu niedrig. Neutral gefärbt — Vorzeichen ist Information, keine Wertung. |
| Asymmetrie | Aufteilung der signed errors in „darüber” (err_rel > 0) und „darunter” (err_rel ≤ 0). Macht sichtbar, ob eine Quelle einseitig daneben liegt — relevant, weil ein einziger Lernfaktor nur symmetrische Fehler glattziehen kann. |
| Backward-Slot | Slot N enthält die Energie aus dem Intervall [N-1, N) — „die letzte Stunde”. Industriestandard für Energiezähler (HA Energy Dashboard, SolarEdge, SMA, Fronius, Tibber). eedc migriert in v3.20.0 alle Energie-Quellen auf Backward; Strompreis bleibt Forward ([N, N+1), „gilt ab jetzt”). |
| Day-Ahead | Erste Prognose des Tages, die nicht mehr überschrieben wird. eedc speichert seit v3.23.4 das Day-Ahead-Stundenprofil (OpenMeteo + Solcast) intern für künftige Diagnostik. |
Komponenten & Effizienz
Abschnitt betitelt „Komponenten & Effizienz“| Begriff | Bedeutung |
|---|---|
| Komponente | Ein erfasstes Gerät der Anlage (PV-Modul, Wechselrichter, Speicher, Wärmepumpe, E-Auto, Wallbox, Balkonkraftwerk, Sonstiges). In der v4-Oberfläche der durchgängige Begriff für das, was im Datenmodell Investition heißt: Angelegt/konfiguriert unter Einstellungen → Komponenten, ausgewertet in der Komponenten-Achse. (ehemals als „Investitionen-Tab” bezeichnet.) |
| Investition | Datenmodell-Begriff für eine Komponente (Kosten, Parameter, Monatsdaten). In Berechnungen und Sensor-Namen weiterhin so benannt; in der Oberfläche „Komponente”. |
| COP | Coefficient of Performance — momentane Effizienz der Wärmepumpe (Wärme / Strom). In eedc reserviert für mathematisch-technische Berechnungs-Variablen. |
| SCOP | Seasonal COP — saisonale Effizienz vom EU-Energielabel, standortunabhängig |
| JAZ | Jahresarbeitszahl — gemessene Effizienz der Wärmepumpe am eigenen Standort über ein Jahr. eedc zeigt Periodenkennzahlen (Cockpit, Auswertungen, Monatsdaten) seit v3.23.4 konsistent als JAZ, nicht COP. |
| Arbeitszahl Kühlen | Kältemenge ÷ Kühlstrom über einen Zeitraum — die Entsprechung der JAZ für den Kühlbetrieb (seit v4.0.29). Setzt beides voraus: einen Zähler für den Kühlstrom und einen Kältemengenzähler (betriebsart_nutzenergie_kuehlen_kwh). Fehlt einer, steht der Grund statt einer Zahl — geschätzt wird nichts. Bewusst nicht „SEER” genannt: SEER ist eine genormte Prüfstandsgröße, diese Zahl ist der Quotient zweier Zähler in deinem Haus. Siehe Wärme & Klima. |
| Fremdanteil auf den Zählern | Anwender-Angabe am Wärmepumpen-Gerät für zwei Lagen, die eedc nicht messen kann: Der Heizstab hängt am Stromzähler, seine Wärme aber nicht am Wärmemengenzähler (Strom zu groß) — oder ein zweiter Erzeuger speist denselben Heizkreis, den der Wärmemengenzähler misst, während sein Strom getrennt gezählt wird (Wärme zu groß) — ein Gas-/Ölkessel, oder ein elektrischer Heizstab. Welche Lage vorliegt, entscheiden die Zähler, nicht das Gerät. Ändert keine Menge: eedc lässt nur die Arbeitszahl weg und nennt den Grund. |
| Modus erfasst | Wie viele Stunden eines Zeitraums eedc den Betriebsmodus tatsächlich mitgelesen hat — die Zeitbasis der abgeleiteten Betriebsart-Aufteilung. Über Tage wird summiert, über Geräte nicht: Zwei Geräte, die dieselben 18 Stunden liefen, ergeben 18 Stunden Beobachtung, nicht 36 (Korrektur v4.0.29). Bei gemessenen Betriebsart-Zählern steht dort „Herkunft: gemessen” — ein Zähler zählt kWh, keine Stunden mit Signal. |
| Aufgeteilte Menge | Die Grundmenge, auf die sich der Betriebsart-Balken bezieht: der Strom nur der Geräte und Zeiträume mit Aufteilung. Sie kann kleiner sein als die Kachel „Strom verbraucht” darüber, die alle Geräte zählt — deshalb wird sie seit v4.0.29 benannt, sobald beide auseinandergehen. |
| Kompressor-Starts | Wie oft der WP-Kompressor anläuft (optionaler Total-Increasing-Zähler pro Wärmepumpe). Verschleiß-Indikator: viele Starts = häufiges Takten, mechanisch belastend. Allein wenig aussagekräftig — erst im Verhältnis zu den Betriebsstunden (siehe dort). |
| Betriebsstunden | Wie lange die Wärmepumpe tatsächlich läuft (optionaler Total-Increasing-Zähler pro WP, Stunden). Auslegungs-Indikator: 10 Starts bei 23 h Laufzeit/Tag sind harmloser als 10 Starts bei nur 4 h. Erst Starts ÷ Betriebsstunden („Takte pro Stunde”) bzw. Betriebsstunden ÷ Starts („Ø Laufzeit pro Start”) zeigen, ob die Heizkurve/Hysterese passt. Sichtbar in der Wärmepumpe-Komponentensicht, den Auswertungen und im PDF-Jahresbericht (#238). |
| Vollzyklen | Batterie-Lade-/Entladezyklen, normiert: `Σ |
| Performance Ratio | Verhältnis IST-Ertrag zu theoretisch möglichem Ertrag (PV_kWh / (GTI × kWp)). Qualitätskennzahl der Anlage. Plausible Werte 0.7–0.95. |
| V2H | Vehicle-to-Home — E-Auto speist Strom ins Haus zurück |
| Heimladung | Zu Hause geladene Energie eines E-Autos (gesamt / aus PV / aus Netz), im Gegensatz zur externen Ladung unterwegs. Die Wallbox misst die Summe aller Ladungen an ihr; ein Auto mit eigener Messung („Heim: PV/Netz/gesamt”) trägt diese, der Rest der Wallbox geht nach Kilometern an die privaten Autos ohne eigene Messung. Ohne Wallbox (Steckerlader/Schuko) nur am E-Auto. In Cockpit und Ersparnis zählt die private Heimladung (ohne Gast-Rest und gemessenen Dienstwagen). |
| Kanonische Quelle | Die eine, strukturell festgelegte Investition, aus der eedc einen Wert liest, wenn ihn mehrere Komponenten messen könnten. Für die Heimladung gibt es keine einzelne Quelle, sondern eine feste Regel je Auto: eigene Messung am Auto, sonst Anteil am Rest der Wallbox (s. Heimladung). Die Regel ersetzt das frühere magnitudenabhängige „Poolen” (größerer Wert gewinnt), das bei Streudaten falsch wählen konnte. |
| Arbitrage | Speicher-Strategie: Bei günstigem Netzstrom laden, bei teurem Strom entladen |
| BKW | Balkonkraftwerk — kleine steckfertige PV-Anlage (auch: Steckersolaranlage) |
| Anschaffungsdatum / Stilllegungsdatum | Lebenszyklus-Marker pro Komponente. Aggregate ignorieren Monatsdaten vor dem Anschaffungsdatum bzw. ab dem Stilllegungsdatum — verhindert Verfälschung bei Erfassungs-Migration oder ausgemusterten Komponenten. Das Anschaffungsdatum ist ab v4.0.1 Pflicht: es ist die Grenze jeder Auswertung und der Nullpunkt der Amortisationskurve; für Bestandskomponenten ohne Datum meldet es der Daten-Checker als Fehler. Gepflegt unter Einstellungen → Komponenten. |
Strompreise & Tarife
Abschnitt betitelt „Strompreise & Tarife“| Begriff | Bedeutung |
|---|---|
| EPEX | European Power Exchange — Strombörse, Quelle für Day-Ahead-Spotpreise. eedc lädt EPEX-Börsenpreise (DE/AT) automatisch via aWATTar API als Tagesverlauf-Overlay. |
| Dynamischer Strompreis | Datenquellen-Feld für Tibber, aWATTar, EPEX oder eigene Template-Sensoren. Akzeptiert ct/kWh, EUR/kWh, EUR/MWh (×0.1), Cent, €. Zuordnung unter Einstellungen → Datenquellen (Feld „Strompreis”). |
| §51 EEG (Negativpreis-Regel) | Seit 2023: Ab 4 Stunden negativer Day-Ahead-Strompreise entfällt für neue PV-Anlagen die Einspeisevergütung in dieser Stunde. eedc trackt pro Tag Anzahl negativer Stunden + Einspeisung bei Negativpreis (sichtbar in Cockpit → Monat). |
| Spezialtarif | Tarif mit Zuordnung zu Standard / Wärmepumpe / Wallbox. Ohne Spezialtarif fällt eedc auf den allgemeinen Tarif zurück. |
| Netto-Ertrag (PV) | Was die PV-Anlage einbringt: Einspeiseerlös + Eigenverbrauchs-Ersparnis + gepflegter Erlös eines Geräts mit eigenem Vergütungssatz (Abgabe an Dritte, sonstiger Erzeuger) (+ Sonstige Erträge − Sonderkosten), bei Regelbesteuerung abzüglich der USt auf den Eigenverbrauch. Ohne Netzbezug-Kosten — die fielen auch ohne PV an — und ohne Wärmepumpen-/E-Mobilitäts-Ersparnis. Ein Erzeuger unter „Sonstiges” (BHKW, Windrad, Wasserkraft) zählt hier mit — er speist hinter denselben Hauszähler, und was er einspeist oder an Netzbezug ersetzt, steckt in Erlös und Ersparnis. Bewertet wird dabei das Gerät nicht: es hat keine eigene Ertrags-Zeile und keine Wirtschaftlichkeit, sein Ertrag wird am Gerät als „Ertrag/Jahr” gepflegt. Kennzahl im Block „Finanz-Übersicht” (Auswertungen → Finanzen). Gilt für Monat, Jahr und Gesamt gleich (seit 03.10.2026 auch in Cockpit → Monat und Jahr) — Stufe 1 der Ergebnis-Leiter. Siehe Berechnungen §3.2. |
| Monatsergebnis / Jahresergebnis | Was am Ende des Monats bzw. Jahres übrig bleibt: Netto-Ertrag (PV) + Wärmepumpen- + E-Mobilitäts-Ersparnis − Stromrechnung (inkl. Grundgebühr) − Betriebskosten der im Zeitraum aktiven Komponenten. Fehlt die Stromrechnung eines Monats, gibt es kein Ergebnis („—” mit Grund) — im Monat, im Vorjahresvergleich und im Jahr. Der Tooltip nennt jeden Summanden einzeln. Siehe Berechnungen §3.2. |
| Gewinn / Verlust (Haushalt) | Ergebniszeile des SOLL/HABEN-T-Kontos: HABEN − SOLL — das Monats- bzw. Jahresergebnis in Kontenform: dieselben Posten (Einspeiseerlös, Ersparnisse, Sonstige Erträge gegen Stromrechnung, Betriebskosten, Sonstige Ausgaben und bei Regelbesteuerung die USt auf den Eigenverbrauch), auf SOLL und HABEN verteilt. |
| Grundgebühr / Zählergebühr | Feste monatliche bzw. jährliche Tarif-Bestandteile. Die Grundgebühr ist in den Netzbezugskosten enthalten; die Zählergebühr (optionales Tarif-Feld ab v4.0) wird getrennt ausgewiesen, aber nicht in Kosten/Netto verrechnet. |
| Kraftstoffpreis | Monatlicher Benzin-/Dieseldurchschnittspreis (€/L) aus dem EU Weekly Oil Bulletin. Ersetzt seit v3.17.0 den statischen Parameter für E-Auto-ROI. |
| Monats-Gaspreis | Optionales Monatsdaten.gaspreis_cent_kwh-Feld (ab v3.21.0) für die WP-Ersparnis-Historie. Ohne Eintrag fällt eedc auf alter_preis_cent_kwh der WP-Komponente zurück. |
| MaStR | Marktstammdatenregister — amtliches Register aller Energieerzeugungsanlagen in Deutschland |
Energieprofil & Snapshots
Abschnitt betitelt „Energieprofil & Snapshots“| Begriff | Bedeutung |
|---|---|
| Energieprofil | Die feinste zeitliche Auflösung der Anlagendaten: eine Zeile pro Stunde, verdichtet zu einer Zusammenfassung pro Tag. Datengrundlage fast aller anderen Auswertungen. In v4 kein eigener Tab mehr — die Anzeigen sind über die Cockpit-Achsen verteilt, die Pflege liegt unter Einstellungen → Daten. Siehe Handbuch Energieprofil. |
| Snapshot | Stündlich erfasster kumulativer Zählerstand pro Anlage und zugeordnetem kWh-Sensor (Tabelle sensor_snapshots). Quellen: HA Long-Term Statistics (Add-on) oder MQTT-Energy-Snapshots (Standalone/Docker). Stunden-kWh = Differenz benachbarter Snapshots. |
| Sensor-Snapshot-Job | Scheduler-Job (:05 und :55). :05 schreibt regulär aus HA-Statistics, :55 schreibt einen Live-Preview für die anstehende volle Stunde — die laufende Stunde wird damit sofort am Stundenende sichtbar. |
| Self-Healing | Bei fehlenden Snapshots holt eedc sie on-demand aus HA Long-Term Statistics nach (Toleranz 10 min, vorher 120 min). Echte Lücken werden linear zwischen Nachbar-Stunden interpoliert. |
| Restart-Recovery | Beim Scheduler-Start (Add-on-Update / Watchdog) holt eedc für die letzten 6 Stunden je Anlage Snapshots nach — verpasste :05/:55-Jobs werden idempotent ausgeholt. |
| Tagesreset-Heuristik | Erkennt HA-utility_meter-Sensoren mit täglichem 0-Reset am Muster s1 < 0.5 ∧ s0 > 0.5 und nimmt max(0, s1) als Slot-0-Wert. Verhindert „IST unvollständig”-Flag um Mitternacht. |
| Reaggregation (Tag / mehrere Tage) | Selbsthilfe in der Reparatur-Werkbank (Einstellungen → Daten). „Tag neu aggregieren” bzw. „Mehrere Tage neu aggregieren” (max. 31) berechnet Tage neu (idempotent: delete + insert). Erfolgsmeldung zeigt Slots mit echten Messdaten (grün > 0, amber = 0). |
| Vollbackfill | „Lücken aus HA-LTS nachfüllen” — ergänzt nur fehlende Tage aus den HA-Long-Term-Statistics, strikt additiv (kein Overwrite-Modus). |
| Counter-Feld | Total-Increasing-Sensor ohne Energie-Einheit (z. B. WP-Kompressor-Starts). Strikt getrennt von kWh-Feldern in KUMULATIVE_COUNTER_FELDER — fließt nicht in die Energie-Bilanz. |
| HA Long-Term Statistics (LTS) | HA’s statistics-Tabelle mit sum-Spalte (reset-bereinigte Kumulation) und stundengranularen state/mean/min/max. Sensoren ohne state_class sind nicht in LTS — wichtig für die Datenquellen-Wahl. |
Integration & Datenquellen
Abschnitt betitelt „Integration & Datenquellen“| Begriff | Bedeutung |
|---|---|
| MQTT | Message Queuing Telemetry Transport — schlankes Protokoll für IoT- und Smarthome-Kommunikation |
| Datenquellen-Zuordnung | Die zentrale feld-zentrische Fläche in v4: jedes eedc-Feld bezieht seinen Wert aus genau einer Quelle (HA-Sensor / MQTT-Gateway / MQTT-Inbound / keine). Löst die früheren getrennten Assistenten ab. Siehe Einstellungen → Datenquellen. (ehemals: „Sensor-Mapping-Wizard” + „MQTT-Inbound/-Gateway-Wizard”.) |
| MQTT-Inbound | eedc-Funktion zum Empfang von Echtzeitdaten via die kanonischen eedc-Standard-Topics (eedc/{anlage_id}/live/... und …/energy/...). In v4 eine Quellen-Art je Feld in der Datenquellen-Zuordnung; die Verbindung richtest du einmal unter Integration → MQTT-Broker ein. |
| MQTT-Gateway | eedc-Funktion zum Übersetzen eigener Geräte-Topics (Shelly, OpenDTU, Tasmota …) auf eedc-Felder. In v4 die „Gateway”-Quelle je Feld in der Datenquellen-Zuordnung. |
| Sensor-Mapping | ehemals: Zuordnung von Home-Assistant-Sensoren zu eedc-Feldern im eigenen Wizard. In v4 in die Datenquellen-Zuordnung aufgegangen (Quellen-Art „HA-Sensor” je Feld). Sensor-Namen/Topics unverändert. |
| Connector | Geräte-Modul in eedc für direkten API-Abruf von Wechselrichtern, Speichern und Ladesäulen. Startbar über die Import-Assistenten; kann seine Werte optional als MQTT-Bridge auf eedc-Topics publishen. |
| Daten-Checker | eedc-System für Datenqualitäts-Prüfung in mehreren Kategorien — von Stammdaten über Plausibilität bis Datenquellen-Konsistenz und HA-Statistics-Verfügbarkeit. In v4 unter Einstellungen → Daten. Details: Handbuch Daten-Checker. |
| Heatmap | Tabellen-Darstellung mit Zellfärbung nach Wertgröße. eedc nutzt sie in der Werte-Werkbank (pro Spalte). Die Tag×Stunde-Heatmap des alten Energieprofils kommt später neu gestaltet zurück (Cockpit → Monat). |
Oberfläche (v4)
Abschnitt betitelt „Oberfläche (v4)“| Begriff | Bedeutung |
|---|---|
| Cockpit | Die Zeit-Achse der v4-Navigation: dieselbe Anlage nach Zeit-Ebene — Live · Tag · Monat · Jahr/Gesamt · Aussicht. Siehe Bedienung §2. |
| Komponenten (Achse) | Die Was-Achse: jeder Gerätetyp einzeln und in der Tiefe (ein Reiter je vorhandenem Typ). Siehe Bedienung §3. |
| Auswertungen | Die Wie-Achse: auswertende Gesamtsichten quer über die Zeit — Finanzen · ROI · Prognose · CO₂ · Tabelle. Siehe Bedienung §4. |
| Aussicht | Die vorwärtsgerichtete Cockpit-Sicht (Kurzfrist, Langfrist, Degradation) mit Horizont-Selektor. Der tiefere Prognose-Vergleich mit Genauigkeit liegt in Auswertungen → Prognose. |
| Block-Modell | Jede Sicht ist aus Blöcken aufgebaut, die sich klappen, umsortieren, fokussieren und parken lassen. |
| Fokus / Vollbild | Ein Block lässt sich in den Fokus heben (⤢ Vollbild-Ansicht) — z. B. eine inline gezeigte Tabelle oder die Infothek im großen Blick. Geteilte Overlay-Mechanik über alle Sichten. |
| Parken (Parkbar) | Einzelne Anzeigen (Kacheln, Charts) lassen sich parken (ausblenden) und später wiederherstellen. Eine Parkbar = eine atomare Anzeige. |
| Herkunfts-Zeile | Die Kopfzeile „woher kommen diese Zahlen?” über einem Diagramm, Balken oder einer Tabelle: ein Zustands-Zeichen (gemessen / geschätzt — gerechnet statt gemessen / weicht ab — unvollständig), worauf sich die Kennzeichnung bezieht, und ein Erklärsatz. Immer sichtbar, nicht nur als Hover-Tooltip, damit sie auch auf Touch lesbar ist. |
| Monatsdaten-Formular | Der EINE Erfassungsweg für die monatlichen Zählerwerte in v4 (MonatsdatenForm) — datengetrieben, mit Assistenz je Feld. Löst den mehrstufigen Monatsabschluss-Wizard ab. Unter Einstellungen → Daten → Monatsdaten. |
| Vorjahresvergleich | Der Vergleichs-Modus der Werte-Tabelle und der Zeit-Sichten: jede Zeile steht ihrem eigenen Zeitraum ein Jahr früher gegenüber (Dez 2025 ↔ Dez 2024), auch über mehrjährige Zeiträume. Fehlt dieser Vorjahres-Zeitraum, bleibt die Spalte leer („—”) — es wird kein Ersatzwert eingesetzt. Siehe Bedienung §4.5. |
| Einstellungs-PIN (Sperre) | Optionaler Schutz gegen versehentliches Verstellen, einzuschalten unter Einstellungen → Anlage. Ansehen ist nie gesperrt, das Ändern verlangt die PIN einmal je Browser-Sitzung; hell/dunkel bleibt frei. Ausdrücklich kein Benutzerkonto und keine Rollen — eedc weiß nicht, wer davorsitzt, es gibt genau einen Schlüssel. Standardmäßig aus. |
| Status-Fußzeile | Die dauerhaft sichtbare Zeile mit Anlagen-Auswahl, Datenquellen-/Teilen-Status und Verbindungshinweisen. |
| CollapsibleSection | Wiederverwendbare UI-Komponente mit localStorage-Persistenz pro storageKey. Status der Sektionen (offen/zu) bleibt pro Browser erhalten. |
Sonstiges
Abschnitt betitelt „Sonstiges“| Begriff | Bedeutung |
|---|---|
| Infothek | Optionales eedc-Modul zur Verwaltung von Verträgen, Zählern, Kontakten und Dokumenten. N:M-Verknüpfung mit Komponenten seit v3.15.2. In v4 eine eigene Kachel-Kategorie unter Einstellungen → Infothek. Siehe Handbuch Infothek. |
| Monatsabschluss | Die monatliche Datenerfassung. In v4 als Monatsdaten-Formular umgesetzt (ein Formular, datengetrieben, mit Assistenz je Feld und automatischen Vorschlägen aus HA-Statistik / Datenquelle / Vorjahr). (ehemals: mehrstufiger „Monatsabschluss-Wizard” — als v4-Fläche stillgelegt, bis zum Flip nur noch über die alte Route erreichbar.) |
| Verbrauchszähler | Eine Kategorie unter Sonstiges (#377): ein Gas-, Wasser-, Heizöl-, Pellet- oder Flüssiggaszähler. eedc führt seinen Zählerstand mit und zeigt, wie weit er sich im gewählten Zeitraum bewegt hat — mehr nicht. Erfasst, nicht bewertet: In Energiebilanz, Autarkie, Wirtschaftlichkeit, CO₂-Bilanz und den Gemeinschaftsdaten kommt er bewusst nicht vor, weil Gas- und Wasserkosten Haushaltskosten sind und nicht zur Rechnung der PV-Anlage gehören. Die Einheit (m³, l, kg, t, kWh) gehört zum Gerät und ist reine Anzeige — eedc rechnet nichts um. Siehe Handbuch Einstellungen §3.4a. |
| Sonstige Positionen | Frei erfassbare Kosten und Erlöse je Monat (Reparaturen, Wartung, THG-Quote, Guthaben-Auszahlung …), Typ Ertrag/Ausgabe. Ab v4.0 auch auf Anlage-Ebene (nicht nur pro Komponente); sie fließen in Netto-Ertrag und T-Konto ein. Siehe Berechnungen §3.10. |
| Community-Hash | Anonymer Identifier für die Community-Benchmark-Funktion; kein Rückschluss auf Person oder Adresse |
| In-App-Hilfe | Hilfe-Seite (Hauptmenü „Hilfe”) seit v3.24.0. Rendert die kuratierten Markdown-Dokumente direkt in der App — funktioniert in der HA-Companion-App identisch zum Browser. URL-Parameter ?doc=<slug> macht Direktlinks teilbar. |
| ICON-CH2 | MeteoSwiss-Wettermodell mit 2 km Auflösung; empfohlen für alpine Standorte (CH, AT, Südtirol) |
| ICON-D2 | DWD-Wettermodell mit 2,2 km Auflösung; hochauflösend für Deutschland |
| ECMWF IFS | Globales Wettermodell des Europäischen Zentrums für mittelfristige Wettervorhersage |
Support
Abschnitt betitelt „Support“Bei Fragen oder Problemen:
- In-App-Hilfe (Hauptmenü → Hilfe): Vollständiges Handbuch direkt in der App
- GitHub Issues: github.com/supernova1963/eedc-homeassistant/issues
- Protokolle (Einstellungen → System → Protokolle): Debug-Modus aktivieren, Problem reproduzieren, Logs als Markdown-Tabelle kopieren, in Issue einfügen
- Daten-Checker (Einstellungen → Daten → Daten-Checker): prüft Datenqualität in mehreren Kategorien — von Stammdaten über Plausibilität bis Datenquellen-Konsistenz und HA-Statistics-Verfügbarkeit
- Web-Dokumentation: supernova1963.github.io/eedc-homeassistant
Letzte Aktualisierung: 2026-07-25 (v4.0)