RGB-Panel glitcht nur mit WiFi: eine ESP32-S3-Fallstudie mit PSRAM

Setup. Waveshare ESP32-S3-Touch-LCD-7 (800×480-RGB-Panel mit ST7262, 16-Bit RGB565, GT911-Touch, 8 MB Octal-PSRAM, 16 MB Flash). PlatformIO mit platform = espressif32 8.0.0 (Arduino-Core 3.3.x, ESP-IDF 5.5), LVGL 9.2.2, ein Framebuffer im PSRAM, 16 MHz Pixeltakt, Bounce-Buffer (10 Zeilen), LVGL mit Partial Rendering. Die Firmware ist ein Dashboard, das per WiFi Home Assistant abfragt.

Symptom. Das Bild war eine Weile in Ordnung, dann tauchten waagerechte Linien am linken Rand auf, es flackerte, das Bild war um ein paar Pixel verschoben und blieb teilweise bis zum Neustart so. Es passierte beim Boot, wenn WiFi und die ersten HTTP-Requests starten, und jedes Mal, wenn die App eine ganze Salve an Netzwerk-Requests abgesetzt hat (zum Beispiel wenn man auf einer Seite mit Statistiken den Zeitraum umgeschaltet hat).

Der irreführende Teil. Ein anderes USB-Kabel oder Netzteil hat verändert, wie schnell es glitcht. Das sieht nach einem Stromproblem aus. War es aber nicht: vier Kabel, zwei Netzteile und beide USB-Ports haben alle geglitcht, nur zu unterschiedlichen Zeitpunkten. Der Zeitpunkt der Netzwerklast schwankt, und genau darauf haben die Kabelwechsel scheinbar Einfluss gehabt. Die originale Waveshare-Demo hat nie geglitcht, nutzt aber auch gar kein WiFi.

So findest du heraus, was los ist. Zwei Build-Schalter haben aus „es glitcht manchmal“ etwas Messbares gemacht:

  1. Ein Build ohne WiFi und ohne jegliches Netzwerk-Polling (-DNO_NET). Der blieb so lange sauber, wie wir zugeschaut haben. Damit waren Panel, Verdrahtung und Stromversorgung ausgeschlossen.
  2. Ein Stress-Build, der von selbst auf die Seite springt, die Daten abruft, und die Anfrage alle 4 s ändert. Zwei Minuten zuschauen reichen dann, um Konfigurationen zu vergleichen.

Was nicht geholfen hat (jeweils einzeln mit dem Stress-Build probiert):

  • Niedrigerer Pixeltakt (12 MHz): Das Panel hat komplett den Sync verloren und ist durch Weiß, Rot, Grün, Blau, Schwarz gezappt. Finger weg vom Takt.
  • Bounce-Buffer mit 20 statt 10 Zeilen: spürbar besser, aber nicht weg. 30 Zeilen waren nicht besser, und die zwei Bounce-Buffer fressen internen RAM, sodass dem WiFi der Speicher knapp wurde.
  • DMA-Burst-Größe 64 und das Flag bb_invalidate_cache: kein klarer Unterschied.
  • Requests nacheinander statt als Salve abschicken: kein klarer Unterschied.

Ein Teilerfolg: nicht den ganzen Heap ins PSRAM legen. Die Firmware hat heap_caps_malloc_extmem_enable(16) aufgerufen, damit LVGLs viele kleine Objekte den internen RAM nicht aufbrauchen. Dadurch sind aber auch alle kleinen Allokationen von WiFi, HTTP und JSON-Verarbeitung ins PSRAM gewandert. Die Netzwerkarbeit hat also mit dem LCD konkurriert, das ständig den Framebuffer aus dem PSRAM liest. Das rauszunehmen und LVGL einen eigenen PSRAM-Allokator zu geben (LV_USE_STDLIB_MALLOC = LV_STDLIB_CUSTOM, heap_caps_malloc(..., MALLOC_CAP_SPIRAM)) hat sichtbar geholfen und internen RAM freigemacht (von etwa 50 KB auf 86 KB frei), die Glitches aber nicht beseitigt.

