@@ -26,8 +26,8 @@ Vorgeschlagene Bündelung:
 | Version | Inhalt | Art | Stand |
 | --- | --- | --- | --- |
 | 3.8.1 | Maßnahme 1 + K1 (Zugangswege, kein Protokoll-/Topic-Einfluss) | Fix | **erledigt 2026-08-18** — umgesetzt, am Gerät abgenommen, auf beiden Stufen ausgerollt |
-| 3.8.2 | Maßnahme 2 (retained `Online`) + K3 (Publish-Wiederholung) | Fix | **erledigt 2026-08-19** — gebaut und getestet, Abnahme am Gerät steht aus |
-| 3.9.0 | Maßnahme 3 (Weg B + `nullptr`-Abschluss) + Testausbau | Umbau | **erledigt 2026-08-19** — gebaut und getestet, Abnahme am Gerät steht aus |
+| 3.8.2 | Maßnahme 2 (retained `Online`) + K3 (Publish-Wiederholung) | Fix | **erledigt 2026-08-19** — in 3.9.0 enthalten, nicht einzeln ausgerollt |
+| 3.9.0 | Maßnahme 3 (Weg B + `nullptr`-Abschluss) + Testausbau | Umbau | **erledigt 2026-08-19** — am Gerät abgenommen, auf beiden Stufen ausgerollt |
 | — | K2 (Beobachtungsauftrag), K4 (bekannte Grenze) | Entscheid | **entschieden 2026-08-19** — keine Codeänderung |
 | — | CI-Trigger nur noch `main` | Aufräumen | **erledigt 2026-08-19** |
 
@@ -311,6 +311,45 @@ Repository sind Actions-Minuten frei; der Gewinn ist weniger Lauf-Rauschen.
 
 ---
 
+## Rollout 3.9.0 — erledigt (2026-08-19)
+
+**Direkt auf 3.9.0, ohne 3.8.2 als Zwischenschritt.** Ein eigener 3.8.2-Rollout
+hätte keinen zusätzlichen Nachweis gebracht: Das Retain-Verhalten zeigt der
+ioBroker-Adapter nicht, und die Publish-Wiederholung wird erst bei einer
+MQTT-Unterbrechung sichtbar. Die `/tablerefresh`-Abnahme deckt genau das ab,
+was 3.9.0 an der Anzeige ändert. 3.8.2 ist trotzdem als Binärstand abgelegt,
+damit ein Rückfall um eine Stufe möglich bleibt.
+
+| Stufe | Gerät | OTA | Ergebnis |
+| --- | --- | --- | --- |
+| 1 | 192.168.2.120 | 09:28 | 90 Zeilen **identisch**, keine einzige Abweichung |
+| 2 | 192.168.2.122 | 09:29 | 90 Zeilen, **eine** Abweichung: `Eva_Outlet_Temp` 21 → 22 °C (laufender Messwert) |
+
+Beide Geräte meldeten sich rund sieben Sekunden nach dem Upload mit 3.9.0
+zurück, `info/LWT` stand unmittelbar danach wieder auf `Online`, die
+State-Topics liefen im 5-Sekunden-Takt weiter. Stufe 2 lief während des OTA im
+Warmwasserbetrieb (`Heatpump_State` On, `Operating_Mode_State` DHW) und lief
+danach unverändert weiter.
+
+Die 22 von Maßnahme 3 betroffenen Zeilen wurden zusätzlich einzeln angesehen —
+alle zeigen ihren erwarteten Klartext (`Off`, `Disabled`, `Blocked`, `Direct`,
+`DHW` …), keine leere Zelle und kein `unknown`. Letzteres ist der Normalfall:
+`unknown` erscheint nur bei einem Rohwert, den die Wärmepumpe bisher nie
+geliefert hat — genau dem Wert, der vorher zum Absturz geführt hätte.
+
+Stabilitätskontrolle rund vier Minuten nach dem Flash: beide Geräte weiter auf
+3.9.0, `info/LWT` unverändert seit dem Neustart (kein zwischenzeitlicher
+Reconnect, also kein Watchdog-Zyklus), und das 5-Minuten-Vollupdate hat auf
+Stufe 1 um 09:33:20 alle State-Topics erneut geschrieben. Dass die
+Zeitstempel dazwischen stehen bleiben, ist kein Befund, sondern das erwartete
+Verhalten: Publiziert wird nur bei Wertänderung oder mit dem Vollupdate.
+
+Für die Abnahme entstand [`test/tablesnap.py`](test/tablesnap.py) (holt
+`/tablerefresh` und gibt `TOP<n>|Name|Wert|Klartext` aus), damit der Vergleich
+ein `diff` ist statt Zeilenvergleich per Auge.
+
+---
+
 ## Ausdrücklich geprüft und in Ordnung
 
 Damit die nächste Durchsicht nicht von vorn anfängt — diese Punkte wurden
 
@@ -38,6 +38,7 @@ bewusst unveraendert - dort warnt die Firmware nur.
 | `decode_vergleich.py` | Dekodierpfad zweier Codestaende gegeneinander laufen lassen, auf dem Mac | nein |
 | `frame_diff.py` | Rohtelegramme eines Mitschnitts ueber alle 203 Bytes vergleichen, angereichert aus `ProtocolByteDecrypt.md` | nein |
 | `retained_loeschen.py` | Retained Messages entfallener state-Topics vom Broker raeumen (Anzeige, `--loeschen` fuer echt) | Broker |
