feat(S3): Cold Extraction überlebt Standby und Neustart (5.3.1)

Der Modus wird im EEPROM (Adresse 977) gespeichert und beim Start wieder
übernommen, sofern die Funktion auf /Brew-Control freigeschaltet ist. Standby
beendet ihn nicht mehr, sondern verwirft nur die Laufzeitdaten.

Grund: Wer nur kalte Bezüge machen will, musste den Modus nach jedem Standby
neu einschalten. Bis dahin heizte die Maschine bereits auf und war für die
nächste kalte Extraktion zu warm — man musste auf das Abkühlen warten, also
genau die Situation, die der Modus vermeiden soll.

Der Modus endet nur noch durch explizites Ausschalten, durch Entzug der
Freischaltung oder durch einen Werksreset.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Changelog.txt

@@ -1,3 +1,44 @@
+Version 5.3.1:
+- Cold Extraction ist jetzt persistent: Der Modus wird im EEPROM gespeichert und überlebt sowohl den
+  Standby als auch einen Neustart. Zuvor wurde er beim Standby beendet und war nach dem Aufwachen aus -
+  die Maschine heizte dann erst auf, obwohl der nächste kalte Bezug einen kalten Kessel braucht, und man
+  musste auf das Abkühlen warten. Wer nur kalte Bezüge machen will, schaltet den Modus damit einmal ein
+  und wieder aus, wenn er fertig ist.
+- Der Modus fällt nur weg, wenn auf /Brew-Control die Freischaltung entzogen wird oder ein Werksreset
+  läuft. Solange er aktiv ist, heizt der Wasserkreis nicht - Dashboard, OLED („(COLD)" in der Wasserzeile)
+  und Touch-Display zeigen das durchgehend an.
+
+Version 5.3.0:
+- Neu: Cold Extraction (kalte Extraktion). Die Maschine hat keinen Bypass um den Wasserkessel, kaltes Wasser
+  kommt also nur bei kaltem Kessel am Puck an. Die Funktion wird deshalb über eine Temperaturschwelle
+  freigegeben (Standard 30 °C, einstellbar 10–40 °C) und ist praktisch aus dem kalten Zustand heraus nutzbar.
+- Solange der Modus aktiv ist, heizt der Wasserkreis nicht (SSR gesperrt, Stellgröße und damit auch die
+  dutyW-Telemetrie auf 0, I-Anteil der Wasser-PID eingefroren, Feed-Forward-Boost deaktiviert). Der
+  Dampfkreis bleibt unberührt und darf weiter heizen.
+- Die Freigabe wird vor jedem Bezug neu geprüft, nicht nur beim Aktivieren: Da der Dampfkessel weiter heizt,
+  kann der Wasserkessel über die Zeit über die Schwelle steigen. In diesem Fall wird der nächste Bezug
+  abgewiesen (Meldung auf OLED, Touch-Display und im Web-Dashboard) - ein laufender Bezug wird nie abgebrochen.
+  Hysterese von 5 °C, damit die Anzeige an der Schwelle nicht flattert; Sensorfehler sperrt die Funktion.
+- Der Fluss wird über Pumpen-Pulsung reduziert (Pulsperiode 200–5000 ms, Pumpenleistung 5–100 %), davor läuft
+  eine einstellbare Vorbenetzung mit voller Pumpenleistung. Bezugsende über Zielgewicht oder Sicherheits-Timeout;
+  Brew-by-Time/Brew-by-Weight und FlowGuard sind während einer kalten Extraktion bewusst außer Kraft (FlowGuard
+  und Cold Extraction würden sonst um denselben Pumpen-Ausgang konkurrieren).
+- Pumpenschutz: Die Steuerung zählt die kumulierte Pumpen-Einschaltzeit und legt nach der eingestellten
+  Laufzeit eine Zwangspause ein (Standard 60 s Laufzeit / 20 s Pause). Zusätzlich Stillstands-Erkennung -
+  läuft die Pumpe bei aktiver Waage 15 s ohne Zulauf, wird der Bezug beendet (dichter Puck oder ausgelöster
+  Pumpen-Thermoschutz).
+- Bedienung: Parameter auf der Seite /Brew-Control, Ein-/Ausschalten über das Web-Dashboard oder das
+  UART-Touch-Display (neue Aktionen "startColdExtraction"/"stopColdExtraction"/"toggleColdExtraction").
+  Cold Extraction ist bewusst kein Profilfeld (maschinen- und situationsabhängig, wie der Feed-Forward);
+  der Modus selbst wird nicht persistiert und ist nach einem Neustart immer aus. Standby beendet ihn.
+- Statistik: Kalte Bezüge werden im Log mit einem vierten CSV-Feld "C" gekennzeichnet, zählen in allen
+  Stückzahlen mit, gehen aber NICHT in die durchschnittliche Bezugsdauer ein (Minuten statt Sekunden würden
+  den Wert verzerren). Die Info-Seite weist die Anzahl separat aus, der Verlaufs-Download hat eine neue
+  Spalte "Art". Ältere Logzeilen bleiben unverändert lesbar.
+- Neue additive State-Felder im UART-JSON (Protokoll bleibt v2): cxEnabled, cxActive, cxShot, cxAllowed,
+  cxResting, cxMaxTemp, cxTarget, cxMaxSecs, cxMessage sowie "cx" pro Eintrag in usageStats; neuer
+  statusKey "coldextraction". Ältere Display-Firmware ignoriert die Felder.
+
 Version 5.2.0:
 - Feed-Forward bei Bezug (Störgrößenaufschaltung) für den Wasserkessel: Während eines Bezugs wird der
   Heizung sofort ein einstellbarer Leistungs-Boost (0–100 % der Fenstergröße, 0 % = aus) aufgeschaltet,

Doku/JC-Display_UART-Protokoll.md

@@ -315,6 +315,26 @@ Alle gültigen `action`-Strings aus `executeDashboardAction()` (Stand v4.8.1, Ze
 | `disableSteamHeat` | — | Dampf-Heizung abschalten |
 | `enableSteamHeat` | — | Dampf-Heizung wieder aktivieren |
 
+**Cold Extraction (kalte Extraktion, ab S3 5.3.0)**
+
+| `action` | `value` | Wirkung |
+|---|---|---|
+| `startColdExtraction` | — | Modus aktivieren (Wasserkreis heizt nicht, Dampf bleibt möglich) |
+| `stopColdExtraction` | — | Modus beenden |
+| `toggleColdExtraction` | — | Modus umschalten |
+
+Alle drei Aktionen werden abgewiesen (`ok:false` + `message`), solange die Bedingungen nicht
+erfüllt sind — Hauptfall ist ein zu warmer Wasserkessel (`cxAllowed:false`). Der Modus ist
+**persistent** (EEPROM) und überlebt Standby und Neustart; er endet nur durch explizites
+Ausschalten, durch Entzug der Freischaltung auf `/Brew-Control` oder durch einen Werksreset.
+Das P4-UI sollte `cxActive` deshalb dauerhaft sichtbar spiegeln — sonst wundert sich der
+Benutzer, warum die Maschine nicht heizt. Ein laufender Bezug wird nie abgebrochen,
+`stopColdExtraction` schlägt dann fehl.
+
+Die Parameter der kalten Extraktion (Schwelle, Vorbenetzung, Pulsperiode, Pumpenleistung,
+Zielgewicht, Timeout, Pumpenschutz) sind bewusst **nicht** über `saveBrew` erreichbar, sondern
+nur über die Web-Seite `/Brew-Control`. Das Display schaltet den Modus, konfiguriert ihn nicht.
+
 **Persistente Toggles**
 
 | `action` | `value` | Wirkung |
@@ -354,7 +374,28 @@ Aus `getTouchUartStatus()`. Für sprach-unabhängige UI-Logik/Icons auf dem P4 v
 (statt `statusText` zu parsen):
 
 `ready`, `error`, `standby`, `maintenance`, `tuning`, `brewing`, `eco`, `fastheatup`,
-`heating`, `ready_eco_pending`.
+`heating`, `ready_eco_pending`, `coldextraction` (ab S3 5.3.0).
+
+### Cold-Extraction-Felder im `state` (ab S3 5.3.0, additiv — Protokoll bleibt v2)
+
+| Feld | Typ | Bedeutung |
+|---|---|---|
+| `cxEnabled` | bool | Funktion in der Web-UI freigeschaltet (sonst Bedienelement ausblenden) |
+| `cxActive` | bool | Modus scharf: Wasserkreis heizt nicht |
+| `cxShot` | bool | Der laufende Bezug ist eine kalte Extraktion |
+| `cxAllowed` | bool | Freigabe **jetzt** (Wasserkessel kalt genug, kein Standby/Wartung/Tuning) |
+| `cxResting` | bool | Zwangspause des Pumpenschutzes läuft (Bezug läuft weiter) |
+| `cxMaxTemp` | float | Freigabeschwelle in °C (für eigene Hinweistexte am Display) |
+| `cxTarget` | float | Zielgewicht in g |
+| `cxMaxSecs` | float | Sicherheits-Timeout des Bezugs in s |
+| `cxMessage` | string | Sperr-/Abbruchmeldung, leer = keine (läuft nach ~6 s selbst ab) |
+
+Während `cxShot` folgt die Phase weiterhin `piState`: `1` = Vorbenetzung, `3` = Hauptbezug
+(gepulst). Eine Pause-Phase (`2`) gibt es bei der kalten Extraktion nicht.
+
+In der Antwort auf `getUsageStats` trägt jeder Eintrag in `shots[]` zusätzlich `cx` (bool) —
+kalte Bezüge zählen in `total`/`today`/`week` mit, sind aber in der durchschnittlichen
+Bezugsdauer der S3-Statistik ausgenommen.
 
 ---