fix(P4): Nur ein Bildspeicher - Ursache des Startfehlers behoben (1.6.24)

Mit dem Prüfbild bei num_fbs = 1 startet das Panel zuverlässig, mit zwei
Bildspeichern nicht. Das war der letzte verbliebene Unterschied zum
funktionierenden Werks-Testsketch - und die Ursache des ganzen
Startproblems: Der Hochlauf meldete durchgehend Erfolg, das Panel blieb
dunkel, erst ein Reset half.

- WS7_SINGLE_FB schaltet die Doppelpufferung für das Waveshare-Panel ab
  (EXAMPLE_LVGL_PORT_AVOID_TEAR_ENABLE = 0). LVGL zeichnet dann in einen
  Zwischenpuffer von 120 Zeilen im PSRAM, der per DMA in den einen
  Bildspeicher übertragen wird.
- num_fbs folgt wieder LVGL_PORT_LCD_BUFFER_NUMS, das in diesem Modus 1
  ist - die Sonderbehandlung im Prüfbild-Modus entfällt.
- WS7_PARTIAL_REFRESH ist damit wirkungslos und als solches vermerkt.
- PSRAM-Bedarf sinkt von 5,4 MB auf 2,8 MB.

Preis ist mögliches Tearing bei schnellen Bildwechseln.

