TFT sentuh ILI9488 3,5 inci di sebuah ESP32
Menengah
Atau lihat semua pelajaran.
- 526komponen di meja kerja
- 46board sedang berjalan
- 1.00xwaktu nyata, di semua board
ILI9488 adalah chip di layar SPI merah ukuran 3,5 inci: 320 kali 480 piksel, dengan panel sentuh resistif XPT2046 di board yang sama. Board 4 inci memakai ST7796S dengan resolusi yang sama dan pin yang sama, empat belas pin. Keduanya terlalu besar agar Uno bisa menggambar dengan cepat, dan keduanya cocok untuk ESP32 dan library TFT_eSPI.
Rangkaian di atas adalah ESP32 DevKit dengan board 3,5 inci: deretan pilihan warna di bagian atas, dan kanvas hitam di bawahnya. Tekan Jalankan, ketuk sebuah warna, lalu gambar di layar dengan mouse atau jarimu.
Yang kamu butuhkan
- Sebuah ESP32 DevKit (board 30 atau 38 pin)
- TFT SPI ILI9488 3,5 inci dengan sentuhan (board merah 14 pin), atau versi ST7796S 4 inci
- Kabel jumper
Pengkabelan
| Komponen dan pin | Disambung ke | Catatan |
|---|---|---|
| VCC dan LED | 3V3 | LED adalah backlight |
| GND | GND | |
| CS | GPIO 15 | TFT_CS |
| DC | GPIO 2 | TFT_DC, jalur perintah atau data |
| RST | GPIO 4 | TFT_RST |
| MOSI (SDI) | GPIO 23 | TFT_MOSI |
| SCK | GPIO 18 | TFT_SCLK |
| MISO (SDO) | tidak terhubung | ILI9488 tidak pernah melepaskannya |
| T_CLK dan T_DIN | GPIO 18 dan 23 | Sentuhan berbagi clock dan data keluar |
| T_CS | GPIO 21 | TOUCH_CS, chip select sentuhan |
| T_DO | GPIO 19 | TFT_MISO: hasil baca sentuhan kembali lewat sini |
Menyiapkan TFT_eSPI
TFT_eSPI tidak menerima layar dan pin-nya lewat kode. Ia membacanya dari sebuah file di folder library, User_Setup.h, dan kamu mengedit file itu sekali saja: hapus tanda komentar pada #define ILI9488_DRIVER lalu atur TFT_MISO, TFT_MOSI, TFT_SCLK, TFT_CS, TFT_DC, TFT_RST dan TOUCH_CS.
Di Mokxi, baris yang sama ditulis di bagian atas sketch, di atas #include <TFT_eSPI.h>, dengan nama yang sama. Jadi semua pengaturan berada di satu tempat yang bisa kamu lihat. Salin baris itu ke User_Setup.h saat kamu membuat versi aslinya.
Untuk board 4 inci, ganti ILI9488_DRIVER menjadi ST7796_DRIVER. Tidak ada bagian lain di sketch yang berubah.
#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);
}Kenapa ILI9488 butuh warna 18-bit
Kebanyakan TFT warna menerima satu piksel sebagai dua byte, warna 16-bit "565": 5 bit merah, 6 bit hijau dan 5 bit biru. ILI9488 tidak melakukannya lewat SPI. Datasheet-nya hanya mencantumkan piksel 3-bit dan 18-bit untuk bus serial, jadi setiap piksel dikirim sebagai tiga byte, masing-masing untuk merah, hijau dan biru.
TFT_eSPI tahu hal ini. Dengan ILI9488_DRIVER, ia mengatur chip ke 18 bit dan mengubah setiap warna 565 menjadi tiga byte saat mengirimnya, jadi kode-mu tetap bisa memakai TFT_RED dan color565(). Jika sebaliknya memakai driver ILI9341, chip membaca dua piksel dari setiap tiga piksel yang dikirim, dengan warna yang salah.
Tiga byte per piksel juga alasan ILI9488 lebih lambat. Di sini, dengan TFT_eSPI di ESP32, fillScreen() memakan 261 ms di ILI9488 dan 192 ms di ST7796S, yang memakai warna 16-bit biasa. Gambar hanya bagian yang berubah, bukan seluruh layar.
Membaca panel sentuh
XPT2046 adalah chip kedua di board, dengan chip select sendiri (T_CS). Ia berbagi jalur clock dan data dengan layar, dan menjawab lewat T_DO. tft.getTouchRawZ() memberi tahu seberapa kuat panel ditekan, dan tft.getTouchRaw(&x, &y) menghasilkan dua angka mentah, sekitar 200 di satu sisi kaca sampai sekitar 3900 di sisi lainnya.
Sketch memeriksa tekanan dulu, lalu mengubah angka mentah menjadi piksel dengan map(). Pada rotasi 0, angka X berjalan berlawanan dengan gambar, jadi pemetaan X-nya dari 3890 turun ke 205. Di panel sungguhan, tft.calibrateTouch() mencari tepinya untukmu.
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);
}Memutar layar ke samping
tft.setRotation(1) memutar gambar seperempat putaran, menjadi 480 lebar kali 320 tinggi, dan tft.width() serta tft.height() bertukar mengikuti. Rotasi 0 dan 2 portrait, 1 dan 3 landscape. Chip-nya yang melakukan pemutaran: TFT_eSPI menulis satu byte, bernama MADCTL, yang memberi tahu arah jalannya memori chip.
Panel sentuh tidak ikut berputar bersamanya, karena filmnya ditempel di kaca, bukan di gambar. Sketch yang memutar layar harus menukar dan membalik angka sentuhnya dengan cara yang sama, atau biarkan tft.calibrateTouch() menghitungkannya untuk rotasi itu.
ILI9488 atau ST7796S?
Kedua board terlihat mirip dan memakai pin yang sama, jadi pilihannya bergantung pada ukuran dan kecepatan. ST7796S 4 inch punya gambar yang lebih besar dan menerima warna 16-bit, jadi mengisinya sekitar seperempat lebih cepat dengan kabel yang sama. ILI9488 3,5 inch lebih kecil, lebih murah, dan lebih mudah ditemukan.
Kode berpindah di antara keduanya dengan satu baris saja: define driver. Chip sentuh, kabel, dan setiap pemanggilan gambar tetap sama. Beberapa board 4 inch adalah panel IPS yang menampilkan gambar negatif sampai kamu menambahkan #define TFT_INVERSION_ON; board TN biasa di sini tidak memerlukannya.
Kesalahan umum
MISO display tersambung ke T_DO. ILI9488 tetap menggerakkan pin SDO-nya bahkan saat tidak dipilih, jadi hasil pembacaan sentuh datang sebagai data rusak. Biarkan MISO display tidak tersambung.
Define driver yang salah. ILI9341_DRIVER atau ST7796_DRIVER pada ILI9488 menghasilkan warna yang salah; ILI9488_DRIVER pada ST7796S juga begitu.
Menjalankannya dari Uno. Ini bisa jalan dengan library ILI9488, tetapi 320 kali 480 piksel dengan tiga byte per piksel itu banyak sekali untuk SPI pada board 16 MHz, dan TFT_eSPI sama sekali tidak berjalan di board AVR.
Menggambar seluruh layar di setiap loop. Bahkan di ESP32, mengisi penuh butuh seperempat detik.
Buka rangkaian ini di editor. ESP32 DevKit: ILI9488 touch paint, dengan kabel seperti saat dijalankan di bagian atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.
Buka rangkaian iniPertanyaan
Apakah TFT_eSPI mendukung ILI9488?
Ya. Taruh #define ILI9488_DRIVER di User_Setup.h (atau di atas include, di Mokxi). Ini mengirim warna 18-bit, satu-satunya format warna penuh yang diterima ILI9488 lewat SPI.
Apa bedanya ILI9488 dan ST7796S?
Keduanya adalah controller SPI TFT 320x480 pada board sentuh 14 pin. ST7796S (biasanya 4 inch) menerima warna 16-bit seperti ILI9341, jadi mengisinya lebih cepat; ILI9488 (biasanya 3,5 inch) hanya menerima warna 18-bit.
Kenapa warnanya salah di ILI9488-ku?
Paling sering sketch memakai driver ILI9341, yang mengirim warna 16-bit. Gunakan ILI9488_DRIVER di TFT_eSPI, atau library ILI9488.
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.