Дисплей Waveshare ESP32-S3-Touch-LCD-1.28: характеристики, ревизии драйвера и настройка
Дисплейная плата с круглым IPS-дисплеем 1,28 дюйма 240×240, контроллером GC9A01, сенсором CST816S и IMU QMI8658 на ESP32-S3 — популярная основа для циферблатов и интерфейсов с ручкой.
Характеристики дисплея Waveshare ESP32-S3-Touch-LCD-1.28
| MCU | ESP32-S3 |
|---|---|
| Дисплей | 1.28″ · 240×240 · круглый |
| Шина дисплея | SPI |
| Драйвер | GC9A01 |
| Сенсор | Ёмкостный CST816S (I2C) |
Какая у вас ревизия Waveshare ESP32-S3-Touch-LCD-1.28?
Известная конфигурация дисплея для этой платы.
| Ревизия | Драйвер | Как определить | Настройки библиотеки |
|---|---|---|---|
| ESP32-S3-Touch-LCD-1.28 | GC9A01 | TFT_eSPI: GC9A01_DRIVER; LovyanGFX: Panel_GC9A01 |
Выводы дисплея и сенсора Waveshare ESP32-S3-Touch-LCD-1.28
| Сигнал | GPIO | Примечания |
|---|---|---|
| LCD SCLK | 10 | SPI |
| LCD MOSI | 11 | SPI |
| LCD CS | 9 | |
| LCD DC | 8 | |
| LCD RST | 14 | |
| Backlight | 2 | |
| Touch/IMU SDA | 6 | I2C, общая шина с QMI8658 |
| Touch/IMU SCL | 7 | I2C |
| Touch INT | 5 | CST816S |
| Touch RST | 13 | CST816S |
Та же спецификация дисплея для серийного производства
Прототип на Waveshare ESP32-S3-Touch-LCD-1.28? Эти модули с наших прямых фабрик имеют тот же размер и разрешение панели, поставляются с даташитом и фиксированным драйвером в каждой партии и доступны образцами от 1 шт. MOQ и сроки согласуются по проекту.
От прототипа на Waveshare ESP32-S3-Touch-LCD-1.28 к серии
Отладочные платы идеальны для проверки интерфейса, но панели для них закупаются на открытом рынке: контроллер может меняться от партии к партии, даташита почти никогда нет, а срок поставок не гарантирован. Для продукта указывайте модуль с фиксированным драйвером в каждой производственной партии, даташитом и обязательством по жизненному циклу.
Наши прямые фабрики выпускают модули того же формата 1,28″ 240×240. Образцы от 1 шт.; MOQ и сроки согласуются по проекту с нашим отделом продаж.
Прежде чем отлаживать код
- Определите свою ревизию (таблица выше): смена драйвера — самая частая причина белого экрана.
- Проверьте, что вывод подсветки не используется повторно в скетче.
- Меняйте по одной настройке за раз (драйвер, инверсия, порядок цветов) и держите рабочий пример для сравнения.
Примеры конфигурации
#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 40000000Частые вопросы
Почему сенсор возвращает нулевые координаты?
CST816S делит шину I2C (SDA 6, SCL 7) с IMU, и его сброс (GPIO 13) должен быть отпущен; проверьте настройку I2C и адрес, прежде чем отлаживать драйвер.
Источники
Не знаете, какой дисплей подойдёт вашему проекту?
Пришлите размер, интерфейс и хост-процессор. Инженер по дисплеям в течение 12 часов ответит с 2–3 вариантами, даташитами и кодом инициализации. Образцы от 1 шт.