Display Waveshare ESP32-S3-Touch-LCD-1.28: especificações, revisões do driver e configuração
Uma placa com display IPS redondo de 1,28 polegadas e 240×240 com controlador GC9A01, touch CST816S e IMU QMI8658 sobre ESP32-S3: uma base comum para mostradores de relógio e interfaces com botão giratório.
Especificações do display do Waveshare ESP32-S3-Touch-LCD-1.28
| MCU | ESP32-S3 |
|---|---|
| Display | 1.28″ · 240×240 · redondo |
| Barramento do display | SPI |
| CI driver | GC9A01 |
| Touch | CST816S capacitivo (I2C) |
Qual revisão do Waveshare ESP32-S3-Touch-LCD-1.28 você tem?
Configuração de display conhecida para esta placa.
| Revisão | CI driver | Como identificar | Configurações da biblioteca |
|---|---|---|---|
| ESP32-S3-Touch-LCD-1.28 | GC9A01 | TFT_eSPI: GC9A01_DRIVER; LovyanGFX: Panel_GC9A01 |
Pinos de display e touch do Waveshare ESP32-S3-Touch-LCD-1.28
| Sinal | GPIO | Observações |
|---|---|---|
| LCD SCLK | 10 | SPI |
| LCD MOSI | 11 | SPI |
| LCD CS | 9 | |
| LCD DC | 8 | |
| LCD RST | 14 | |
| Backlight | 2 | |
| Touch/IMU SDA | 6 | I2C, compartilhado com QMI8658 |
| Touch/IMU SCL | 7 | I2C |
| Touch INT | 5 | CST816S |
| Touch RST | 13 | CST816S |
A mesma especificação de display para produção em volume
Fez o protótipo no Waveshare ESP32-S3-Touch-LCD-1.28? 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 Waveshare ESP32-S3-Touch-LCD-1.28 à 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, 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 1,28″ e 240×240. 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 GC9A01_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 240
#define TFT_SCLK 10
#define TFT_MOSI 11
#define TFT_CS 9
#define TFT_DC 8
#define TFT_RST 14
#define TFT_BL 2
#define SPI_FREQUENCY 40000000Perguntas frequentes
Por que o touch retorna coordenadas zero?
O CST816S compartilha o barramento I2C (SDA 6, SCL 7) com a IMU e precisa que o reset (GPIO 13) seja liberado; verifique a configuração I2C e o endereço antes de depurar o driver.
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ç.