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.
Spesifikasi display ESP32-2432S028R (CYD)
| MCU | ESP32 (ESP32-WROOM-32) |
|---|---|
| Display | 2.8″ · 240×320 |
| Bus display | SPI (HSPI) |
| Driver IC | ILI9341 atau ST7789 |
| Sentuh | XPT2046 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.
| Revisi | Driver IC | Cara mengidentifikasi | Pengaturan pustaka |
|---|---|---|---|
| Orisinal (micro-USB) | ILI9341 | Berfungsi dengan User_Setup.h komunitas tanpa perubahan | TFT_eSPI: ILI9341_2_DRIVER, tanpa inversi |
| Batch berikutnya (sebagian dengan dua port USB) | ST7789 | Layar putih, warna pudar, atau terbalik dengan pengaturan ILI9341 | TFT_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)
| Sinyal | GPIO | Catatan |
|---|---|---|
| TFT MOSI | 13 | HSPI |
| TFT MISO | 12 | HSPI |
| TFT SCLK | 14 | HSPI |
| TFT CS | 15 | |
| TFT DC | 2 | |
| TFT RST | -1 | Tidak tersambung ke GPIO |
| Backlight | 21 | Active high; jangan dipakai ulang |
| Touch CLK | 25 | XPT2046 |
| Touch CS | 33 | XPT2046 |
| Touch DIN (MOSI) | 32 | XPT2046 |
| Touch DO (MISO) | 39 | XPT2046 |
| Touch IRQ | 36 | XPT2046 |
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
- Konfirmasikan revisi yang Anda miliki (tabel di atas): perubahan driver IC adalah penyebab paling umum layar putih.
- Pastikan pin backlight tidak dipakai ulang di sketch Anda.
- Ubah satu pengaturan setiap kali (driver, inversi, urutan warna), dan simpan contoh yang sudah terbukti berfungsi sebagai pembanding.
Contoh konfigurasi
#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 setupPertanyaan 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
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.

