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
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 pin | Disambung ke | Catatan |
|---|---|---|
| TFT CS | Pin 10 | Chip select |
| TFT DC | Pin 9 | LOW untuk perintah, HIGH untuk data |
| TFT SCK | Pin 13 | Clock SPI |
| TFT MOSI | Pin 11 | Data SPI ke layar |
| TFT RST | 5 V | Ditarik tinggi di sini; atau sambungkan ke pin dan sebutkan di sketch |
| TFT LED | 5 V | Lampu latar; tanpanya layar tetap gelap |
| TFT VCC dan GND | 5 V dan GND | Cek modul-mu: banyak yang butuh logika 3,3 V |
| Stick VRX, VRY | A0, A1 | Dua sumbu |
| Stick SW | Pin 2 | Tekanannya |
| Piezo | Pin 6 dan GND | Bunyi 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.
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.
#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 iniPertanyaan
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.
Lanjutkan
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.