Display ESP32-2432S028R (CYD): specifiche, revisioni del driver e configurazione
Il Cheap Yellow Display: un TFT SPI da 2,8 pollici 240×320 su una scheda ESP32. A seconda del lotto viene fornito con un controller display ILI9341 o ST7789, quindi lo stesso sketch può funzionare su una scheda e mostrare uno schermo bianco su un’altra.
Specifiche del display ESP32-2432S028R (CYD)
| MCU | ESP32 (ESP32-WROOM-32) |
|---|---|
| Display | 2.8″ · 240×320 |
| Bus display | SPI (HSPI) |
| Driver IC | ILI9341 o ST7789 |
| Touch | XPT2046 resistivo (pin SPI separati) |
Quale revisione del ESP32-2432S028R (CYD) hai?
Schede vendute con lo stesso nome vengono fornite con driver IC del display diversi. Il codice scritto per una revisione mostra uno schermo bianco, colori sbagliati o nulla sull’altra: identifica prima la tua.
| Revisione | Driver IC | Come identificarlo | Impostazioni della libreria |
|---|---|---|---|
| Originale (micro-USB) | ILI9341 | Funziona con lo User_Setup.h della community senza modifiche | TFT_eSPI: ILI9341_2_DRIVER, senza inversione |
| Lotti successivi (alcuni con due porte USB) | ST7789 | Schermo bianco, colori slavati o invertiti con la configurazione ILI9341 | TFT_eSPI: ST7789_DRIVER; prova TFT_INVERSION_ON/OFF e TFT_RGB_ORDER TFT_BGR uno alla volta; retroilluminazione sempre sul GPIO 21 |
Pin display e touch del ESP32-2432S028R (CYD)
| Segnale | GPIO | Note |
|---|---|---|
| TFT MOSI | 13 | HSPI |
| TFT MISO | 12 | HSPI |
| TFT SCLK | 14 | HSPI |
| TFT CS | 15 | |
| TFT DC | 2 | |
| TFT RST | -1 | Non collegato a un GPIO |
| Backlight | 21 | Attivo alto; non riutilizzare |
| Touch CLK | 25 | XPT2046 |
| Touch CS | 33 | XPT2046 |
| Touch DIN (MOSI) | 32 | XPT2046 |
| Touch DO (MISO) | 39 | XPT2046 |
| Touch IRQ | 36 | XPT2046 |
Stessa specifica display per la produzione in serie
Prototipo realizzato sul ESP32-2432S028R (CYD)? Questi moduli delle nostre fabbriche dirette condividono dimensione e risoluzione del pannello, sono forniti con datasheet e driver IC fisso per lotto di produzione e sono disponibili in campioni da 1 pz. MOQ e tempi concordati per progetto.
Dal prototipo ESP32-2432S028R (CYD) alla produzione
Le schede di sviluppo sono ideali per validare una UI, ma i loro pannelli vengono acquistati sul mercato aperto: il controller può cambiare tra un lotto e l’altro (come è già successo su questa scheda), raramente c’è un datasheet e la durata non è garantita. Per un prodotto, specifica un modulo con driver IC fisso per lotto di produzione, un datasheet e un impegno sul ciclo di vita.
Le nostre fabbriche dirette producono moduli nello stesso formato 2,8″ 240×320. Campioni da 1 pz; MOQ e tempi di consegna concordati per progetto con il nostro team commerciale.
Prima di fare il debug del codice
- Verifica quale revisione hai (tabella sopra): il cambio di driver IC è la causa più comune dello schermo bianco.
- Controlla che il pin della retroilluminazione non sia riutilizzato nello sketch.
- Cambia un’impostazione alla volta (driver, inversione, ordine dei colori) e tieni un esempio funzionante per il confronto.
Esempi di configurazione
#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 setupDomande frequenti
Perché il mio CYD mostra uno schermo bianco con codice che ad altri funziona?
Probabilmente la tua scheda ha il controller display ST7789 invece dell’ILI9341. Cambia il driver TFT_eSPI in ST7789_DRIVER e regola inversione e ordine dei colori; i pin restano gli stessi.
Quale GPIO controlla la retroilluminazione del CYD?
GPIO 21, attivo alto. Riutilizzare il GPIO 21 nello sketch spegne lo schermo.
Perché il touch non funziona in TFT_eSPI sul CYD?
Il controller touch XPT2046 è su pin propri (CLK 25, CS 33, DIN 32, DO 39, IRQ 36), non sul bus SPI del display, quindi usa un’istanza separata della libreria XPT2046 su quei pin.
Fonti
Non sai quale display è adatto al tuo progetto?
Inviaci dimensione, interfaccia e processore host. Un display engineer risponde entro 12 ore con 2–3 opzioni, datasheet e codice di inizializzazione. Campioni da 1 pz.