Pong trên màn hình TFT màu: ILI9341 với Arduino Uno
Nâng cao
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
ILI9341 là con chip nằm sau các màn hình TFT màu 2.4 và 2.8 inch phổ biến, độ phân giải 240 x 320 điểm ảnh. Nó là một bước tiến lớn so với màn hình OLED nhỏ. Bạn có 65.536 màu và đủ không gian cho một trò chơi thật hoặc một bảng điều khiển. Nó giao tiếp với Arduino qua SPI cùng vài chân điều khiển thêm.
Mạch ở trên là một Arduino Uno chơi Pong trên ILI9341, với cần joystick để di chuyển vợt và một piezo cho tiếng beep. Nhấn cần joystick để phát bóng. Nó chạy ngay trong trình duyệt với sketch bên dưới, và cách nó vẽ dạy cho bạn điều quan trọng nhất về các màn hình này: chỉ vẽ lại những gì đã di chuyển.
Những gì bạn cần
- Một Arduino Uno
- Mô-đun TFT SPI ILI9341 2.4 inch (240x320)
- Mô-đun cần joystick và còi piezo, cho trò chơi
- Một breadboard cỡ đầy đủ và các dây cắm
Đi dây
| Linh kiện và chân | Nối tới | Ghi chú |
|---|---|---|
| TFT CS | Chân 10 | Chọn chip |
| TFT DC | Chân 9 | LOW cho lệnh, HIGH cho dữ liệu |
| TFT SCK | Chân 13 | Xung clock SPI |
| TFT MOSI | Chân 11 | Dữ liệu SPI đến màn hình |
| TFT RST | 5 V | Ở đây nối lên mức cao; hoặc nối vào một chân và khai báo trong sketch |
| TFT LED | 5 V | Đèn nền; thiếu nó màn hình sẽ tối đen |
| TFT VCC và GND | 5 V và GND | Kiểm tra mô-đun của bạn: nhiều loại cần logic 3.3 V |
| VRX, VRY của cần joystick | A0, A1 | Hai trục |
| SW của cần joystick | Chân 2 | Cú nhấn |
| Piezo | Chân 6 và GND | Tiếng beep |
DC: lệnh hay dữ liệu
ILI9341 có thêm một chân khiến nó khác một chip SPI thông thường: DC, để chọn dữ liệu hay lệnh. Khi DC ở mức LOW, byte bạn gửi là một lệnh, chẳng hạn "đặt cửa sổ" hoặc "bắt đầu ghi điểm ảnh". Khi DC ở mức HIGH, các byte là dữ liệu cho lệnh đó, kể cả bản thân các điểm ảnh.
Vẽ một hình chữ nhật gồm ba bước: đặt khoảng cột, đặt khoảng hàng, rồi gửi liên tiếp đúng số lượng màu điểm ảnh. Mọi thư viện đều làm đúng như thế bên dưới.
Vì sao trò chơi chỉ vẽ lại những gì đã di chuyển
Mỗi điểm ảnh là 16 bit, và toàn màn hình là 76.800 điểm ảnh. Đó là rất nhiều dữ liệu đối với một Uno. Trong Mokxi, mô hình Uno không có phần cứng SPI, nên mỗi bit được gửi thủ công, và xóa toàn màn hình mất khoảng một giây rưỡi. SPI phần cứng của Uno thật nhanh hơn, nhưng vẽ lại toàn màn hình vẫn quá chậm cho một trò chơi mượt.
Vì vậy sketch vẽ khung, các nhãn và điểm số đúng một lần. Sau đó, mỗi khung hình chỉ vẽ lại quả bóng và dải vợt đã di chuyển: dưới hai nghìn điểm ảnh, giúp trò chơi giữ được 30 khung hình mỗi giây. Trò chơi cũng nằm trong một cửa sổ 160 x 200 ở giữa màn hình, khiến lần xóa đầu tiên ngắn hơn.
Thói quen này, vẽ một lần rồi chỉ cập nhật những gì thay đổi, là chìa khóa cho bất kỳ dự án màn hình nhanh nào, trên bất kỳ bo mạch nào.
static void drawFrame() {
tft.fillRect(FX, FY, FW, FH, BG);
tft.rect(FX - 2, FY - 2, FW + 4, FH + 4, EDGE, 2);
tft.text(FX, FY - 26, "PONG", ILI9341_WHITE, ILI9341_BLACK, 3);
tft.text(FX, FY + FH + 10, "SCORE", ILI9341_WHITE, ILI9341_BLACK, 2);
tft.text(FX + 110, FY + FH + 10, "LIVES", ILI9341_WHITE, ILI9341_BLACK, 2);
}Dùng thư viện Adafruit
Ví dụ dùng mokxi_ili9341.h, một driver nhỏ đi kèm Mokxi. Trên Uno thật, phần lớn hướng dẫn dùng các thư viện Adafruit_ILI9341 và Adafruit_GFX, và Mokxi có sẵn các header với những tên đó cùng các lệnh quen thuộc. Chương trình hello world bên dưới được viết theo kiểu của các hướng dẫn đó.
Phiên bản của Mokxi có vài điểm khác biệt. Font dựng sẵn là font 5x8 riêng của Mokxi, và các header trong Fonts/ là chữ của Mokxi theo kích thước từng font. Không có gì được đọc ngược từ màn hình. Và bus là SPI phần mềm, nên hãy vẽ những gì di chuyển thay vì thường xuyên tô toàn màn hình.
#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ILI9341.h>
Adafruit_ILI9341 tft(10, 9); // CS, DC; add a third pin for RST if it is wired
void setup() {
tft.begin();
tft.setRotation(1);
tft.fillScreen(ILI9341_BLACK);
tft.setTextColor(ILI9341_WHITE);
tft.setCursor(10, 10);
tft.print("Hello");
}
void loop() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Thử trong trình soạn thảo
Đổi BALL_COLOUR thành ILI9341_RED thì quả bóng chuyển sang màu đỏ. Màu là các số RGB565 16 bit, nên bạn cũng có thể tự viết màu riêng, như 0xF81F cho màu hồng đào.
Cho vợt rộng hơn bằng cách tăng PADDLE_W từ 36 lên 60, và trò chơi dễ hơn. Làm cửa sổ lớn hơn bằng cách đổi FW và FH, và xem lần xóa đầu tiên lâu thêm ra sao.
Những lỗi thường gặp
Màn hình trắng hoặc tối. Kiểm tra chân LED: nó là đèn nền, và màn hình sẽ tối nếu thiếu nó. Màn hình trắng khi đèn nền đã bật thường có nghĩa là phần khởi tạo chưa chạy: kiểm tra CS, DC và RST.
Logic 5 V trên màn hình 3.3 V. Nhiều mô-đun ILI9341 là linh kiện 3.3 V. Một số có bộ chuyển mức trên bo mạch, một số không. Kiểm tra mô-đun của bạn trước khi nối vào Uno, và dùng bộ chuyển mức nếu cần.
Xóa toàn màn hình mỗi khung hình. Nó sẽ nhấp nháy và tiến rất chậm. Hãy vẽ nền một lần và chỉ tô lại những gì thay đổi.
Nhầm DC với CS trong hàm khởi tạo. Thứ tự là CS trước, rồi DC.
Mở mạch này trong trình soạn thảo. Arduino Uno: Pong trên ILI9341, nối dây đúng như đang chạy ở đầu trang này. Đổi một linh kiện hoặc một giá trị rồi chạy lại.
Mở mạchCâu hỏi
ILI9341 dùng những chân nào trên Arduino Uno?
SCK nối với chân 13 và MOSI với chân 11 (các chân SPI của Uno), CS và DC với hai chân bất kỳ mà bạn đặt tên trong sketch, RST với một chân hoặc với nguồn, và LED với nguồn cho đèn nền.
Sao ILI9341 của tôi chạy chậm trên Uno vậy?
Toàn màn hình là 76.800 điểm ảnh, mỗi điểm 16 bit. Chỉ vẽ lại phần thay đổi. Trong Mokxi, SPI của Uno được thực hiện bằng phần mềm nên còn chậm hơn nữa, và ví dụ Pong cho thấy cách xoay xở trong điều kiện đó.
Mokxi có hỗ trợ phiên bản cảm ứng không?
Có. Trong hộp linh kiện có ILI9341 kèm màn hình cảm ứng, đọc bằng thư viện XPT2046_Touchscreen, và có dự án Touch paint dùng linh kiện đó.
Tiếp tục nào
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.