Langsung ke konten
Display Engineer
Sunton · Dev board display

Display ESP32-2432S028R (CYD): spesifikasi, revisi driver & pengaturan

Cheap Yellow Display: TFT SPI 2,8 inci 240×320 pada board ESP32. Batch-nya dikirim dengan pengontrol display ILI9341 atau ST7789, sehingga sketch yang sama bisa berfungsi di satu board dan menampilkan layar putih di board lain.

Ditinjau engineer 11 Okt 2026

Spesifikasi display ESP32-2432S028R (CYD)

MCUESP32 (ESP32-WROOM-32)
Display2.8″ · 240×320
Bus displaySPI (HSPI)
Driver ICILI9341 atau ST7789
SentuhXPT2046 resistif (pin SPI terpisah)

Revisi ESP32-2432S028R (CYD) mana yang Anda miliki?

Board yang dijual dengan nama sama dikirim dengan driver IC display berbeda. Kode untuk satu revisi menampilkan layar putih, warna salah, atau tidak tampil sama sekali di revisi lain, jadi identifikasi milik Anda terlebih dahulu.

RevisiDriver ICCara mengidentifikasiPengaturan pustaka
Orisinal (micro-USB)ILI9341Berfungsi dengan User_Setup.h komunitas tanpa perubahanTFT_eSPI: ILI9341_2_DRIVER, tanpa inversi
Batch berikutnya (sebagian dengan dua port USB)ST7789Layar putih, warna pudar, atau terbalik dengan pengaturan ILI9341TFT_eSPI: ST7789_DRIVER; coba TFT_INVERSION_ON/OFF dan TFT_RGB_ORDER TFT_BGR satu per satu; backlight tetap di GPIO 21

Pin display dan sentuh ESP32-2432S028R (CYD)

SinyalGPIOCatatan
TFT MOSI13HSPI
TFT MISO12HSPI
TFT SCLK14HSPI
TFT CS15
TFT DC2
TFT RST-1Tidak tersambung ke GPIO
Backlight21Active high; jangan dipakai ulang
Touch CLK25XPT2046
Touch CS33XPT2046
Touch DIN (MOSI)32XPT2046
Touch DO (MISO)39XPT2046
Touch IRQ36XPT2046

Spesifikasi display yang sama untuk produksi massal

Membuat prototipe dengan ESP32-2432S028R (CYD)? Modul dari pabrik langsung kami ini memiliki ukuran dan resolusi panel yang sama, disertai datasheet dan driver IC tetap per lot produksi, serta tersedia sebagai sampel mulai 1 pcs. MOQ dan lead time disepakati per proyek.

Dari prototipe ESP32-2432S028R (CYD) ke produksi

Dev board ideal untuk membuktikan UI, tetapi panelnya dibeli di pasar terbuka: pengontrol bisa berubah antar-batch (seperti yang sudah terjadi pada board ini), jarang ada datasheet, dan umurnya tidak dijamin. Untuk produk, tentukan modul dengan driver IC tetap per lot produksi, datasheet, dan komitmen siklus hidup.

Pabrik langsung kami membuat modul dengan format 2,8″ 240×320 yang sama. Sampel mulai 1 pcs; MOQ dan lead time disepakati per proyek dengan tim penjualan kami.

Sebelum men-debug kode

  1. Konfirmasikan revisi yang Anda miliki (tabel di atas): perubahan driver IC adalah penyebab paling umum layar putih.
  2. Pastikan pin backlight tidak dipakai ulang di sketch Anda.
  3. Ubah satu pengaturan setiap kali (driver, inversi, urutan warna), dan simpan contoh yang sudah terbukti berfungsi sebagai pembanding.

Contoh konfigurasi

TFT_eSPI User_Setup.h: ILI9341 revision (community default)c
#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
Referensi· Community / vendor configuration (see sources)
TFT_eSPI User_Setup.h: ST7789 revision (change only the driver block)c
// 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
Referensi· Community / vendor configuration (see sources)

Pertanyaan yang sering diajukan

Mengapa CYD saya menampilkan layar putih dengan kode yang berfungsi di tempat lain?

Board Anda kemungkinan memiliki pengontrol display ST7789, bukan ILI9341. Ubah driver TFT_eSPI ke ST7789_DRIVER dan sesuaikan inversi serta urutan warna; pinnya tetap sama.

GPIO mana yang mengontrol backlight CYD?

GPIO 21, active high. Memakai ulang GPIO 21 di sketch membuat layar gelap.

Mengapa sentuh tidak berfungsi di TFT_eSPI pada CYD?

Pengontrol sentuh XPT2046 berada di pin tersendiri (CLK 25, CS 33, DIN 32, DO 39, IRQ 36), bukan di bus SPI display, jadi gunakan instance pustaka XPT2046 terpisah pada pin tersebut.

Sumber

  1. ESP32-Cheap-Yellow-Display: peta pin
  2. ESP32-Cheap-Yellow-Display: User_Setup.h
  3. F1ATB: konfigurasi ESP32-2432S028 / S024 (versi ILI9341 dan ST7789)

Belum yakin display mana yang cocok untuk desain Anda?

Kirimkan ukuran, antarmuka, dan prosesor host Anda. Display engineer akan membalas dalam 12 jam dengan 2–3 opsi, datasheet, dan kode inisialisasi. Sampel mulai 1 pcs.