ESP32 Cheap Yellow Display (CYD): распиновка, настройка и LVGL
Руководство по ESP32 Cheap Yellow Display (ESP32-2432S028R): полная распиновка, настройка TFT_eSPI и сенсора XPT2046, калибровка, SD-карта, динамик и первый интерфейс на LVGL.
ESP32 Cheap Yellow Display (сокращённо CYD, официальное название модели — ESP32-2432S028R) — это готовая отладочная плата, на которой собраны ESP32, цветной сенсорный экран диагональю 2,8 дюйма, слот microSD, RGB-светодиод, датчик освещённости и выход на динамик, и всё это на одной жёлтой печатной плате. Прозвище говорит само за себя: плата жёлтая, дешёвая и с дисплеем. Подключи один USB-кабель, загрузи скетч, и сенсорный интерфейс готов: ничего не нужно паять и не нужна ни одна перемычка.
В этом руководстве разберём, что есть на плате и как отличить версии друг от друга, и приведём полную распиновку. Затем ты настроишь в Arduino IDE библиотеки TFT_eSPI и XPT2046_Touchscreen, выведешь текст на экран, откалибруешь сенсорную панель, будешь переключать RGB-светодиод экранными кнопками, записывать данные на карту microSD и соберёшь первый настоящий интерфейс на LVGL. В последних разделах — идеи проектов вроде погодного дисплея и панели умного дома, а также решения самых частых проблем.

