Компоненты · 8 мин чтения

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. В последних разделах — идеи проектов вроде погодного дисплея и панели умного дома, а также решения самых частых проблем.

TFT-дисплей диагональю 2,8 дюйма с драйвером ILI9341
Отдельный TFT-модуль на ILI9341: экран диагональю 2,8 дюйма на CYD работает на том же драйвере; разница в том, что ESP32 и схема сенсора стоят на одной плате с ним.

Что такое 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, обычно ST7789Micro-USB и USB-C рядомЦвета могут быть инвертированы; нужно сменить драйвер или настройку invertDisplay
ESP32-2432S0242,4" 240×320Экран меньшеПины и чип сенсора могут отличаться
ESP32-2432S0323,2" 240×320Плата крупнееВ ёмкостной версии сенсор читается по I2C
ESP32-3248S0353,5" 320×480, ST7796Разрешение вышеНужна отдельная настройка TFT_eSPI
На CYD с двумя USB-разъёмами (Micro-USB + USB-C) у дисплея обычно драйвер ST7789. С настройкой ILI9341 экран может и заработать, но цвета выглядят как негатив: белый вместо чёрного, жёлтый вместо синего. В этом случае выбери ST7789_DRIVER в User_Setup.h или добавь tft.invertDisplay(1) сразу после tft.init().

Распиновка CYD

УзелСигнал и GPIOПримечание
Дисплей (ILI9341)MOSI 13, MISO 12, SCK 14, CS 15, DC 2Шина HSPI; RST соединён с EN
ПодсветкаGPIO 21HIGH = включена; яркость регулируется через PWM
Сенсор (XPT2046)CLK 25, MOSI 32, MISO 39, CS 33, IRQ 36Шина VSPI, отдельно от дисплея
microSDSCK 18, MISO 19, MOSI 23, CS 5Стандартные пины VSPI
RGB-светодиодКрасный 4, зелёный 16, синий 17Общий анод: LOW = горит
Фоторезистор (LDR)GPIO 34Только вход, читается через analogRead
ДинамикGPIO 26Усилитель SC8002B, разъём SPEAK
Кнопка BOOTGPIO 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, загляни в утилиту распиновки.

GPIO 21 на разъёме P3 заодно управляет подсветкой дисплея: если подключить туда что-нибудь и подать на пин LOW, экран погаснет. GPIO 35 работает только как вход, так что управлять светодиодом или реле он не может. Когда питаешь внешнюю деталь от пина 3,3 V на CN1, не бери с него сотни миллиампер: плата и так тратит немалый ток на экран и Wi-Fi.

Настройка Arduino IDE: параметры платы и библиотеки

  1. Установи в Arduino IDE пакет плат ESP32 (esp32 by Espressif в «Менеджере плат», Boards Manager) и выбери плату ESP32 Dev Module.
  2. Подключи плату USB-кабелем. Если порт не появился, установи драйвер CH340 и убедись, что кабель передаёт данные, а не только питание.
  3. Установи через «Менеджер библиотек» (Library Manager) библиотеки TFT_eSPI (Bodmer) и XPT2046_Touchscreen (Paul Stoffregen).
  4. Замени содержимое файла User_Setup.h в папке TFT_eSPI настройками из следующего раздела.
  5. Если загрузка обрывается с ошибкой «Failed to connect» (не удалось подключиться), держи кнопку BOOT нажатой в момент, когда загрузка начинается; подробности — в статье ESP32 Failed to Connect.

Настройка TFT_eSPI: User_Setup.h

TFT_eSPI — очень быстрая библиотека, и эту скорость ей дают настройки пинов, зафиксированные на этапе компиляции. Они лежат в файле User_Setup.h в папке самой библиотеки («Документы › Arduino › libraries › TFT_eSPI»). Сделай резервную копию файла, удали из него всё и вставь строки ниже. При обновлении библиотеки этот файл сбрасывается к варианту по умолчанию, так что держи свою копию в надёжном месте и возвращай её после каждого обновления.

C++ (Arduino IDE)
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

Первый тест: текст на экране и рисование касанием

C++ (Arduino IDE)
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-светодиода, фоторезистора и выхода на динамик на обратной стороне платы хватит для первого проекта. Код ниже рисует три большие кнопки; касание кнопки включает или выключает соответствующий цвет светодиода, а динамик издаёт короткий щелчок. Жёлтая полоса внизу показывает значение с датчика освещённости и обновляется каждые полсекунды.

