Màn hình Waveshare ESP32-S3-Touch-LCD-1.28: thông số, bản sửa đổi driver & cài đặt
Board màn hình IPS tròn 1,28 inch 240×240 với bộ điều khiển GC9A01, cảm ứng CST816S và IMU QMI8658 trên ESP32-S3: nền tảng phổ biến cho mặt đồng hồ và giao diện núm xoay.
Thông số màn hình Waveshare ESP32-S3-Touch-LCD-1.28
| MCU | ESP32-S3 |
|---|---|
| Màn hình | 1.28″ · 240×240 · tròn |
| Bus màn hình | SPI |
| IC driver | GC9A01 |
| Cảm ứng | CST816S điện dung (I2C) |
Bạn đang dùng bản sửa đổi Waveshare ESP32-S3-Touch-LCD-1.28 nào?
Cấu hình màn hình đã biết cho board này.
| Bản sửa đổi | IC driver | Cách nhận biết | Cài đặt thư viện |
|---|---|---|---|
| ESP32-S3-Touch-LCD-1.28 | GC9A01 | TFT_eSPI: GC9A01_DRIVER; LovyanGFX: Panel_GC9A01 |
Chân màn hình và cảm ứng của Waveshare ESP32-S3-Touch-LCD-1.28
| Tín hiệu | GPIO | Ghi chú |
|---|---|---|
| LCD SCLK | 10 | SPI |
| LCD MOSI | 11 | SPI |
| LCD CS | 9 | |
| LCD DC | 8 | |
| LCD RST | 14 | |
| Backlight | 2 | |
| Touch/IMU SDA | 6 | I2C, dùng chung với QMI8658 |
| Touch/IMU SCL | 7 | I2C |
| Touch INT | 5 | CST816S |
| Touch RST | 13 | CST816S |
Cùng thông số màn hình cho sản xuất hàng loạt
Làm prototype trên Waveshare ESP32-S3-Touch-LCD-1.28? 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 Waveshare ESP32-S3-Touch-LCD-1.28 đế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ô, 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 1,28″ 240×240. 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 GC9A01_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 240
#define TFT_SCLK 10
#define TFT_MOSI 11
#define TFT_CS 9
#define TFT_DC 8
#define TFT_RST 14
#define TFT_BL 2
#define SPI_FREQUENCY 40000000Câu hỏi thường gặp
Vì sao cảm ứng trả về tọa độ bằng 0?
CST816S dùng chung bus I2C (SDA 6, SCL 7) với IMU và cần nhả chân reset (GPIO 13); hãy kiểm tra cài đặt I2C và địa chỉ trước khi debug driver.
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.