Beide Panel-Varianten mit arduino-cli gegengebaut.

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,188 @@
+Version 1.6.24:
+- Ursache des unzuverlaessigen Starts gefunden und behoben: die Anzahl der Bildspeicher.
+  Mit zwei Bildspeichern kam nach dem Einschalten kein Bild - der Hochlauf meldete
+  durchgehend Erfolg, das Panel blieb dunkel, und erst ein Reset half. Mit genau einem
+  startet es zuverlaessig. Belegt wurde das mit den Prueffarbbalken: Sie erscheinen mit
+  einem Speicher sofort, mit zweien nicht. Der Werks-Testsketch benutzt ebenfalls einen -
+  das war der letzte verbliebene Unterschied zu ihm.
+- Die Oberflaeche laeuft deshalb ohne Doppelpufferung: LVGL zeichnet in einen
+  Zwischenpuffer von 120 Zeilen im PSRAM, der dann in den einen Bildspeicher uebertragen
+  wird. Bei schnellen Bildwechseln kann kurz eine Kante sichtbar werden; ein zuverlaessig
+  startendes Display wiegt das auf.
+- Schalter WS7_SINGLE_FB in pins_config.h. WS7_PARTIAL_REFRESH ist damit wirkungslos, weil
+  es ohne Doppelpufferung nichts umzuschalten gibt.
+- Der PSRAM-Bedarf sinkt von 5,4 MB auf 2,8 MB.
+- Die Umgehungen aus den Vorversionen bleiben erhalten: Anlaufzeit, wiederholte
+  Bridge-Grundeinstellung, wiederholte Weckbefehle und der Neustart nach Kaltstart. Ob
+  jede davon noch noetig ist, laesst sich jetzt einzeln pruefen - der Startfehler selbst
+  ist behoben.
+
+Version 1.6.23:
+- Der Selbst-Neustart aus 1.6.22 reicht nicht: Ein Software-Neustart setzt offenbar nicht
+  dasselbe zurueck wie die Reset-Taste. Der Schalter bleibt eingeschaltet, er schadet nicht,
+  loest das Problem aber nicht allein.
+- Zurueck zu dem einen Unterschied zum funktionierenden Werks-Testsketch, der bisher nie
+  ueberprueft wurde: Dieser legt EINEN Bildspeicher an, die Firmware zwei. Der Pruefbild-Test
+  lief bislang ebenfalls mit zwei und war damit nie ein echter Nachbau des Testsketches - er
+  wich an genau der Stelle ab, die noch offen ist.
+- Mit WS7_TEST_PATTERN = 1 wird jetzt genau ein Bildspeicher angelegt, wie im Testsketch.
+  Erscheinen die Farbbalken damit zuverlaessig, liegt es an der Anzahl der Bildspeicher, und
+  die Oberflaeche laesst sich darauf umstellen.
+
+Version 1.6.22:
+- Der Ab- und Wiederaufbau der DSI-Strecke aus 1.6.21 hat nicht geholfen, sondern das Bild
+  um einen Schritt verschlechtert: Nach dem Einschalten kam gar nichts mehr, nach dem
+  ersten Reset nur die Beleuchtung, erst nach dem zweiten das Bild. Ein Ab- und Wiederaufbau
+  im laufenden Betrieb ist einem echten Chip-Reset also nicht gleichwertig. WS7_DSI_RESTART
+  steht deshalb wieder auf 0; der Schalter bleibt samt Begruendung erhalten.
+- Stattdessen der Weg, den die Messungen eindeutig stuetzen: Nach einem Kaltstart startet
+  der P4 sich genau einmal selbst neu, sobald der erste Hochlauf durch ist. Damit passiert
+  genau das, was bei jedem Versuch zuverlaessig geholfen hat - ohne dass jemand die
+  Reset-Taste druecken muss.
+- Eine Schleife ist ausgeschlossen: Beim zweiten Durchlauf ist der Startgrund kein Kaltstart
+  mehr, die Bedingung greift nicht erneut. Der Fruehstart-Zaehler der Absturzsicherung wird
+  vor dem gewollten Neustart zurueckgesetzt, damit dieser nicht als Absturz zaehlt.
+- Kostet rund drei Sekunden, und nur beim Einschalten. Schalter WS7_COLD_BOOT_RESTART in
+  pins_config.h.
+- Das ist eine Umgehung, keine Erklaerung: Warum das Panel den ersten Anlauf nach dem
+  Einschalten nicht annimmt, ist weiterhin offen. Der Hochlauf meldet durchgehend Erfolg.
+
+Version 1.6.21:
+- Der Hochlauf lief zuletzt vollstaendig fehlerfrei durch - Bridge zweimal eingestellt,
+  Panel zweimal geweckt, alle I2C-Bausteine erreichbar - und trotzdem kam beim ersten
+  Einschalten kein Bild. Erst ein Reset half, und der zuverlaessig. Es fehlte also kein
+  Befehl mehr; es fehlte der Vorgang selbst.
+- Ein Reset unterscheidet sich an dieser Stelle in genau einem Punkt: Die DSI-Verbindung
+  geht einmal weg und neu auf, waehrend Bridge und Panel bereits versorgt und eingestellt
+  sind. Weder die wiederholte Grundeinstellung noch die wiederholten Weckbefehle ersetzen
+  das - beide laufen ueber eine Verbindung, die durchgehend bestand.
+- Der Hochlauf baut die DSI-Strecke jetzt einmal komplett ab und wieder auf: Bildausgabe,
+  Kommandokanal und Bus werden freigegeben und neu angelegt. Damit passiert ohne Reset,
+  was vorher erst der zweite Start brachte. Schalter WS7_DSI_RESTART in pins_config.h,
+  Pause dazwischen WS7_DSI_RESTART_MS (Vorgabe 200 ms).
+- Der DSI-Aufbau steckt dafuer in einer eigenen Funktion, damit der Vorgang wiederholbar
+  ist statt zweimal im Quelltext zu stehen.
+
+Version 1.6.20:
+- Nach 1.6.19 lief es reproduzierbar so ab: Beim Einschalten ging nach zwei bis drei
+  Sekunden die Hintergrundbeleuchtung an, dann kam nichts mehr; nach einem Reset ging die
+  Beleuchtung kurz aus und danach erschien Beleuchtung samt Bild. Daraus folgt der letzte
+  fehlende Schritt: Auch die Grundeinstellung der Bridge lief bisher nur einmal, und zwar
+  bevor die DSI-Strecke ueberhaupt existierte. Beim Reset half es nur deshalb, weil die
+  Bridge ihre Einstellung aus dem vorigen Durchlauf noch hatte und diesmal ein DSI-Signal
+  vorfand.
+- Die Grundeinstellung der Bridge wird jetzt ein zweites Mal geschrieben, sobald die
+  Videoausgabe laeuft - dasselbe Vorgehen wie bei den Weckbefehlen des Panels in 1.6.19.
+  Damit wird ohne Reset erreicht, was vorher erst der zweite Durchlauf brachte.
+- Im Start-Log sind beide Durchgaenge benannt ("Bridge-Grundeinstellung vor dem DSI-Start"
+  und "... nach dem Start der Videoausgabe").
+
+Version 1.6.19:
+- Die Wartezeit aus 1.6.18 hat den Start deutlich verbessert, aber noch nicht zuverlässig
+  gemacht. Aus dem verbliebenen Fehlerbild folgt der nächste Schritt: Die Beleuchtung ging
+  an, das Bild fehlte. Die Beleuchtung hängt an der Bridge und wird über I2C geschaltet -
+  sie funktioniert also. Verloren gehen die Weckbefehle an das Panel selbst.
+- Diese Befehle wurden bisher genau einmal geschickt, bevor die Videoausgabe lief. War der
+  Panel-Controller in dem Moment noch nicht aufnahmebereit, waren sie weg, und danach hat
+  nie wieder jemand nachgefragt. Sie werden jetzt ein zweites Mal gesendet, sobald die
+  Videoausgabe steht. Die Befehle sind wiederholbar, der zweite Anlauf kostet nichts.
+- Die Pause dazwischen steht als WS7_PANEL_SETTLE_MS in pins_config.h (Vorgabe 200 ms).
+- Im Start-Log ist jeder Anlauf einzeln zu sehen ("Weckbefehle vor/nach dem Start der
+  Videoausgabe").
+
+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

P4_Display_Firmware/P4_Display_Firmware.ino

@@ -24,6 +24,7 @@
 #include "protocol_client.h"
 #include "ui.h"
 #include "display_hal.h"
+#include "pins_config.h"
 #include <ArduinoJson.h>
 #include <Update.h>
 #include <Preferences.h>
@@ -296,6 +297,31 @@ void setup() {
     g_client.onOta(onOta);
 
     hal_init(&g_client);   // LVGL + Panel/Touch + Dashboard (ruft ui_init intern auf)
+
+    // --- Waveshare-Panel: einmaliger Neustart nach dem Einschalten ---
+    //
+    // Das Panel kommt nach dem Anlegen der Versorgung im ersten Anlauf nicht zuverlaessig
+    // hoch: Die Beleuchtung geht an, ein Bild bleibt aus - obwohl jeder Schritt des
+    // Hochlaufs Erfolg meldet. Ein Reset behebt es zuverlaessig, und zwar nur ein echter
+    // Chip-Reset; die DSI-Strecke im laufenden Betrieb ab- und wieder aufzubauen genuegt
+    // nicht (siehe WS7_DSI_RESTART).
+    //
+    // Deshalb startet der P4 sich nach einem Kaltstart genau einmal selbst neu, nachdem
+    // der erste Hochlauf durch ist. Beim zweiten Durchlauf ist der Startgrund kein
+    // Kaltstart mehr, die Bedingung greift also nicht erneut - eine Schleife ist
+    // ausgeschlossen. Kostet rund drei Sekunden, aber nur beim Einschalten.
+#if (JC_PANEL_TYPE == WS_PANEL_7H) && WS7_COLD_BOOT_RESTART
+    if (esp_reset_reason() == ESP_RST_POWERON) {
+        // Der Fruehstart-Zaehler wurde oben bereits erhoeht. Diesen gewollten Neustart
+        // darf er nicht mitzaehlen, sonst laeuft die Absturzsicherung nach ein paar
+        // Einschaltvorgaengen in den Update-Modus.
+        { Preferences p; p.begin("bootguard", false); p.putUShort("early", 0); p.end(); }
+        DBG_SERIAL.println(F("[Panel] Kaltstart - einmaliger Neustart fuer das Displaypanel"));
+        DBG_SERIAL.flush();
+        delay(50);
+        esp_restart();
+    }
+#endif
     g_client.begin();      // UART starten, hello folgt automatisch in loop()
 
     DBG_SERIAL.println(F("Bereit. Warte auf Verbindung zur Hauptplatine..."));

P4_Display_Firmware/README.md

@@ -50,7 +50,7 @@ Vendor-Pakete: 4,3" im Ordner `JC4880P443C_I_W/`, 7,0" im Repo-Ordner
 | 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 × 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 | **1 × 2,8 MB** — mehr verträgt das Panel beim Start nicht |
 | 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 GPIO20 / RX GPIO21** |
 

P4_Display_Firmware/board_bringup.c

@@ -30,6 +30,7 @@
 #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"
@@ -70,6 +71,82 @@
 
 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)                                                             \
@@ -107,11 +184,33 @@ 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
-// DSI-Bringup laufen; die Hintergrundbeleuchtung bleibt dabei noch aus.
+// Grundeinstellung der Bridge. Bewusst mehrfach aufrufbar, siehe unten.
+//
+// Warum zweimal: Beim ersten Aufruf existiert die DSI-Strecke noch gar nicht - die Bridge
+// bekommt ihre Einstellung also, bevor ein Signal anliegt. Beim ersten Einschalten reichte
+// das nicht: Die Beleuchtung ging an (die haengt an der Bridge), ein Bild kam aber nicht.
+// Erst ein Reset half - und dann nur deshalb, weil die Bridge ihre Einstellung aus dem
+// vorigen Durchlauf noch hatte und diesmal ein DSI-Signal vorfand. Genau das holt der
+// zweite Aufruf nach, ohne dass ein Reset noetig ist. Die Register sind wiederholbar.
+static void ws7_bridge_core_init(const char *wann)
+{
+    esp_rom_printf("[Panel] Bridge-Grundeinstellung %s\n", wann);
+    ws7_bridge_write(0xC0, 0x01);
+    ws7_bridge_write(0xC2, 0x01);
+    ws7_bridge_write(0xAC, 0x01);
+}
+
+// Bridge am I2C-Bus anmelden und erstmalig einstellen. Laeuft VOR dem DSI-Bringup;
+// die Hintergrundbeleuchtung bleibt dabei noch aus.
 static void ws7_bridge_pre_init(void)
 {
     i2c_device_config_t dev_cfg = {
@@ -123,9 +222,7 @@ static void ws7_bridge_pre_init(void)
         s_bridge_handle = NULL;
         return;
     }
-    ws7_bridge_write(0xC0, 0x01);
-    ws7_bridge_write(0xC2, 0x01);
-    ws7_bridge_write(0xAC, 0x01);
+    ws7_bridge_core_init("vor dem DSI-Start");
 }
 
 void jc_backlight_init(void)
@@ -300,45 +397,43 @@ static void jc_touch_scale(esp_lcd_touch_handle_t tp, uint16_t *x, uint16_t *y,
 }
 #endif
 
-// Bringt Panel + Touch + LVGL-Port hoch (LVGL laeuft danach in eigenem Task).
-// Rueckgabe false: Panel kam nicht hoch - der Aufrufer darf dann KEINE LVGL-Funktion
-// benutzen, sonst folgt ein zweiter Absturz, der die eigentliche Ursache ueberdeckt.
-bool jc_board_bringup(void)
-{
-    jc_backlight_init();
-
-    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,
-    };
-    i2c_new_master_bus(&i2c_bus_conf, &s_i2c_handle);
-
 #if JC_PANEL_TYPE == WS_PANEL_7H
-    // Bridge des Waveshare-Panels vorbereiten (noch ohne Hintergrundbeleuchtung).
-    ws7_bridge_pre_init();
+// Panel wecken. Bewusst mehrfach, siehe unten.
+//
+// Ein reines DPI-Panel kennt keine reset-Funktion, esp_lcd_panel_reset() wuerde ins Leere
+// greifen - deshalb nur die DCS-Befehle.
+//
+// Warum mehrfach: Verpasst der Panel-Controller diese Befehle, weil er nach dem
+// Einschalten noch nicht bereit war, bleibt der Bildschirm dunkel, obwohl der P4 alles
+// korrekt gesendet hat und jeder Schritt Erfolg meldet. Die Hintergrundbeleuchtung geht
+// trotzdem an, weil sie an der Bridge haengt und nicht am Panel - genau dieses Bild.
+// Die Befehle sind wiederholbar, ein zweiter Anlauf nach dem Start der Videoausgabe
+// kostet nichts und faengt den Fall ab.
+static void ws7_panel_wake(esp_lcd_panel_io_handle_t io, const char *wann)
+{
+    uint8_t zero = 0x00;
+    uint8_t madctl = WS7_MADCTL;
+    esp_rom_printf("[Panel] Weckbefehle %s\n", wann);
+    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));
+    BSP_STEP(esp_lcd_panel_io_tx_param(io, 0x29, &zero, 1), "Panel-Befehl Display On");
+    vTaskDelay(pdMS_TO_TICKS(20));
+}
 #endif
 
