Học

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
Arduino Uno: Pong trên ILI9341trực tiếp0.000 s 0.00x
Nhấn cần joystick để phát bóng, rồi đẩy trái và phải
Ví dụ máy chơi Pong trên ATmega328P được mô phỏng. Nhấn cần joystick để phát bóng.

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ânNối tớiGhi chú
TFT CSChân 10Chọn chip
TFT DCChân 9LOW cho lệnh, HIGH cho dữ liệu
TFT SCKChân 13Xung clock SPI
TFT MOSIChân 11Dữ liệu SPI đến màn hình
TFT RST5 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 LED5 VĐèn nền; thiếu nó màn hình sẽ tối đen
TFT VCC và GND5 V và GNDKiểm tra mô-đun của bạn: nhiều loại cần logic 3.3 V
VRX, VRY của cần joystickA0, A1Hai trục
SW của cần joystickChân 2Cú nhấn
PiezoChân 6 và GNDTiế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.

Vẽ các phần cố định một lần, từ ví dụ máy chơi Pong
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.

Hello world với thư viện Adafruit ILI9341
#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ạch

Câ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 đó.

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.