Display ESP32-2432S028R (CYD): especificações, revisões do driver e configuração
A Cheap Yellow Display: um TFT SPI de 2,8 polegadas e 240×320 em uma placa ESP32. Os lotes saem com controlador de display ILI9341 ou ST7789, então o mesmo sketch pode funcionar em uma placa e mostrar tela branca em outra.
Especificações do display do ESP32-2432S028R (CYD)
| MCU | ESP32 (ESP32-WROOM-32) |
|---|---|
| Display | 2.8″ · 240×320 |
| Barramento do display | SPI (HSPI) |
| CI driver | ILI9341 ou ST7789 |
| Touch | XPT2046 resistivo (pinos SPI separados) |
Qual revisão do ESP32-2432S028R (CYD) você tem?
Placas vendidas com o mesmo nome saem com CIs driver de display diferentes. Código escrito para uma revisão mostra tela branca, cores erradas ou nada na outra, então identifique a sua primeiro.
| Revisão | CI driver | Como identificar | Configurações da biblioteca |
|---|---|---|---|
| Original (micro-USB) | ILI9341 | Funciona com o User_Setup.h da comunidade sem alterações | TFT_eSPI: ILI9341_2_DRIVER, sem inversão |
| Lotes posteriores (alguns com duas portas USB) | ST7789 | Tela branca, cores lavadas ou invertidas com a configuração ILI9341 | TFT_eSPI: ST7789_DRIVER; teste TFT_INVERSION_ON/OFF e TFT_RGB_ORDER TFT_BGR um de cada vez; o backlight continua no GPIO 21 |
Pinos de display e touch do ESP32-2432S028R (CYD)
| Sinal | GPIO | Observações |
|---|---|---|
| TFT MOSI | 13 | HSPI |
| TFT MISO | 12 | HSPI |
| TFT SCLK | 14 | HSPI |
| TFT CS | 15 | |
| TFT DC | 2 | |
| TFT RST | -1 | Não conectado a um GPIO |
| Backlight | 21 | Ativo em nível alto; não reutilize |
| Touch CLK | 25 | XPT2046 |
| Touch CS | 33 | XPT2046 |
| Touch DIN (MOSI) | 32 | XPT2046 |
| Touch DO (MISO) | 39 | XPT2046 |
| Touch IRQ | 36 | XPT2046 |
A mesma especificação de display para produção em volume
Fez o protótipo no ESP32-2432S028R (CYD)? Estes módulos das nossas fábricas diretas têm o mesmo tamanho e resolução de painel, vêm com datasheet e CI driver fixo por lote de produção e estão disponíveis em amostras a partir de 1 pç. Quantidade mínima e prazo são definidos por projeto.
Do protótipo com ESP32-2432S028R (CYD) à produção
Placas de desenvolvimento são ideais para validar uma interface, mas seus painéis são comprados no mercado aberto: o controlador pode mudar entre lotes (como já aconteceu com esta placa), raramente há datasheet e a vida útil não é garantida. Para um produto, especifique um módulo com CI driver fixo por lote de produção, datasheet e compromisso de ciclo de vida.
Nossas fábricas diretas fabricam módulos no mesmo formato de 2,8″ e 240×320. Amostras a partir de 1 pç; quantidade mínima e prazo são definidos por projeto com nossa equipe comercial.
Antes de depurar o código
- Confirme qual revisão você tem (tabela acima): mudanças de CI driver são a causa mais comum de tela branca.
- Verifique se o pino do backlight não é reutilizado no seu sketch.
- Mude um ajuste de cada vez (driver, inversão, ordem de cor) e mantenha um exemplo que funciona para comparar.
Exemplos de configuração
#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 setupPerguntas frequentes
Por que minha CYD mostra tela branca com um código que funciona para outros?
Provavelmente sua placa tem o controlador de display ST7789 em vez do ILI9341. Mude o driver do TFT_eSPI para ST7789_DRIVER e ajuste a inversão e a ordem de cor; os pinos continuam os mesmos.
Qual GPIO controla o backlight da CYD?
GPIO 21, ativo em nível alto. Reutilizar o GPIO 21 no seu sketch apaga a tela.
Por que o touch não funciona no TFT_eSPI na CYD?
O controlador de touch XPT2046 fica em pinos próprios (CLK 25, CS 33, DIN 32, DO 39, IRQ 36), não no barramento SPI do display, então use uma instância separada da biblioteca XPT2046 nesses pinos.
Fontes
Não sabe qual display combina com o seu projeto?
Envie o tamanho, a interface e o processador host. Um engenheiro de displays responde em até 12 horas com 2–3 opções, datasheets e código de inicialização. Amostras a partir de 1 pç.