feat: eigene Cold-Extraction-Seite in Web-UI und Display (S3 5.4.0 / P4 1.2.0)

Cold Extraction bekommt in beiden Oberflächen einen eigenen Menüpunkt statt eines angehängten Blocks auf der Brew-Control-Seite. Die Parameter sind damit erstmals auch am Touch-Display änderbar. S3: neue Seite /Cold-Extraction, gegliedert in Grundeinstellung, Vorbenetzung, Hauptbezug, Bezugsende und Pumpenschutz, jeder Abschnitt mit kurzer Begründung. /Brew-Control verweist nur noch darauf. Das UART-Kommando saveBrew akzeptiert jetzt die cx-Felder, und das State-JSON liefert die restlichen Parameter mit, damit das Display seine Felder vorbelegen kann. Wichtig: Der Speicher-Handler von /Brew-Control wertet die cx-Felder nicht mehr aus. Er tat es bisher, und nach dem Verschieben der Checkbox hätte ein Speichern dort die Freischaltung abgeschaltet, weil das Feld im Formular fehlt. P4: neue Seite "Cold Extraction" mit allen Parametern; der Modus-Schalter ist von der Temperatur-Seite dorthin umgezogen, damit es nur eine Stelle gibt. Die Brew-Control- Seite ist neu gegliedert: jede Funktion in einer eigenen Karte mit Titel und einer Zeile, die erklärt was sie tut, statt einer durchlaufenden Liste unter Zwischenüberschriften. Neues Hilfsmakro group_card() für beide Seiten. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Merge pull request 'fix(S3): Cold Extraction benetzt sanft statt mit voller Leistung (5.3.6)' (#18 ) from fix/cold-extraction-sanfte-vorbenetzung into main
2026-08-12 00:09:23 +02:00 · 2026-08-11 23:41:43 +02:00 · 2026-08-11 23:41:23 +02:00 · 2026-08-11 03:01:10 +02:00 · 2026-08-11 02:59:22 +02:00 · 2026-08-11 02:07:35 +02:00
10 changed files with 2950 additions and 223 deletions
@@ -1,3 +1,165 @@
 Version 5.4.0:
 - Cold Extraction hat eine eigene Seite: /Cold-Extraction, eigener Eintrag im Menü. Auf /Brew-Control
  steht nur noch ein Verweis darauf - die Seite war mit dem angehängten Block unübersichtlich geworden.
 - Die neue Seite ist in Abschnitte gegliedert (Grundeinstellung, Vorbenetzung, Hauptbezug, Bezugsende,
  Pumpenschutz), jeder mit einer kurzen Erklärung, warum der Wert so eingestellt gehört.
 - Wichtig für bestehende Installationen: Ein Speichern auf /Brew-Control fasst die Cold-Extraction-
  Einstellungen nicht mehr an. Vorher wertete dieser Handler die cx-Felder mit aus; nach dem Verschieben
  hätte ein Speichern dort die Freischaltung abgeschaltet, weil die Checkbox im Formular fehlt.
 - Das UART-Kommando "saveBrew" akzeptiert jetzt zusätzlich die Cold-Extraction-Felder (cxEnabled,
  cxMaxTemp, cxPreInf, cxPreInfDuty, cxPulseMs, cxDuty, cxTarget, cxMaxSecs, cxPumpMaxRun, cxPumpRest) -
  damit lässt sich die Funktion auch am Touch-Display vollständig einstellen.
 - Das State-JSON liefert die restlichen Parameter mit (cxPreInfDuty, cxDuty, cxPulseMs, cxPumpMaxRun,
  cxPumpRest), damit das Display seine Eingabefelder vorbelegen kann.
 Version 5.3.6:
 - Cold Extraction: Die Vorbenetzung läuft nicht mehr mit voller Pumpenleistung, sondern gepulst mit
  eigener, niedriger Leistung (neue Einstellung „Pumpenleistung Vorbenetzung", Standard 10 %).
  Messung an der Maschine: Nach 7 s Vorbenetzung kommen heiß 1-2 Tropfen, kalt bei voller Leistung
  rund 10 g dünne Brühe ohne Crema - etwa zehnfacher Durchfluss trotz dreifacher Viskosität.
  Ursache ist nicht die Viskosität, sondern das Kaffeebett: Kaltes Mehl quillt nicht, ist schlecht
  benetzbar, es wandert kein Feinanteil und es lösen sich kaum Feststoffe, die das Bett verdichten.
  Volle Leistung auf den trockenen kalten Puck legt deshalb sofort Kanäle an, die sich - anders als
  bei heißem Bezug - nie wieder schließen; der restliche Bezug läuft daran vorbei statt zu extrahieren.
 - Standard der Pumpenleistung im Hauptbezug von 30 % auf 20 % gesenkt (gleicher Grund: das kalte Bett
  ist erheblich durchlässiger als ein heißes). Bestehende Installationen behalten ihren Wert.
 - Der Erklärtext auf /Brew-Control benennt den Zusammenhang jetzt und weist darauf hin, dass die
  Vorbenetzung deutlich schwächer eingestellt sein sollte als der Hauptbezug.
 Version 5.3.5:
 - Cold Extraction lässt sich jetzt auch im Standby und bei noch warmem Kessel scharf schalten.
  Bisher galt „Standby aktiv" und „Kessel zu warm" auch fürs Aktivieren - das war falsch herum
  gedacht: Der Modus schaltet die Heizung AB, man kam aber erst an den Schalter, nachdem die
  Maschine aufgeweckt war und bereits zu heizen begonnen hatte. Genau der Ablauf, den die
  Funktion vermeiden soll.
 - Scharfschalten und Beziehen sind jetzt zwei getrennte Bedingungen:
  - Scharfschalten (neues State-Feld „cxArmable"): blockiert nur durch fehlende Freischaltung,
    Wartungsmodus, Reinigungsassistent, PID-Tuning oder einen laufenden Bezug/Spülvorgang.
  - Bezug (unverändert „cxAllowed"): zusätzlich kein Standby, Kessel unter der Freigabeschwelle,
    gültiger Sensorwert.
  Ist der Modus scharf, der Bezug aber noch gesperrt, sagen Web-UI und Display das jetzt
  ausdrücklich („Modus aktiv, Bezug noch gesperrt: …").
 - Wird bei warmem Kessel aktiviert, geht die Wasserheizung sofort aus und der Kessel kühlt ab;
  die Rückmeldung weist darauf hin, dass Bezüge bis zum Unterschreiten der Schwelle gesperrt sind.
 Version 5.3.4:
 - Cold Extraction weist jetzt deutlich darauf hin, wenn keine Waage aktiv/verbunden ist. Ohne Waage
  greifen weder das Zielgewicht noch die Stillstands-Erkennung - der Bezug endet dann erst nach der
  maximalen Bezugsdauer, die damit faktisch zur Dosierung wird. Bisher passierte das stillschweigend.
 - Die Funktion bleibt ohne Waage bewusst nutzbar (Zeitsteuerung als Rückfallebene): Ein kurzzeitig
  abgemeldeter HX711 soll die kalte Extraktion nicht komplett blockieren.
 - Angezeigt wird das an vier Stellen: dauerhafter Warnhinweis auf /Brew-Control (dort ist das
  Zielgewicht-Feld zusätzlich als „nur mit Waage wirksam" beschriftet), Hinweiszeile unter dem
  Dashboard-Schalter, Statustext „Cold Extraction bereit (ohne Waage: Zeitsteuerung)" sowie eine
  einmalige Meldung beim Aktivieren.
 - Neuer Code im UART-Feld cxNotice: 4 = ohne Waage aktiviert (additiv, Protokoll bleibt v2).
 Version 5.3.3:
 - Bug-Fix (Cold Extraction, hätte die Funktion mit Waage komplett unbrauchbar gemacht): Die
  Stillstands-Erkennung lief bereits während der Vorbenetzung mit. In dieser Phase sättigt der Puck
  aber erst, es kommt naturgemäß nichts in der Tasse an - bei einer Vorbenetzung länger als die
  15 s Stillstands-Zeit wurde deshalb JEDER kalte Bezug mit „kein Zulauf" abgebrochen. Mit dem
  bisherigen Standard von 30 s Vorbenetzung wäre das immer passiert. Die Erkennung startet jetzt
  erst mit dem Hauptbezug.
 - Standard der Vorbenetzung von 30 s auf 10 s gesenkt. In dieser Phase läuft die Pumpe bewusst
  ungepulst auf voller Leistung; bei heißem Bezug kommt der erste Tropfen nach etwa 7 s, kalt
  (rund dreifache Viskosität) entsprechend später. 30 s wären also längst voller Bezug bei vollem
  Druck gewesen, und die Hälfte des Pumpen-Laufzeitbudgets wäre vor dem eigentlichen Bezug
  verbraucht. Bestehende Installationen behalten ihren gespeicherten Wert - dort ggf. auf
  /Brew-Control nachziehen.
 - Die Beschriftung auf /Brew-Control sagt jetzt ausdrücklich, dass die Pumpe während der
  Vorbenetzung durchläuft und erst im Hauptbezug gepulst wird.
 Version 5.3.2:
 - Cold Extraction sendet den Sperrgrund jetzt als Code („cxBlock") statt als Klartext („cxMessage"),
  dazu eine transiente Meldung als Code („cxNotice") und die Vorbenetzungsdauer („cxPreInf").
  Hintergrund: Die State-Zeile ans Touch-Display liegt real bereits bei rund 2,1 KB, und der P4
  verwirft eingehende Zeilen ab einer Obergrenze komplett - ein bis zu 110 Byte langer Klartext
  hätte die Zeile über diese Grenze gedrückt und damit die ganze Telemetrie unbrauchbar gemacht.
  Die Texte rendert jetzt das Display, analog zur bestehenden Trennung statusKey/statusText.
 - Der Klartext bleibt unverändert auf dem OLED und in den Web-/UART-Antworten (ack-message).
 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,
  statt auf den vom Sensor gemeldeten Temperaturabfall zu warten. Die PID regelt nur noch den Restfehler;
  der Temperatur-Dip während des Shots wird deutlich kleiner. Einstellung auf der /PID-Seite
  („Feed-Forward bei Bezug"), gespeichert im EEPROM (bewusst kein Profilfeld, da maschinenabhängig).
 - Optional: I-Anteil der Wasser-PID während des Bezugs einfrieren. Verhindert das Aufladen des
  Integral-Anteils während des Shots und damit das Überschwingen nach Bezugsende.
 - Der Boost wirkt nur bei echten Bezügen (Hardware-Schalter oder Software-Start), nicht bei
  Spülen/Wartungsmodus/AutoTune. Sicherheitslogik unverändert: Sensorfehler, Übertemperatur-Abschaltung
  und „Heizen oberhalb Setpoint verhindern" haben weiterhin Vorrang; Deckelung auf die Fenstergröße.
 - Die Heizleistungs-Telemetrie (dutyW, u. a. für das Verlaufs-Chart des Touch-Displays) zeigt den
  Boost mit an - damit ist die Wirkung direkt im Chart kalibrierbar.
 Version 5.1.2:
 - Profil-Seite (Web-UI): Die neue „Aktives Profil"-Anzeige stand linksbündig außerhalb des
  Karten-Layouts. Sie nutzt jetzt den status-message-Stil der Seite (zentriert, max. 600 px,
  dezenter Rahmen) und fügt sich damit in das bestehende Layout ein; Profilname zusätzlich fett.
 Version 5.1.1:
 - Aktives Profil wird jetzt geführt und angezeigt: Die Steuerung merkt sich das zuletzt geladene bzw.
  gespeicherte Profil dauerhaft im EEPROM (überlebt Neustarts). Web-UI: Anzeige auf dem Dashboard über der
  Profil-Auswahl sowie auf der Profil-Seite (aktives Profil zusätzlich mit grünem Punkt in der Liste).
 - „Geändert"-Erkennung: Werden nach dem Laden profil-relevante Einstellungen geändert (Solltemperaturen,
  PID-Werte inkl. AutoTune-Ergebnis und AutoTune-Parameter, Boost, Eco, Dampfverzögerung, Fast-Heat-Up,
  Brew-Control, Piezo), erscheint hinter dem Profilnamen „✱ (geändert)". Reine Anzeige-/Systemeinstellungen
  (Anzeigemodus, Aufheizzeit, Licht, FlowGuard, Waage/Sensoren) lösen das bewusst nicht aus.
 - Profil löschen setzt die Anzeige zurück, wenn das gelöschte Profil das aktive war; Werksreset ebenso.
 - Neue additive State-Felder "profile" und "profDirty" im UART-JSON für das Touch-Display (Protokoll bleibt
  kompatibel, ältere Display-Firmware ignoriert die Felder) - Grundlage für die Profil-Schnellwahl am Display.
 Version 5.1.0:
 - Display-Auswahl in die Web-UI (/Sensoren) verlegt: Ohne Display / OLED (SH1106, I2C) / UART-Touch-Display.
  Der Compile-Schalter ENABLE_DISPLAY entfällt, die Einstellung wird im EEPROM gespeichert und ohne Neustart
  übernommen. Default ist "Ohne Display", damit die Steuerung ohne angeschlossene Anzeige immer sicher startet.
 - Boot-Schutz: Vor der OLED-Initialisierung wird per I2C-Probe (0x3C) geprüft, ob das Display wirklich
  angeschlossen ist. Ohne Antwort bleibt die Anzeige deaktiviert und die Steuerung bootet normal weiter -
  eine falsch gesetzte Display-Einstellung kann die Maschine damit nicht mehr blockieren.
 - UART-Touch-Anbindung (Serial1) wird nur noch initialisiert und bedient, wenn "UART-Touch-Display" gewählt ist.
 Version 5.0.12:
 - Neues additives Feld "piState" im State-JSON für das UART-Touch-Display (0=inaktiv, 1=Pre-Infusion,
  2=Pause, 3=Hauptbezug): Die Pre-Infusion-Phasenleiste auf dem Display folgt damit quelltreu der echten
@@ -157,6 +157,8 @@ Erzeugt von `buildTouchUartStateJson()`. Alle Felder in einem flachen JSON-Objek
 | `steamHeatDisabled` | bool | Dampfheizung per Nutzer deaktiviert |
 | `lightOn` | bool | Beleuchtung an |
 | `piezoEnabled` | bool | Piezo-Summer aktiv |
 | `profile` | string | zuletzt geladenes/gespeichertes Profil, leer = keines (additiv seit S3 5.1.1) |
 | `profDirty` | bool | profil-relevante Einstellungen seit dem Laden geändert (additiv seit S3 5.1.1) |
 | `weight` | float | aktuelles Waagengewicht (UI) |
 | `targetWeight` | float | Ziel-Gewicht (Brew-by-Weight) |
 | `scaleEnabled` | bool | Waage aktiviert |
@@ -313,6 +315,38 @@ 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 |
 Für das Bedienelement zählt `cxArmable`, **nicht** `cxAllowed`: Der Modus schaltet die
 Wasserheizung ab und muss deshalb auch im Standby und bei noch warmem Kessel scharf zu
 stellen sein — sonst heizt die Maschine nach dem Aufwecken an, bevor man an den Schalter
 kommt. `cxAllowed` gilt nur für den einzelnen Bezug; ist der Modus scharf und `cxAllowed`
 false, sollte die UI „Modus aktiv, Bezug noch gesperrt" zeigen.
 Ein Aufwecken direkt in die kalte Extraktion sendet `startColdExtraction` **vor**
 `deactivateStandby` — in dieser Reihenfolge, damit der Wasserkreis gar nicht erst anheizt.
 Die Aktionen werden abgewiesen (`ok:false` + `message`), solange die Bedingungen nicht
 erfüllt sind. 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 sind ab S3 5.4.0 über `saveBrew` einstellbar (zusätzlich
 zur Web-Seite `/Cold-Extraction`). Zulässige Felder: `cxEnabled` (bool), `cxMaxTemp`,
 `cxPreInf`, `cxPreInfDuty`, `cxPulseMs`, `cxDuty`, `cxTarget`, `cxMaxSecs`, `cxPumpMaxRun`,
 `cxPumpRest`. Es werden nur die tatsächlich gesendeten Felder übernommen; Grenzwerte prüft
 die S3. Die aktuellen Werte stehen alle im `state`, damit das Display seine Eingabefelder
 vorbelegen kann.
 **Persistente Toggles**
 | `action` | `value` | Wirkung |
@@ -352,7 +386,52 @@ 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 | **Bezug** jetzt möglich (Wasserkessel kalt genug, kein Standby/Wartung/Tuning) |
 | `cxArmable` | bool | **Modus umschaltbar** — auch im Standby und bei warmem Kessel (ab S3 5.3.5) |
 | `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 |
 | `cxPreInf` | float | Vorbenetzung in s (auch für die Phasenleiste des kalten Bezugs) |
 | `cxPreInfDuty` | float | Pumpenleistung Vorbenetzung in % (ab S3 5.4.0) |
 | `cxDuty` | float | Pumpenleistung Hauptbezug in % (ab S3 5.4.0) |
 | `cxPulseMs` | uint16 | Pulsperiode in ms (ab S3 5.4.0) |
 | `cxPumpMaxRun` | float | Pumpenschutz: max. kumulierte Laufzeit in s (ab S3 5.4.0) |
 | `cxPumpRest` | float | Pumpenschutz: Zwangspause in s (ab S3 5.4.0) |
 | `cxMaxSecs` | float | Sicherheits-Timeout des Bezugs in s |
 | `cxBlock` | uint8 | Sperrgrund (siehe unten), `0` = frei |
 | `cxNotice` | uint8 | transiente Meldung, `0` = keine (läuft nach ~6 s selbst ab) |
 `cxBlock`: `0` frei, `1` nicht freigeschaltet, `2` Standby, `3` Wartungsmodus,
 `4` Reinigungsassistent, `5` PID-Tuning, `6` Sensorfehler, `7` Wasserkessel zu warm.
 `cxNotice`: `0` keine, `1` Start abgewiesen (Grund steht in `cxBlock`), `2` Bezug wegen
 fehlenden Zulaufs beendet, `3` Umschalten während eines Bezugs abgelehnt, `4` ohne Waage
 aktiviert (ab S3 5.3.4).
 **Ohne Waage** (`scaleEnabled`/`scaleConnected` false) läuft die kalte Extraktion rein
 zeitgesteuert: `cxTarget` ist wirkungslos und die Stillstands-Erkennung ist inaktiv, es
 bleibt `cxMaxSecs` als Ende. Das ist Absicht (ein kurz abgemeldeter HX711 soll die Funktion
 nicht blockieren) und **kein** Sperrgrund — das Display sollte es aber dauerhaft anzeigen.
 Bewusst **Codes statt Klartext**: Die State-Zeile muss unter dem Zeilenlimit des P4 bleiben
 (`PROTO_RX_LINE_MAX`; sie liegt real bereits bei ~2,1 KB), und die Texte gehören ins Display —
 dieselbe Trennung wie bei `statusKey`/`statusText`.
 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.
 ---
@@ -1,3 +1,132 @@
 Version 1.2.0:
 - Neue Seite „Cold Extraction" mit eigenem Menüeintrag (braucht S3-Firmware ab 5.4.0). Dort stehen jetzt
  alle Parameter der kalten Extraktion und lassen sich direkt am Display ändern: Freigabetemperatur,
  Vorbenetzung (Dauer + Pumpenleistung), Hauptbezug (Pulsperiode + Pumpenleistung), Zielgewicht,
  maximale Bezugsdauer sowie der Pumpenschutz. Gespeichert wird über das erweiterte saveBrew-Kommando.
 - Der Modus-Schalter ist von der Temperatur-Seite auf die neue Seite umgezogen (eine Stelle statt zwei).
  Der Knopf „Aufwecken mit Cold Extraction" im Standby-Dialog bleibt unverändert.
 - Brew-Control-Seite neu gegliedert: Statt einer durchlaufenden Liste unter Zwischenüberschriften liegt
  jede Funktion (Pre-Infusion, Brew-by-Time, Brew-by-Weight, Dampf-Timer) jetzt in einer eigenen Karte
  mit Titel und einer Zeile, die erklärt, was sie tut. Die neue Cold-Extraction-Seite nutzt dieselbe
  Gliederung.
 - Eingabefelder werden nur beim Öffnen der Seite aus dem Zustand gefüllt, damit laufende State-Pushes
  eine begonnene Eingabe nicht überschreiben (gleiches Verhalten wie auf der Brew-Control-Seite).
 Version 1.1.3:
 - Aufweck-Dialog hat einen dritten Knopf: „Aufwecken mit Cold Extraction" (braucht S3 ab 5.3.5).
  Er stellt den Modus scharf und beendet erst danach den Standby - in dieser Reihenfolge, damit
  der Wasserkreis gar nicht erst anheizt. Ohne diesen Weg musste man normal aufwecken (Maschine
  heizt an) und den Modus danach umschalten. Der Knopf erscheint nur, wenn die Funktion
  freigeschaltet und umschaltbar ist und der Modus nicht ohnehin schon läuft.
 - Der Schalter „Cold Extraction" auf der Temperatur-Seite hängt jetzt am neuen State-Feld
  cxArmable statt an cxAllowed: umschaltbar auch im Standby und bei warmem Kessel, gesperrt nur
  während eines laufenden kalten Bezugs. Bei älterer S3-Firmware fällt das Feld auf cxEnabled
  zurück, der Schalter bleibt also bedienbar.
 - Erklärzeile im Standby: „Nach dem Aufwecken bleibt der Wasserkreis aus."
 Version 1.1.2:
 - Cold Extraction: Fehlt eine nutzbare Waage, weist das Display jetzt dauerhaft darauf hin.
  Ohne Waage greifen weder Zielgewicht noch Stillstands-Erkennung, der Bezug endet erst nach der
  maximalen Bezugsdauer (braucht S3-Firmware ab 5.3.4).
  - Statuszeile: „Cold Extraction aktiv - ohne Waage, Ende nach Zeit" (gelb) statt des blauen
    Normalhinweises; beim Aktivieren zusätzlich kurz die Meldung zum neuen cxNotice-Code 4.
  - Erklärzeile unter dem Schalter und die Parameter-Anzeige auf der Brew-Seite ergänzen den
    Hinweis; bei aktivem Modus ohne Waage nennt die Zeile die Zeit statt des Zielgewichts.
 Version 1.1.1:
 - Compiler-Warnungen des P4-Builds aufgeräumt (rein technisch, keine Funktionsänderung):
  - „LV_FS_DEFAULT_DRIVE_LETTER is deprecated": Die Option heißt ab LVGL 9.3
    LV_FS_DEFAULT_DRIVER_LETTER. Der alte Name funktionierte zwar noch, löste aber in
    lv_api_map_v9_1.h ein #warning aus - und zwar in JEDER Übersetzungseinheit, die lvgl.h
    einbindet. Das allein waren rund 60 Warnungen pro Build, die alles andere zugedeckt haben.
    In lv_conf.h umbenannt.
  - „bitwise operation between different enumeration types is deprecated": LV_PART_* und
    LV_STATE_* sind in LVGL 9 zwei verschiedene Enum-Typen; sie direkt mit | zu verknüpfen ist
    in C++20 abgekündigt. Neues Makro TH_SEL(part, state) in theme.h castet beide auf
    lv_style_selector_t (ohnehin uint32_t). Betraf 5 Stellen in ui.cpp und theme.h.
 - Bug-Fix: Der Puffer für die Cold-Extraction-Infozeile auf der Brew-Seite war mit 192 Bytes
  zu klein - der Text ist rund 205 Zeichen lang (das „°" zählt als zwei Bytes), die letzte
  Zeile wurde also abgeschnitten. Jetzt 256 Bytes.
 Version 1.1.0:
 - Cold Extraction am Display bedienbar (braucht S3-Firmware ab 5.3.2):
  - Neuer Schalter „Cold Extraction" auf der Seite „Temperaturen" unter „Modi", darunter eine
    Erklärzeile mit dem aktuellen Zustand bzw. dem Sperrgrund. Schalter und Zeile bleiben
    unsichtbar, solange die S3 die Funktion nicht freigeschaltet meldet (auch bei älterer
    S3-Firmware, die die Felder gar nicht sendet).
  - Einschalten ist nur bei erteilter Freigabe möglich (Wasserkessel kalt genug, kein Standby /
    Wartung / Tuning); ausschalten immer, außer während eines laufenden kalten Bezugs. Gesendet
    wird gezielt startColdExtraction/stopColdExtraction statt eines Toggles, damit ein
    abgewiesener Befehl den Schalter nicht in einen nie bestätigten Zustand bringt.
  - Statuszeile: eigener Slot direkt hinter der Sicherheitsmeldung. Zeigt dauerhaft
    „Cold Extraction aktiv - Wasserkreis heizt nicht", bei fehlender Freigabe den Grund,
    während der Pumpen-Zwangspause den Pumpenschutz und transient einen abgewiesenen Start
    bzw. einen Abbruch wegen fehlenden Zulaufs.
  - Wasser-Kachel im Dashboard zeigt bei aktivem Modus „Cold Extraction - Heizen aus" statt
    eines Sollwerts, der nicht erreicht wird; der Aufheiz-Countdown ist dann unterdrückt.
  - Phasenleiste und Live-Bezugsschirm benennen die erste Phase eines kalten Bezugs
    „Vorbenetzung" (keine Pause-Phase) und zeigen die Pumpenpause an.
  - Brew-Seite: Cold-Extraction-Parameter als Anzeige (Freigabeschwelle, Vorbenetzung,
    Zielgewicht, Timeout) mit Hinweis, dass sie in der Web-UI eingestellt werden.
  - Statistik-Seite: kalte Bezüge sind mit „(kalt)" markiert und gehen nicht in die mittlere
    Bezugsdauer ein - gleiche Regel wie in der S3-Statistik.
 - Bug-Fix: Das Limit für eingehende UART-Zeilen (PROTO_RX_LINE_MAX) lag bei 2048 Bytes, während
  die State-Zeile der S3 bereits rund 2,1 KB erreicht - mit langem Status-, Profil- oder
  SSID-Text konnte sie darüber liegen. In dem Fall wurde die GANZE Zeile verworfen und das
  Display fror auf dem letzten Stand ein, ohne dass die Verbindung als tot erkannt wurde.
  Das Limit ist jetzt 4096 Bytes; der RX-Puffer selbst bleibt bei 2 KB reserviert, weil der
  interne RAM knapp ist und eine Arduino-String nicht ins PSRAM alloziert werden kann.
 Version 1.0.13:
 - Profil-Schnellwahl + Anzeige des aktiven Profils (braucht S3-Firmware ab 5.1.1):
  - Neuer Profil-Chip im Header (auf allen Seiten sichtbar): zeigt das zuletzt geladene bzw.
    gespeicherte Profil; ein „*" hinter dem Namen bedeutet, dass seitdem profil-relevante
    Einstellungen geändert wurden. Lange Namen werden gekürzt; ohne bekanntes Profil
    (oder mit älterer S3-Firmware) bleibt der Chip unsichtbar.
  - Antippen des Chips öffnet die Profil-Schnellwahl: ein Overlay mit allen gespeicherten
    Profilen, das aktive mit Häkchen und Akzentfarbe hervorgehoben. Ein Tap lädt das Profil
    direkt (Toast bestätigt, Chip aktualisiert sich mit dem nächsten State) — zwei Berührungen
    vom Dashboard zum Profilwechsel statt Umweg über die Profile-Seite.
  - Profile-Seite: das aktive Profil wird in der Liste mit Häkchen-Symbol und Akzentfarbe
    markiert.
 Version 1.0.12:
 - Verlauf-Chart: Flackernde Heizleistungs-Kurven in den großen Zeitfenstern behoben. Die
  Dezimierung pickte pro Chart-Punkt ein Einzelsample, dessen Abtast-Raster mit jedem
  Sekundentick um eine Position wanderte — die schnell schaltende Heizleistung (PWM)
  sprang dadurch sichtbar zwischen zwei Kurvenbildern hin und her. Jetzt wird über den
  gesamten Zeitabschnitt eines Chart-Punkts gemittelt: das Bild steht ruhig, und die
  Leistungs-Kurve zeigt die tatsächliche mittlere Heizleistung statt zufälliger
  Momentwerte. Im 2-min-Fenster (1 Sample je Punkt) ändert sich nichts.
 Version 1.0.11:
 - Verlauf-Seite ausgebaut (nur P4, keine S3-/Protokolländerung nötig):
  - Umschaltbares Zeitfenster: Buttons „2 min / 10 min / 30 min / 60 min" in der Kopfzeile.
    Intern läuft eine 1-s-Historie als Ringpuffer über volle 60 Minuten; das Chart zeigt
    weiterhin 120 Punkte und dezimiert je Fenster. Dadurch ist beim Fensterwechsel der
    komplette Verlauf sofort da (kein leeres Chart, kein Neuaufbau). Die Wahl wird P4-lokal
    im NVS gespeichert und überlebt Neustarts.
  - Gestrichelte Soll-Linien für Wasser und Dampf im Chart (Farbe der jeweiligen Kurve,
    gedimmt). Die Y-Skala bezieht die Soll-Werte mit ein, damit die Linien im Bild liegen —
    aber nur für Kreise, deren Ist-Kurve im Fenster sichtbar ist (ein kalter Dampfkessel
    zieht die Skala nicht auseinander).
  - Heizleistung zuschaltbar: Button „Leistung" blendet Duty-Cycle Wasser/Dampf als gedimmte
    Zusatzkurven auf einer zweiten Achse (0–100 %) ein, inkl. Live-Legende. Einstellung
    ebenfalls P4-lokal im NVS.
  - Feinere Kurven: Die Temperatur-Historie wird jetzt in Zehntelgrad geführt und gezeichnet
    (vorher ganzzahlig gerundet) — PID-Schwingungen um ±1 °C sind damit sauber ablesbar.
  - Die ~29 KB Historie liegen im PSRAM (heap_caps_malloc, wie die LVGL-Framebuffer) —
    als statische Arrays sprengten sie den internen RAM (Linker: 107 % belegt).
 - Shot-Zusammenfassung: Karte auf 560 px verbreitert und Spaltenabstand zwischen
  Dauer/Gewicht/Flow deutlich vergrößert (28 px statt 10 px) — die drei Werte standen
  zu nahe beisammen und waren schlecht lesbar.
 - PID-AutoTune sichtbar gemacht: Während eines Tuning-Laufs erscheint auf der Verlauf-Seite
  eine Live-Karte (mit Spinner) — je Kreis Laufzeit, aktuelle Phase (heizt/kühlt ab) und
  Schwingungshub samt Mittelpunkt (Min/Max der Ist-Temperatur seit Start). Nach dem Ende
  zeigt die Karte ~30 s das Ergebnis (Erfolg/Abbruch samt Grund, farbcodiert). Die
  PID-Tuning-Meldung in der Statuszeile ist jetzt antippbar und springt zur Verlauf-Seite,
  wo die Schwingung auch als Kurve zu sehen ist.
 Version 1.0.10:
 - Live-Bezugsschirm (abschaltbar): Beim Start eines echten Bezugs blendet sich ein Vollbild-Overlay
  weich ein — große Bezugszeit, Live-Gewicht und Flow samt Flow-Verlaufskurve der letzten 30 Sekunden
@@ -65,13 +65,16 @@
 // -------------------------------------------------------------------------------------
 //  Firmware
 // -------------------------------------------------------------------------------------
-#define DISPLAY_FW_VERSION       "1.0.10"   // Firmware-Stand der P4-Display-Steuerung (Info-Seite)
+#define DISPLAY_FW_VERSION       "1.2.0"   // Firmware-Stand der P4-Display-Steuerung (Info-Seite)
 // -------------------------------------------------------------------------------------
 //  Protokoll
 // -------------------------------------------------------------------------------------
 #define PROTO_EXPECTED_VERSION   2      // muss zur S3-Firmware passen (TOUCH_UART_PROTOCOL_VERSION)
-#define PROTO_RX_LINE_MAX        2048   // max. eingehende Zeilenlaenge (Bytes)
+// Die State-Zeile der S3 kann mit langem Status-/Profil-/SSID-Text ueber 2 KB gehen. Wird
 // das Limit erreicht, verwirft der Client die GANZE Zeile und das Display friert auf dem
 // letzten Stand ein -> Reserve deutlich groesser als der reale Bedarf (~2,3 KB).
 #define PROTO_RX_LINE_MAX        4096   // max. eingehende Zeilenlaenge (Bytes)
 #define PROTO_HEARTBEAT_MS       5000   // Intervall fuer 'ping' (S3-Timeout = 15 s)
 #define PROTO_HELLO_RETRY_MS     2000   // erneuter 'hello'-Versuch, solange nicht verbunden
 #define PROTO_LINK_TIMEOUT_MS    8000   // ohne empfangene Nachricht -> Verbindung gilt als tot
@@ -727,7 +727,10 @@
 /*File system interfaces for common APIs */
 /*Setting a default driver letter allows skipping the driver prefix in filepaths*/
-#define LV_FS_DEFAULT_DRIVE_LETTER '\0'
+/* Ab LVGL 9.3 heisst die Option LV_FS_DEFAULT_DRIVER_LETTER. Der alte Name wird zwar noch
   uebersetzt, loest aber in lv_api_map_v9_1.h ein #warning aus - und zwar in JEDER
   Uebersetzungseinheit, die lvgl.h einbindet (~60 Warnungen pro Build). */
 #define LV_FS_DEFAULT_DRIVER_LETTER '\0'
 /*API for fopen, fread, etc*/
 #define LV_USE_FS_STDIO 0
@@ -50,6 +50,8 @@ struct MachineState {
    long   heatUpRemainSec = -1;         // verbleibende Sekunden bis "durchgewaermt" (-1 = aus)
    bool   lightOn = false;
    bool   piezoEnabled = false;
    String activeProfile;          // zuletzt geladenes/gespeichertes Profil (leer = keines; seit S3 5.1.1)
    bool   profileDirty = false;   // Einstellungen weichen seit dem Laden vom Profil ab
    // --- Waage ---
    float weight = 0, targetWeight = 0;
@@ -66,6 +68,30 @@ struct MachineState {
    float bbwTarget = 0, bbwOffset = 0;
    uint8_t piState = 0;           // Pre-Infusion-Phase (0=inaktiv,1=Pre-Infusion,2=Pause,3=Hauptbezug; seit S3 5.0.12)
    // --- Cold Extraction (kalte Extraktion; seit S3 5.3.0) ---
    bool  cxEnabled = false;       // Funktion auf der S3 freigeschaltet (sonst Bedienelement ausblenden)
    bool  cxActive = false;        // Modus scharf: Wasserkreis heizt nicht (persistent, seit S3 5.3.1)
    bool  cxShot = false;          // der laufende Bezug ist eine kalte Extraktion
    bool  cxAllowed = false;       // Bezug jetzt moeglich (Wasserkessel kalt genug, kein Standby/Wartung/Tuning)
    bool  cxArmable = false;       // Modus umschaltbar - auch im Standby und bei warmem Kessel (seit S3 5.3.5)
    bool  cxResting = false;       // Zwangspause des Pumpenschutzes laeuft (Bezug laeuft weiter)
    float cxMaxTemp = 0;           // Freigabeschwelle in C
    float cxTarget = 0;            // Zielgewicht in g
    float cxPreInfSec = 0;         // Vorbenetzung in s (fuer die Phasenleiste des kalten Bezugs)
    // Restliche Parameter fuer die Einstellseite am Display (seit S3 5.4.0)
    float    cxPreInfDuty = 0;     // Pumpenleistung Vorbenetzung in %
    float    cxDuty = 0;           // Pumpenleistung Hauptbezug in %
    uint16_t cxPulseMs = 0;        // Pulsperiode in ms
    float    cxPumpMaxRun = 0;     // Pumpenschutz: max. kumulierte Laufzeit in s
    float    cxPumpRest = 0;       // Pumpenschutz: Zwangspause in s
    float cxMaxSecs = 0;           // Sicherheits-Timeout des Bezugs in s
    // Sperrgrund: 0=frei, 1=nicht freigeschaltet, 2=Standby, 3=Wartung, 4=Reinigungsassistent,
    // 5=PID-Tuning, 6=Sensorfehler, 7=Wasserkessel zu warm
    uint8_t cxBlock = 0;
    // Transiente Meldung: 0=keine, 1=Start abgewiesen, 2=Bezug ohne Zulauf beendet,
    // 3=Umschalten waehrend eines Bezugs abgelehnt
    uint8_t cxNotice = 0;
    // --- Gehaeusesensor ---
    bool    caseSensorEnabled = false;
    bool    caseTempDashboard = false;
@@ -16,6 +16,10 @@ void ProtocolClient::begin() {
    DISPLAY_UART_PORT.setRxBufferSize(2048);
    DISPLAY_UART_PORT.begin(DISPLAY_UART_BAUDRATE, SERIAL_8N1,
                            DISPLAY_UART_RX_PIN, DISPLAY_UART_TX_PIN);
    // Bewusst NICHT auf PROTO_RX_LINE_MAX (4 KB) reserviert: Der interne RAM ist knapp
    // (statisch ~98 %), und eine Arduino-String kann nicht ins PSRAM alloziert werden.
    // 2 KB deckt die reale State-Zeile (~2,1 KB) fast vollstaendig ab; der Rest waechst
    // in kleinen Schritten nach. Das Limit dient nur als Obergrenze gegen Muell/Overflow.
    _rxBuf.reserve(2048);
    _lastHelloMs = 0;
    _lastHeartbeatMs = 0;
@@ -192,6 +196,8 @@ void ProtocolClient::applyState(const String& json) {
    s.heatUpRemainSec    = doc["heatUpRemainSec"]    | (long)-1;
    s.lightOn            = doc["lightOn"]            | false;
    s.piezoEnabled       = doc["piezoEnabled"]       | false;
    s.activeProfile      = String((const char*)(doc["profile"] | ""));   // fehlt bei aelterer S3-FW -> leer
    s.profileDirty       = doc["profDirty"]          | false;
    s.weight        = doc["weight"]        | s.weight;
    s.targetWeight  = doc["targetWeight"]  | s.targetWeight;
@@ -214,6 +220,26 @@ void ProtocolClient::applyState(const String& json) {
    s.bbwTarget  = doc["bbwTarget"]  | s.bbwTarget;
    s.bbwOffset  = doc["bbwOffset"]  | s.bbwOffset;
    // Cold Extraction (fehlt bei S3-FW < 5.3.0 -> cxEnabled bleibt false, UI blendet alles aus)
    s.cxEnabled  = doc["cxEnabled"]  | false;
    s.cxActive   = doc["cxActive"]   | false;
    s.cxShot     = doc["cxShot"]     | false;
    s.cxAllowed  = doc["cxAllowed"]  | false;
    // Fehlt bei S3-FW < 5.3.5 -> auf cxEnabled zurueckfallen, sonst waere der Schalter tot
    s.cxArmable  = doc["cxArmable"]  | (doc["cxEnabled"] | false);
    s.cxResting  = doc["cxResting"]  | false;
    s.cxMaxTemp  = doc["cxMaxTemp"]  | s.cxMaxTemp;
    s.cxTarget   = doc["cxTarget"]   | s.cxTarget;
    s.cxPreInfSec= doc["cxPreInf"]   | s.cxPreInfSec;
    s.cxPreInfDuty = doc["cxPreInfDuty"] | s.cxPreInfDuty;
    s.cxDuty       = doc["cxDuty"]       | s.cxDuty;
    s.cxPulseMs    = doc["cxPulseMs"]    | s.cxPulseMs;
    s.cxPumpMaxRun = doc["cxPumpMaxRun"] | s.cxPumpMaxRun;
    s.cxPumpRest   = doc["cxPumpRest"]   | s.cxPumpRest;
    s.cxMaxSecs  = doc["cxMaxSecs"]  | s.cxMaxSecs;
    s.cxBlock    = doc["cxBlock"]    | (uint8_t)0;
    s.cxNotice   = doc["cxNotice"]   | (uint8_t)0;
    s.caseSensorEnabled = doc["caseSensorEnabled"] | false;
    s.caseTempDashboard = doc["caseTempDashboard"] | false;
    s.caseSensorType    = doc["caseSensorType"]    | 0;
@@ -25,6 +25,11 @@
 #define COL_BORDER    lv_color_hex(0x555555)
 #define COL_INPUT_BG  lv_color_hex(0x101010)
 // Style-Selektor aus Part + State. LV_PART_* und LV_STATE_* sind in LVGL 9 zwei
 // verschiedene Enum-Typen; sie direkt mit | zu verknuepfen ist in C++20 deprecated
 // (-Wdeprecated-enum-enum-conversion). Der Zieltyp ist ohnehin uint32_t.
 #define TH_SEL(part, state) ((lv_style_selector_t)(part) | (lv_style_selector_t)(state))
 // ---- Karte (dunkel, abgerundet) ----
 static inline lv_obj_t* th_card(lv_obj_t* parent) {
    lv_obj_t* c = lv_obj_create(parent);
@@ -61,7 +66,7 @@ static inline lv_obj_t* th_textarea(lv_obj_t* parent, bool oneLine) {
    lv_textarea_set_one_line(ta, oneLine);
    lv_obj_set_style_bg_color(ta, COL_INPUT_BG, 0);
    lv_obj_set_style_border_color(ta, COL_BORDER, 0);
-    lv_obj_set_style_border_color(ta, COL_ACCENT, LV_PART_MAIN | LV_STATE_FOCUSED);
+    lv_obj_set_style_border_color(ta, COL_ACCENT, TH_SEL(LV_PART_MAIN, LV_STATE_FOCUSED));
    lv_obj_set_style_border_width(ta, 1, 0);
    lv_obj_set_style_radius(ta, 8, 0);
    lv_obj_set_style_text_color(ta, COL_TEXT, 0);