fix(P4): Anlaufzeit des Displaymoduls abwarten (1.6.18)

Entscheidender Hinweis vom Gerät: "Sobald der serielle Monitor läuft,
startet es fast immer einwandfrei." Dessen USB-Anmeldung verzögert den
Start - und ersetzte damit unbeabsichtigt eine Wartezeit, die der
Werks-Testsketch explizit hat: delay(2000) am Anfang von setup().

Unsere Firmware sprach Bridge und Panel sofort nach dem Einschalten an.
Das Displaymodul ist dann noch nicht bereit: Die Bridge nimmt ihre
Register nicht an oder das Panel zeigt trotz korrekt gesendeter DSI-Daten
nichts - beides ohne Fehlermeldung, weil aus Sicht des P4 jeder Schritt
geklappt hat. Daher das sprunghafte Verhalten und der Fehlstart beim
ersten Anstecken.

jc_board_bringup() wartet für WS_PANEL_7H jetzt WS7_PANEL_WARMUP_MS
(Vorgabe 2000 ms), bevor es beginnt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01P7JsiDJ1QbNFLDz5chf8Jt

P4_Display_Firmware/Changelog.txt

@@ -1,3 +1,186 @@
+Version 1.6.18:
+- Ursache des unzuverlässigen Starts gefunden: Der P4 sprach Bridge und Panel sofort nach
+  dem Einschalten an. Das Displaymodul braucht danach aber einen Moment, bis es bereit ist.
+  Kam der Hochlauf zu früh, nahm die Bridge ihre Register nicht an oder das Panel zeigte
+  trotz korrekt gesendeter DSI-Daten nichts - beides ohne Fehlermeldung, weil aus Sicht des
+  P4 jeder Schritt geklappt hatte. Das Ergebnis war ein Display, das mal ansprang und mal
+  nicht, und beim ersten Anstecken meist gar nicht.
+- Der Hochlauf wartet jetzt WS7_PANEL_WARMUP_MS (Vorgabe 2000 ms), bevor er beginnt. Der
+  Werks-Testsketch wartet aus demselben Grund 2 Sekunden am Anfang.
+- Damit erklärt sich auch, warum es mit geöffnetem seriellen Monitor fast immer klappte:
+  Dessen USB-Anmeldung verzögert den Start und ersetzte damit unbeabsichtigt die Wartezeit.
+- Der Wert steht in pins_config.h. Läuft der Start zuverlässig, lässt er sich vorsichtig
+  senken; springt die Anzeige nicht an, ist er der erste Wert zum Erhöhen.
+
+Version 1.6.17:
+- Der I2C-Stoerimpulsfilter aus 1.6.16 wirkt: Nach dem Panel-Start melden sich wieder alle
+  drei Bausteine, Bridge und Touch bleiben ansprechbar.
+- Das Pruefbild aus 1.6.15 war allerdings wirkungslos und damit als Test untauglich: Es
+  wurde zwar gesetzt, doch unmittelbar danach startete LVGL und schrieb in den Bildspeicher,
+  womit das Pruefbild wieder verschwand. Der Test sah deshalb genauso aus wie der Fehler,
+  den er finden sollte.
+- Mit WS7_TEST_PATTERN = 1 endet der Hochlauf jetzt direkt nach dem Pruefbild: Beleuchtung
+  an, Farbbalken stehen, kein LVGL. Damit ist die Frage eindeutig zu beantworten, ob die
+  Anzeigekette bis zum Panel arbeitet.
+
+Version 1.6.16:
+- Ursache des schwarzen Bildes gefunden. Der Start-Log zeigte es eindeutig: Vor dem
+  Panel-Start meldeten sich alle drei I2C-Bausteine (Touch 0x14, Audio 0x18, Bridge 0x45),
+  danach nur noch der Audio-Baustein. Es fielen also genau die beiden weg, die am
+  Displaykabel haengen - der Bus selbst arbeitete weiter. Sobald die DSI-Ausgabe laeuft,
+  stoeren deren schnelle Signale auf das lange Flachbandkabel ein, und ohne Filterung
+  bringen diese Stoerspitzen die I2C-Uebertragung aus dem Tritt. Die Bridge liess sich
+  daraufhin nicht mehr ansprechen, das Panel blieb dunkel.
+- Der I2C-Bus laeuft fuer das Waveshare-Panel jetzt mit Stoerimpulsfilter und internen
+  Abschlusswiderstaenden, so wie es auch das Waveshare-Beispiel tut. Beides fehlte, weil
+  die Bus-Einrichtung urspruenglich von den JC-Panels uebernommen wurde, die kein
+  Flachbandkabel dieser Laenge haben.
+- Das erklaert rueckwirkend auch, warum sich der Fehler so sprunghaft verhielt: Ob eine
+  Uebertragung durchkam, hing von der Stoerlage ab.
+
+Version 1.6.15:
+- Diagnose fuer das schwarze Bild, das der Log bisher nicht erklaeren konnte: Alle Schritte
+  liefen fehlerfrei durch, trotzdem blieb die Anzeige leer.
+- Die drei Weckbefehle an das Panel (MADCTL, Sleep Out, Display On) liefen bislang
+  ungeprueft durch und sind jetzt in die Fehlerausgabe einbezogen.
+- Neuer Schalter WS7_TEST_PATTERN in pins_config.h: zeigt statt der Oberflaeche
+  Prueffarbbalken an. Sie entstehen im DSI-Baustein selbst und benutzen weder Bildspeicher
+  noch LVGL. Damit laesst sich in einem Durchgang trennen, ob die Anzeigekette bis zum
+  Panel arbeitet oder ob der Fehler weiter oben liegt.
+- Das Ende des Hochlaufs wird gemeldet ("Bringup fertig" / "LVGL laeuft"). Bisher endete
+  die Ausgabe nach dem Panel-Start, und ein Haengenbleiben in LVGL war von einem
+  fehlenden Bild nicht zu unterscheiden.
+
+Version 1.6.14:
+- Der Touch-Controller wird jetzt erst angesprochen, nachdem die Bridge freigegeben und die
+  Hintergrundbeleuchtung eingeschaltet ist. Der GT9271 haengt an derselben Versorgung und
+  antwortet vorher nicht auf I2C - deshalb schlug seine Initialisierung bisher schon beim
+  Kaltstart fehl. In der Werks-Testskizze steht die Touch-Initialisierung aus demselben
+  Grund hinter dem Einschalten der Beleuchtung; beim Uebertragen in die Firmware war diese
+  Reihenfolge verloren gegangen.
+- Die Wartezeit dazwischen steht als WS7_TOUCH_POWER_MS in pins_config.h (Vorgabe 120 ms).
+- Neu im Start-Log: eine Liste aller Bausteine am I2C-Bus, einmal vor und einmal nach dem
+  Panel-Start. Erwartet werden 0x45 (Bridge) und 0x14 (Touch). Damit ist auf einen Blick zu
+  sehen, ob ein Baustein gar nicht antwortet, statt aus Treiberfehlern raten zu muessen.
+
+Version 1.6.13:
+- Ursache des schwarzen Bildes gefunden: ein haengender I2C-Bus. Trifft ein Reset des P4
+  mitten in eine laufende Uebertragung, bleibt der angesprochene Baustein in seiner
+  Bitausgabe stehen und haelt die Datenleitung dauerhaft auf Masse. Damit schlaegt jede
+  weitere Uebertragung fehl. Bridge und Touch-Controller haengen an Dauerstrom, weshalb
+  dieser Zustand jeden Reset und sogar das Flashen ueberlebt - nur echtes Stromabziehen
+  loest ihn. Die Folge: Die Bridge wird nie initialisiert, das Bild bleibt schwarz, und
+  weil sie ihre Register behaelt, brennt die Hintergrundbeleuchtung weiter.
+- Vor dem Anlegen des I2C-Busses wird die Taktleitung jetzt von Hand getaktet, bis der
+  Baustein die Datenleitung freigibt, danach folgt eine Stopp-Bedingung. Das ist der in
+  der I2C-Spezifikation vorgesehene Weg und laeuft bei freiem Bus wirkungslos durch.
+- Fehlerbehebung: Schreibzugriffe auf die Bridge liefen stillschweigend ins Leere. Genau
+  deshalb war der Fehler so schwer zu finden - das Bild blieb ohne jeden Hinweis schwarz.
+  Sie melden Fehler jetzt im Klartext.
+- Fehlerbehebung: In pins_config.h stand seit 1.6.10 "#elsealle" statt "#else". Der
+  Tippfehler traf nur den Zweig des 4,3-Zoll-Panels, das damit nicht mehr uebersetzbar war.
+  Beide Panel-Varianten sind jetzt wieder gegengebaut.
+
+Version 1.6.12:
+- Die Abschaltfolge für die Bridge aus 1.6.11 ist zurückgenommen. Sie hat den Fehler nicht
+  behoben, sondern verschlimmert: Nach dem Nullsetzen von C0/C2/AC kam das Panel auch
+  direkt nach dem Flashen nicht mehr hoch, die normale Einschaltfolge holt es aus diesem
+  Zustand nicht zurück. Der Start entspricht damit wieder 1.6.10.
+- Stattdessen zwei Diagnosen, um die Ursache des schwarzen Bildes nach einem Reset
+  einzugrenzen: Der Startgrund wird beim Hochlauf ausgegeben (1 = Kaltstart, alles andere
+  Warmstart), und das Anfordern der Stromversorgung für die MIPI-Strecke wird jetzt auf
+  Fehler geprüft - bislang lief dieser Schritt als einziger ungeprüft durch.
+
+Version 1.6.10:
+- WS7_PARTIAL_REFRESH ist jetzt auch im Auslieferungsstand 1. Am Gerät geprüft: kein
+  Flackern, und der Gewinn ist der größte der drei Tempo-Maßnahmen - vor allem während
+  eines Bezugs, wo die Zeitanzeige zehnmal je Sekunde weiterläuft.
+- Der Hintergrund der Seiten ist deckend statt durchsichtig. Sichtbar ändert sich nichts,
+  die Ebenen darunter haben dieselbe Farbe; LVGL muss sie beim Scrollen aber nicht mehr
+  mitzeichnen und durchmischen.
+- Neuer Schalter WS7_PERF_MONITOR in pins_config.h: blendet unten rechts Bilder je Sekunde
+  und Prozessorlast ein. Damit lässt sich beantworten, ob weitere Mühe beim Zeichnen
+  überhaupt noch etwas bringt, statt ins Blaue zu optimieren.
+
+Version 1.6.9:
+- Fehlerbehebung: Ein Tipp auf einen Knopf löste oft mehrfach aus. Der GT9271 lässt
+  gelegentlich einen Messzyklus aus oder liefert ein unplausibles Paket; der
+  Hersteller-Treiber kann "gerade nichts Neues" nicht von "Finger weg" unterscheiden und
+  meldet beides als losgelassen. Seit die Oberfläche mit 1.6.8 doppelt so oft abtastet,
+  wurde daraus sichtbar Drücken-Loslassen-Drücken-Loslassen.
+- Vor den Treiber ist deshalb ein Filter gesetzt: Er verwirft unplausible Rohwerte und hält
+  den letzten gültigen Berührpunkt noch WS7_TOUCH_HOLD_MS lang (Vorgabe 40 ms). Losgelassen
+  wird erst gemeldet, wenn wirklich nichts mehr kommt. Der Wert steht in pins_config.h;
+  0 schaltet die Überbrückung ab. Zu groß gewählt verzögert er das Loslassen und dämpft
+  den Schwung beim Wischen.
+- Der Filter hängt sich zur Laufzeit in den Treiber ein, die Herstellerdateien bleiben
+  unverändert.
+
+Version 1.6.8:
+- Scrollen und Wischen laufen am Waveshare-Panel flüssiger: LVGL rechnet dort jetzt im
+  16-Millisekunden-Takt statt alle 33 ms. Dieser Wert steuert nicht nur die Bildrate,
+  sondern auch, wie oft der Touch abgetastet und wie fein eine Animation gerechnet wird -
+  mit 30 Schritten je Sekunde war vor allem das Ziehen mit dem Finger sichtbar ruckelig.
+  Das Panel läuft mit 60 Hz, mehr als 16 ms bringt also nichts.
+- Kommt das Zeichnen einmal nicht hinterher, wird ein Bild später fertig; kaputt geht
+  dabei nichts. Die JC-Panels bleiben bei 33 ms.
+
+Version 1.6.7:
+- Der Menue-Knopf oben links fängt Tipps jetzt auch knapp daneben ab. Mit 48x36 Pixeln war
+  er auf dem 7-Zoll-Panel ein sehr kleines Ziel; gemessen wurde ein Fehlgriff von rund
+  10 Pixeln neben der Fläche, weshalb sich das Menü scheinbar nicht öffnen ließ. Optisch
+  bleibt der Knopf unverändert, die Trefferfläche wächst um 20 Pixel nach allen Seiten.
+  Sie wirkt nur innerhalb der Kopfleiste - dem Seiteninhalt darunter wird nichts genommen.
+- Die Touch-Zuordnung selbst war korrekt: Eine Messung mit WS7_TOUCH_DEBUG hat gezeigt,
+  dass Achsen und Spiegelung stimmen.
+
+Version 1.6.6:
+- Neuer Schalter WS7_TOUCH_DEBUG in pins_config.h: Auf 1 gesetzt, gibt jeder Berührpunkt
+  seine Rohwerte und die daraus errechnete Bildposition auf der seriellen Konsole aus.
+  Gedacht zum Einmessen des Touch, wenn Bedienelemente nicht reagieren - insbesondere am
+  oberen Bildrand, wo die 44 Pixel hohe Kopfleiste sitzt.
+
+Version 1.6.5:
+- Zwei der drei Tempo-Maßnahmen aus 1.6.4 haben sich am Gerät als untauglich erwiesen und
+  stehen wieder auf ihrem alten Wert. Sie bleiben als Schalter erhalten, mit Notiz, woran
+  sie gescheitert sind.
+  * WS7_COLOR_BITS wieder 24: Die Bridge dieses Panels nimmt kein RGB565 an, mit 16 Bit
+    kommt kein brauchbares Bild.
+  * WS7_PARTIAL_REFRESH wieder 0: Der Menü-Vorhang ließ sich nicht mehr öffnen. Er ist
+    halbtransparent und wird deshalb in den gerade aktiven Bildpuffer eingemischt; die
+    nächste Zustandsmeldung der S3 zeichnet aber in den zweiten Puffer, der ihn nie
+    bekommen hat - der Vorhang war also sofort wieder weg. Nutzbar wäre der Modus erst,
+    wenn der LVGL-Port die geänderten Bereiche zwischen beiden Puffern abgleicht.
+- WS7_PARALLEL_RENDER bleibt eingeschaltet: LVGL zeichnet weiterhin mit zwei Threads auf
+  beiden Prozessorkernen. Von den drei Maßnahmen trägt nur diese.
+
+Version 1.6.4:
+- Waveshare 7" (H): Drei Maßnahmen gegen die träge Bedienung am großen Panel. 1280x720
+  sind 2,4-mal so viele Pixel wie beim 4,3-Zöller, und bis 1.6.3 wurde bei jeder Änderung
+  das komplette Bild in 24 Bit neu gezeichnet.
+  * Farbtiefe RGB565 statt RGB888 (WS7_COLOR_BITS): halbiert die Datenmenge je Bild.
+    Feinere Farbabstufungen entfallen, sichtbar allenfalls in den dunklen Verläufen der
+    Rundanzeige - die JC-Panels laufen seit jeher so.
+  * Nur geänderte Bildbereiche neu zeichnen statt des ganzen Bildes
+    (WS7_PARTIAL_REFRESH, LVGL-Direct-Mode mit zwei Puffern). Eine sich ändernde
+    Temperaturanzeige kostet damit ein paar tausend statt 921.600 Pixel.
+  * LVGL zeichnet mit zwei Threads auf beiden Prozessorkernen (WS7_PARALLEL_RENDER).
+- Jeder der drei Schalter steht in pins_config.h und lässt sich einzeln zurückstellen;
+  die README nennt zu jedem, woran man erkennt, dass er zurück muss. Die JC-Panels sind
+  von allen dreien nicht betroffen.
+- Nebeneffekt: Der Framebuffer-Bedarf sinkt von rund 8,3 MB auf 3,7 MB PSRAM.
+
+Version 1.6.3:
+- Waveshare ESP32-P4-Pico: UART zur Hauptplatine liegt jetzt auf TX = GPIO20 und
+  RX = GPIO21 (vorher GPIO17/GPIO18). Die JC-Panels bleiben bei GPIO33/GPIO31.
+- Das Bild steht in der tatsächlichen Einbaulage richtig herum, die 180-Grad-Drehung aus
+  1.6.1 ist deshalb wieder abgeschaltet (WS7_ROTATE_180 = 0). Sie bleibt als Schalter
+  erhalten, falls das Panel später anders montiert wird.
+- Der Touch war dagegen oben/unten spiegelverkehrt: Der Digitizer sitzt gegenüber dem Bild
+  um die Hochachse gedreht. WS7_TOUCH_MIRROR_RAW_X steht dafür jetzt auf 1. Bild- und
+  Touch-Ausrichtung sind damit zwei getrennte Schalter, weil sie an diesem Panel eben
+  nicht zusammenfallen.
+
 Version 1.6.2:
 - Kommt das Panel nicht hoch, stürzt der P4 nicht mehr wortlos ab. Die Bringup-Schritte
   melden ihren Fehler jetzt im Klartext auf der seriellen Konsole (auch bei abgeschaltetem

P4_Display_Firmware/README.md

@@ -44,15 +44,15 @@ Vendor-Pakete: 4,3" im Ordner `JC4880P443C_I_W/`, 7,0" im Repo-Ordner
 | Haupt-MCU (UI) | ESP32-P4 | ESP32-P4 | ESP32-P4 (32 MB PSRAM, 32 MB Flash) |
 | WLAN/BT (hier ungenutzt) | ESP32-C6 | ESP32-C6 | — (kein Funkmodul) |
 | Display | ST7701, 480×800 IPS, MIPI-DSI | JD9165, 1024×600 IPS, MIPI-DSI | 1280×720 IPS, MIPI-DSI 2 Lanes über Waveshare-Bridge |
-| Farbformat | RGB565 | RGB565 | **RGB888** (Bridge nimmt nichts anderes) |
-| LVGL-Ausrichtung | Rotation **270°** (PPA) → 800×480 | **keine** Rotation, nativ 1024×600 | nativ 1280×720, bei Einbau auf dem Kopf **180°** (PPA) |
+| Farbformat | RGB565 | RGB565 | **RGB888** — die Bridge nimmt kein RGB565 (geprüft) |
+| LVGL-Ausrichtung | Rotation **270°** (PPA) → 800×480 | **keine** Rotation, nativ 1024×600 | **keine** Rotation, nativ 1280×720 |
 | Touch | GT911, I²C SDA=GPIO7 / SCL=GPIO8 | GT911, I²C SDA=GPIO7 / SCL=GPIO8 | **GT9271** (I²C-Adresse **0x14**), SDA=GPIO7 / SCL=GPIO8 |
 | Touch-Rohkoordinaten | 480×800 (= Panelraster) | **800×480** → wird auf 1024×600 skaliert | **720×1280** (Hochformat) → X/Y werden getauscht |
 | LCD-Reset | GPIO5 | **GPIO27** | kein Reset-Pin (macht die Bridge) |
 | Backlight | GPIO23 (LEDC-PWM) | GPIO23 (LEDC-PWM) | **Bridge-Register** auf I²C **0x45** (`AD`/`AB`/`AA`) |
-| Framebuffer (3×) | 3 × 750 KB ≈ 2,3 MB PSRAM | 3 × 1,2 MB ≈ 3,6 MB PSRAM | 3 × 2,8 MB ≈ **8,3 MB** PSRAM |
+| Framebuffer | 3 × 750 KB ≈ 2,3 MB PSRAM | 3 × 1,2 MB ≈ 3,6 MB PSRAM | 3 × 2,8 MB ≈ 8,3 MB PSRAM |
 | Freie Expansion-IO | Stiftleiste **JP1**: GPIO 52/51/50/49/35/34/33/32/31/30/29/28 | FPC 1,0 mm 16-pol. **FPC4**: GPIO 34/33/32/31/30/29/28 · **FPC3**: 48/47/46/45/5/4/3/2 | 40-poliger Header im Raspberry-Pi-Pico-Format; belegt sind I²C (7/8), TF-Karte (9/10/11/12/13/53) und Debug-UART0 (37/38) |
-| UART zur Hauptplatine | TX GPIO33 / RX GPIO31 | TX GPIO33 / RX GPIO31 | **TX GPIO17 / RX GPIO18** |
+| UART zur Hauptplatine | TX GPIO33 / RX GPIO31 | TX GPIO33 / RX GPIO31 | **TX GPIO20 / RX GPIO21** |
 
 ### Waveshare 7" (H) — Besonderheiten des Bringups
 
@@ -68,9 +68,31 @@ Das Panel hängt hinter einer Waveshare-Bridge und braucht **keinen** Hersteller
   `Display On` → DPI-Start → **erst dann** Hintergrundbeleuchtung. Wird das Licht früher
   eingeschaltet, blitzt beim Start Bildrauschen auf.
 - **Einbaulage:** `WS7_ROTATE_180` in [`pins_config.h`](pins_config.h) dreht Bild **und**
-  Touch um 180°, wenn das Panel auf dem Kopf montiert ist (Vorgabe: gedreht). Die Drehung
-  macht der PPA-Grafikbeschleuniger; die Software-Rotation des LVGL-Ports beherrscht nur
-  RGB565 und käme für dieses Panel nicht in Frage.
+  Touch um 180°, falls das Panel auf dem Kopf montiert wird. Vorgabe ist **0** — in der
+  jetzigen Einbaulage steht das Bild richtig herum. Die Drehung macht der
+  PPA-Grafikbeschleuniger; die Software-Rotation des LVGL-Ports beherrscht nur RGB565.
+- **Touch-Spiegelung:** Der Digitizer sitzt gegenüber dem Bild um die Hochachse gedreht.
+  `WS7_TOUCH_MIRROR_RAW_X` steht deshalb auf **1** (dreht oben/unten), unabhängig von der
+  Bilddrehung.
+
+### Waveshare 7" (H) — Tempo-Schalter
+
+1280×720 bedeutet 2,4-mal so viele Pixel wie beim 4,3-Zöller. Drei Schalter in
+[`pins_config.h`](pins_config.h) halten die Bedienung flüssig; jeder ist einzeln
+zurückstellbar, falls er Ärger macht:
+
+| Schalter | Vorgabe | Wirkung | Stand am Gerät |
+|---|---|---|---|
+| `WS7_COLOR_BITS` | `24` | `16` (RGB565) würde die Datenmenge je Bild halbieren. | **Geht an diesem Panel nicht** — die Bridge nimmt nur RGB888 |
+| `WS7_PARTIAL_REFRESH` | `0` | `1` zeichnet nur geänderte Bereiche neu (LVGL-Direct-Mode, zwei wechselnde Puffer). Wäre der größte Gewinn. | **Geht so nicht** — der halbtransparente Menü-Vorhang landet nur in einem der beiden Puffer und ist sofort wieder weg |
+| `WS7_PARALLEL_RENDER` | `1` | LVGL zeichnet mit zwei Threads auf beiden Prozessorkernen. | Aktiv |
+
+> Damit `WS7_PARTIAL_REFRESH` nutzbar würde, müsste der LVGL-Port die geänderten Bereiche
+> zwischen beiden Puffern abgleichen. Die Maschinerie dafür liegt in `lvgl_port_v9.c`,
+> wird aber nur bei gedrehter Ausgabe übersetzt.
+
+Die Farbtiefe muss für Sketch **und** LVGL-Bibliothek dieselbe sein; `lv_conf.h` liest
+`WS7_COLOR_BITS` deshalb direkt aus `pins_config.h`.
 
 > Beim 7-Zöller ist die Expansion-IO **kein Stiftleisten-Header**, sondern eine
 > FPC-Buchse (1,0 mm Raster, 16-polig) — für die UART-Verdrahtung wird ein
@@ -90,8 +112,8 @@ Für **beide JC-Panels** dieselben P4-Pins (4,3": Header JP1, Schaltplan
 **Waveshare ESP32-P4-Pico** (40-poliger Header):
 
 ```
-  S3 GPIO43 (TX) ----> P4 GPIO18 (RX)     (DISPLAY_UART_RX_PIN)
-  S3 GPIO44 (RX) <---- P4 GPIO17 (TX)     (DISPLAY_UART_TX_PIN)
+  S3 GPIO43 (TX) ----> P4 GPIO21 (RX)     (DISPLAY_UART_RX_PIN)
+  S3 GPIO44 (RX) <---- P4 GPIO20 (TX)     (DISPLAY_UART_TX_PIN)
   S3 GND        ------ P4 GND
 ```
 > Die rechte JP1-Spalte (`C6_U01TXD`/`C6_I10RXD`/…) gehört zum **ESP32-C6** — nicht

P4_Display_Firmware/board_bringup.c

@@ -29,6 +29,8 @@
 #include "esp_cache.h"
 #include "esp_heap_caps.h"
 #include "esp_rom_sys.h"
+#include "esp_timer.h"
+#include "esp_system.h"
 #include "esp_ldo_regulator.h"
 #include "esp_lcd_panel_io.h"
 #include "esp_lcd_panel_ops.h"
@@ -59,16 +61,92 @@
 #define BSP_LCD_BACKLIGHT                   ((gpio_num_t)LCD_LED)
 #define LCD_LEDC_CH                         LEDC_CHANNEL_0
 
-// Bytes je Pixel im Framebuffer. Das Waveshare-Panel laeuft in RGB888 (LVGL ebenfalls,
-// siehe lv_conf.h), die JC-Panels in RGB565.
+// Bytes je Pixel im Framebuffer. Beim Waveshare-Panel waehlbar ueber WS7_COLOR_BITS
+// (pins_config.h); LVGL rechnet mit derselben Tiefe (lv_conf.h). JC-Panels: RGB565.
 #if JC_PANEL_TYPE == WS_PANEL_7H
-#define BSP_LCD_FB_BYTES_PER_PX             (3)
+#define BSP_LCD_FB_BYTES_PER_PX             (WS7_COLOR_BITS / 8)
 #else
 #define BSP_LCD_FB_BYTES_PER_PX             (2)
 #endif
 
 static i2c_master_bus_handle_t s_i2c_handle = NULL;
 
+#if JC_PANEL_TYPE == WS_PANEL_7H
+// ------------------------------------------------------------------------------------
+//  Haengenden I2C-Bus befreien
+//
+//  Trifft ein Reset des P4 mitten in eine laufende I2C-Uebertragung, bleibt der
+//  angesprochene Baustein in seiner Bitausgabe stehen und haelt die Datenleitung dauerhaft
+//  auf Masse. Der Bus ist damit tot: Jede weitere Uebertragung schlaegt fehl. Da Bridge und
+//  Touch-Controller an Dauerstrom haengen, ueberlebt dieser Zustand jeden Reset und sogar
+//  das Flashen - nur echtes Stromabziehen loest ihn.
+//
+//  Folge: Die Bridge wird nie initialisiert, das Bild bleibt schwarz, und weil sie ihre
+//  Register behaelt, brennt die Hintergrundbeleuchtung weiter. Genau dieses Bild.
+//
+//  Abhilfe ist der uebliche Weg aus der I2C-Spezifikation: Vor dem Anlegen des Busses die
+//  Taktleitung von Hand takten, bis der Baustein sein letztes Bit ausgegeben hat und die
+//  Datenleitung wieder loslaesst, danach eine Stopp-Bedingung erzeugen.
+static void ws7_i2c_bus_recover(void)
+{
+    gpio_config_t io = {
+        .pin_bit_mask = BIT64(BSP_I2C_SDA) | BIT64(BSP_I2C_SCL),
+        .mode = GPIO_MODE_INPUT_OUTPUT_OD,     // offener Kollektor, Zustand lesbar
+        .pull_up_en = GPIO_PULLUP_ENABLE,
+        .pull_down_en = GPIO_PULLDOWN_DISABLE,
+        .intr_type = GPIO_INTR_DISABLE,
+    };
+    gpio_config(&io);
+    gpio_set_level(BSP_I2C_SDA, 1);
+    gpio_set_level(BSP_I2C_SCL, 1);
+    esp_rom_delay_us(10);
+
+    if (gpio_get_level(BSP_I2C_SDA) != 0) {
+        return;                                 // Bus frei - nichts zu tun
+    }
+
+    esp_rom_printf("[Panel] I2C-Bus haengt - wird freigetaktet\n");
+
+    // Bis zu neun Takte: so viele braucht ein Baustein hoechstens, um ein angefangenes
+    // Byte samt Bestaetigungsbit zu Ende zu schieben.
+    for (int i = 0; i < 9 && gpio_get_level(BSP_I2C_SDA) == 0; i++) {
+        gpio_set_level(BSP_I2C_SCL, 0);
+        esp_rom_delay_us(5);
+        gpio_set_level(BSP_I2C_SCL, 1);
+        esp_rom_delay_us(5);
+    }
+
+    // Stopp-Bedingung: Datenleitung geht bei hoher Taktleitung von Masse auf High.
+    gpio_set_level(BSP_I2C_SDA, 0);
+    esp_rom_delay_us(5);
+    gpio_set_level(BSP_I2C_SCL, 1);
+    esp_rom_delay_us(5);
+    gpio_set_level(BSP_I2C_SDA, 1);
+    esp_rom_delay_us(10);
+
+    esp_rom_printf("[Panel] I2C-Bus nach Freitakten: %s\n",
+                   gpio_get_level(BSP_I2C_SDA) ? "frei" : "weiterhin belegt");
+
+    // Pins wieder freigeben, damit der I2C-Treiber sie uebernehmen kann.
+    gpio_reset_pin(BSP_I2C_SDA);
+    gpio_reset_pin(BSP_I2C_SCL);
+}
+
+// Zeigt, welche Bausteine sich am I2C-Bus melden. Erwartet werden 0x45 (Bridge) und
+// 0x14 (GT9271-Touch); 0x18 waere der Audio-Baustein. Fehlt einer, sagt das mehr aus als
+// jede Fehlermeldung des Treibers.
+static void ws7_i2c_scan(const char *wann)
+{
+    esp_rom_printf("[Panel] I2C-Bausteine (%s):", wann);
+    for (uint8_t addr = 1; addr < 127; addr++) {
+        if (i2c_master_probe(s_i2c_handle, addr, 50) == ESP_OK) {
+            esp_rom_printf(" 0x%02X", addr);
+        }
+    }
+    esp_rom_printf("\n");
+}
+#endif  // JC_PANEL_TYPE == WS_PANEL_7H
+
 // Klartext-Meldung auf der seriellen Konsole. Bewusst esp_rom_printf: das laeuft auch bei
 // abgeschaltetem Core-Debug-Level und ohne Heap, also genau dann, wenn es darauf ankommt.
 #define BSP_STEP(call, what)                                                             \
@@ -106,7 +184,13 @@ static void ws7_bridge_write(uint8_t reg, uint8_t value)
 {
     if (s_bridge_handle == NULL) return;
     uint8_t buf[2] = { reg, value };
-    i2c_master_transmit(s_bridge_handle, buf, sizeof(buf), 100);
+    esp_err_t err = i2c_master_transmit(s_bridge_handle, buf, sizeof(buf), 100);
+    if (err != ESP_OK) {
+        // Frueher lief das stillschweigend ins Leere. Schlaegt es fehl, wird die Bridge
+        // nie initialisiert und das Bild bleibt schwarz - ohne jeden Hinweis darauf.
+        esp_rom_printf("[Panel] Bridge-Register 0x%02X liess sich nicht schreiben: %s\n",
+                       reg, esp_err_to_name(err));
+    }
 }
 
 // Bridge am I2C-Bus anmelden und Grundinitialisierung schreiben. Muss VOR dem
@@ -184,6 +268,63 @@ IRAM_ATTR static bool on_vsync(esp_lcd_panel_handle_t panel,
 }
 
 #if JC_PANEL_TYPE == WS_PANEL_7H
+
+// ------------------------------------------------------------------------------------
+//  Aussetzer des GT9271 ueberbruecken
+//
+//  Der Controller laesst gelegentlich einen Messzyklus aus und liefert ab und zu ein
+//  unplausibles Paket - die Werks-Testskizze hat solche Pakete ebenfalls verworfen. Der
+//  Hersteller-Treiber kann "gerade nichts Neues" nicht von "Finger weg" unterscheiden und
+//  meldet beides als losgelassen. Seit die Oberflaeche doppelt so oft abtastet, faellt das
+//  auf: Aus einem Tipp wird Druecken-Loslassen-Druecken-Loslassen, der Knopf loest also
+//  mehrfach aus.
+//
+//  Deshalb liegt hier ein eigener get_xy-Aufsatz vor dem Treiber: Er verwirft unplausible
+//  Rohwerte und haelt den letzten gueltigen Punkt kurz fest. Losgelassen wird erst
+//  gemeldet, wenn WS7_TOUCH_HOLD_MS lang wirklich nichts mehr kam.
+// ------------------------------------------------------------------------------------
+static bool (*s_touch_get_xy_orig)(esp_lcd_touch_handle_t, uint16_t *, uint16_t *,
+                                   uint16_t *, uint8_t *, uint8_t) = NULL;
+static uint16_t s_touch_last_x = 0;
+static uint16_t s_touch_last_y = 0;
+static int64_t  s_touch_last_us = 0;
+static bool     s_touch_down = false;
+
+static bool ws7_touch_get_xy(esp_lcd_touch_handle_t tp, uint16_t *x, uint16_t *y,
+                             uint16_t *strength, uint8_t *point_num, uint8_t max_point_num)
+{
+    bool got = s_touch_get_xy_orig(tp, x, y, strength, point_num, max_point_num);
+    int64_t now = esp_timer_get_time();
+
+    // Unplausible Rohwerte gelten als Aussetzer, nicht als Beruehrung.
+    if (got && *point_num > 0 &&
+        (x[0] > WS7_TOUCH_RAW_X_MAX || y[0] > WS7_TOUCH_RAW_Y_MAX)) {
+        got = false;
+        *point_num = 0;
+    }
+
+    if (got && *point_num > 0) {
+        s_touch_last_x = x[0];
+        s_touch_last_y = y[0];
+        s_touch_last_us = now;
+        s_touch_down = true;
+        return true;
+    }
+
+#if WS7_TOUCH_HOLD_MS > 0
+    if (s_touch_down && (now - s_touch_last_us) < ((int64_t)WS7_TOUCH_HOLD_MS * 1000)) {
+        x[0] = s_touch_last_x;
+        y[0] = s_touch_last_y;
+        if (strength) strength[0] = 0;
+        *point_num = 1;
+        return true;
+    }
+#endif
+
+    s_touch_down = false;
+    return false;
+}
+
 // Der GT9271 des Waveshare-Panels meldet im Hochformat (Roh-X 0..720, Roh-Y 0..1280),
 // das Bild laeuft aber im Querformat 1280x720. Achsentausch (und bei Bedarf Spiegelung)
 // deshalb ueber den process_coordinates-Hook, der VOR den swap/mirror-Flags von
@@ -211,6 +352,10 @@ static void ws7_touch_map(esp_lcd_touch_handle_t tp, uint16_t *x, uint16_t *y,
         // Bild wird um 180 Grad gedreht ausgegeben -> Touch muss mitdrehen.
         px = (uint16_t)(LCD_H_RES - 1 - px);
         py = (uint16_t)(LCD_V_RES - 1 - py);
+#endif
+#if WS7_TOUCH_DEBUG
+        esp_rom_printf("[Touch] roh X=%u Y=%u -> Bild X=%u Y=%u\n",
+                       (unsigned)x[i], (unsigned)y[i], (unsigned)px, (unsigned)py);
 #endif
         x[i] = px;
         y[i] = py;
@@ -243,27 +388,61 @@ static void jc_touch_scale(esp_lcd_touch_handle_t tp, uint16_t *x, uint16_t *y,
 // benutzen, sonst folgt ein zweiter Absturz, der die eigentliche Ursache ueberdeckt.
 bool jc_board_bringup(void)
 {
+#if JC_PANEL_TYPE == WS_PANEL_7H
+    // Anlaufzeit abwarten, BEVOR Bridge und Panel angesprochen werden.
+    //
+    // Das Displaymodul braucht nach dem Anlegen der Versorgung einen Moment, bis Bridge
+    // und Panel bereit sind. Faengt der P4 sofort an, laeuft der Hochlauf ins Leere: Die
+    // Bridge nimmt ihre Register nicht an oder das Panel zeigt trotz korrekt gesendeter
+    // DSI-Daten nichts - beides ohne Fehlermeldung, weil aus Sicht des P4 alles geklappt
+    // hat. Das Ergebnis war ein Display, das mal ansprang und mal nicht.
+    //
+    // Der Werks-Testsketch wartet aus demselben Grund 2 Sekunden am Anfang von setup().
+    // Dass es mit geoeffnetem seriellen Monitor fast immer klappte, hatte dieselbe
+    // Ursache: Dessen USB-Anmeldung verzoegert den Start und ersetzte damit die Wartezeit.
+    vTaskDelay(pdMS_TO_TICKS(WS7_PANEL_WARMUP_MS));
+#endif
     jc_backlight_init();
 
+#if JC_PANEL_TYPE == WS_PANEL_7H
+    ws7_i2c_bus_recover();          // haengenden Bus vom letzten Reset befreien
+#endif
+
     i2c_master_bus_config_t i2c_bus_conf = {
         .clk_source = I2C_CLK_SRC_DEFAULT,
         .sda_io_num = BSP_I2C_SDA,
         .scl_io_num = BSP_I2C_SCL,
         .i2c_port = BSP_I2C_NUM,
+#if JC_PANEL_TYPE == WS_PANEL_7H
+        // Stoerimpulsfilter und interne Abschlusswiderstaende - beides setzt auch das
+        // Waveshare-Beispiel. Ohne den Filter brechen Bridge und Touch weg, sobald die
+        // DSI-Ausgabe laeuft: Deren schnelle Signale stoeren auf das lange Flachbandkabel
+        // ein, und ungefilterte Stoerspitzen bringen die I2C-Uebertragung aus dem Tritt.
+        // Der Audio-Baustein auf der Platine bleibt dabei erreichbar, weil er nicht am
+        // Displaykabel haengt - genau dieses Muster war im Start-Log zu sehen.
+        .glitch_ignore_cnt = 7,
+        .flags.enable_internal_pullup = true,
+#endif
     };
     i2c_new_master_bus(&i2c_bus_conf, &s_i2c_handle);
 
 #if JC_PANEL_TYPE == WS_PANEL_7H
+    ws7_i2c_scan("vor dem Panel-Start");
     // Bridge des Waveshare-Panels vorbereiten (noch ohne Hintergrundbeleuchtung).
     ws7_bridge_pre_init();
 #endif
 
+    // Reset-Grund mitschreiben: 1 = Kaltstart (Strom weg), alles andere ist ein Warmstart.
+    // Nur beim Warmstart behalten die Bausteine ihren alten Zustand - genau dann traten
+    // die schwarzen Bilder auf.
+    esp_rom_printf("[Panel] Startgrund: %d (1 = Kaltstart)\n", (int)esp_reset_reason());
+
     static esp_ldo_channel_handle_t phy_pwr_chan = NULL;
     esp_ldo_channel_config_t ldo_cfg = {
         .chan_id = BSP_MIPI_DSI_PHY_PWR_LDO_CHAN,
         .voltage_mv = BSP_MIPI_DSI_PHY_PWR_LDO_VOLTAGE_MV,
     };
-    esp_ldo_acquire_channel(&ldo_cfg, &phy_pwr_chan);
+    BSP_STEP(esp_ldo_acquire_channel(&ldo_cfg, &phy_pwr_chan), "Stromversorgung MIPI-D-PHY");
 
     esp_lcd_dsi_bus_handle_t mipi_dsi_bus;
     esp_lcd_panel_io_handle_t io = NULL;
@@ -296,7 +475,11 @@ bool jc_board_bringup(void)
         .virtual_channel = 0,
         .dpi_clk_src = MIPI_DSI_DPI_CLK_SRC_DEFAULT,
         .dpi_clock_freq_mhz = WS7_DPI_CLOCK_MHZ,
+#if WS7_COLOR_BITS == 24
         .pixel_format = LCD_COLOR_PIXEL_FORMAT_RGB888,
+#else
+        .pixel_format = LCD_COLOR_PIXEL_FORMAT_RGB565,
+#endif
         .num_fbs = LVGL_PORT_LCD_BUFFER_NUMS,
         .video_timing = {
             .h_size = BSP_LCD_H_RES,
@@ -327,13 +510,32 @@ bool jc_board_bringup(void)
     {
         uint8_t zero = 0x00;
         uint8_t madctl = WS7_MADCTL;
-        esp_lcd_panel_io_tx_param(io, 0x36, &madctl, 1); // MADCTL
-        esp_lcd_panel_io_tx_param(io, 0x11, &zero, 1);   // Sleep Out
+        BSP_STEP(esp_lcd_panel_io_tx_param(io, 0x36, &madctl, 1), "Panel-Befehl MADCTL");
+        BSP_STEP(esp_lcd_panel_io_tx_param(io, 0x11, &zero, 1), "Panel-Befehl Sleep Out");
         vTaskDelay(pdMS_TO_TICKS(120));
-        esp_lcd_panel_io_tx_param(io, 0x29, &zero, 1);   // Display On
+        BSP_STEP(esp_lcd_panel_io_tx_param(io, 0x29, &zero, 1), "Panel-Befehl Display On");
         vTaskDelay(pdMS_TO_TICKS(20));
     }
     BSP_STEP(esp_lcd_panel_init(disp_panel), "DPI-Videoausgabe starten");
+#if WS7_TEST_PATTERN
+    // Prueffarbbalken: Sie entstehen im DSI-Baustein selbst und benutzen weder den
+    // Bildspeicher noch LVGL. Erscheinen sie, arbeitet die Anzeigekette bis zum Panel und
+    // der Fehler liegt weiter oben. Bleibt es schwarz, liegt es an DSI, Zeitbasis oder
+    // Panel.
+    //
+    // Der Hochlauf endet hier bewusst: Wuerde LVGL danach starten, schriebe es sofort in
+    // den Bildspeicher und das Pruefbild waere wieder weg - der Test saehe dann genauso
+    // aus wie der Fehler, den er finden soll.
+    jc_backlight_set(100);          // Beleuchtung an, sonst ist nichts zu sehen
+    BSP_STEP(esp_lcd_dpi_panel_set_pattern(disp_panel, MIPI_DSI_PATTERN_BAR_VERTICAL),
+             "Prueffarbbalken");
+    esp_rom_printf("[Panel] Pruefbild steht - erwartet werden senkrechte Farbbalken.\n");
+    esp_rom_printf("[Panel] Hochlauf endet hier (WS7_TEST_PATTERN = 1, keine Oberflaeche).\n");
+    return false;                   // ohne LVGL: Anzeige bleibt beim Pruefbild
+#endif
+
+
+
 #elif JC_PANEL_TYPE == JC_PANEL_70
     // ---------------- 7,0" JD9165 (1024x600) ----------------
     esp_lcd_dsi_bus_config_t bus_config = JD9165_PANEL_BUS_DSI_2CH_CONFIG();
@@ -423,6 +625,16 @@ bool jc_board_bringup(void)
     };
     esp_lcd_dpi_panel_register_event_callbacks(disp_panel, &cbs, NULL);
 
+#if JC_PANEL_TYPE == WS_PANEL_7H
+    // Bridge freigeben und Beleuchtung einschalten, BEVOR der Touch angesprochen wird.
+    // Der GT9271 antwortet erst danach: Die Freigabe der Bridge (Register 0xAD) versorgt
+    // offenbar auch ihn. In der Werks-Testskizze steht die Touch-Initialisierung aus
+    // demselben Grund hinter dem Einschalten der Beleuchtung.
+    jc_backlight_set(100);
+    vTaskDelay(pdMS_TO_TICKS(WS7_TOUCH_POWER_MS));
+    ws7_i2c_scan("nach dem Panel-Start");
+#endif
+
     esp_lcd_panel_io_handle_t tp_io_handle = NULL;
     // MUSS vorbelegt sein: schlaegt die Touch-Initialisierung fehl, gibt der Treiber einen
     // unbrauchbaren Zeiger zurueck. Ohne Vorbelegung landet Muell im LVGL-Port.
@@ -459,11 +671,19 @@ bool jc_board_bringup(void)
         esp_rom_printf("[Panel] Touch-Controller nicht gefunden - Anzeige laeuft ohne Bedienung.\n");
         tp_handle = NULL;
     }
+#if JC_PANEL_TYPE == WS_PANEL_7H
+    if (tp_handle) {                       // Aussetzer-Filter vor den Treiber haengen
+        s_touch_get_xy_orig = tp_handle->get_xy;
+        tp_handle->get_xy = ws7_touch_get_xy;
+    }
+#endif
 
     lvgl_port_interface_t interface =
         (dpi_config.flags.use_dma2d) ? LVGL_PORT_INTERFACE_MIPI_DSI_DMA
                                      : LVGL_PORT_INTERFACE_MIPI_DSI_NO_DMA;
+    esp_rom_printf("[Panel] Bringup fertig - LVGL wird gestartet\n");
     lvgl_port_init(disp_panel, tp_handle, interface);
+    esp_rom_printf("[Panel] LVGL laeuft\n");
     return true;
 }
 

P4_Display_Firmware/config.h

@@ -109,15 +109,15 @@
 //
 //  Waveshare ESP32-P4-Pico (WS_PANEL_7H): 40-poliger Header im Raspberry-Pi-Pico-Format.
 //  Belegt sind dort u.a. I2C (7/8), TF-Karte (9/10/11/12/13/53) und der Debug-UART0
-//  (37/38); diese Pins duerfen NICHT genommen werden. Genutzt werden GPIO17/GPIO18:
-//    GPIO17 (P4 TX) ----> S3 GPIO44 (RX)
-//    GPIO18 (P4 RX) <---- S3 GPIO43 (TX)
+//  (37/38); diese Pins duerfen NICHT genommen werden. Genutzt werden GPIO20/GPIO21:
+//    GPIO20 (P4 TX) ----> S3 GPIO44 (RX)
+//    GPIO21 (P4 RX) <---- S3 GPIO43 (TX)
 //    GND            ----  S3 GND
 #define DISPLAY_UART_PORT        Serial1
 #define DISPLAY_UART_BAUDRATE    230400
 #if JC_PANEL_TYPE == WS_PANEL_7H
-#define DISPLAY_UART_TX_PIN      17
-#define DISPLAY_UART_RX_PIN      18
+#define DISPLAY_UART_TX_PIN      20
+#define DISPLAY_UART_RX_PIN      21
 #else
 #define DISPLAY_UART_TX_PIN      33
 #define DISPLAY_UART_RX_PIN      31
@@ -126,7 +126,7 @@
 // -------------------------------------------------------------------------------------
 //  Firmware
 // -------------------------------------------------------------------------------------
-#define DISPLAY_FW_VERSION       "1.6.2"   // Firmware-Stand der P4-Display-Steuerung (Info-Seite)
+#define DISPLAY_FW_VERSION       "1.6.10"   // Firmware-Stand der P4-Display-Steuerung (Info-Seite)
 
 // -------------------------------------------------------------------------------------
 //  Protokoll

P4_Display_Firmware/display_hal.cpp

@@ -10,12 +10,14 @@
 #include "display_hal.h"
 #include "ui.h"
 #include "config.h"
+#include "pins_config.h"
 
 // LVGL muss mit derselben Farbtiefe uebersetzt sein wie das Panel erwartet. Zieht der
 // Build versehentlich eine fremde lv_conf.h (z.B. eine alte Datei neben dem lvgl-Ordner),
 // faellt das hier auf - sonst erst am schwarzen oder farbverfaelschten Bild.
 #if JC_PANEL_TYPE == WS_PANEL_7H
-static_assert(LV_COLOR_DEPTH == 24, "Waveshare 7\" (H) braucht RGB888 - falsche lv_conf.h?");
+static_assert(LV_COLOR_DEPTH == WS7_COLOR_BITS,
+              "Farbtiefe passt nicht zu WS7_COLOR_BITS - falsche lv_conf.h?");
 #else
 static_assert(LV_COLOR_DEPTH == 16, "JC-Panels brauchen RGB565 - falsche lv_conf.h?");
 #endif

P4_Display_Firmware/lv_conf.h

@@ -26,18 +26,18 @@
    COLOR SETTINGS
  *====================*/
 
-/* Panel-Typ des Projekts. Liegt im selben Ordner wie diese Datei, ein Include mit
- * Anfuehrungszeichen findet also immer genau diese config.h - auch dann, wenn die
- * LVGL-Bibliothek uebersetzt wird. Nur so bekommen Sketch UND Bibliothek dieselbe
- * Farbtiefe; ein Compiler-Flag allein wuerde die Bibliothek nicht erreichen. */
-#include "config.h"
+/* Panel- und Tempo-Einstellungen des Projekts. Die Datei liegt im selben Ordner wie
+ * diese hier, ein Include mit Anfuehrungszeichen findet also immer genau sie - auch
+ * dann, wenn die LVGL-Bibliothek uebersetzt wird. Nur so bekommen Sketch UND Bibliothek
+ * dieselben Werte; ein Compiler-Flag allein wuerde die Bibliothek nicht erreichen. */
+#include "pins_config.h"
 
 /*Color depth: 1 (I1), 8 (L8), 16 (RGB565), 24 (RGB888), 32 (XRGB8888)*/
-/* Waveshare 7inch DSI LCD (H): Die Bridge des Panels nimmt ausschliesslich RGB888
- * entgegen, deshalb muss auch LVGL in 24 Bit rechnen. Die JC-Panels laufen wie
- * bisher mit RGB565. */
+/* Waveshare 7inch DSI LCD (H): Farbtiefe kommt aus WS7_COLOR_BITS (pins_config.h) -
+ * 16 Bit halbiert die Datenmenge je Bild, 24 Bit bringt feinere Verlaeufe.
+ * Die JC-Panels laufen unveraendert mit RGB565. */
 #if JC_PANEL_TYPE == WS_PANEL_7H
-#define LV_COLOR_DEPTH 24
+#define LV_COLOR_DEPTH WS7_COLOR_BITS
 #else
 #define LV_COLOR_DEPTH 16
 #endif
@@ -91,7 +91,17 @@
  *====================*/
 
 /*Default display refresh, input device read and animation step period.*/
+/* Der Wert bestimmt nicht nur die Bildrate, sondern auch, wie oft der Touch abgetastet
+ * und wie fein eine Animation gerechnet wird. 33 ms sind 30 Schritte je Sekunde - beim
+ * Ziehen mit dem Finger deutlich als Stocken zu sehen. Das Waveshare-Panel laeuft mit
+ * 60 Hz, deshalb dort 16 ms; mehr als das Panel zeigen kann, bringt nichts. Kommt das
+ * Zeichnen nicht hinterher, wird es einfach seltener fertig - kaputt geht dabei nichts.
+ * Die JC-Panels bleiben bei 33 ms, damit sich ihr Verhalten nicht aendert. */
+#if JC_PANEL_TYPE == WS_PANEL_7H
+#define LV_DEF_REFR_PERIOD  16      /*[ms]*/
+#else
 #define LV_DEF_REFR_PERIOD  33      /*[ms]*/
+#endif
 
 /*Default Dot Per Inch. Used to initialize default sizes such as widgets sized, style paddings.
  *(Not so important, you can adjust it to modify default sizes and spaces)*/
@@ -109,7 +119,14 @@
  * - LV_OS_WINDOWS
  * - LV_OS_MQX
  * - LV_OS_CUSTOM */
+/* Nur mit einem Betriebssystem kann LVGL auf mehreren Kernen zeichnen. Beim
+ * Waveshare-Panel wird das gebraucht (WS7_PARALLEL_RENDER), sonst bleibt es aus -
+ * die JC-Panels sollen sich nicht aendern. */
+#if (JC_PANEL_TYPE == WS_PANEL_7H) && WS7_PARALLEL_RENDER
+#define LV_USE_OS   LV_OS_FREERTOS
+#else
 #define LV_USE_OS   LV_OS_NONE
+#endif
 
 #if LV_USE_OS == LV_OS_CUSTOM
     #define LV_OS_CUSTOM_INCLUDE <stdint.h>
@@ -175,7 +192,14 @@
 	/* Set the number of draw unit.
      * > 1 requires an operating system enabled in `LV_USE_OS`
      * > 1 means multiple threads will render the screen in parallel */
+    /* Der ESP32-P4 hat zwei Kerne. Beim grossen Waveshare-Panel lohnt es sich, beide
+     * zum Zeichnen zu benutzen; jeder Zeichen-Thread kostet einen eigenen Stack im
+     * knappen internen RAM. */
+    #if (JC_PANEL_TYPE == WS_PANEL_7H) && WS7_PARALLEL_RENDER
+    #define LV_DRAW_SW_DRAW_UNIT_CNT    2
+    #else
     #define LV_DRAW_SW_DRAW_UNIT_CNT    1
+    #endif
 
     /* Use Arm-2D to accelerate the sw render */
     #define LV_USE_DRAW_ARM2D_SYNC      0
@@ -891,14 +915,19 @@
 #define LV_USE_SNAPSHOT 0
 
 /*1: Enable system monitor component*/
+/* Nur fuer die Messeinblendung des Waveshare-Panels, siehe WS7_PERF_MONITOR. */
+#if (JC_PANEL_TYPE == WS_PANEL_7H) && WS7_PERF_MONITOR
+#define LV_USE_SYSMON   1
+#else
 #define LV_USE_SYSMON   0
+#endif
 #if LV_USE_SYSMON
     /*Get the idle percentage. E.g. uint32_t my_get_idle(void);*/
     #define LV_SYSMON_GET_IDLE lv_timer_get_idle
 
     /*1: Show CPU usage and FPS count
      * Requires `LV_USE_SYSMON = 1`*/
-    #define LV_USE_PERF_MONITOR 0
+    #define LV_USE_PERF_MONITOR 1
     #if LV_USE_PERF_MONITOR
         #define LV_USE_PERF_MONITOR_POS LV_ALIGN_BOTTOM_RIGHT
 

P4_Display_Firmware/pins_config.h

@@ -4,10 +4,36 @@
 
 // -------------------------------------------------------------------------------------
 //  Waveshare 7" (H): Einbaulage. Haengt das Panel auf dem Kopf (Flachbandkabel oben statt
-//  unten), dreht 1 das Bild UND den Touch um 180 Grad. Auf 0 setzen, wenn das Panel
-//  andersherum eingebaut wird.
+//  unten), dreht 1 das Bild UND den Touch um 180 Grad. In der aktuellen Einbaulage steht
+//  das Bild richtig herum -> 0. Der Touch braucht davon unabhaengig eine Spiegelung,
+//  siehe WS7_TOUCH_MIRROR_RAW_X weiter unten.
 // -------------------------------------------------------------------------------------
-#define WS7_ROTATE_180 1
+#define WS7_ROTATE_180 0
+
+// -------------------------------------------------------------------------------------
+//  Waveshare 7" (H): Tempo-Schalter
+//
+//  1280x720 ist gegenueber den JC-Panels ein Vielfaches an Pixeln. Die drei Schalter
+//  senken die Last und lassen sich einzeln zurueckstellen, falls einer Aerger macht.
+//
+//  WS7_COLOR_BITS      24 = RGB888. GEPRUEFT: Die Bridge dieses Panels nimmt KEIN RGB565
+//                           an - mit 16 kommt kein brauchbares Bild. Einstellbar bleibt es
+//                           nur, weil andere Waveshare-Panels an derselben Firmware
+//                           haengen koennten.
+//  WS7_PARTIAL_REFRESH  1 = nur geaenderte Bildbereiche neu zeichnen statt jedes Mal des
+//                           gesamten Bildes (LVGL-Direct-Mode, zwei wechselnde Puffer).
+//                           Groesster Tempogewinn, besonders waehrend eines Bezugs: Die
+//                           Zeitanzeige laeuft zehnmal je Sekunde weiter, und mit 0 wuerde
+//                           dafuer jedes Mal das ganze Bild neu gezeichnet. Am Geraet
+//                           geprueft, kein Flackern - am 4,3-Zoll-Panel hatte derselbe
+//                           Modus dagegen geflackert.
+//  WS7_PARALLEL_RENDER  1 = LVGL zeichnet mit zwei Threads auf beiden Prozessorkernen.
+//                           Kostet zwei zusaetzliche Task-Stacks im knappen internen RAM;
+//                           startet der P4 nicht mehr, hier zuerst auf 0 stellen.
+// -------------------------------------------------------------------------------------
+#define WS7_COLOR_BITS        24
+#define WS7_PARTIAL_REFRESH    1
+#define WS7_PARALLEL_RENDER    1
 
 #define EXAMPLE_LVGL_PORT_TASK_MAX_DELAY_MS 500  //range 2 to 2000
 #define EXAMPLE_LVGL_PORT_TASK_MIN_DELAY_MS 5     //range 1 to 100
@@ -23,7 +49,13 @@
 //     Bild, daher zeigen statische Flaechen (z.B. Tab-Leiste) nie alten Bufferinhalt.
 //     (Mode 3 = Direct-Mode flackert bei nie neu gezeichneten Bereichen.)
 //     Bei Rotation 90 nutzen beide Modi ohnehin 3 Framebuffer -> kein Mehrverbrauch.
+// Beim Waveshare-Panel waere Vollbild-Neuzeichnen bei 1280x720 zu teuer -> Mode 3
+// (Direct-Mode, zwei Puffer, nur geaenderte Bereiche), siehe WS7_PARTIAL_REFRESH.
+#if (JC_PANEL_TYPE == WS_PANEL_7H) && WS7_PARTIAL_REFRESH
+#define EXAMPLE_LVGL_PORT_AVOID_TEAR_MODE   3   //range 1 to 3
+#else
 #define EXAMPLE_LVGL_PORT_AVOID_TEAR_MODE   2   //range 1 to 3
+#endif
 
 #if JC_PANEL_TYPE == WS_PANEL_7H
 // Waveshare 7" (H): Panel ist nativ 1280x720 Querformat. Bei Einbau auf dem Kopf wird um
@@ -83,13 +115,47 @@
 #define WS7_MADCTL           0x00
 
 // Der GT9271 meldet im Hochformat: Roh-X 0..720, Roh-Y 0..1280. Fuer das Querformat
-// werden die Achsen getauscht. Zeigt der Cursor spiegelverkehrt, hier die passende
-// Achse auf 1 setzen (die Spiegelung geschieht VOR dem Tausch, auf den Rohwerten).
+// werden die Achsen getauscht. Die Spiegelung geschieht VOR dem Tausch, also noch auf den
+// Rohwerten: Roh-X wird zur Bildschirmhoehe, Roh-Y zur Bildschirmbreite.
+//   WS7_TOUCH_MIRROR_RAW_X = 1 -> dreht OBEN/UNTEN um
+//   WS7_TOUCH_MIRROR_RAW_Y = 1 -> dreht LINKS/RECHTS um
+// Der Digitizer dieses Panels sitzt gegenueber dem Bild um die Hochachse gedreht, deshalb
+// ist oben/unten dauerhaft aktiv.
 #define WS7_TOUCH_RAW_X_MAX  720
 #define WS7_TOUCH_RAW_Y_MAX  1280
-#define WS7_TOUCH_MIRROR_RAW_X 0
+#define WS7_TOUCH_MIRROR_RAW_X 1
 #define WS7_TOUCH_MIRROR_RAW_Y 0
 
+// Zeigt unten rechts Bilder je Sekunde und Prozessorlast ein. Nur zum Messen gedacht:
+// Der Wert sagt, ob sich weitere Muehe beim Zeichnen ueberhaupt lohnt.
+#define WS7_PERF_MONITOR 0
+
+// Zum Einmessen des Touch: 1 gibt jeden Beruehrpunkt roh und umgerechnet auf der
+// seriellen Konsole aus. Danach wieder auf 0, sonst laeuft das Log dauernd mit.
+#define WS7_TOUCH_DEBUG 0
+
+// So lange gilt eine Beruehrung nach dem letzten gueltigen Messwert noch als anliegend.
+// Ueberbrueckt Aussetzer des GT9271, die sonst als Loslassen durchgehen und einen Tipp in
+// mehrere Klicks zerlegen. 0 schaltet die Ueberbrueckung ab. Nicht zu gross waehlen: Der
+// Wert verzoegert das Loslassen und daempft dadurch den Schwung beim Wischen.
+#define WS7_TOUCH_HOLD_MS 40
+
+// Wartezeit zwischen dem Freigeben der Bridge und dem Ansprechen des Touch. Der GT9271
+// haengt an derselben Versorgung und braucht nach dem Einschalten einen Moment, bis er
+// auf I2C antwortet. Meldet sich 0x14 beim Start nicht, diesen Wert erhoehen.
+#define WS7_TOUCH_POWER_MS 120
+
+// Prueffarbbalken statt Oberflaeche anzeigen. Sie entstehen im DSI-Baustein selbst und
+// benutzen weder Bildspeicher noch LVGL. Damit laesst sich trennen, ob die Anzeigekette
+// bis zum Panel arbeitet (Balken sichtbar) oder nicht (schwarz). Nur zur Fehlersuche.
+// Anlaufzeit des Displaymoduls, bevor Bridge und Panel angesprochen werden. Ohne diese
+// Pause startet die Anzeige nur zufaellig - der Werks-Testsketch wartet aus demselben
+// Grund 2 Sekunden. Springt das Display beim Einschalten nicht zuverlaessig an, ist das
+// der erste Wert zum Erhoehen; laeuft es sicher, kann er vorsichtig gesenkt werden.
+#define WS7_PANEL_WARMUP_MS 2000
+
+#define WS7_TEST_PATTERN 0
+
 #elif JC_PANEL_TYPE == JC_PANEL_70
 
 #define LCD_H_RES 1024

P4_Display_Firmware/ui.cpp

@@ -453,7 +453,11 @@ static lv_obj_t* make_page(lv_obj_t* parent) {
     lv_obj_t* p = lv_obj_create(parent);
     lv_obj_set_size(p, LV_PCT(100), LV_PCT(100));
     lv_obj_set_pos(p, 0, 0);
-    lv_obj_set_style_bg_opa(p, LV_OPA_TRANSP, 0);
+    // Deckend in der Hintergrundfarbe statt durchsichtig. Sieht identisch aus - die Ebenen
+    // darunter haben dieselbe Farbe -, erspart LVGL beim Scrollen aber, sie mitzuzeichnen
+    // und durchzumischen.
+    lv_obj_set_style_bg_color(p, COL_BG, 0);
+    lv_obj_set_style_bg_opa(p, LV_OPA_COVER, 0);
     lv_obj_set_style_border_width(p, 0, 0);
     lv_obj_set_style_pad_all(p, 8, 0);
     lv_obj_set_style_pad_row(p, 6, 0);
@@ -3171,6 +3175,11 @@ void ui_init(ProtocolClient* client) {
 
     lv_obj_t* burger = th_button(header, LV_SYMBOL_LIST, COL_CARD2, COL_TEXT);
     lv_obj_set_size(burger, 48, 36);
+    // Der Knopf bleibt optisch klein, faengt Tipps aber auch knapp daneben ab. 48x36 Pixel
+    // sind auf dem 7-Zoll-Panel ein sehr kleines Ziel; gemessen wurde ein Fehlgriff von
+    // rund 10 Pixeln. Die Vergroesserung wirkt nur innerhalb der Kopfleiste - darunter
+    // beschneidet sie die Leiste selbst, sodass dem Seiteninhalt nichts weggenommen wird.
+    lv_obj_set_ext_click_area(burger, 20);
     lv_obj_add_event_cb(burger, hamburger_cb, LV_EVENT_CLICKED, nullptr);
 
     g_hdrTitle = lv_label_create(header);