Der Fix: die Bibliotheken mit anderer sdkconfig neu bauen. Die vorkompilierten Arduino-Bibliotheken kommen mit einer festen ESP-IDF-Konfiguration. Etliche ihrer Einstellungen passen schlecht zu einem Framebuffer im PSRAM plus WiFi. PlatformIO kann Arduino als ESP-IDF-Komponente kompilieren (framework = arduino, espidf) und eine eigene sdkconfig.defaults anwenden. Wir haben die Arduino-S3-Konfiguration qio_opi als Basis genommen und Folgendes geändert:

EinstellungArduino-StandardVerwendet
CONFIG_LCD_RGB_ISR_IRAM_SAFEausan
CONFIG_ESP32S3_DATA_CACHE_64KB / _LINE_64B32 KB, 32-B-Zeilen64 KB, 64-B-Zeilen
CONFIG_ESP32S3_INSTRUCTION_CACHE_32KB16 KB32 KB
CONFIG_SPIRAM_FETCH_INSTRUCTIONS, CONFIG_SPIRAM_RODATAausan (Code und Rodata laufen aus dem PSRAM)
CONFIG_ESP_WIFI_IRAM_OPT, CONFIG_ESP_WIFI_RX_IRAM_OPT, CONFIG_LWIP_IRAM_OPTIMIZATIONausan
CONFIG_SPIRAM_TRY_ALLOCATE_WIFI_LWIPanaus (WiFi-Buffer bleiben im internen RAM)

Mit diesem Build hat der Stress-Lauf keine Glitches gezeigt. Der Besitzer meldete „nicht ein einziger Glitch“, während er zugeschaut hat. Aus dem längeren Alltagsbetrieb gibt es noch keine Rückmeldung.

Einschränkungen, ganz ehrlich.

  • Wir haben diese Einstellungen zusammen geändert und nicht einzeln durchprobiert, welche die entscheidende ist. Ein plausibler Mechanismus: Der LCD-Interrupt war nicht IRAM-sicher, kann also nicht laufen, während der Flash-Cache abgeschaltet ist (das passiert beim WiFi-Start und bei der Kalibrierung), und die kleinen Caches lassen Framebuffer-Zugriffe und WiFi-Code sich gegenseitig rauswerfen. Das ist eine Hypothese, keine Messung.
  • Die neue Konfiguration braucht mehr internen RAM (IRAM-Optimierungen, größere Caches). Mit 20 Zeilen Bounce-Buffer und 15 Zeilen LVGL-Draw-Buffern ist WiFi nicht mehr gestartet („Expected to init 4 rx buffers, actual is 3“). Mit 10 und 10 läuft es und es bleiben etwa 49 KB freier Heap.
  • Getestet wurde bisher nur ein paar Minuten im Stress-Lauf, kein langer Dauertest.
  • Der erste Hybrid-Build lädt ESP-IDF herunter und kompiliert mehrere Minuten. In unserem Setup hat die idf_component.yml des Arduino-Frameworks außerdem unverwandte Espressif-Komponenten (RainMaker, Insights, Spracherkennung) nachgezogen, die den Build kaputtgemacht haben. Die Liste haben wir mit einem kleinen Skript gekürzt.
  • Hybrid-Builds verwenden kein build_src_filter. Die Quellen stehen in einer src/CMakeLists.txt, und eingebettete Dateien brauchen einen anderen Mechanismus (wir haben ein Assembler-.incbin genommen).

Video-Beweis. vor und nach dem Fix

Analyse, Experimente und Fix hat Claude (Anthropic) über Claude Code gemacht, der Projektbesitzer hat jeden Build auf der Hardware getestet.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

Diese Website verwendet Akismet, um Spam zu reduzieren. Erfahre, wie deine Kommentardaten verarbeitet werden.