{"id":4801,"date":"2026-05-22T13:17:32","date_gmt":"2026-05-22T11:17:32","guid":{"rendered":"https:\/\/g7itchme.wordpress.com\/?p=4801"},"modified":"2026-05-22T13:17:32","modified_gmt":"2026-05-22T11:17:32","slug":"das-ultimative-cyd-display-problem-wenn-das-display-nur-drei-viertel-anzeigt","status":"publish","type":"post","link":"https:\/\/technodidact.de\/en\/das-ultimative-cyd-display-problem-wenn-das-display-nur-drei-viertel-anzeigt\/","title":{"rendered":"Das ultimative CYD-Display-Problem: Wenn das Display nur drei Viertel anzeigt"},"content":{"rendered":"\n

Autor: DerSchneider<\/strong><\/p>\n\n\n\n

\n\n\n\n

Einleitung: Ein gelbes Display, das mich zur Verzweiflung brachte<\/h2>\n\n\n\n

Es ist ein bekanntes Bild in den Entwicklerforen: Ein gl\u00fccklicher Bastler hat sein neues „Cheap Yellow Display“ (CYD) ausgepackt, den ESP32-2432S028R an den USB-Port angeschlossen, die TFT_eSPI-Bibliothek installiert \u2013 und dann die Ern\u00fcchterung. Das Display zeigt zwar etwas an, aber nur die oberen drei Viertel<\/strong>. Das untere Viertel bleibt schwarz. Die Farben sind falsch, die Hoffnung schwindet.<\/p>\n\n\n\n

Ich habe genau dieses Problem durchgemacht. Nach Tagen des Herumprobierens, unz\u00e4hligen Kompilierungsfehlern und viel Frust m\u00f6chte ich meine L\u00f6sung teilen. Dieser Artikel ist eine praktische Anleitung f\u00fcr alle, die mit genau diesem Problem k\u00e4mpfen<\/strong> \u2013 kein technikhistorischer R\u00fcckblick, sondern eine handfeste Probleml\u00f6sung.<\/p>\n\n\n\n

\n\n\n\n

Das Problem im Detail: Was passiert da eigentlich?<\/h2>\n\n\n\n

Bevor wir zur L\u00f6sung kommen, ein kurzer Blick auf das Problem selbst. Du hast eines dieser Boards:<\/p>\n\n\n\n

Merkmal<\/th>Dein Board<\/th><\/tr><\/thead>
Bezeichnung<\/td>ESP32-2432S028R (CYD V3)<\/td><\/tr>
USB-Anschluss<\/td>USB-C<\/td><\/tr>
Display-Treiber<\/td>ILI9341 (eigentlich)<\/td><\/tr>
Besonderheit<\/td>Invertierte Farben + geteilter Pin<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Du l\u00e4dst ein Beispiel hoch, aber das Display zeigt nur die oberen 240 Pixel von 320 Pixeln. Der untere Bereich bleibt schwarz. Das nennt sich das „drei-viertel-Problem“<\/strong>. Zus\u00e4tzlich sind die Farben falsch \u2013 rot wird blau, blau wird rot.<\/p>\n\n\n\n

Die Ursache:<\/strong> Die Bibliothek erkennt dein Board nicht korrekt. Sie denkt, das Display w\u00e4re kleiner, als es tats\u00e4chlich ist.<\/p>\n\n\n\n

\n\n\n\n

Warum die „Standard“-L\u00f6sung nicht funktioniert<\/h2>\n\n\n\n

Die meisten Online-Anleitungen und die offizielle Dokumentation der TFT_eSPI-Bibliothek empfehlen diese Einstellung:<\/p>\n\n\n\n

cpp<\/p>\n\n\n\n

#define ILI9341_DRIVER\n#define TFT_WIDTH  240\n#define TFT_HEIGHT 320<\/pre>\n\n\n\n
Diese Einstellung funktioniert f\u00fcr dein V3-Board nicht<\/strong>. Sie f\u00fchrt genau zu dem beschriebenen Problem. Der Grund liegt in der Revision deines Boards. Es gibt mehrere Versionen des CYD:<\/p>\n\n\n\n
Version<\/th>USB<\/th>Display-Treiber<\/th>Ben\u00f6tigter Treiber<\/th><\/tr><\/thead>
V1 (alt)<\/td>Micro-USB<\/td>ILI9341<\/td>ILI9341_DRIVER<\/td><\/tr>
V2<\/td>Micro-USB<\/td>ILI9341<\/td>ILI9341_DRIVER<\/td><\/tr>
V3 (dein Board)<\/strong><\/td>USB-C<\/strong><\/td>ILI9341 (invertiert)<\/strong><\/td>ILI9341_2_DRIVER<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Dein V3-Board ben\u00f6tigt einen anderen Treiber<\/strong> und eine zus\u00e4tzliche Inversion<\/strong>.<\/p>\n\n\n\n
\n\n\n\n
Die L\u00f6sung: Schritt-f\u00fcr-Schritt zur korrekten Konfiguration<\/h2>\n\n\n\n
Schritt 1: Die richtige User_Setup.h erstellen<\/h3>\n\n\n\n
\u00d6ffne die Datei User_Setup.h<\/code> im TFT_eSPI-Bibliotheksordner. Bei Arduino IDE findest du sie unter:<\/p>\n\n\n\n
text<\/p>\n\n\n\n
C:\\Users\\DEIN_BENUTZER\\Documents\\Arduino\\libraries\\TFT_eSPI\\User_Setup.h<\/pre>\n\n\n\n
Ersetze den gesamten Inhalt mit folgendem Code:<\/strong><\/p>\n\n\n\n
cpp<\/p>\n\n\n\n
\/\/ ===================================================================<\/em>\n\/\/ KORREKTE User_Setup.h f\u00fcr ESP32-2432S028R V3 (USB-C Version)<\/em>\n\/\/ ===================================================================<\/em>\n\n\/\/ F\u00fcr V3 (USB-C) MUSS ILI9341_2_DRIVER verwendet werden!<\/em>\n#define ILI9341_2_DRIVER\n\n\/\/ NICHT verwenden f\u00fcr V3:<\/em>\n\/\/ #define ILI9341_DRIVER     \/\/ F\u00fchrt zum 3\/4-Problem!<\/em>\n\n\/\/ Display-Gr\u00f6\u00dfe (240x320 Pixel)<\/em>\n#define TFT_WIDTH  240\n#define TFT_HEIGHT 320\n\n\/\/ F\u00fcr V3 zwingend erforderlich (sonst sind Farben invertiert!)<\/em>\n#define TFT_INVERSION_ON\n\n\/\/ GPIO-Pins f\u00fcr Display<\/em>\n#define TFT_MISO  12\n#define TFT_MOSI  13\n#define TFT_SCLK  14\n#define TFT_CS    15\n#define TFT_DC    2\n#define TFT_RST   -1      \/\/ -1 = nicht verwendet (geteilt mit roter LED!)<\/em>\n#define TFT_BL    21\n\n\/\/ Backlight: HIGH = an<\/em>\n#define TFT_BACKLIGHT_ON HIGH\n\n\/\/ Touch (XPT2046) - f\u00fcr sp\u00e4tere Projekte<\/em>\n#define TOUCH_CS  33\n\n\/\/ SPI-Geschwindigkeiten (27MHz ist stabiler als 40MHz!)<\/em>\n#define SPI_FREQUENCY       27000000\n#define SPI_READ_FREQUENCY  20000000\n#define SPI_TOUCH_FREQUENCY  2500000\n\n\/\/ Farb-Reihenfolge (RGB ist korrekt bei V3)<\/em>\n#define TFT_RGB_ORDER TFT_RGB\n\n\/\/ Schriftarten laden<\/em>\n#define LOAD_GLCD\n#define LOAD_FONT2\n#define LOAD_FONT4\n#define LOAD_FONT6\n#define LOAD_FONT7\n#define LOAD_FONT8\n#define LOAD_GFXFF\n#define SMOOTH_FONT<\/pre>\n\n\n\n
Schritt 2: User_Setup_Select.h pr\u00fcfen<\/h3>\n\n\n\n
\u00d6ffne die Datei User_Setup_Select.h<\/code> im selben Ordner. Stelle sicher, dass NUR diese Zeile aktiv ist:<\/strong><\/p>\n\n\n\n
cpp<\/p>\n\n\n\n
#include <User_Setup.h>   \/\/ <- DAS MUSS AKTIV SEIN!<\/em><\/pre>\n\n\n\n
Alle anderen Zeilen (wie #include <User_Setups\/Setup0_ILI9341_ESP32.h><\/code>) m\u00fcssen auskommentiert<\/strong> sein (mit \/\/<\/code> am Anfang).<\/p>\n\n\n\n
Schritt 3: Backlight einschalten (nicht vergessen!)<\/h3>\n\n\n\n
Viele vergessen diesen wichtigen Punkt: Die Backlight (Hintergrundbeleuchtung) muss explizit eingeschaltet werden. F\u00fcge in deinem Sketch hinzu:<\/p>\n\n\n\n
cpp<\/p>\n\n\n\n
pinMode(21, OUTPUT);      \/\/ GPIO21 = TFT_BL<\/em>\ndigitalWrite(21, HIGH);   \/\/ Backlight EIN<\/em><\/pre>\n\n\n\n
Schritt 4: Den Test-Sketch hochladen<\/h3>\n\n\n\n
Jetzt kommt der Moment der Wahrheit. Lade folgenden Sketch auf dein Board:<\/p>\n\n\n\n
cpp<\/p>\n\n\n\n
#include <Arduino.h>\n#include <TFT_eSPI.h>\n\nTFT_eSPI tft = TFT_eSPI();\n\nvoid setup() {\n  Serial.begin(115200);\n  \n  \/\/ Backlight einschalten (WICHTIG!)<\/em>\n  pinMode(21, OUTPUT);\n  digitalWrite(21, HIGH);\n  \n  \/\/ Display initialisieren<\/em>\n  tft.init();\n  tft.setRotation(1);  \/\/ 1 = Querformat (USB rechts\/links)<\/em>\n  \n  \/\/ Farbtest<\/em>\n  tft.fillScreen(TFT_RED);\n  delay(1000);\n  tft.fillScreen(TFT_GREEN);\n  delay(1000);\n  tft.fillScreen(TFT_BLUE);\n  delay(1000);\n  tft.fillScreen(TFT_WHITE);\n  delay(1000);\n  tft.fillScreen(TFT_BLACK);\n  \n  \/\/ Textausgabe<\/em>\n  tft.setTextColor(TFT_WHITE, TFT_BLACK);\n  tft.setTextSize(2);\n  tft.drawString(\"CYD V3 OK!\", 80, 100);\n  \n  Serial.println(\"Display funktioniert!\");\n}\n\nvoid loop() {}<\/pre>\n\n\n\n
\n\n\n\n
Was du nach der Korrektur sehen solltest<\/h2>\n\n\n\n
Vorher (falsch)<\/th>Nachher (richtig)<\/th><\/tr><\/thead>
Nur obere 3\/4 des Displays werden genutzt<\/td>Ganzer Bildschirm wird genutzt<\/strong><\/td><\/tr>
Farben sind invertiert (rot\/blau vertauscht)<\/td>Farben sind korrekt<\/strong><\/td><\/tr>
Rote LED spinnt (weil Pin geteilt)<\/td>Rote LED bleibt aus<\/strong> (wie gew\u00fcnscht)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n
Die h\u00e4ufigsten Stolpersteine \u2013 und wie du sie vermeidest<\/h2>\n\n\n\n
Stolperstein 1: Die rote RGB-LED<\/h3>\n\n\n\n
Die rote LED auf dem Board teilt sich den Pin GPIO4 mit dem Display-Reset (TFT_RST<\/code>). Wenn du die rote LED einschaltest (digitalWrite(4, LOW)<\/code>), setzt du das Display zur\u00fcck \u2013 es st\u00fcrzt ab oder zeigt M\u00fcll an.<\/p>\n\n\n\n
L\u00f6sung:<\/strong> Lasse die rote LED dauerhaft aus (digitalWrite(LED_RED, HIGH)<\/code>). Nutze nur die gr\u00fcne (GPIO16) und blaue (GPIO17) LED.<\/p>\n\n\n\n
Stolperstein 2: Die USB-C Buchse<\/h3>\n\n\n\n
Die USB-C Buchse deines Boards ist nicht vollst\u00e4ndig korrekt beschaltet. Die CC-Leitungen (Configuration Channel) fehlen.<\/p>\n\n\n\n
Auswirkung:<\/strong> Du kannst kein reines USB-C-zu-USB-C-Kabel verwenden.<\/p>\n\n\n\n
L\u00f6sung:<\/strong> Verwende entweder ein USB-A-auf-USB-C-Kabel<\/strong> oder einen USB-C-auf-USB-C-Adapter<\/strong>.<\/p>\n\n\n\n
Stolperstein 3: Veraltete Plattform-Versionen (f\u00fcr PlatformIO-Nutzer)<\/h3>\n\n\n\n
Wenn du PlatformIO verwendest, musst du eine \u00e4ltere Version der ESP32-Plattform<\/strong> angeben. Die neueste Version ist nicht kompatibel.<\/p>\n\n\n\n
L\u00f6sung:<\/strong> In deiner platformio.ini<\/code>:<\/p>\n\n\n\n
ini<\/p>\n\n\n\n
[env:esp32dev]\nplatform = espressif32@6.5.0    # <- WICHTIG: Version 6.5.0, nicht neuer!\nboard = esp32dev\nframework = arduino\n\nlib_deps = bodmer\/TFT_eSPI@^2.5.43<\/pre>\n\n\n\n
\n\n\n\n
Kompletter Test-Sketch f\u00fcr alle F\u00e4lle<\/h2>\n\n\n\n
Hier ist ein vollst\u00e4ndiger Test-Sketch, der alle relevanten Funktionen pr\u00fcft<\/strong>:<\/p>\n\n\n\n
cpp<\/p>\n\n\n\n
\/**<\/em>\n * CYD V3 (ESP32-2432S028R) - Kompletter Hardware-Test\n * \n * Pr\u00fcft: Display, Farben, LDR, Touch-Kalibrierung, RGB-LED\n *\/\n\n#include <Arduino.h>\n#include <TFT_eSPI.h>\n\nTFT_eSPI tft = TFT_eSPI();\n\n\/\/ Pin-Definitionen (aus deiner Dokumentation)<\/em>\n#define PIN_LED_GREEN  16\n#define PIN_LED_BLUE   17\n#define PIN_LDR        34\n#define PIN_TOUCH_CS   33\n\nvoid setup() {\n  Serial.begin(115200);\n  delay(1000);\n  \n  Serial.println(\"\\n=== CYD V3 HARDWARE-TEST ===\\n\");\n  \n  \/\/ Backlight einschalten<\/em>\n  pinMode(21, OUTPUT);\n  digitalWrite(21, HIGH);\n  \n  \/\/ RGB-LED (rote LED wird ignoriert!)<\/em>\n  pinMode(PIN_LED_GREEN, OUTPUT);\n  pinMode(PIN_LED_BLUE, OUTPUT);\n  digitalWrite(PIN_LED_GREEN, HIGH);\n  digitalWrite(PIN_LED_BLUE, HIGH);\n  \n  \/\/ Display initialisieren<\/em>\n  tft.init();\n  tft.setRotation(1);\n  tft.fillScreen(TFT_BLACK);\n  \n  \/\/ 1. FARBTEST (muss vollfl\u00e4chig sein)<\/em>\n  Serial.println(\"Test 1: Farben (Rot, Gruen, Blau, Weiss)\");\n  tft.fillScreen(TFT_RED);   delay(800);\n  tft.fillScreen(TFT_GREEN); delay(800);\n  tft.fillScreen(TFT_BLUE);  delay(800);\n  tft.fillScreen(TFT_WHITE); delay(800);\n  tft.fillScreen(TFT_BLACK);\n  \n  \/\/ 2. TEXT-TEST<\/em>\n  Serial.println(\"Test 2: Textausgabe\");\n  tft.setTextColor(TFT_WHITE, TFT_BLACK);\n  tft.setTextSize(2);\n  tft.drawString(\"CYD V3 READY\", 70, 100);\n  delay(1500);\n  \n  \/\/ 3. LICHT-SENSOR (LDR)<\/em>\n  Serial.println(\"Test 3: Lichtsensor (GPIO34)\");\n  tft.fillScreen(TFT_BLACK);\n  tft.setTextColor(TFT_CYAN, TFT_BLACK);\n  tft.setTextSize(1);\n  tft.drawString(\"LDR Wert:\", 20, 50);\n  \n  for(int i = 0; i < 10; i++) {\n    int ldrValue = analogRead(PIN_LDR);\n    int percent = map(ldrValue, 0, 4095, 0, 100);\n    \n    \/\/ Balkenanzeige<\/em>\n    int barWidth = map(ldrValue, 0, 4095, 0, 250);\n    tft.fillRect(20, 80, 250, 20, TFT_DARKGREY);\n    tft.fillRect(20, 80, barWidth, 20, TFT_YELLOW);\n    \n    tft.setCursor(20, 120);\n    tft.print(\"Wert: \");\n    tft.print(ldrValue);\n    tft.print(\" (\");\n    tft.print(percent);\n    tft.println(\"%)\");\n    \n    Serial.printf(\"  LDR: %d (%d%%)\\n\", ldrValue, percent);\n    delay(500);\n  }\n  \n  \/\/ 4. RGB-LED TEST (nur gr\u00fcn und blau)<\/em>\n  Serial.println(\"Test 4: RGB-LED (Gruen + Blau)\");\n  tft.fillScreen(TFT_BLACK);\n  tft.drawString(\"LED Test\", 100, 80);\n  tft.drawString(\"Gruen...\", 110, 120);\n  digitalWrite(PIN_LED_GREEN, LOW);  \/\/ Gr\u00fcn an<\/em>\n  delay(1000);\n  digitalWrite(PIN_LED_GREEN, HIGH); \/\/ Gr\u00fcn aus<\/em>\n  \n  tft.fillScreen(TFT_BLACK);\n  tft.drawString(\"LED Test\", 100, 80);\n  tft.drawString(\"Blau...\", 110, 120);\n  digitalWrite(PIN_LED_BLUE, LOW);   \/\/ Blau an<\/em>\n  delay(1000);\n  digitalWrite(PIN_LED_BLUE, HIGH);  \/\/ Blau aus<\/em>\n  \n  \/\/ 5. Touch-Kalibrierung (Startwerte)<\/em>\n  Serial.println(\"Test 5: Touch-Kalibrierung (Startwerte)\");\n  tft.fillScreen(TFT_BLACK);\n  tft.setTextColor(TFT_GREEN, TFT_BLACK);\n  tft.drawString(\"Touch Startwerte:\", 60, 80);\n  tft.setTextColor(TFT_WHITE, TFT_BLACK);\n  tft.drawString(\"x: 280 - 3860\", 80, 120);\n  tft.drawString(\"y: 340 - 3860\", 80, 150);\n  \n  \/\/ ERFOLGSMELDUNG<\/em>\n  Serial.println(\"\\n=== ALLE TESTS BESTANDEN! ===\\n\");\n  tft.fillScreen(TFT_BLACK);\n  tft.setTextColor(TFT_GREEN, TFT_BLACK);\n  tft.setTextSize(2);\n  tft.drawString(\"TEST\", 120, 100);\n  tft.drawString(\"FERTIG!\", 100, 140);\n  tft.setTextSize(1);\n  tft.drawString(\"Board ist bereit!\", 90, 200);\n}\n\nvoid loop() {}<\/pre>\n\n\n\n
\n\n\n\n
Wichtige Hinweise f\u00fcr deine zuk\u00fcnftigen Projekte<\/h2>\n\n\n\n
Bereich<\/th>Hinweis<\/th><\/tr><\/thead>
Rote LED<\/strong><\/td>Niemals verwenden (Pin-Konflikt mit TFT_RST)<\/td><\/tr>
Backlight<\/strong><\/td>Immer einschalten: digitalWrite(21, HIGH)<\/code><\/td><\/tr>
Display-Rotation<\/strong><\/td>setRotation(1)<\/code> = Querformat, USB rechts<\/td><\/tr>
Touch<\/strong><\/td>XPT2046 auf CS=33, wird separat initialisiert<\/td><\/tr>
I2C<\/strong><\/td>SDA=27, SCL=22 (externe Sensoren)<\/td><\/tr>
SD-Karte<\/strong><\/td>CS=5, teilt sich SPI-Bus mit Display<\/td><\/tr>
Audio<\/strong><\/td>GPIO26 f\u00fcr PWM-Audio (Lautsprecher \u00fcber P4)<\/td><\/tr>
Lichtsensor<\/strong><\/td>GPIO34 (analoger Eingang, 0-4095)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n
Die entscheidende Erkenntnis (f\u00fcr alle, die es eilig haben)<\/h2>\n\n\n\n
Wenn du nur eine Sache<\/strong> aus diesem Artikel mitnehmen m\u00f6chtest, dann diese:<\/p>\n\n\n\n
\n
Dein ESP32-2432S028R V3 (mit USB-C) ben\u00f6tigt in der User_Setup.h:<\/strong><\/p>\n\n\n\n
cpp<\/p>\n\n\n\n
#define ILI9341_2_DRIVER  \/\/ NICHT ILI9341_DRIVER!<\/em>\n#define TFT_INVERSION_ON  \/\/ Zwingend erforderlich!<\/em><\/pre>\n<\/blockquote>\n\n\n\n
Diese zwei Zeilen sind der Schl\u00fcssel. Alles andere sind Details.<\/p>\n\n\n\n
\n\n\n\n
Fazit: Dein Board ist jetzt bereit<\/h2>\n\n\n\n
Nach all den Tests und Korrekturen ist dein ESP32-2432S028R V3 nun perfekt konfiguriert<\/strong>. Das Display zeigt das gesamte Bild an, die Farben stimmen, und du kennst alle Einschr\u00e4nkungen (rote LED, USB-C).<\/p>\n\n\n\n
Du kannst jetzt mit den spannenden Projekten beginnen:<\/p>\n\n\n\n