ESP32-2432S028R (CYD)-Display: Daten, Treiberrevisionen & Einrichtung
Das Cheap Yellow Display: ein 2,8-Zoll-240×320-SPI-TFT auf einem ESP32-Board. Je nach Charge wird es mit einem ILI9341- oder einem ST7789-Displaycontroller ausgeliefert, sodass derselbe Sketch auf einem Board funktioniert und auf einem anderen einen weißen Bildschirm zeigt.
Display-Daten des ESP32-2432S028R (CYD)
| MCU | ESP32 (ESP32-WROOM-32) |
|---|---|
| Display | 2.8″ · 240×320 |
| Display-Bus | SPI (HSPI) |
| Treiber-IC | ILI9341 oder ST7789 |
| Touch | XPT2046 resistiv (separate SPI-Pins) |
Welche ESP32-2432S028R (CYD)-Revision haben Sie?
Boards mit demselben Namen werden mit unterschiedlichen Display-Treiber-ICs ausgeliefert. Code für eine Revision zeigt auf der anderen einen weißen Bildschirm, falsche Farben oder gar nichts – bestimmen Sie also zuerst Ihre Revision.
| Revision | Treiber-IC | So erkennen Sie sie | Bibliothekseinstellungen |
|---|---|---|---|
| Original (Micro-USB) | ILI9341 | Funktioniert mit der unveränderten User_Setup.h der Community | TFT_eSPI: ILI9341_2_DRIVER, ohne Inversion |
| Spätere Chargen (teils mit zwei USB-Anschlüssen) | ST7789 | Weißer Bildschirm, ausgewaschene oder invertierte Farben mit dem ILI9341-Setup | TFT_eSPI: ST7789_DRIVER; TFT_INVERSION_ON/OFF und TFT_RGB_ORDER TFT_BGR einzeln nacheinander testen; Hintergrundbeleuchtung weiterhin an GPIO 21 |
Display- und Touch-Pins des ESP32-2432S028R (CYD)
| Signal | GPIO | Hinweise |
|---|---|---|
| TFT MOSI | 13 | HSPI |
| TFT MISO | 12 | HSPI |
| TFT SCLK | 14 | HSPI |
| TFT CS | 15 | |
| TFT DC | 2 | |
| TFT RST | -1 | Nicht mit einem GPIO verbunden |
| Backlight | 21 | Active High; nicht anderweitig nutzen |
| Touch CLK | 25 | XPT2046 |
| Touch CS | 33 | XPT2046 |
| Touch DIN (MOSI) | 32 | XPT2046 |
| Touch DO (MISO) | 39 | XPT2046 |
| Touch IRQ | 36 | XPT2046 |
Gleiche Display-Spezifikation für die Serienfertigung
Prototyp mit dem ESP32-2432S028R (CYD) gebaut? Diese Module aus unseren Direktfabriken haben dieselbe Panelgröße und Auflösung, kommen mit Datenblatt und festem Treiber-IC je Produktionslos und sind als Muster ab 1 Stk. erhältlich. MOQ und Lieferzeit werden projektbezogen vereinbart.
Vom ESP32-2432S028R-(CYD)-Prototyp zur Serie
Dev-Boards sind ideal, um eine UI zu erproben, aber ihre Panels werden auf dem freien Markt eingekauft: Der Controller kann zwischen Chargen wechseln (wie es bei diesem Board bereits passiert ist), ein Datenblatt gibt es selten, und die Lebensdauer ist nicht garantiert. Spezifizieren Sie für ein Produkt ein Modul mit festem Treiber-IC pro Fertigungslos, Datenblatt und Lebenszykluszusage.
Unsere Direktfabriken bauen Module im gleichen 2,8″-240×320-Format. Muster ab 1 Stück; MOQ und Lieferzeit werden pro Projekt mit unserem Vertriebsteam vereinbart.
Bevor Sie Code debuggen
- Bestätigen Sie, welche Revision Sie haben (Tabelle oben): Ein geänderter Treiber-IC ist die häufigste Ursache für einen weißen Bildschirm.
- Prüfen Sie, dass der Backlight-Pin in Ihrem Sketch nicht anderweitig genutzt wird.
- Ändern Sie jeweils nur eine Einstellung (Treiber, Inversion, Farbreihenfolge) und behalten Sie ein funktionierendes Beispiel zum Vergleich.
Konfigurationsbeispiele
#define ILI9341_2_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 320
#define TFT_BL 21
#define TFT_BACKLIGHT_ON HIGH
#define TFT_MISO 12
#define TFT_MOSI 13
#define TFT_SCLK 14
#define TFT_CS 15
#define TFT_DC 2
#define TFT_RST -1
#define SPI_FREQUENCY 55000000
#define SPI_READ_FREQUENCY 20000000
#define SPI_TOUCH_FREQUENCY 2500000
#define USE_HSPI_PORT// replace the ILI9341_2_DRIVER line with:
#define ST7789_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 320
// if colours are inverted, toggle ONE of these:
#define TFT_INVERSION_ON
// #define TFT_INVERSION_OFF
// if red and blue are swapped:
// #define TFT_RGB_ORDER TFT_BGR
// pins and SPI settings stay the same as the ILI9341 setupHäufige Fragen
Warum zeigt mein CYD einen weißen Bildschirm mit Code, der bei anderen funktioniert?
Ihr Board hat vermutlich den ST7789-Displaycontroller statt des ILI9341. Stellen Sie den TFT_eSPI-Treiber auf ST7789_DRIVER um und passen Sie Inversion und Farbreihenfolge an; die Pins bleiben gleich.
Welcher GPIO steuert die Hintergrundbeleuchtung des CYD?
GPIO 21, Active High. Wird GPIO 21 im Sketch anderweitig genutzt, wird der Bildschirm dunkel.
Warum funktioniert Touch in TFT_eSPI beim CYD nicht?
Der XPT2046-Touch-Controller liegt an eigenen Pins (CLK 25, CS 33, DIN 32, DO 39, IRQ 36), nicht am SPI-Bus des Displays; verwenden Sie daher eine separate XPT2046-Bibliotheksinstanz an diesen Pins.
Quellen
Unsicher, welches Display zu Ihrem Design passt?
Nennen Sie uns Größe, Schnittstelle und Host-Prozessor. Ein Display-Ingenieur antwortet innerhalb von 12 Stunden mit 2–3 Optionen, Datenblättern und Init-Code. Muster ab 1 Stk.