-    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);
-
-    esp_lcd_dsi_bus_handle_t mipi_dsi_bus;
+#if JC_PANEL_TYPE == WS_PANEL_7H
+// Baut die komplette DSI-Strecke auf: Bus, Kommandokanal, Bildausgabe, und weckt das
+// Panel. Bewusst als eigene Funktion, damit der ganze Vorgang wiederholbar ist.
+static bool ws7_dsi_bringup(esp_lcd_dsi_bus_handle_t *out_bus,
+                            esp_lcd_panel_io_handle_t *out_io,
+                            esp_lcd_panel_handle_t *out_panel,
+                            esp_lcd_dpi_panel_config_t *out_dpi_config)
+{
+    esp_lcd_dsi_bus_handle_t mipi_dsi_bus = NULL;
     esp_lcd_panel_io_handle_t io = NULL;
     esp_lcd_panel_handle_t disp_panel = NULL;
 
-#if JC_PANEL_TYPE == WS_PANEL_7H
-    // ---------------- Waveshare 7inch DSI LCD (H) (1280x720) ----------------
-    // Kein Hersteller-Panel-Treiber: DSI-Bus, DBI-Kommandokanal und DPI-Panel werden
-    // direkt angelegt. Entscheidend ist die Referenztaktquelle PLL_F20M - mit der
-    // Standardquelle bleibt das Bild auf ESP32-P4 Rev. 1.3 / ECO2 schwarz.
-    bsp_report_psram((size_t)BSP_LCD_H_RES * BSP_LCD_V_RES * BSP_LCD_FB_BYTES_PER_PX
-                     * LVGL_PORT_LCD_BUFFER_NUMS);
-
     esp_lcd_dsi_bus_config_t bus_config = {
         .bus_id = 0,
         .num_data_lanes = WS7_DSI_LANES,
@@ -363,6 +458,8 @@ bool jc_board_bringup(void)
 #else
         .pixel_format = LCD_COLOR_PIXEL_FORMAT_RGB565,
 #endif
+        // Anzahl der Bildspeicher. Beim Waveshare-Panel genau einer: mit zweien kam nach
+        // dem Einschalten kein Bild (siehe WS7_SINGLE_FB in pins_config.h).
         .num_fbs = LVGL_PORT_LCD_BUFFER_NUMS,
         .video_timing = {
             .h_size = BSP_LCD_H_RES,
@@ -387,19 +484,142 @@ bool jc_board_bringup(void)
         return false;
     }
 
-    // Panel wecken (MADCTL / Sleep Out / Display On). Ein Reset gibt es hier nicht:
-    // ein reines DPI-Panel kennt keine reset-Funktion, esp_lcd_panel_reset() wuerde
-    // ins Leere greifen.
-    {
-        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
-        vTaskDelay(pdMS_TO_TICKS(120));
-        esp_lcd_panel_io_tx_param(io, 0x29, &zero, 1);   // Display On
-        vTaskDelay(pdMS_TO_TICKS(20));
-    }
+    ws7_panel_wake(io, "vor dem Start der Videoausgabe");
+
     BSP_STEP(esp_lcd_panel_init(disp_panel), "DPI-Videoausgabe starten");
+
+    // Zweiter Anlauf, jetzt bei laufender Videoausgabe: faengt den Fall ab, dass das
+    // Panel beim ersten Mal noch nicht aufnahmebereit war.
+    vTaskDelay(pdMS_TO_TICKS(WS7_PANEL_SETTLE_MS));
+    ws7_bridge_core_init("nach dem Start der Videoausgabe");
+    ws7_panel_wake(io, "nach dem Start der Videoausgabe");
+
+    *out_bus = mipi_dsi_bus;
+    *out_io = io;
+    *out_panel = disp_panel;
+    *out_dpi_config = dpi_config;
+    return true;
+}
+#endif
+
+// Bringt Panel + Touch + LVGL-Port hoch (LVGL laeuft danach in eigenem Task).
+// Rueckgabe false: Panel kam nicht hoch - der Aufrufer darf dann KEINE LVGL-Funktion
+// 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,
+    };
+    BSP_STEP(esp_ldo_acquire_channel(&ldo_cfg, &phy_pwr_chan), "Stromversorgung MIPI-D-PHY");
+
+    esp_lcd_dsi_bus_handle_t mipi_dsi_bus = NULL;
+    esp_lcd_panel_io_handle_t io = NULL;
+    esp_lcd_panel_handle_t disp_panel = NULL;
+#if JC_PANEL_TYPE == WS_PANEL_7H
+    esp_lcd_dpi_panel_config_t dpi_config;
+#endif
+
+#if JC_PANEL_TYPE == WS_PANEL_7H
+    // ---------------- Waveshare 7inch DSI LCD (H) (1280x720) ----------------
+    // Kein Hersteller-Panel-Treiber: DSI-Bus, DBI-Kommandokanal und DPI-Panel werden
+    // direkt angelegt. Entscheidend ist die Referenztaktquelle PLL_F20M - mit der
+    // Standardquelle bleibt das Bild auf ESP32-P4 Rev. 1.3 / ECO2 schwarz.
+    bsp_report_psram((size_t)BSP_LCD_H_RES * BSP_LCD_V_RES * BSP_LCD_FB_BYTES_PER_PX
+                     * LVGL_PORT_LCD_BUFFER_NUMS);
+
+    if (!ws7_dsi_bringup(&mipi_dsi_bus, &io, &disp_panel, &dpi_config)) {
+        return false;
+    }
+
+#if WS7_DSI_RESTART
+    // Die Strecke einmal komplett ab- und wieder aufbauen.
+    //
+    // Beim ersten Einschalten kam trotz fehlerfreiem Hochlauf kein Bild; erst ein Reset
+    // half, und zwar zuverlaessig. Ein Reset unterscheidet sich an dieser Stelle nur in
+    // einem Punkt von unserem Ablauf: Die DSI-Verbindung geht einmal weg und neu auf,
+    // waehrend Bridge und Panel bereits versorgt und eingestellt sind. Weder die
+    // wiederholte Grundeinstellung der Bridge noch die wiederholten Weckbefehle ersetzen
+    // das. Genau dieser Ab- und Wiederaufbau wird hier nachgeholt - ohne Reset.
+    esp_rom_printf("[Panel] DSI-Strecke wird neu aufgebaut\n");
+    esp_lcd_panel_del(disp_panel);
+    esp_lcd_panel_io_del(io);
+    esp_lcd_del_dsi_bus(mipi_dsi_bus);
+    vTaskDelay(pdMS_TO_TICKS(WS7_DSI_RESTART_MS));
+
+    if (!ws7_dsi_bringup(&mipi_dsi_bus, &io, &disp_panel, &dpi_config)) {
+        return false;
+    }
+#endif
+#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();
@@ -489,6 +709,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.
@@ -535,7 +765,9 @@ bool jc_board_bringup(void)
     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/pins_config.h

