Học

Màn hình TFT cảm ứng ILI9488 3.5 inch trên một ESP32

Trung bình

Hoặc xem mọi bài học.

  • 526linh kiện trên bàn làm mạch
  • 46bo mạch đang chạy
  • 1.00xthời gian thực, trên mọi bo mạch
ESP32 DevKit: vẽ tay trên ILI9488 cảm ứngtrực tiếp0.000 s 0.00x
Nhấp để mở trong trình soạn thảo
Nhấn Chạy, rồi vẽ trên khung vẽ. Chạm vào một ô màu để đổi màu bút, và vào dòng chữ để xóa. XPT2046 đọc vị trí bạn chạm, và sketch quy đổi nó ra tọa độ điểm ảnh.

ILI9488 là chip trên các màn hình SPI đỏ 3.5 inch: 320 nhân 480 điểm ảnh, kèm một cảm ứng điện trở XPT2046 ngay trên bo mạch. Các bo mạch 4 inch dùng ST7796S với cùng độ phân giải và cùng mười bốn chân. Cả hai đều quá lớn để Uno vẽ nhanh, và cả hai đều rất hợp với ESP32 cùng thư viện TFT_eSPI.

Mạch trên là một ESP32 DevKit với bo mạch 3.5 inch: một dãy ô màu nằm dọc mép trên, và khung vẽ màu đen phía dưới. Nhấn Chạy, chạm vào một màu, rồi vẽ trên màn hình bằng chuột hoặc ngón tay.

Những gì bạn cần

  • Một ESP32 DevKit (bo mạch 30 hoặc 38 chân)
  • Màn hình TFT SPI ILI9488 3.5 inch có cảm ứng (bo mạch đỏ 14 chân), hoặc loại 4 inch dùng ST7796S
  • Dây cắm

Đi dây

Linh kiện và chânNối tớiGhi chú
VCC và LED3V3LED là đèn nền
GNDGND
CSGPIO 15TFT_CS
DCGPIO 2TFT_DC, đường lệnh hoặc dữ liệu
RSTGPIO 4TFT_RST
MOSI (SDI)GPIO 23TFT_MOSI
SCKGPIO 18TFT_SCLK
MISO (SDO)chưa kết nốiILI9488 không bao giờ nhả đường này
T_CLK và T_DINGPIO 18 và 23Cảm ứng dùng chung đường clock và dữ liệu ra
T_CSGPIO 21TOUCH_CS, chân chọn chip cảm ứng
T_DOGPIO 19TFT_MISO: các số đọc cảm ứng quay về đây

Thiết lập TFT_eSPI

TFT_eSPI không nhận màn hình và các chân của nó qua code. Nó đọc chúng từ một tệp trong thư mục thư viện, User_Setup.h, và bạn chỉ cần chỉnh tệp đó một lần: bỏ chú thích #define ILI9488_DRIVER và đặt TFT_MISO, TFT_MOSI, TFT_SCLK, TFT_CS, TFT_DC, TFT_RST và TOUCH_CS.

Trong Mokxi, các dòng tương tự đặt ở đầu sketch, phía trên #include <TFT_eSPI.h>, với các tên giống hệt. Như vậy toàn bộ phần thiết lập nằm ngay tại một chỗ bạn nhìn thấy được. Khi làm thật, hãy chép chúng vào User_Setup.h.

Với bo mạch 4 inch, đổi ILI9488_DRIVER thành ST7796_DRIVER. Không có gì khác trong sketch phải thay đổi.

Sketch vẽ tay bằng cảm ứng, phần setup
#define ILI9488_DRIVER
#define TFT_MISO 19
#define TFT_MOSI 23
#define TFT_SCLK 18
#define TFT_CS   15
#define TFT_DC    2
#define TFT_RST   4
#define TOUCH_CS 21

#include <TFT_eSPI.h>

TFT_eSPI tft = TFT_eSPI();

void setup() {
  Serial.begin(115200);
  tft.init();
  tft.setRotation(0);  // portrait, 320x480
  tft.fillScreen(TFT_BLACK);
}

Vì sao ILI9488 cần màu 18 bit

Hầu hết các TFT màu nhận mỗi điểm ảnh dưới dạng hai byte, màu 16 bit kiểu "565": 5 bit đỏ, 6 bit xanh lá và 5 bit xanh dương. ILI9488 không làm vậy qua SPI. Datasheet của nó chỉ liệt kê điểm ảnh 3 bit và 18 bit cho bus nối tiếp, nên mỗi điểm ảnh gửi đi bằng ba byte, mỗi byte một kênh đỏ, xanh lá và xanh dương.

TFT_eSPI biết điều này. Với ILI9488_DRIVER nó đặt chip ở chế độ 18 bit và chuyển mỗi màu 565 thành ba byte khi gửi, nên code của bạn vẫn dùng TFT_RED và color565() như thường. Nếu thay bằng driver ILI9341, chip sẽ đọc hai điểm ảnh trong mỗi ba điểm gửi tới, với màu sai.

Ba byte mỗi điểm ảnh cũng là lý do ILI9488 chậm hơn. Ở đây, với TFT_eSPI trên ESP32, fillScreen() mất 261 ms trên ILI9488 và 192 ms trên ST7796S, vốn dùng màu 16 bit thông thường. Hãy vẽ phần thay đổi, chứ đừng vẽ cả màn hình.

