Bir ESP32 üzerinde 3.5 inç ILI9488 dokunmatik TFT
Orta
Ya da tüm dersleri gör.
- 526parça tezgahta
- 46kart şu an çalışıyor
- 1.00xgerçek zamanlı, her kartta
ILI9488, kırmızı 3.5 inç SPI ekranlardaki çiptir: 320x480 piksel, aynı kart üzerinde XPT2046 dirençli dokunmatik panel ile. 4 inç kartlar aynı çözünürlükte ve aynı on dört pinde ST7796S kullanır. İkisi de bir Uno'nun hızlı çizmesi için fazla büyüktür ve ikisi de bir ESP32 ile TFT_eSPI kütüphanesi için uygun bir eşleşmedir.
Yukarıdaki devre, 3.5 inç kartlı bir ESP32 DevKit'tir: üstte bir sıra renk örneği, altında siyah bir tuval. Çalıştır'a bas, bir renge dokun, sonra ekranda faren ya da parmağınla çiz.
Neye ihtiyacın var?
- Bir ESP32 DevKit (30 veya 38 pinlik kart)
- Dokunmatikli 3.5 inç ILI9488 SPI TFT (kırmızı 14 pinli kart) veya 4 inç ST7796S olanı
- Jumper kablolar
Kablolama
| Parça ve pin | Gittiği yer | Not |
|---|---|---|
| VCC ve LED | 3V3 | LED arka aydınlatmadır |
| GND | GND | |
| CS | GPIO 15 | TFT_CS |
| DC | GPIO 2 | TFT_DC, komut ya da veri hattı |
| RST | GPIO 4 | TFT_RST |
| MOSI (SDI) | GPIO 23 | TFT_MOSI |
| SCK | GPIO 18 | TFT_SCLK |
| MISO (SDO) | bağlı değil | ILI9488 bu hattı hiç bırakmaz |
| T_CLK ve T_DIN | GPIO 18 ve 23 | Dokunmatik, saat ve veri çıkışını paylaşır |
| T_CS | GPIO 21 | TOUCH_CS, dokunmatik çip seçimi |
| T_DO | GPIO 19 | TFT_MISO: dokunmatik ölçümleri buradan döner |
TFT_eSPI'yi ayarlamak
TFT_eSPI, ekranı ve pinlerini kod içinde almaz. Bunları kütüphane klasöründeki User_Setup.h dosyasından okur ve bu dosyayı bir kez düzenlersin: #define ILI9488_DRIVER satırının açıklama işaretini kaldır ve TFT_MISO, TFT_MOSI, TFT_SCLK, TFT_CS, TFT_DC, TFT_RST ile TOUCH_CS değerlerini ayarla.
Mokxi'de aynı satırlar kodun en üstüne, #include <TFT_eSPI.h> satırının üzerine, aynı adlarla gider. Bu, tüm ayarı görebileceğin tek bir yerde tutar. Gerçekten kurarken bunları User_Setup.h dosyasına kopyala.
4 inç kart için ILI9488_DRIVER değerini ST7796_DRIVER olarak değiştir. Koddaki başka hiçbir şey değişmez.
#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);
}ILI9488 neden 18 bit renge ihtiyaç duyar
Renkli TFT'lerin çoğu bir pikseli iki bayt, 16 bit "565" renk olarak alır: 5 bit kırmızı, 6 bit yeşil ve 5 bit mavi. ILI9488 bunu SPI üzerinden yapmaz. Veri sayfasında seri veri yolu için yalnızca 3 bit ve 18 bit piksel listelenir, yani her piksel kırmızı, yeşil ve mavi için birer tane olmak üzere üç bayt olarak gider.
TFT_eSPI bunu bilir. ILI9488_DRIVER ile çipi 18 bite ayarlar ve gönderirken her 565 rengini üç bayta çevirir, böylece kodun yine TFT_RED ve color565() kullanır. Bunun yerine bir ILI9341 sürücüsüyle, çip kendisine gönderilen her üç bayttan iki pikseli yanlış renklerle okur.
Piksel başına üç bayt olması, ILI9488'nin daha yavaş olmasının da nedenidir. Burada, ESP32 üzerinde TFT_eSPI ile fillScreen(), ILI9488'de 261 ms, normal 16 bit renk alan ST7796S'de ise 192 ms sürer. Tüm ekranı değil, değişen kısmı çiz.
Dokunmatik paneli okumak
XPT2046, kart üzerinde kendi çip seçimi (T_CS) olan ikinci bir çiptir. Saat ve veri hatlarını ekranla paylaşır ve T_DO üzerinden yanıt verir. tft.getTouchRawZ() panele ne kadar basıldığını söyler, tft.getTouchRaw(&x, &y) ise camın bir kenarında yaklaşık 200'den diğer kenarında yaklaşık 3900'a kadar iki ham sayı verir.
Kod önce basınca bakar, sonra ham sayıları map() ile piksele çevirir. 0 döndürmesinde X sayıları resme göre ters yönde ilerler, bu yüzden X haritalaması 3890'dan 205'e düşer. Gerçek bir panelde tft.calibrateTouch() kenarları senin için bulur.
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);
}Ekranı yan çevirmek
tft.setRotation(1) resmi çeyrek tur döndürür, 480 genişliğe 320 yüksekliğe, ve tft.width() ile tft.height() buna uyacak şekilde yer değiştirir. 0 ve 2 döndürmeleri dikey, 1 ve 3 yataydır. Döndürmeyi çip yapar: TFT_eSPI, çipe belleğini hangi yönde gezineceğini söyleyen MADCTL adlı tek bir bayt yazar.
Dokunmatik panel onunla birlikte dönmez, çünkü film cama yapıştırılmıştır, görüntüye değil. Ekranı döndüren bir kodun, dokunma numaralarını da aynı şekilde yer değiştirip çevirmesi ya da tft.calibrateTouch() fonksiyonunun o döndürme için bunu kendisinin hesaplamasına izin vermesi gerekir.
ILI9488 mi ST7796S mi?
İki kart birbirine benzer ve aynı pinleri kullanır, bu yüzden seçim boyut ve hıza göre yapılır. 4 inç ST7796S daha büyük bir görüntüye sahiptir ve 16 bit renk alır, dolayısıyla aynı kablolarla ekranı yaklaşık dörtte bir daha hızlı doldurur. 3.5 inç ILI9488 ise daha küçük, daha ucuz ve bulması daha kolaydır.
Kod aralarında tek bir satırla taşınır: sürücü tanımı. Dokunmatik çip, kablolama ve tüm çizim çağrıları aynı kalır. Bazı 4 inç kartlar, #define TFT_INVERSION_ON ekleyene kadar negatif görüntü gösteren IPS panellerdir; buradaki düz TN kart bunu gerektirmez.
Sık yapılan hatalar
Ekran MISO'sunun T_DO ile bağlanması. ILI9488, seçili olmadığında bile SDO pinini sürmeye devam eder, bu yüzden dokunmatik okumaları bozuk veri olarak geri gelir. Ekran MISO pinini bağlamadan boş bırakın.
Yanlış sürücü tanımı. ILI9488 üzerinde ILI9341_DRIVER veya ST7796_DRIVER yanlış renkler verir; ST7796S üzerinde ILI9488_DRIVER da aynı şekilde.
Bir Uno ile çalıştırmak. ILI9488 kütüphanesi ile çalışır, ama her biri üç bayt olan 320'ye 480 piksel, 16 MHz'lik bir kart için çok fazla SPI yüküdür ve TFT_eSPI AVR kartlarında hiç çalışmaz.
Her döngüde ekranın tamamını çizmek. Bir ESP32'de bile tam bir doldurma çeyrek saniye sürer.
Bu devreyi düzenleyicide aç. ESP32 DevKit: ILI9488 dokunmatik boyama, bu sayfanın üstünde çalıştığı gibi kablolandırılmış. Bir parçayı ya da değeri değiştir ve yeniden çalıştır.
Devreyi açSorular
TFT_eSPI, ILI9488'i destekliyor mu?
Evet. User_Setup.h içine (ya da Mokxi'de include satırının üstüne) #define ILI9488_DRIVER yazın. 18 bit renk gönderir, bu da ILI9488'in SPI üzerinden kabul ettiği tek tam renk biçimidir.
ILI9488 ile ST7796S arasındaki fark nedir?
İkisi de 14 pinli dokunmatik kartlarda 320x480 SPI TFT denetleyicileridir. ST7796S (genellikle 4 inç) ILI9341 gibi 16 bit renk alır, bu yüzden daha hızlı doldurur; ILI9488 (genellikle 3.5 inç) yalnızca 18 bit renk alır.
ILI9488'imde renkler neden yanlış?
Çoğu zaman kod, 16 bit renk gönderen bir ILI9341 sürücüsü kullanıyordur. TFT_eSPI'de ILI9488_DRIVER'ı ya da ILI9488 kütüphanesini kullanın.
Bunu gerçekten kur
Düzenleyiciyi aç, bir değeri değiştir ve sayının onunla birlikte değiştiğini izle. Kurulacak bir şey yok, hesaba da gerek yok.