@@ -32,7 +32,13 @@
 //                           startet der P4 nicht mehr, hier zuerst auf 0 stellen.
 // -------------------------------------------------------------------------------------
 #define WS7_COLOR_BITS        24
+// Ohne Wirkung, solange WS7_SINGLE_FB = 1 ist: Mit nur einem Bildspeicher gibt es keine
+// Doppelpufferung, zwischen deren Betriebsarten man waehlen koennte.
 #define WS7_PARTIAL_REFRESH    1
+// Nur EIN Bildspeicher. Zwei vertraegt die DSI-Ausgabe dieses Panels beim Einschalten
+// nicht - siehe die ausfuehrliche Begruendung weiter unten beim Avoid-Tear-Schalter.
+// Auf 0 nur, wenn das Startverhalten erneut untersucht wird.
+#define WS7_SINGLE_FB          1
 #define WS7_PARALLEL_RENDER    1
 
 #define EXAMPLE_LVGL_PORT_TASK_MAX_DELAY_MS 500  //range 2 to 2000
@@ -42,7 +48,25 @@
 #define EXAMPLE_LVGL_PORT_TASK_CORE         -1  //range -1 to 1
 #define EXAMPLE_LVGL_PORT_TICK              2   //ragne 1 to 100
 
+// Ruckelfreie Ausgabe braucht mindestens zwei Bildspeicher, aus denen abwechselnd
+// angezeigt und in die gezeichnet wird.
+//
+// Das Waveshare-Panel vertraegt das nicht: Mit zwei Bildspeichern kam nach dem Einschalten
+// kein Bild - der Hochlauf meldete durchgehend Erfolg, das Panel blieb dunkel, und erst ein
+// Reset half. Mit genau einem Bildspeicher startet es zuverlaessig; belegt wurde das mit den
+// Prueffarbbalken, die der Werks-Testsketch ebenfalls mit einem Speicher anzeigt.
+// Deshalb hier ohne Doppelpufferung: LVGL zeichnet in einen kleinen Zwischenpuffer, der
+// dann in den einen Bildspeicher uebertragen wird. Bei schnellen Bildwechseln kann dabei
+// kurz eine Kante sichtbar werden - ein zuverlaessig startendes Display wiegt das auf.
+#if (JC_PANEL_TYPE == WS_PANEL_7H) && WS7_SINGLE_FB
+#define EXAMPLE_LVGL_PORT_AVOID_TEAR_ENABLE   0
+// Zwischenpuffer fuer das Zeichnen: 120 Zeilen im PSRAM (rund 460 KB). Der interne
+// Speicher ist zu knapp, dort passt er nicht.
+#define CONFIG_EXAMPLE_LVGL_PORT_BUF_PSRAM    1
+#define CONFIG_EXAMPLE_LVGL_PORT_BUF_HEIGHT   120
+#else
 #define EXAMPLE_LVGL_PORT_AVOID_TEAR_ENABLE   1