Đọc cảm ứng

XPT2046 là một chip thứ hai trên bo mạch, có chân chọn riêng (T_CS). Nó dùng chung đường clock và dữ liệu với màn hình, và trả lời trên T_DO. tft.getTouchRawZ() cho biết mặt kính bị nhấn mạnh đến đâu, còn tft.getTouchRaw(&x, &y) trả về hai số thô, từ khoảng 200 ở một cạnh kính đến khoảng 3900 ở cạnh kia.

Sketch kiểm tra lực nhấn trước, rồi đổi các số thô thành tọa độ điểm ảnh bằng map(). Ở chế độ xoay 0, các số X chạy ngược với hình vẽ, nên phép map X của nó đi từ 3890 xuống 205. Trên một cảm ứng thật, tft.calibrateTouch() tự tìm các cạnh cho bạn.

Sketch vẽ tay bằng cảm ứng, phần loop
void loop() {
  if (tft.getTouchRawZ() < 300) return;  // not pressed
  uint16_t rx, ry;
  tft.getTouchRaw(&rx, &ry);
  int x = constrain(map(rx, 3890, 205, 0, 319), 0, 319);
  int y = constrain(map(ry, 205, 3890, 0, 479), 0, 479);
  tft.fillCircle(x, y, 4, TFT_YELLOW);
}

Xoay màn hình sang một bên

tft.setRotation(1) quay hình một phần tư vòng, thành rộng 480 cao 320, và tft.width() với tft.height() đổi chỗ cho nhau tương ứng. Chế độ xoay 0 và 2 là dọc, 1 và 3 là ngang. Chính chip thực hiện việc xoay: TFT_eSPI ghi một byte tên MADCTL để báo cho nó biết đi theo hướng nào trong bộ nhớ.

Bảng cảm ứng không xoay cùng màn hình, vì lớp phim được dán vào kính chứ không dán vào hình ảnh. Một sketch xoay màn hình phải hoán đổi và lật ngược các số liệu cảm ứng theo cách tương tự, hoặc để tft.calibrateTouch() tự tính cho góc xoay đó.

ILI9488 hay ST7796S?

Hai bo mạch trông giống nhau và dùng cùng các chân, nên lựa chọn phụ thuộc vào kích thước và tốc độ. ST7796S 4 inch có hình ảnh lớn hơn và nhận màu 16-bit, nên nó tô đầy màn hình nhanh hơn khoảng một phần tư trên cùng các dây nối. ILI9488 3.5 inch nhỏ hơn, rẻ hơn và dễ tìm hơn.

Code chuyển giữa chúng chỉ bằng một dòng: dòng define driver. Chip cảm ứng, cách nối dây và mọi lệnh vẽ đều giữ nguyên. Một số bo mạch 4 inch là màn hình IPS hiển thị ảnh âm bản cho đến khi bạn thêm #define TFT_INVERSION_ON; bo mạch TN thông thường ở đây không cần dòng này.

Những lỗi thường gặp

Chân MISO của màn hình bị nối với T_DO. ILI9488 vẫn kéo chân SDO của nó ngay cả khi không được chọn, nên các số đo cảm ứng trả về thành rác. Hãy để chân MISO của màn hình không nối.

Sai dòng define driver. ILI9341_DRIVER hoặc ST7796_DRIVER trên ILI9488 cho màu sai; ILI9488_DRIVER trên ST7796S cũng vậy.

Chạy trên Uno. Nó chạy được với thư viện ILI9488, nhưng 320 nhân 480 điểm ảnh, mỗi điểm ba byte, là quá nhiều cho SPI của một bo mạch 16 MHz, và TFT_eSPI thì không chạy trên các bo mạch AVR.

Vẽ lại toàn bộ màn hình trong mỗi vòng lặp. Ngay cả trên ESP32, một lần tô đầy cũng mất một phần tư giây.

Mở mạch này trong trình soạn thảo. ESP32 DevKit: vẽ bằng cảm ứng trên ILI9488, được nối dây như khi chạy ở đầu trang này. Thay đổi một linh kiện hoặc một giá trị rồi chạy lại.

Mở mạch

Câu hỏi

TFT_eSPI có hỗ trợ ILI9488 không?

Có. Đặt #define ILI9488_DRIVER trong User_Setup.h (hoặc phía trên dòng include, trong Mokxi). Nó gửi màu 18-bit, là định dạng màu đầy đủ duy nhất mà ILI9488 nhận qua SPI.

Khác nhau giữa ILI9488 và ST7796S là gì?

Cả hai đều là bộ điều khiển TFT SPI 320x480 trên các bo mạch cảm ứng 14 chân. ST7796S (thường 4 inch) nhận màu 16-bit như ILI9341 nên tô nhanh hơn; ILI9488 (thường 3.5 inch) chỉ nhận màu 18-bit.

Tại sao màu trên ILI9488 của tôi bị sai?

Thường là do sketch dùng driver ILI9341, vốn gửi màu 16-bit. Hãy dùng ILI9488_DRIVER trong TFT_eSPI, hoặc thư viện ILI9488.

Lắp mạch này ngoài đời

Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.