C++ (Arduino IDE)
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-карты.

C++ (Arduino IDE)
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}
И контроллер сенсора, и SD-карта используют аппаратный блок VSPI, но на разных пинах. Если в одном скетче нужны оба, выбери библиотеку, которая читает сенсорную панель через программный SPI (например, XPT2046_Bitbang), либо перезапускай шину SPI с нужными пинами перед каждым обращением к SD-карте и после него. Иначе пока работает одно устройство, второе молчит.

Первый интерфейс на LVGL

Рисовать кнопки, слайдеры и графики по одному fillRect быстро надоедает. LVGL — графическая библиотека с открытым исходным кодом: она даёт виджеты в духе телефонных интерфейсов (кнопки, слайдеры, списки, графики, вкладки) и сама обрабатывает касания. Начиная с версии 9 поддержка TFT_eSPI встроена в библиотеку, так что писать собственную функцию вывода (flush) для дисплея больше не нужно.

  1. Установи через «Менеджер библиотек» библиотеку lvgl (версия 9.x).
  2. Скопируй файл lv_conf_template.h из папки libraries/lvgl на уровень выше, рядом с папкой lvgl, и переименуй его в lv_conf.h.
  3. Замени #if 0 в начале файла на #if 1 и задай для LV_USE_TFT_ESPI значение 1.
  4. Если нужны шрифты покрупнее, поставь 1 и в строках вроде LV_FONT_MONTSERRAT_20; каждый шрифт занимает место во флеш-памяти.
C++ (Arduino IDE)
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-FiUSB-порт или кабель не дают достаточный токВозьми короткий качественный кабель и адаптер не менее чем на 1 A
Загрузка не начинаетсяНет драйвера CH340 или плата не в режиме загрузкиУстанови драйвер и нажми BOOT в момент начала загрузки
Если при подключении к Wi-Fi плата постоянно перезагружается, а в мониторе порта появляется «Brownout detector was triggered» (сработал детектор просадки питания), дело в питании, а не в коде; подробности — в статье Brownout и Guru Meditation на ESP32.

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
ES-11Новичок

Измерение освещённости модулем LDR на ESP32

Наблюдение в мониторе порта в реальном времени за сырым значением ADC модуля LDR и относительным процентом освещённости, вычисленным по опорным значениям темноты и света. Этот процент — не измерение в люксах. Учит логике калибровки модуля. Идеально выполнить его перед проектом 10, потому что он нужен для определения порога.

4.6(36)
55
ESP32 HTTPClient + API погоды (с OLED-дисплеем SSD1306)
ES-32Продвинутый
Premium

ESP32 HTTPClient + API погоды (с OLED-дисплеем SSD1306)

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

4.3(10)
22
ESP32 HTTPClient + API погоды (с экраном LCD)
ES-31Продвинутый
Premium

ESP32 HTTPClient + API погоды (с экраном LCD)

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

4.7(13)
20
Точное время из интернета через NTP на ESP32
ES-26Продвинутый
Premium

Точное время из интернета через NTP на ESP32

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

4.5(13)
22
Асинхронный веб-сервер на ESP32 (с выводом IP на LCD)
ES-27Продвинутый

Асинхронный веб-сервер на ESP32 (с выводом IP на LCD)

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

4.8(16)
26
Регистратор температуры на ESP32 (DHT22 + DS1307 RTC + microSD + OLED)
ES-40Продвинутый
Premium

Регистратор температуры на ESP32 (DHT22 + DS1307 RTC + microSD + OLED)

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

4.7(7)
12
Управление RGB-светодиодом на ESP32
ES-9Новичок

Управление RGB-светодиодом на ESP32

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

4.6(29)
52
Мелодия на зуммере с ESP32
ES-12Новичок
Premium

Мелодия на зуммере с ESP32

Воспроизведение простой мелодии (Twinkle Twinkle Little Star) на пассивном зуммере. Ноты играются функциями tone() и noTone(), как в Arduino, — ESP32 работает с тем же синтаксисом в Arduino Core 3.0+. Нужен пассивный зуммер (активный мелодию не сыграет).

4.8(30)
55