Что такое ESP32 Cheap Yellow Display и что есть на плате?
В основе платы — модуль ESP32-WROOM-32: двухъядерный процессор с частотой до 240 MHz, 520 КБ SRAM, 4 МБ флеш-памяти, Wi-Fi 2,4 GHz и Bluetooth. Всё, о чём рассказано в статье Что такое ESP32?, верно и здесь. Дисплей подключён к шине HSPI платы ESP32, а чип XPT2046, который считывает резистивную сенсорную панель, сидит на второй шине SPI (VSPI) со своими пинами. Эта деталь важна: типовые примеры для TFT исходят из того, что сенсор делит шину с дисплеем, и на CYD они не работают. PSRAM на плате нет, поэтому кадр не хранится в памяти целиком, а изображение рисуется по частям.
| Характеристика | Значение |
|---|---|
| Процессорный модуль | ESP32-WROOM-32 (два ядра, 240 MHz) |
| Память | 520 КБ SRAM, 4 МБ флеш-памяти, без PSRAM |
| Дисплей | TFT 2,8 дюйма, 240×320 пикселей, 16-битный цвет (RGB565) |
| Драйвер дисплея | ILI9341 (в версии с двумя USB обычно ST7789) |
| Сенсор | Резистивная панель, контроллер XPT2046 |
| Накопитель | Слот для карты microSD (SPI) |
| Дополнительно | RGB-светодиод, фоторезистор (LDR), выход на динамик (усилитель SC8002B) |
| USB и питание | Micro-USB, преобразователь USB-UART CH340, 5 V |
| Кнопки | BOOT (GPIO 0) и RST |
Версии платы: что означает название ESP32-2432S028R?
Название модели — это краткая сводка: 2432 — разрешение (240×320), S028 — размер экрана (2,8 дюйма), а буква R в конце означает резистивный (resistive) сенсор. В том же семействе есть платы с буквой C на конце (ёмкостный сенсор) и с буквой N (без сенсора). Продавцы называют «Cheap Yellow Display» их все, поэтому перед заказом проверь точное название модели: распиновка и драйвер дисплея могут меняться от версии к версии.
| Плата | Дисплей | Как узнать | На что обратить внимание |
|---|---|---|---|
| ESP32-2432S028R (один USB) | 2,8" 240×320, ILI9341 | Только разъём Micro-USB | На этой версии основаны большинство примеров и это руководство |
| ESP32-2432S028R (два USB) | 2,8" 240×320, обычно ST7789 | Micro-USB и USB-C рядом | Цвета могут быть инвертированы; нужно сменить драйвер или настройку invertDisplay |
| ESP32-2432S024 | 2,4" 240×320 | Экран меньше | Пины и чип сенсора могут отличаться |
| ESP32-2432S032 | 3,2" 240×320 | Плата крупнее | В ёмкостной версии сенсор читается по I2C |
| ESP32-3248S035 | 3,5" 320×480, ST7796 | Разрешение выше | Нужна отдельная настройка TFT_eSPI |
Распиновка CYD
| Узел | Сигнал и GPIO | Примечание |
|---|---|---|
| Дисплей (ILI9341) | MOSI 13, MISO 12, SCK 14, CS 15, DC 2 | Шина HSPI; RST соединён с EN |
| Подсветка | GPIO 21 | HIGH = включена; яркость регулируется через PWM |
| Сенсор (XPT2046) | CLK 25, MOSI 32, MISO 39, CS 33, IRQ 36 | Шина VSPI, отдельно от дисплея |
| microSD | SCK 18, MISO 19, MOSI 23, CS 5 | Стандартные пины VSPI |
| RGB-светодиод | Красный 4, зелёный 16, синий 17 | Общий анод: LOW = горит |
| Фоторезистор (LDR) | GPIO 34 | Только вход, читается через analogRead |
| Динамик | GPIO 26 | Усилитель SC8002B, разъём SPEAK |
| Кнопка BOOT | GPIO 0 | В скетче её тоже можно читать как обычную кнопку |
| Последовательный порт (P1) | TX 1, RX 3 | Общие с чипом USB-UART |
| Свободные пины | GPIO 22, 27 (CN1), GPIO 35 (P3) | 35 работает только как вход |
Небольшие разъёмы JST (шаг 1,25 мм) по краю платы — твоя дверь во внешний мир. На CN1 выведены GND, GPIO 22, GPIO 27 и 3,3 V, и это идеальный набор для датчика с I2C: вызови Wire.begin(27, 22) и подключи напрямую датчик вроде BME280. На P3 выведены GPIO 35, 22 и 21, а на P1 — вход 5 V и линии последовательного порта TX/RX. Чтобы сверить эти пины с общими ограничениями ESP32, загляни в утилиту распиновки.
Настройка Arduino IDE: параметры платы и библиотеки
- Установи в Arduino IDE пакет плат ESP32 (esp32 by Espressif в «Менеджере плат», Boards Manager) и выбери плату ESP32 Dev Module.
- Подключи плату USB-кабелем. Если порт не появился, установи драйвер CH340 и убедись, что кабель передаёт данные, а не только питание.
- Установи через «Менеджер библиотек» (Library Manager) библиотеки TFT_eSPI (Bodmer) и XPT2046_Touchscreen (Paul Stoffregen).
- Замени содержимое файла User_Setup.h в папке TFT_eSPI настройками из следующего раздела.
- Если загрузка обрывается с ошибкой «Failed to connect» (не удалось подключиться), держи кнопку BOOT нажатой в момент, когда загрузка начинается; подробности — в статье ESP32 Failed to Connect.
Настройка TFT_eSPI: User_Setup.h
TFT_eSPI — очень быстрая библиотека, и эту скорость ей дают настройки пинов, зафиксированные на этапе компиляции. Они лежат в файле User_Setup.h в папке самой библиотеки («Документы › Arduino › libraries › TFT_eSPI»). Сделай резервную копию файла, удали из него всё и вставь строки ниже. При обновлении библиотеки этот файл сбрасывается к варианту по умолчанию, так что держи свою копию в надёжном месте и возвращай её после каждого обновления.
1// TFT_eSPI/User_Setup.h: CYD (ESP32-2432S028R) ayarı / setup for the CYD
2#define ILI9341_2_DRIVER // iki USB'li kartta ST7789_DRIVER / two-USB board: ST7789_DRIVER
3#define TFT_WIDTH 240
4#define TFT_HEIGHT 320
5#define TFT_BL 21 // arka ışık / backlight
6#define TFT_BACKLIGHT_ON HIGH
7#define TFT_MISO 12
8#define TFT_MOSI 13
9#define TFT_SCLK 14
10#define TFT_CS 15
11#define TFT_DC 2
12#define TFT_RST -1 // EN'e bağlı / tied to EN
13#define USE_HSPI_PORT // ekran HSPI hattında / display on the HSPI bus
14
15#define LOAD_GLCD
16#define LOAD_FONT2
17#define LOAD_FONT4
18#define LOAD_FONT6
19#define LOAD_FONT7
20#define LOAD_FONT8
21#define LOAD_GFXFF
22#define SMOOTH_FONT
23
24#define SPI_FREQUENCY 55000000 // sorun olursa 27000000 / use 27000000 if unstable
25#define SPI_READ_FREQUENCY 20000000
26#define SPI_TOUCH_FREQUENCY 2500000Первый тест: текст на экране и рисование касанием
1#include <SPI.h>
2#include <TFT_eSPI.h>
3#include <XPT2046_Touchscreen.h>
4
5// Dokunmatik (XPT2046) kendi SPI hattında / touch (XPT2046) on its own SPI bus
6#define XPT2046_IRQ 36
7#define XPT2046_MOSI 32
8#define XPT2046_MISO 39
9#define XPT2046_CLK 25
10#define XPT2046_CS 33
11
12SPIClass touchSpi(VSPI);
13XPT2046_Touchscreen ts(XPT2046_CS, XPT2046_IRQ);
14TFT_eSPI tft;
15
16void setup() {
17 Serial.begin(115200);
18 touchSpi.begin(XPT2046_CLK, XPT2046_MISO, XPT2046_MOSI, XPT2046_CS);
19 ts.begin(touchSpi);
20 ts.setRotation(1); // ekranla aynı yön / same orientation as the screen
21
22 tft.init();
23 tft.setRotation(1); // yatay 320x240 / landscape 320x240
24 tft.fillScreen(TFT_BLACK);
25 tft.setTextColor(TFT_WHITE, TFT_BLACK);
26 tft.drawCentreString("BlueGrays CYD", 160, 10, 4);
27 tft.drawCentreString("Ekrana dokun / Touch the screen", 160, 40, 2);
28}
29
30void loop() {
31 if (ts.tirqTouched() && ts.touched()) {
32 TS_Point p = ts.getPoint();
33 // Ham değerleri piksele çevir / convert raw values to pixels
34 int x = map(p.x, 200, 3700, 0, 319);
35 int y = map(p.y, 240, 3800, 0, 239);
36 x = constrain(x, 0, 319);
37 y = constrain(y, 0, 239);
38 tft.fillCircle(x, y, 3, TFT_YELLOW);
39 Serial.printf("ham/raw x=%d y=%d z=%d -> piksel/pixel %d,%d\n", p.x, p.y, p.z, x, y);
40 }
41}Ключевая строка здесь — SPIClass touchSpi(VSPI): она сажает контроллер сенсора на вторую шину SPI со своими пинами, независимо от дисплея. В ts.setRotation(1) и tft.setRotation(1) должно стоять одно и то же значение; если они различаются, место касания и точка, нарисованная на экране, не совпадут. В альбомной ориентации координаты идут от 0 до 319 по x и от 0 до 239 по y. После загрузки попробуй написать что-нибудь на экране стилусом; если линии идут за рукой, дисплей и сенсор настроены правильно.
Калибровка сенсорного экрана (XPT2046)
XPT2046 выдаёт не пиксели, а сырые значения от 0 до 4095. Числа 200, 3700 и 240, 3800 в коде — это та часть сырого диапазона, которая приходится на края экрана, и от платы к плате они немного отличаются. Для калибровки открой монитор порта на 115200 бод, коснись стилусом по очереди четырёх углов и запиши наименьшие и наибольшие сырые значения x и y. Подставь эти четыре числа в строки с map(), и расхождение между касанием и нарисованной точкой сократится до нескольких пикселей. Резистивная панель измеряет ещё и силу нажатия: функция touched() из библиотеки и так возвращает true только при достаточно сильном нажатии, но если у краёв значения дрожат, можно задать для p.z порог повыше.
RGB-светодиод, LDR и динамик: сенсорная панель управления
RGB-светодиода, фоторезистора и выхода на динамик на обратной стороне платы хватит для первого проекта. Код ниже рисует три большие кнопки; касание кнопки включает или выключает соответствующий цвет светодиода, а динамик издаёт короткий щелчок. Жёлтая полоса внизу показывает значение с датчика освещённости и обновляется каждые полсекунды.
1#include <SPI.h>
2#include <TFT_eSPI.h>
3#include <XPT2046_Touchscreen.h>
4
5#define XPT2046_IRQ 36
6#define XPT2046_MOSI 32
7#define XPT2046_MISO 39
8#define XPT2046_CLK 25
9#define XPT2046_CS 33
10
11const int LED_PINS[3] = {4, 16, 17}; // RGB LED: kırmızı, yeşil, mavi (LOW = yanar) / red, green, blue (LOW = on)
12const int LDR_PIN = 34; // ışık sensörü / light sensor
13const int SPEAKER_PIN = 26; // hoparlör yükselticisi / speaker amplifier
14const char* NAMES[3] = {"RED", "GREEN", "BLUE"};
15const uint16_t COLORS[3] = {TFT_RED, TFT_GREEN, TFT_BLUE};
16
17SPIClass touchSpi(VSPI);
18XPT2046_Touchscreen ts(XPT2046_CS, XPT2046_IRQ);
19TFT_eSPI tft;
20
21bool ledOn[3] = {false, false, false};
22bool wasTouched = false;
23unsigned long lastLdr = 0;
24
25void drawButton(int i) {
26 int x = 8 + i * 104; // 3 düğme yan yana / 3 buttons side by side
27 tft.fillRoundRect(x, 60, 96, 80, 10, ledOn[i] ? COLORS[i] : TFT_DARKGREY);
28 tft.setTextColor(TFT_WHITE);
29 tft.drawCentreString(NAMES[i], x + 48, 92, 2);
30}
31
32void setup() {
33 for (int i = 0; i < 3; i++) {
34 pinMode(LED_PINS[i], OUTPUT);
35 digitalWrite(LED_PINS[i], HIGH); // HIGH = sönük / HIGH = off
36 }
37 touchSpi.begin(XPT2046_CLK, XPT2046_MISO, XPT2046_MOSI, XPT2046_CS);
38 ts.begin(touchSpi);
39 ts.setRotation(1);
40 tft.init();
41 tft.setRotation(1);
42 tft.fillScreen(TFT_BLACK);
43 tft.setTextColor(TFT_WHITE, TFT_BLACK);
44 tft.drawString("BlueGrays panel", 8, 12, 4);
45 for (int i = 0; i < 3; i++) drawButton(i);
46}
47
48void loop() {
49 bool touchedNow = ts.tirqTouched() && ts.touched();
50 if (touchedNow && !wasTouched) { // yalnız ilk dokunuşta / only on the first touch
51 TS_Point p = ts.getPoint();
52 int x = map(p.x, 200, 3700, 0, 319);
53 int y = map(p.y, 240, 3800, 0, 239);
54 if (y > 60 && y < 140) {
55 int i = constrain((x - 8) / 104, 0, 2);
56 ledOn[i] = !ledOn[i];
57 digitalWrite(LED_PINS[i], ledOn[i] ? LOW : HIGH);
58 drawButton(i);
59 tone(SPEAKER_PIN, 2000, 30); // kısa tık sesi / short click sound
60 }
61 }
62 wasTouched = touchedNow;
63
64 if (millis() - lastLdr > 500) { // yarım saniyede bir / every half second
65 lastLdr = millis();
66 int light = analogRead(LDR_PIN); // 0-4095
67 tft.fillRect(8, 170, 304, 20, TFT_BLACK);
68 tft.fillRect(8, 170, map(light, 0, 4095, 0, 304), 20, TFT_YELLOW);
69 tft.setTextColor(TFT_WHITE, TFT_BLACK);
70 tft.drawString("LDR: " + String(light) + " ", 8, 200, 2);
71 }
72}RGB-светодиод подключён по схеме с общим анодом, поэтому логика здесь обратная: запись LOW включает цвет, а HIGH выключает; вот почему setup() сначала выставляет HIGH на всех трёх пинах. Переменная wasTouched не даёт кнопке переключаться снова и снова, пока палец остаётся на экране: считается только момент начала касания. Показания LDR могут держаться в узком диапазоне из-за резистора делителя на плате, так что измерь значения в темноте и на свету в своей комнате и подбери порог по ним. К разъёму динамика можно подключить небольшой динамик на 8 Ω и через tone() воспроизводить гудки и простые мелодии.
Запись данных на карту microSD
Слот для карты подключён к стандартным пинам VSPI платы ESP32 (18, 19, 23 и 5 для CS), поэтому достаточно вызвать SD.begin(5). Отформатируй карту в FAT32; карты до 32 ГБ работают без проблем. Пример ниже каждые пять секунд дописывает время и уровень освещённости в файл log.csv, а потом этот файл можно открыть на компьютере в любой программе для таблиц. Об общих приёмах работы с SD-картами читай в руководстве модуль SD-карты.
1#include <SPI.h>
2#include <SD.h>
3
4const int SD_CS = 5; // microSD: SCK 18, MISO 19, MOSI 23, CS 5
5const int LDR_PIN = 34;
6
7void setup() {
8 Serial.begin(115200);
9 if (!SD.begin(SD_CS)) { // varsayılan SPI pinleri / default SPI pins
10 Serial.println("SD kart yok / no SD card");
11 return;
12 }
13 Serial.printf("SD: %llu MB\n", SD.cardSize() / (1024 * 1024));
14}
15
16void loop() {
17 File f = SD.open("/log.csv", FILE_APPEND); // dosyanın sonuna ekle / append to the file
18 if (f) {
19 f.printf("%lu,%d\n", millis() / 1000, analogRead(LDR_PIN));
20 f.close();
21 }
22 delay(5000);
23}Первый интерфейс на LVGL
Рисовать кнопки, слайдеры и графики по одному fillRect быстро надоедает. LVGL — графическая библиотека с открытым исходным кодом: она даёт виджеты в духе телефонных интерфейсов (кнопки, слайдеры, списки, графики, вкладки) и сама обрабатывает касания. Начиная с версии 9 поддержка TFT_eSPI встроена в библиотеку, так что писать собственную функцию вывода (flush) для дисплея больше не нужно.
- Установи через «Менеджер библиотек» библиотеку lvgl (версия 9.x).
- Скопируй файл lv_conf_template.h из папки libraries/lvgl на уровень выше, рядом с папкой lvgl, и переименуй его в lv_conf.h.
- Замени #if 0 в начале файла на #if 1 и задай для LV_USE_TFT_ESPI значение 1.
- Если нужны шрифты покрупнее, поставь 1 и в строках вроде LV_FONT_MONTSERRAT_20; каждый шрифт занимает место во флеш-памяти.
1#include <SPI.h>
2#include <lvgl.h>
3#include <TFT_eSPI.h>
4#include <XPT2046_Touchscreen.h>
5
6#define XPT2046_IRQ 36
7#define XPT2046_MOSI 32
8#define XPT2046_MISO 39
9#define XPT2046_CLK 25
10#define XPT2046_CS 33
11#define SCREEN_WIDTH 240
12#define SCREEN_HEIGHT 320
13#define DRAW_BUF_SIZE (SCREEN_WIDTH * SCREEN_HEIGHT / 10 * (LV_COLOR_DEPTH / 8))
14
15SPIClass touchSpi(VSPI);
16XPT2046_Touchscreen ts(XPT2046_CS, XPT2046_IRQ);
17uint32_t drawBuf[DRAW_BUF_SIZE / 4]; // ekranın 1/10'u kadar tampon / buffer for 1/10 of the screen
18lv_obj_t* valueLabel;
19
20// LVGL'e dokunuşu bildir / report touches to LVGL
21void touchRead(lv_indev_t* indev, lv_indev_data_t* data) {
22 if (ts.tirqTouched() && ts.touched()) {
23 TS_Point p = ts.getPoint();
24 data->point.x = map(p.x, 200, 3700, 1, SCREEN_WIDTH);
25 data->point.y = map(p.y, 240, 3800, 1, SCREEN_HEIGHT);
26 data->state = LV_INDEV_STATE_PRESSED;
27 } else {
28 data->state = LV_INDEV_STATE_RELEASED;
29 }
30}
31
32uint32_t tickMs() { return millis(); } // LVGL'in saat kaynağı / LVGL time source
33
34void onLedButton(lv_event_t* e) {
35 lv_obj_t* btn = lv_event_get_target_obj(e);
36 bool on = lv_obj_has_state(btn, LV_STATE_CHECKED);
37 digitalWrite(4, on ? LOW : HIGH); // kırmızı LED / red LED
38}
39
40void onSlider(lv_event_t* e) {
41 lv_obj_t* slider = lv_event_get_target_obj(e);
42 lv_label_set_text_fmt(valueLabel, "%d %%", (int)lv_slider_get_value(slider));
43}
44
45void lvglSetup() {
46 pinMode(4, OUTPUT);
47 digitalWrite(4, HIGH);
48 touchSpi.begin(XPT2046_CLK, XPT2046_MISO, XPT2046_MOSI, XPT2046_CS);
49 ts.begin(touchSpi);
50 ts.setRotation(2);
51
52 lv_init();
53 lv_tick_set_cb(tickMs);
54 lv_display_t* disp = lv_tft_espi_create(SCREEN_WIDTH, SCREEN_HEIGHT, drawBuf, sizeof(drawBuf));
55 lv_display_set_rotation(disp, LV_DISPLAY_ROTATION_270); // yatay kullanım / landscape
56 lv_indev_t* indev = lv_indev_create();
57 lv_indev_set_type(indev, LV_INDEV_TYPE_POINTER);
58 lv_indev_set_read_cb(indev, touchRead);
59
60 lv_obj_t* title = lv_label_create(lv_screen_active());
61 lv_label_set_text(title, "BlueGrays + LVGL");
62 lv_obj_align(title, LV_ALIGN_TOP_MID, 0, 10);
63
64 lv_obj_t* btn = lv_button_create(lv_screen_active());
65 lv_obj_set_size(btn, 120, 50);
66 lv_obj_align(btn, LV_ALIGN_CENTER, 0, -30);
67 lv_obj_add_flag(btn, LV_OBJ_FLAG_CHECKABLE); // aç-kapa düğmesi / toggle button
68 lv_obj_add_event_cb(btn, onLedButton, LV_EVENT_VALUE_CHANGED, NULL);
69 lv_obj_t* btnLabel = lv_label_create(btn);
70 lv_label_set_text(btnLabel, "LED");
71 lv_obj_center(btnLabel);
72
73 lv_obj_t* slider = lv_slider_create(lv_screen_active());
74 lv_obj_set_width(slider, 220);
75 lv_obj_align(slider, LV_ALIGN_CENTER, 0, 40);
76 lv_obj_add_event_cb(slider, onSlider, LV_EVENT_VALUE_CHANGED, NULL);
77 valueLabel = lv_label_create(lv_screen_active());
78 lv_label_set_text(valueLabel, "0 %");
79 lv_obj_align_to(valueLabel, slider, LV_ALIGN_OUT_BOTTOM_MID, 0, 10);
80}
81
82void lvglLoop() {
83 lv_timer_handler(); // LVGL çizim ve olayları / LVGL drawing and events
84 delay(5);
85}Добавь в конец этого кода setup() и loop(): в setup() вызывай только lvglSetup(), а в loop() — только lvglLoop(). Экран рисуется по частям через буфер размером в одну десятую экрана (около 15 КБ), и для CYD без PSRAM это хороший баланс. Поворотом занимается сама LVGL, поэтому координаты касания передаются в портретном порядке (240×320), а LVGL пересчитывает их для альбомного экрана. Кнопка объявлена как переключаемая (checkable), так что каждое касание меняет состояние красного светодиода, а слайдер записывает своё значение в процентах в надпись под ним.
Идеи проектов на CYD: погодный дисплей и панель умного дома
- Погодный дисплей: возьми за основу руководство погодный API на ESP32 и выводи температуру, влажность и прогноз на день с иконками.
- Панель умного дома: управляй светом и розетками с экранных кнопок через MQTT и Home Assistant.
- Настольные часы: показывай крупными цифрами время из интернета по NTP и приглушай подсветку ночью по показаниям LDR.
- Панель датчиков: строй живой график температуры, влажности и давления по данным датчика I2C, подключённого к CN1.
- Регистратор данных: сохраняй показания на карту microSD и показывай график за последние 24 часа.
- Сенсорные игры: сделай крестики-нолики, змейку или игру на память, в которые играют стилусом.
Частые проблемы и их решения
| Симптом | Вероятная причина | Решение |
|---|---|---|
| Экран остаётся белым или чёрным | User_Setup.h не настроен или выбран не тот драйвер | Скопируй настройки из этого руководства; на плате с двумя USB попробуй ST7789 |
| Цвета как на негативе | Не подходит драйвер или настройка инверсии цветов | Добавь tft.invertDisplay(1) или смени драйвер |
| Сенсор не реагирует | В коде считается, что сенсор сидит на одной шине SPI с дисплеем | Используй touchSpi(VSPI) с пинами 25, 32, 39, 33 |
| Место касания и рисунок смещены | Калибровочные значения не подходят к плате | Измерь сырые значения в углах и обнови строки с map() |
| Мерцание или искажённые линии | Слишком высокая частота SPI | Уменьши SPI_FREQUENCY до 27000000 |
| Перезагрузка при включении Wi-Fi | USB-порт или кабель не дают достаточный ток | Возьми короткий качественный кабель и адаптер не менее чем на 1 A |
| Загрузка не начинается | Нет драйвера CH340 или плата не в режиме загрузки | Установи драйвер и нажми BOOT в момент начала загрузки |
ESP32 Cheap Yellow Display — самый короткий путь к проекту на ESP32 с экраном: никакой путаницы проводов, никакой пайки, только код. Если тебе больше нравится работать с отдельными модулями, в руководстве TFT-дисплей ILI9341 тот же драйвер разобран на макетной плате. В приложении BlueGrays есть проекты с погодой, часами по NTP, веб-сервером и LDR с пошаговыми схемами подключения и кодом, и их легко перенести на экран CYD.
Частые вопросы
Какую плату выбрать в Arduino IDE для Cheap Yellow Display?
Выбери ESP32 Dev Module: на CYD стоит стандартный модуль ESP32-WROOM-32. Объём флеш-памяти оставь 4 МБ, а если загрузка срывается, снизь её скорость до 115200. Если порт не появляется, установи драйвер CH340.
Почему экран CYD белый?
Белый экран означает, что подсветка включена, но драйвер дисплея не получает корректных данных. Почти всегда причина в том, что файл User_Setup.h библиотеки TFT_eSPI не настроен под CYD или выбран не тот драйвер. Проверь настройки пинов, а на платах с двумя USB-разъёмами попробуй драйвер ST7789 вместо ILI9341.
Какие пины GPIO можно использовать на ESP32 Cheap Yellow Display?
Доступны GPIO 22 и 27 на разъёме CN1 и GPIO 35 на P3; GPIO 35 работает только как вход. Для датчиков I2C вызови Wire.begin(27, 22), а питание датчика возьми с пинов 3,3 V и GND на CN1. GPIO 21 не трогай: он управляет подсветкой.
Работает ли LVGL на CYD без PSRAM?
Да, LVGL 9 работает на CYD плавно. PSRAM на плате нет, поэтому вместо полного кадра используется буфер отрисовки в одну десятую экрана (около 15 КБ). Если добавить много крупных шрифтов или изображений, настоящим ограничением станут флеш-память и RAM, так что отключи неиспользуемые шрифты в lv_conf.h.
Можно ли использовать сенсорный экран и SD-карту одновременно?
Да, но нужна дополнительная настройка: оба устройства используют аппаратный блок VSPI платы ESP32 на разных пинах. Проще всего взять библиотеку сенсора, которая работает через программный SPI. Второй вариант — перед каждым обращением к карте перезапускать шину SPI с пинами SD, а после него снова с пинами сенсора.
Может ли Cheap Yellow Display работать от аккумулятора?
Плата питается от 5 V и с включёнными подсветкой и Wi-Fi обычно потребляет 100–250 mA. Для автономного питания возьми Li-ion аккумулятор с зарядным модулем TP4056 и повышающим преобразователем на 5 V или просто пауэрбанк. Чтобы продлить время работы, выключай экран и Wi-Fi в простое и переводи ESP32 в сон.
Что собрать после прочтения
Все проекты
Измерение освещённости модулем LDR на ESP32
Наблюдение в мониторе порта в реальном времени за сырым значением ADC модуля LDR и относительным процентом освещённости, вычисленным по опорным значениям темноты и света. Этот процент — не измерение в люксах. Учит логике калибровки модуля. Идеально выполнить его перед проектом 10, потому что он нужен для определения порога.

