Chuyển đến nội dung
Display Engineer
Waveshare · Board phát triển có màn hình

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.

Kỹ sư rà soát 11 thg 10, 2026

Thông số màn hình Waveshare ESP32-S3-Touch-LCD-1.28

MCUESP32-S3
Màn hình1.28″ · 240×240 · tròn
Bus màn hìnhSPI
IC driverGC9A01
Cảm ứngCST816S đ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 đổiIC driverCách nhận biếtCài đặt thư viện
ESP32-S3-Touch-LCD-1.28GC9A01TFT_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ệuGPIOGhi chú
LCD SCLK10SPI
LCD MOSI11SPI
LCD CS9
LCD DC8
LCD RST14
Backlight2
Touch/IMU SDA6I2C, dùng chung với QMI8658
Touch/IMU SCL7I2C
Touch INT5CST816S
Touch RST13CST816S

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ã

  1. 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.
  2. Kiểm tra chân đèn nền không bị dùng lại trong sketch.
  3. 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

TFT_eSPI User_Setup.hc
#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 40000000
Tham khảo· Community / vendor configuration (see sources)

Câ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

  1. RIOT OS: board waveshare-esp32s3-touch-lcd-128 (bảng chân)
  2. Waveshare: ESP32-S3-LCD-1.28

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.