Дисплей ESP32-2432S028R (CYD): характеристики, ревизии драйвера и настройка
Cheap Yellow Display: SPI TFT 2,8 дюйма 240×320 на плате ESP32. Партии поставляются с контроллером дисплея ILI9341 или ST7789, поэтому один и тот же скетч может работать на одной плате и показывать белый экран на другой.
Характеристики дисплея ESP32-2432S028R (CYD)
| MCU | ESP32 (ESP32-WROOM-32) |
|---|---|
| Дисплей | 2.8″ · 240×320 |
| Шина дисплея | SPI (HSPI) |
| Драйвер | ILI9341 или ST7789 |
| Сенсор | Резистивный XPT2046 (отдельные выводы SPI) |
Какая у вас ревизия ESP32-2432S028R (CYD)?
Платы под одним названием поставляются с разными драйверами дисплея. Код для одной ревизии показывает на другой белый экран, неверные цвета или вообще ничего — сначала определите свою.
| Ревизия | Драйвер | Как определить | Настройки библиотеки |
|---|---|---|---|
| Оригинальная (micro-USB) | ILI9341 | Работает с community-файлом User_Setup.h без изменений | TFT_eSPI: ILI9341_2_DRIVER, без инверсии |
| Поздние партии (у некоторых два порта USB) | ST7789 | Белый экран, блёклые или инвертированные цвета с настройкой ILI9341 | TFT_eSPI: ST7789_DRIVER; пробуйте TFT_INVERSION_ON/OFF и TFT_RGB_ORDER TFT_BGR по одному; подсветка по-прежнему на GPIO 21 |
Выводы дисплея и сенсора ESP32-2432S028R (CYD)
| Сигнал | GPIO | Примечания |
|---|---|---|
| TFT MOSI | 13 | HSPI |
| TFT MISO | 12 | HSPI |
| TFT SCLK | 14 | HSPI |
| TFT CS | 15 | |
| TFT DC | 2 | |
| TFT RST | -1 | Не подключён к GPIO |
| Backlight | 21 | Активный высокий уровень; не использовать повторно |
| Touch CLK | 25 | XPT2046 |
| Touch CS | 33 | XPT2046 |
| Touch DIN (MOSI) | 32 | XPT2046 |
| Touch DO (MISO) | 39 | XPT2046 |
| Touch IRQ | 36 | XPT2046 |
Та же спецификация дисплея для серийного производства
Прототип на ESP32-2432S028R (CYD)? Эти модули с наших прямых фабрик имеют тот же размер и разрешение панели, поставляются с даташитом и фиксированным драйвером в каждой партии и доступны образцами от 1 шт. MOQ и сроки согласуются по проекту.
От прототипа на ESP32-2432S028R (CYD) к серии
Отладочные платы идеальны для проверки интерфейса, но панели для них закупаются на открытом рынке: контроллер может меняться от партии к партии (как уже произошло с этой платой), даташита почти никогда нет, а срок поставок не гарантирован. Для продукта указывайте модуль с фиксированным драйвером в каждой производственной партии, даташитом и обязательством по жизненному циклу.
Наши прямые фабрики выпускают модули того же формата 2,8″ 240×320. Образцы от 1 шт.; MOQ и сроки согласуются по проекту с нашим отделом продаж.
Прежде чем отлаживать код
- Определите свою ревизию (таблица выше): смена драйвера — самая частая причина белого экрана.
- Проверьте, что вывод подсветки не используется повторно в скетче.
- Меняйте по одной настройке за раз (драйвер, инверсия, порядок цветов) и держите рабочий пример для сравнения.
Примеры конфигурации
#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 setupЧастые вопросы
Почему мой CYD показывает белый экран с кодом, который у других работает?
Вероятно, на вашей плате стоит контроллер ST7789 вместо ILI9341. Смените драйвер TFT_eSPI на ST7789_DRIVER и настройте инверсию и порядок цветов; выводы остаются прежними.
Какой GPIO управляет подсветкой CYD?
GPIO 21, активный высокий уровень. Повторное использование GPIO 21 в скетче гасит экран.
Почему сенсор не работает в TFT_eSPI на CYD?
Контроллер сенсора XPT2046 подключён к собственным выводам (CLK 25, CS 33, DIN 32, DO 39, IRQ 36), а не к шине SPI дисплея, поэтому используйте отдельный экземпляр библиотеки XPT2046 на этих выводах.
Источники
Не знаете, какой дисплей подойдёт вашему проекту?
Пришлите размер, интерфейс и хост-процессор. Инженер по дисплеям в течение 12 часов ответит с 2–3 вариантами, даташитами и кодом инициализации. Образцы от 1 шт.