Batteriespannung-Fallback: zeigt letzte Ruhespannungsmessung ueber Neustarts hinweg

Der RAM-only Fallback fuer die Zustand-Kachel wurde bei jedem Neustart
geleert und zeigte "unbekannt", solange seit dem Neustart keine echte
Live-Messung eintraf (Dongle bei ausgeschaltetem Fahrzeug erwartungsgemaess
immer offline). spannung_cache_vorladen() laedt ihn jetzt beim Start aus
der gespeicherten Historie vor, begrenzt auf den vereinbarten Bereich
10,0-13,0 V (SPANNUNG_MIN_V bis AGM_RUHE_MAX_V) - eine Generatorspannung
(z.B. 15,4 V) soll dort nie als Batteriespannung erscheinen.

Version 2026.8.27.21, im Testcontainer verifiziert (12,149 V statt
"unbekannt", trotz Dongle weiterhin 0 V live).

Co-Authored-By: Claude Sonnet 5 <[email protected]>

custom_components/audi_dashboard/veroeffentlichung.py

@@ -27,15 +27,58 @@ from .einstellungen import POSITIONEN, Sensorzuordnung
 
 # Letzte plausible Batteriespannung, für die "Zustand"-Kachel, wenn die
 # aktuelle Live-Messung gerade unplausibel ist (Sensor kurzzeitig offline,
-# Dongle getrennt o.ä.) - der Nutzer will dort die zuletzt gemessene Spannung
-# sehen statt "unbekannt". RAM-only wie andere Laufzeitzustände dieses
-# Projekts (siehe die bekannten Lücken zu Fahrtstart/Tankstand): kein Store,
-# bewusst - ein Neustart zeigt kurz wieder "unbekannt", bis die nächste echte
-# Messung eintrifft, statt einen möglicherweise sehr alten Wert aus einer
-# Datei wiederzubeleben.
+# Dongle getrennt o.ä. - erwartungsgemäß bei ausgeschaltetem Fahrzeug immer)
+# - der Nutzer will dort die zuletzt gemessene Spannung sehen statt
+# "unbekannt", ohne Ablaufdatum. Im RAM statt in einem Store wie andere
+# Laufzeitzustände dieses Projekts (siehe die bekannten Lücken zu
+# Fahrtstart/Tankstand) - aber koordinator.starten() lädt diesen Wert bei
+# jedem Neustart einmalig aus der gespeicherten Historie vor
+# (spannung_cache_vorladen()), bevor die erste Veröffentlichung läuft, damit
+# ein Neustart NICHT mehr kurz "unbekannt" zeigt.
 _letzte_gueltige_spannung: dict[str, float | None] = {"wert": None}
 
 
+def spannung_cache_vorladen(verlauf: list[dict]) -> None:
+    """Lädt die "Zustand"-Kachel-Fallback-Spannung beim Start aus der
+    gespeicherten Historie (batteriespannung.jsonl) vor, statt bis zur
+    nächsten echten Live-Messung nach jedem Neustart erst "unbekannt" zu
+    zeigen.
+
+    Der Dongle ist bei ausgeschaltetem Fahrzeug erwartungsgemäß immer
+    offline (Nutzerangabe) - "die zuletzt gemessene Spannung" soll deshalb
+    auch über einen Neustart hinweg sichtbar bleiben, und zwar ohne
+    Ablaufdatum: hier gibt es bewusst KEINE Prüfung, wie alt der Wert ist -
+    ein alter, aber echter Messwert ist der Kachel immer noch lieber als
+    "unbekannt".
+
+    Aber nur innerhalb der vereinbarten Grenze [SPANNUNG_MIN_V,
+    AGM_RUHE_MAX_V] (10,0-13,0 V, batterie.py): min/max werden roh
+    gespeichert (siehe batterie.py's Moduldocstring) und können deshalb auch
+    Generatorspannung enthalten (z. B. ein Tagesmaximum von 15,4 V bei
+    laufendem Alternator) - so ein Wert soll nie als "Batteriespannung"
+    auf der Zustand-Kachel landen, auch nicht als letzter bekannter Wert.
+    Durchsucht deshalb die GESAMTE Historie (nicht nur den letzten
+    Tageseintrag) nach dem zeitlich jüngsten min- oder max-Wert, der
+    innerhalb der Grenze liegt - ein Tag, an dem das Fahrzeug nie im
+    Ruhezustand beobachtet wurde (beide Werte über der Grenze), wird dabei
+    übersprungen, der davor gemessene gültige Wert bleibt der Fallback."""
+    from .batterie import AGM_RUHE_MAX_V, SPANNUNG_MIN_V
+
+    kandidaten: list[tuple[str, float]] = []
+    for eintrag in verlauf:
+        for wert_feld, ts_feld in (("min", "min_ts"), ("max", "max_ts")):
+            wert = eintrag.get(wert_feld)
+            ts = eintrag.get(ts_feld)
+            if wert is None or not ts:
+                continue
+            if SPANNUNG_MIN_V <= wert <= AGM_RUHE_MAX_V:
+                kandidaten.append((ts, wert))
+    if not kandidaten:
+        return
+    kandidaten.sort(key=lambda p: p[0])
+    _letzte_gueltige_spannung["wert"] = kandidaten[-1][1]
+
+
 def zustand_oder_none(hass: HomeAssistant, entity_id: str | None) -> str | None:
     """Sicherer Zustandszugriff.