Màn hình ESP32-2432S028R (CYD): thông số, bản sửa đổi driver & cài đặt
Cheap Yellow Display: TFT SPI 2,8 inch 240×320 trên board ESP32. Các lô hàng dùng bộ điều khiển màn hình ILI9341 hoặc ST7789, nên cùng một sketch có thể chạy trên board này nhưng hiển thị màn hình trắng trên board khác.
Thông số màn hình ESP32-2432S028R (CYD)
| MCU | ESP32 (ESP32-WROOM-32) |
|---|---|
| Màn hình | 2.8″ · 240×320 |
| Bus màn hình | SPI (HSPI) |
| IC driver | ILI9341 hoặc ST7789 |
| Cảm ứng | XPT2046 điện trở (chân SPI riêng) |
Bạn đang dùng bản sửa đổi ESP32-2432S028R (CYD) nào?
Các board bán cùng tên được giao với IC driver màn hình khác nhau. Mã viết cho một bản sửa đổi sẽ hiện màn hình trắng, sai màu hoặc không hiện gì trên bản kia, vì vậy hãy xác định board của bạn trước.
| Bản sửa đổi | IC driver | Cách nhận biết | Cài đặt thư viện |
|---|---|---|---|
| Bản gốc (micro-USB) | ILI9341 | Chạy được với User_Setup.h của cộng đồng mà không cần sửa | TFT_eSPI: ILI9341_2_DRIVER, không đảo màu |
| Các lô sau (một số có hai cổng USB) | ST7789 | Màn hình trắng, màu nhạt hoặc bị đảo với cấu hình ILI9341 | TFT_eSPI: ST7789_DRIVER; thử lần lượt TFT_INVERSION_ON/OFF và TFT_RGB_ORDER TFT_BGR; đèn nền vẫn ở GPIO 21 |
Chân màn hình và cảm ứng của ESP32-2432S028R (CYD)
| Tín hiệu | GPIO | Ghi chú |
|---|---|---|
| TFT MOSI | 13 | HSPI |
| TFT MISO | 12 | HSPI |
| TFT SCLK | 14 | HSPI |
| TFT CS | 15 | |
| TFT DC | 2 | |
| TFT RST | -1 | Không nối với GPIO |
| Backlight | 21 | Tích cực mức cao; không dùng lại |
| Touch CLK | 25 | XPT2046 |
| Touch CS | 33 | XPT2046 |
| Touch DIN (MOSI) | 32 | XPT2046 |
| Touch DO (MISO) | 39 | XPT2046 |
| Touch IRQ | 36 | XPT2046 |
Cùng thông số màn hình cho sản xuất hàng loạt
Làm prototype trên ESP32-2432S028R (CYD)? Các module này từ nhà máy trực tiếp của chúng tôi có cùng kích thước và độ phân giải tấm nền, kèm datasheet và IC driver cố định cho mỗi lô sản xuất, có sẵn mẫu từ 1 chiếc. MOQ và thời gian giao hàng thỏa thuận theo dự án.
Từ prototype ESP32-2432S028R (CYD) đến sản xuất
Board phát triển rất tốt để kiểm chứng giao diện, nhưng tấm nền của chúng được mua trên thị trường tự do: bộ điều khiển có thể thay đổi giữa các lô (như đã xảy ra với board này), hiếm khi có datasheet và tuổi thọ không được đảm bảo. Với sản phẩm, hãy chỉ định module có IC driver cố định cho mỗi lô sản xuất, có datasheet và cam kết vòng đời.
Các nhà máy trực tiếp của chúng tôi sản xuất module cùng định dạng 2,8″ 240×320. Mẫu từ 1 chiếc; MOQ và thời gian giao hàng được thỏa thuận theo từng dự án với đội ngũ kinh doanh của chúng tôi.
Trước khi debug mã
- Xác nhận phiên bản board của bạn (bảng ở trên): thay đổi IC driver là nguyên nhân phổ biến nhất gây màn hình trắng.
- Kiểm tra chân đèn nền không bị dùng lại trong sketch.
- Thay đổi từng cài đặt một (driver, đảo màu, thứ tự màu), và giữ một ví dụ chạy tốt để so sánh.
Ví dụ cấu hình
#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 setupCâu hỏi thường gặp
Vì sao CYD của tôi hiển thị màn hình trắng với mã chạy được trên board của người khác?
Board của bạn có lẽ dùng bộ điều khiển màn hình ST7789 thay vì ILI9341. Hãy đổi driver TFT_eSPI sang ST7789_DRIVER và chỉnh đảo màu và thứ tự màu; các chân giữ nguyên.
GPIO nào điều khiển đèn nền CYD?
GPIO 21, tích cực mức cao. Dùng lại GPIO 21 trong sketch sẽ làm màn hình tối.
Vì sao cảm ứng không hoạt động trong TFT_eSPI trên CYD?
Bộ điều khiển cảm ứng XPT2046 nằm trên các chân riêng (CLK 25, CS 33, DIN 32, DO 39, IRQ 36), không nằm trên bus SPI của màn hình, nên hãy dùng một instance thư viện XPT2046 riêng trên các chân đó.
Nguồn
Chưa chắc màn hình nào phù hợp thiết kế của bạn?
Gửi kích thước, giao tiếp và bộ xử lý host. Kỹ sư màn hình sẽ phản hồi trong 12 giờ với 2–3 phương án, datasheet và mã khởi tạo. Mẫu từ 1 chiếc.