+#endif
 
 #ifdef  EXAMPLE_LVGL_PORT_AVOID_TEAR_ENABLE
 // 2 = Triple-Buffer + LVGL Full-Refresh: zeichnet bei jeder Aenderung das komplette
@@ -140,6 +164,43 @@
 // 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
+
+// Pause zwischen dem Start der Videoausgabe und dem zweiten Anlauf der Weckbefehle.
+// Verpasst das Panel den ersten Anlauf, bleibt der Bildschirm dunkel, waehrend die
+// Beleuchtung brennt - sie haengt an der Bridge, nicht am Panel.
+#define WS7_PANEL_SETTLE_MS 200
+
+// Die DSI-Strecke beim Hochlauf einmal ab- und wieder aufbauen. Beim ersten Einschalten
+// kam sonst trotz fehlerfreiem Ablauf kein Bild; erst ein Reset half. Der einzige
+// Unterschied dabei: Die DSI-Verbindung geht einmal weg und neu auf, waehrend Bridge und
+// Panel schon versorgt und eingestellt sind. Genau das holt der zweite Aufbau nach.
+// Kostet WS7_DSI_RESTART_MS zusaetzliche Startzeit.
+#define WS7_DSI_RESTART    0
+#define WS7_DSI_RESTART_MS 200
+
+// Nach einem Kaltstart einmal selbst neu starten, sobald der erste Hochlauf durch ist.
+// Das Panel kommt beim ersten Anlauf nach dem Einschalten nicht zuverlaessig hoch;
+// ein echter Chip-Reset behebt es zuverlaessig, der Ab- und Wiederaufbau der
+// DSI-Strecke im Betrieb dagegen nicht. Kostet rund drei Sekunden beim Einschalten.
+// Eine Schleife ist ausgeschlossen: Beim zweiten Durchlauf ist der Startgrund kein
+// Kaltstart mehr.
+#define WS7_COLD_BOOT_RESTART 1
+
+#define WS7_TEST_PATTERN 0
+
 #elif JC_PANEL_TYPE == JC_PANEL_70
 
 #define LCD_H_RES 1024
@@ -148,7 +209,7 @@
 #define LCD_RST 27
 #define LCD_LED 23
 
-#elsealle
+#else
 
 #define LCD_H_RES 480
 #define LCD_V_RES 800