ESP32 HTTPClient + API погоды (с OLED-дисплеем SSD1306)
В этом проекте ESP32 через HTTPClient.h делает вызов REST API к сервису погоды (wttr.in). В отличие от прошлой версии с I2C LCD, здесь используется OLED SSD1306 (128×64), который позволяет крупные шрифты, векторные значки и богатую картинку на одном экране. Семь векторных значков погоды (солнечно, переменная облачность, облачно, дождь, снег, гроза, туман) рисуются во время работы (растровые файлы не нужны). Температура выводится крупными цифрами.

ESP32 HTTPClient + API погоды (с экраном LCD)
В этом проекте ESP32 через HTTPClient.h делает вызов REST API к сервису погоды (wttr.in) через интернет. Полученный ответ в JSON разбирается с помощью ArduinoJson v7, а город, температура, влажность, погода и ветер выводятся на I2C LCD на турецком и английском. wttr.in бесплатен и не требует ключа API — достаточно указать любое название города, чтобы получить текущую погоду. Данные автоматически обновляются каждые 30 минут.

Точное время из интернета через NTP на ESP32
ESP32 подключается к Wi-Fi и получает точное время с точностью до миллисекунд от серверов NTP (Network Time Protocol). Благодаря функции configTzTime() автоматически применяется часовой пояс Турции (TRT, UTC+3), а в странах с летним временем переходы обрабатываются автоматически по строке POSIX TZ. Время выводится в монитор порта и на необязательный I2C LCD. configTzTime() запускает службу SNTP, которая периодически пересинхронизирует часы.

