Belajar

Pong di TFT berwarna: ILI9341 di Arduino Uno

Mahir

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Arduino Uno: Pong di ILI9341live0.000 s 0.00x
Tekan thumb stick untuk melakukan servis, lalu dorong ke kiri dan ke kanan
Contoh konsol Pong di ATmega328P simulasi. Tekan stick untuk servis.

ILI9341 adalah chip di balik layar TFT warna 2,4 dan 2,8 inci yang umum, 240 kali 320 piksel. Ini lompatan besar dari OLED kecil. Kamu mendapat 65.536 warna dan ruang untuk game sungguhan atau dasbor. Chip ini berbicara dengan Arduino lewat SPI dengan beberapa pin kontrol tambahan.

Rangkaian di atas adalah Arduino Uno yang memainkan Pong di ILI9341, dengan thumb stick untuk menggerakkan paddle dan piezo untuk bunyi beep. Tekan stick untuk servis. Game ini berjalan di browser-mu dengan sketch di bawah, dan cara menggambarnya mengajarkan hal terpenting tentang layar ini: gambar ulang hanya yang bergerak.

Yang kamu butuhkan

  • Arduino Uno
  • Modul TFT SPI ILI9341 2,4 inci (240x320)
  • Modul thumb stick dan piezo buzzer, untuk gamenya
  • Breadboard ukuran penuh dan kabel jumper

Pengkabelan

Komponen dan pinDisambung keCatatan
TFT CSPin 10Chip select
TFT DCPin 9LOW untuk perintah, HIGH untuk data
TFT SCKPin 13Clock SPI
TFT MOSIPin 11Data SPI ke layar
TFT RST5 VDitarik tinggi di sini; atau sambungkan ke pin dan sebutkan di sketch
TFT LED5 VLampu latar; tanpanya layar tetap gelap
TFT VCC dan GND5 V dan GNDCek modul-mu: banyak yang butuh logika 3,3 V
Stick VRX, VRYA0, A1Dua sumbu
Stick SWPin 2Tekanannya
PiezoPin 6 dan GNDBunyi beep

DC: perintah atau data

ILI9341 punya satu pin tambahan yang membedakannya dari chip SPI biasa: DC, untuk data atau perintah. Saat DC LOW, byte yang kamu kirim adalah perintah, seperti "atur jendela" atau "mulai menulis piksel". Saat DC HIGH, byte-byte itu adalah data untuk perintah tersebut, termasuk pikselnya sendiri.

Menggambar persegi panjang butuh tiga langkah. Atur rentang kolom, atur rentang baris, lalu kirim jumlah warna piksel yang tepat. Setiap library melakukan persis seperti ini di balik layar.

Kenapa game hanya menggambar ulang yang bergerak

Setiap piksel 16 bit, dan seluruh layar berisi 76.800 piksel. Itu banyak data untuk sebuah Uno. Di Mokxi model Uno tidak punya hardware SPI, jadi setiap bit dikirim manual, dan membersihkan seluruh layar butuh sekitar satu setengah detik. Hardware SPI di Uno sungguhan lebih cepat, tapi menggambar ulang penuh tetap terlalu lambat untuk game yang mulus.

Jadi sketch menggambar bingkai, label, dan skor sekali saja. Setelah itu, setiap frame hanya mengecat ulang bola dan strip paddle yang bergerak: di bawah dua ribu piksel, yang menjaga game tetap di 30 frame per detik. Game juga hidup di jendela 160 kali 200 di tengah layar, yang membuat pembersihan sekali itu lebih singkat.

Kebiasaan ini, gambar sekali lalu perbarui hanya yang berubah, adalah kunci proyek tampilan cepat apa pun, di board mana pun.

Menggambar bagian tetap sekali saja, dari contoh konsol 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);
}

Memakai library Adafruit

Contoh ini memakai mokxi_ili9341.h, driver kecil yang dibawa Mokxi. Di Uno sungguhan, kebanyakan tutorial memakai library Adafruit_ILI9341 dan Adafruit_GFX, dan Mokxi membawa header dengan nama itu dan panggilan biasanya juga. Hello world di bawah ditulis seperti cara tutorial-tutorial itu menulisnya.

Versi Mokxi punya beberapa perbedaan. Font bawaan adalah 5x8 buatan Mokxi, dan header di Fonts/ adalah huruf Mokxi pada ukuran setiap font. Tidak ada yang dibaca balik dari layar. Dan busnya adalah SPI software, jadi gambar yang bergerak saja daripada mengisi seluruh layar terus-menerus.

Hello world dengan library 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() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Coba di editor

Ubah BALL_COLOUR menjadi ILI9341_RED dan bolanya berubah merah. Warna adalah angka RGB565 16 bit, jadi kamu juga bisa menulis sendiri, seperti 0xF81F untuk magenta.

Buat paddle lebih lebar dengan menaikkan PADDLE_W dari 36 ke 60, dan game jadi lebih mudah. Perbesar jendela dengan mengubah FW dan FH, dan lihat pembersihan pertama makin lama.

Kesalahan umum

Layar putih atau gelap. Cek pin LED: itu lampu latar, dan layar tetap gelap tanpanya. Layar putih dengan lampu latar menyala biasanya berarti init tidak pernah berjalan: cek CS, DC, dan RST.

Logika 5 V di layar 3,3 V. Banyak modul ILI9341 adalah komponen 3,3 V. Beberapa punya level shifter di board dan beberapa tidak. Cek punyamu sebelum menyambungkannya ke Uno, dan pakai level shifter bila perlu.

Membersihkan seluruh layar setiap frame. Berkedip dan berjalan lambat. Gambar latar sekali dan cat ulang hanya yang berubah.

Tertukar DC dan CS di constructor. Urutannya CS dulu, lalu DC.

Buka rangkaian ini di editor. Arduino Uno: Pong di ILI9341, dirangkai seperti yang berjalan di atas halaman ini. Ubah komponen atau nilai lalu jalankan lagi.

Buka rangkaian ini

Pertanyaan

Pin apa saja yang dipakai ILI9341 di Arduino Uno?

SCK ke 13 dan MOSI ke 11 (pin SPI Uno), CS dan DC ke dua pin apa pun yang kamu sebutkan di sketch, RST ke sebuah pin atau ke catu daya, dan LED ke catu daya untuk backlight.

Kenapa ILI9341 saya lambat sekali di Uno?

Satu layar penuh berarti 76.800 piksel, masing-masing 16 bit. Gambar ulang hanya bagian yang berubah. Di Mokxi, SPI Uno dikerjakan lewat software, jadi lebih lambat lagi, dan contoh Pong menunjukkan cara bekerja dalam batas itu.

Apakah Mokxi mendukung versi sentuh?

Ya. Ada ILI9341 dengan panel sentuh di kotak komponen, dibaca dengan library XPT2046_Touchscreen, dan ada proyek Touch paint yang menggunakannya.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.