+| `tablesnap.py` | Momentaufnahme der Topic-Tabelle ueber `/tablerefresh`, zeilenweise diffbar - fuer die Abnahme nach dem Flashen | Produktivgeraet (nur lesend) |
 | `heisha_probe.py` | gemeinsame Helfer (Telnet, Hexlog-Parser) | - |
 | `mqtt_pub.py` | minimaler MQTT-Publisher ohne Abhaengigkeiten | - |
 | `stubs/` | Arduino-Ersatzheader, gemeinsam genutzt von `byte110_test.cpp` und `decode_vergleich.py` | - |
@@ -197,6 +198,33 @@ einbindenden Datei sucht: aus `src/` heraus gewinnt der echte Header und zieht
 LittleFS, WiFi und den Rest der Arduino-Welt nach. `decode_hosttest.sh` kopiert
 die Uebersetzungseinheit deshalb neben die Ersatzheader aus `stubs/`.
 
+## Abnahme nach dem Flashen (tablesnap.py, 3.9.0)
+
+Die Projektkonvention nach jedem OTA: Baseline der Topic-Tabelle vor dem Flash
+ziehen, nach dem Flash noch einmal, und beide zeilenweise halten. Bis 3.9.0 ging
+das per Augenschein ueber die Weboberflaeche - bei 90 Zeilen je Stufe ist das
+muehsam und uebersieht leicht etwas.
+
+`tablesnap.py` holt `/tablerefresh` und gibt je Zeile `TOP<n>|Name|Wert|Klartext`
+aus. Damit ist die Abnahme ein `diff`:
+
+```
+./tablesnap.py 192.168.2.120 > vorher.txt
+pio run -e heishamon_esp32_h1_ota -t upload
+./tablesnap.py 192.168.2.120 > nachher.txt
+diff vorher.txt nachher.txt
+```
+
+Was uebrig bleibt, ist entweder ein laufender Messwert oder ein Befund. Reines
+GET, kein Eingriff ins Geraet. Beim Rollout von 3.9.0 am 2026-08-19 blieb Stufe 1
+vollstaendig ohne Abweichung, Stufe 2 mit einer einzigen (`Eva_Outlet_Temp`
+21 -> 22 Grad).
+
+Zwei Hinweise: Nach dem Neustart braucht das Geraet ein paar Abfragezyklen, bis
+die Tabelle wieder gefuellt ist - erst schnappen, wenn keine Zeile mehr leer
+oder `unused` ist. Und die Baseline gehoert unmittelbar vor den Flash gezogen,
+sonst wandern in der Zwischenzeit Messwerte und der Diff wird unuebersichtlich.
+
 ## Verhaeltnis zu `pio test`
 
 Das sind eigenstaendige Diagnosewerkzeuge, keine Unity-Testsuites - `pio test`
 
@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+"""Momentaufnahme der Topic-Tabelle eines HeishaMon-Geraets ueber /tablerefresh.
+
+Zweck: die Abnahme nach dem Flashen zu einem Zeilenvergleich machen. Vor dem OTA
+einmal laufen lassen, nach dem OTA ein zweites Mal, dann 'diff' der beiden
+Dateien - was uebrig bleibt, sind entweder laufende Messwerte oder ein Befund.
+
+  ./tablesnap.py 192.168.2.120 > vorher.txt
+  ./tablesnap.py 192.168.2.120 > nachher.txt
+  diff vorher.txt nachher.txt
+
+Ausgabe je Zeile:  TOP<n>|<Name>|<Wert>|<Klartext bzw. Einheit>
+Nur Standardbibliothek, kein Geraeteeingriff (reines GET).
+"""
+import html
+import re
+import sys
+import urllib.request
+
+ZELLEN = re.compile(r"<td>(.*?)</td>", re.S)
+
+
+def schnappschuss(ip: str, timeout: float = 10.0) -> list[str]:
+    with urllib.request.urlopen(f"http://{ip}/tablerefresh", timeout=timeout) as antwort:
+        seite = antwort.read().decode("utf-8", "replace")
+    zeilen = []
+    for roh in seite.split("<tr>"):
+        felder = [html.unescape(z).strip() for z in ZELLEN.findall(roh)]
+        if len(felder) >= 4:
+            zeilen.append("|".join(felder[:4]))
+    return zeilen
+
+
+def main() -> int:
+    if len(sys.argv) != 2:
+        print(__doc__, file=sys.stderr)
+        return 2
+    try:
+        zeilen = schnappschuss(sys.argv[1])
+    except OSError as fehler:
+        print(f"FEHLER: {sys.argv[1]} nicht erreichbar ({fehler})", file=sys.stderr)
+        return 1
+    if not zeilen:
+        print("FEHLER: keine Tabellenzeilen gefunden", file=sys.stderr)
+        return 1
+    print("\n".join(zeilen))
+    print(f"# {len(zeilen)} Zeilen von {sys.argv[1]}", file=sys.stderr)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())