Асинхронный веб-сервер на ESP32 (с выводом IP на LCD)
В этом проекте ESP32 превращается в асинхронный веб-сервер, которым можно управлять с телефона или компьютера в той же сети Wi-Fi. Благодаря библиотеке ESPAsyncWebServer сервер может обрабатывать несколько запросов одновременно (в отличие от классического WebServer.h, который блокируется на одном запросе). Открыв IP-адрес ESP32 в браузере, ты нажимаешь кнопки ON/OFF (маршруты /on и /off) и включаешь и выключаешь светодиод на GPIO 5.

Регистратор температуры на ESP32 (DHT22 + DS1307 RTC + microSD + OLED)
Собери на ESP32 регистратор температуры с отметками времени! Каждую минуту читай температуру и влажность с DHT22, бери реальное время из DS1307 RTC и записывай всё на карту microSD в формате CSV. OLED показывает текущую температуру (крупным шрифтом), влажность в процентах, время и счётчик записей. Файл /temp_log.csv на SD-карте открывается в Excel, Google Sheets или Python pandas — идеально для теплиц, комнат, лабораторий и хранения продуктов.

Управление RGB-светодиодом на ESP32
Бесконечное число цветов одним RGB-светодиодом вместо 3 отдельных. Как в Arduino, радужный переход получается заданием значений R/G/B через analogWrite(). Теория цвета (например, красный + зелёный = жёлтый) видна на практике.

Мелодия на зуммере с ESP32
Воспроизведение простой мелодии (Twinkle Twinkle Little Star) на пассивном зуммере. Ноты играются функциями tone() и noTone(), как в Arduino, — ESP32 работает с тем же синтаксисом в Arduino Core 3.0+. Нужен пассивный зуммер (активный мелодию не сыграет).
Другие статьи
Приложение BlueGrays
Собери эту схему шаг за шагом в телефоне
Схема подключения, код и список деталей на одном экране. 500+ проектов на Arduino, ESP32 и Pico готовы к сборке.
Наведи камеру телефона
Наведи камеру на код — откроется магазин приложений на телефоне.
или открыть магазин

