Parçalar · 7 dk okuma

2,4 inç TFT Shield Arduino: MCUFRIEND_kbv, Dokunmatik ve SD

2,4 inç TFT shield Arduino rehberi: MCUFRIEND_kbv kurulumu, sürücü kimliği, beyaz ekran çözümü, dokunmatik kalibrasyon, buton arayüzü, SD'den resim ve pinler.

2,4 inç TFT LCD shield, Arduino Uno'nun üstüne doğrudan takılan, 240×320 piksellik renkli ve dokunmatik bir ekrandır. Kablo bağlamazsın, lehim yapmazsın: shield'i Uno ya da Mega'nın pin başlıklarına oturtur, doğru kütüphaneyi kurar ve birkaç dakika içinde renkli yazılar, şekiller, dokunmatik butonlar ve SD karttan resimler gösterirsin. Ucuz olduğu için başlangıç setlerinde ve okul projelerinde çok yaygındır; aynı nedenle internette en çok "ekranım beyaz kalıyor" diye sorulan parçalardan biridir.

Bu rehberde shield'in neden bazen beyaz ekran verdiğini ve bunun MCUFRIEND_kbv kütüphanesiyle nasıl çözüldüğünü göreceksin. Sürücü kimliğini bulacak, dokunmatik paneli kalibre edecek, ters çalışan dokunmayı düzeltecek, dokunmatik butonlarla bir LED'i yönetecek ve microSD karttan resim göstereceksin. Ayrıca shield'in hangi pinleri kapladığını, geriye ne kaldığını ve Mega, ESP32 ile Pico'da nelere dikkat etmen gerektiğini anlatıyoruz.

Arduino Uno kartı
2,4 inç TFT shield bu kartın üstüne oturur ve pinlerin neredeyse hepsini kullanır; geriye A5, D0–D1 ve SD kullanılmıyorsa D10–D13 kalır.

2,4 inç TFT shield nedir, nasıl çalışır?

Shield'in üzerinde üç ayrı parça vardır: renkli TFT panel, panelin üstüne yapıştırılmış dirençli (rezistif) dokunmatik katman ve arkada bir microSD kart yuvası. Ekran Arduino'ya SPI gibi seri bir hatla değil, 8 bitlik paralel bir veri yoluyla bağlanır; her seferde bir bayt gönderildiği için Uno'da SPI modüllere göre hızlı çizer ama çok pin kullanır. Panelin içindeki sürücü yonga 3,3 V ile çalışır; shield üzerindeki 3,3 V regülatör ve 74HC245 benzeri seviye dönüştürücü sayesinde Uno'nun 5 V sinyalleri güvenle kullanılır.

ÖzellikDeğer
Ekran2,4 inç TFT, 240×320 piksel
Renk16 bit (RGB565), 65 536 renk
Arayüz8 bit paralel (D0–D7) + 5 kontrol hattı
Sürücü yongaDeğişken: ILI9341, ILI9325, ST7781, SPFD5408, HX8347 ve diğerleri
Dokunmatik4 telli dirençli, ekran pinleriyle ortak
SD yuvasımicroSD, SPI (D10–D13)
Besleme5 V (kart üzerinde 3,3 V regülatör)
AkımYaklaşık 80–120 mA, çoğunu arka ışık çeker
Uyumlu kartlarArduino Uno, Arduino Mega 2560

Shield mi, SPI modül mü?

Aynı boyda iki farklı ürün satılır ve ikisi de "2,4 inç TFT" diye anılır. Shield, Uno'ya takıp çalıştırdığın paralel modeldir. SPI modül ise kenarında tek sıra pin başlığı olan, kabloyla bağlanan modeldir; dokunmatiği de genellikle XPT2046 yongasıyla SPI üzerinden okunur. Bu yazı shield'i anlatıyor; SPI modül için ILI9341 TFT ekran yazısına bakabilirsin.

SPI arayüzlü ILI9341 TFT ekran modülü
Shield'in kardeşi olan SPI modül: tek sıra pin başlığıyla kabloyla bağlanır, ESP32 ve Pico ile çok daha rahat çalışır.
Özellik2,4" Uno shield2,4" SPI modül
BağlantıUno ya da Mega'ya takılır, kablo yok7–14 jumper kablo
Kullandığı pinD2–D9, A0–A4 (SD ile D10–D13)Ekran için 5, dokunmatik ve SD ile 8–9
Uno'da çizim hızıHızlı (paralel)Daha yavaş (SPI)
KütüphaneMCUFRIEND_kbvAdafruit_ILI9341, TFT_eSPI
Dokunmatik okumaAnalog, ekranla ortak pinlerXPT2046 yongası, SPI
ESP32 ve PicoUygun değilUygun
Sensörler için boş pinNeredeyse yokÇok

Pin tablosu: shield hangi pinleri kullanır?

Shield piniArduino Uno piniGörevi
LCD_RDA0Okuma sinyali
LCD_WRA1Yazma sinyali (dokunmatikle ortak olabilir)
LCD_RS (CD)A2Komut mu veri mi? (dokunmatikle ortak)
LCD_CSA3Ekran seçme (dokunmatikle ortak olabilir)
LCD_RSTA4Ekranı resetleme
LCD_D0, LCD_D1D8, D9Veri hattının ilk iki biti
LCD_D2–LCD_D7D2–D7Veri hattının kalan altı biti
SD_SS / SD_DI / SD_DO / SD_SCKD10 / D11 / D12 / D13microSD kart (SPI)
5V, 3V3, GND5V, 3.3V, GNDBesleme
Shield takılıyken Uno'da sensörler için neredeyse pin kalmaz. A4 ekranın reset hattı olduğu için A4/A5 üzerindeki I2C kullanılamaz; I2C'li bir sensör ya da ekran ekleyemezsin. Boş kalanlar: A5 (çoğu shield'de bağlı değildir), USB yüklemesiyle paylaşılan D0–D1 ve SD kart kullanmıyorsan D10–D13. Daha fazla sensör gerekiyorsa shield'i Arduino Mega'ya tak ya da SPI modüle geç.

MCUFRIEND_kbv kütüphanesini kurmak

  1. Arduino IDE'de Kütüphane Yöneticisi'ni aç, MCUFRIEND_kbv yaz ve kur.
  2. Aynı yerden Adafruit GFX Library'yi kur; yazı, çizgi, daire ve buton fonksiyonları bu kütüphaneden gelir.
  3. Dokunmatik için Adafruit TouchScreen kütüphanesini kur (kodda TouchScreen.h olarak eklenir).
  4. SD kart için ayrıca bir şey kurman gerekmez; SD kütüphanesi Arduino IDE ile birlikte gelir.

Neden MCUFRIEND_kbv? Bu shield'ler aynı görünse de içlerinde farklı sürücü yongaları olabilir: aynı satıcıdan iki ay arayla aldığın iki shield'in biri ILI9341, diğeri ST7781 çıkabilir. Eski Adafruit_TFTLCD ya da SPFD5408 kütüphaneleri yalnızca birkaç yongayı tanır; yonga uymazsa ekran hiç başlatılamaz ve sonuç meşhur beyaz ekrandır. MCUFRIEND_kbv ise önce yongaya kimliğini sorar, sonra o yongaya uygun başlatma komutlarını gönderir.

Sürücü kimliğini bulmak: readID()

İlk iş, shield'ine kimliğini sormak. Aşağıdaki kod kimliği seri monitöre ve ekrana yazar, sonra üç renkli kutu çizer. Seri monitörü 9600 baud'a ayarla.

C++ (Arduino IDE)
1#include <Adafruit_GFX.h>
2#include <MCUFRIEND_kbv.h>
3
4MCUFRIEND_kbv tft;
5
6void setup() {
7  Serial.begin(9600);
8  uint16_t id = tft.readID();                 // sürücü kimliğini oku / read the driver ID
9  Serial.print(F("TFT ID = 0x"));
10  Serial.println(id, HEX);
11  if (id == 0xD3D3) id = 0x9341;              // salt yazılır shield: kimliği elle ver / write-only shield: set the ID by hand
12  tft.begin(id);
13  tft.setRotation(1);                         // yatay, 320x240 / landscape, 320x240
14  tft.fillScreen(0x0000);                     // siyah / black
15  tft.setTextColor(0xFFFF);                   // beyaz / white
16  tft.setTextSize(3);
17  tft.setCursor(20, 20);
18  tft.print(F("BlueGrays"));
19  tft.setTextSize(2);
20  tft.setCursor(20, 70);
21  tft.print(F("ID: 0x"));
22  tft.print(id, HEX);
23  tft.fillRect(20, 120, 80, 60, 0xF800);      // kırmızı / red
24  tft.fillRect(120, 120, 80, 60, 0x07E0);     // yeşil / green
25  tft.fillRect(220, 120, 80, 60, 0x001F);     // mavi / blue
26}
27
28void loop() {
29}
Okunan kimlikYongaNe yapmalısın?
0x9341ILI9341En yaygın model; doğrudan çalışır
0x9325 / 0x9328ILI9325 / ILI9328Eski ama sorunsuz; doğrudan çalışır
0x7783ST7781Doğrudan çalışır
0x5408SPFD5408Doğrudan çalışır; eski SPFD5408 kütüphanesine gerek yok
0x4747 / 0x9595HX8347-D / HX8347-IDoğrudan çalışır
0x1505 / 0x0154R61505 / S6D0154Doğrudan çalışır
0xD3D3Okuma hattı bağlı olmayan shieldKimliği koda elle yaz; 2,4 inçte önce 0x9341'i dene
0x0000 ya da 0xFFFFYanıt yokShield tam oturmamış, pin bükük ya da kart arızalı

Renkli kutular doğru sırayla kırmızı, yeşil, mavi görünüyorsa her şey yolunda. Kırmızı yerine mavi görüyorsan kimliği elle verdiğin için yanlış başlatma komutları gitmiştir, readID'nin bulduğu değeri kullan; renkler negatif gibiyse begin'den sonra tft.invertDisplay(true) satırını ekle. Kimlik garip bir değer çıkarsa kütüphanenin Dosya > Örnekler > MCUFRIEND_kbv > LCD_ID_readreg örneği yonganın bütün kayıtlarını döker; bu çıktı sorunu anlamanın en hızlı yoludur. graphictest_kbv örneği ise ekranın bütün fonksiyonlarını tek seferde test eder.

Beyaz ekran sorunu ve diğer görüntü hataları

Beyaz ekran aslında bir ipucudur: arka ışık enerji alıyor ama sürücü yonga hiç başlatılmamış. Panel komut almadığında pikseller ışığı geçirir ve ekran bembeyaz görünür. Aşağıdaki tabloyu yukarıdan aşağıya kontrol et:

BelirtiOlası sebepÇözüm
Beyaz ekran, eski bir kütüphane kullanılıyorKütüphane senin yongani tanımıyorMCUFRIEND_kbv kur, readID ile başlat
Beyaz ekran, kimlik 0x0000 ya da 0xFFFFShield tam oturmamış ya da pin bükükShield'i çıkar, pinleri düzelt, sonuna kadar bastır
Beyaz ekran, kimlik 0xD3D3Okuma hattı yok, kimlik alınamıyortft.begin(0x9341) gibi kimliği elle ver, olmazsa 0x9325 ve 0x7783'ü dene
Renkler negatif (beyaz siyah görünüyor)Yonganın renk tersleme ayarı farklıbegin'den sonra tft.invertDisplay(true)
Kırmızı ve mavi yer değiştirmişElle verilen kimlik yongayla uyuşmuyorreadID'nin bulduğu kimliği kullan, kütüphaneyi son sürüme güncelle
Yazılar ayna gibi tersElle verilen kimlik panelle uyuşmuyorKimliği readID ile al; kütüphanenin aspect_kbv örneğiyle dört yönü kontrol et
Dokununca ekran bozuluyorDokunmatik okuması ortak pinleri giriş bırakmışgetPoint'ten sonra YP ve XM'i yeniden OUTPUT yap
Uno'da çalışıyor, Mega'da beyazKütüphane Mega pin eşleşmesini bilmiyorMCUFRIEND_kbv Mega'yı tanır; eski kütüphaneyi kaldır

Dokunmatik kalibrasyon

Dirençli dokunmatik panel, aralarında küçük bir boşluk bulunan iki ince dirençli tabakadan oluşur. Bastığında tabakalar birbirine değer; kütüphane bir tabakanın iki ucuna gerilim uygulayıp öbür tabakadaki gerilimi analog girişle okur ve böylece X ile Y konumunu bulur. Bu okumalar 100–900 civarında ham sayılardır ve her panelde farklıdır; ekran piksellerine çevirmek için kalibrasyon gerekir. Ayrıca dokunmatik, ekranla aynı pinleri kullanır: hangi dört pinin dokunmatiğe gittiği shield'den shield'e değişir.

  1. Dosya > Örnekler > MCUFRIEND_kbv menüsünden TouchScreen_Calibr_native örneğini aç ve yükle.
  2. Seri monitörü 9600 baud'da aç; örnek önce dokunmatik pinlerini kendisi bulur.
  3. Ekranda beliren artı işaretlerine sırayla bas ve parmağını ya da kalemi her birinde yazı değişene kadar basılı tut.
  4. İş bitince seri monitörde "COPY-PASTE" başlığının altında iki satır çıkar: const int XP=...,XM=...,YP=...,YM=... ve const int TS_LEFT=...,TS_RT=...,TS_TOP=...,TS_BOT=....
  5. Bu iki satırı aşağıdaki kodların başındaki örnek değerlerin yerine yapıştır.
C++ (Arduino IDE)
1#include <Adafruit_GFX.h>
2#include <MCUFRIEND_kbv.h>
3#include <TouchScreen.h>
4
5MCUFRIEND_kbv tft;
6
7// Kalibrasyon örneğinin çıktısını buraya yapıştır / paste the calibration sketch output here
8const int XP = 6, XM = A2, YP = A1, YM = 7;
9const int TS_LEFT = 907, TS_RT = 136, TS_TOP = 942, TS_BOT = 139;
10
11TouchScreen ts = TouchScreen(XP, YP, XM, YM, 300);   // 300 ohm X plakası / 300 ohm X plate
12const int MINPRESSURE = 200;
13const int MAXPRESSURE = 1000;
14
15bool readTouch(int &x, int &y) {
16  TSPoint p = ts.getPoint();
17  pinMode(YP, OUTPUT);                 // ortak pinleri ekrana geri ver / give the shared pins back to the display
18  pinMode(XM, OUTPUT);
19  digitalWrite(YP, HIGH);
20  digitalWrite(XM, HIGH);
21  if (p.z < MINPRESSURE || p.z > MAXPRESSURE) return false;
22  x = map(p.x, TS_LEFT, TS_RT, 0, tft.width());    // dikey yön için / for portrait
23  y = map(p.y, TS_TOP, TS_BOT, 0, tft.height());
24  return true;
25}
26
27void setup() {
28  tft.begin(tft.readID());
29  tft.setRotation(0);                  // dikey, kalibrasyonla aynı / portrait, same as calibration
30  tft.fillScreen(0x0000);
31  tft.fillRect(0, 0, 240, 30, 0x001F);
32  tft.setTextColor(0xFFFF);
33  tft.setTextSize(2);
34  tft.setCursor(10, 8);
35  tft.print(F("Ciz / Draw"));
36}
37
38void loop() {
39  int x, y;
40  if (readTouch(x, y)) {
41    if (y < 30) tft.fillRect(0, 30, 240, 290, 0x0000);   // başlığa dokun: temizle / tap the header: clear
42    else tft.fillCircle(x, y, 3, 0xFFE0);                 // sarı nokta / yellow dot
43  }
44}

Bu küçük çizim programı kalibrasyonu test etmenin en iyi yoludur: parmağın neredeyse noktayı oraya koymalıdır. p.z basınç değeridir; MINPRESSURE ile MAXPRESSURE arasında değilse dokunma sayılmaz, böylece hafif sürtünmeler ve elektriksel gürültü elenir. readTouch() içindeki pinMode satırları kritik: TouchScreen kütüphanesi okuma yaparken ortak pinleri analog giriş yapar ve öyle bırakır; bu satırlar olmazsa sonraki çizim komutları ekrana ulaşmaz ve görüntü bozulur. Kalem ucuna dikkat et: dirençli panel basınçla çalışır, tırnakla ya da kalemle parmaktan daha hassas çizersin.

BelirtiSebepÇözüm
Sağa dokununca nokta solda çıkıyorX ekseni tersTS_LEFT ile TS_RT değerlerini yer değiştir
Üste dokununca nokta altta çıkıyorY ekseni tersTS_TOP ile TS_BOT değerlerini yer değiştir
Yatay modda X ve Y karışmışsetRotation(1) ile eksenler döndüx için p.y'yi, y için p.x'i map et ya da dikey modda kal
Dokunma hiç algılanmıyorXP, XM, YP, YM yanlışKalibrasyon örneğini yeniden çalıştır ve çıkan pinleri kullan
Dokunmadan sürekli nokta çıkıyorBasınç eşiği çok düşükMINPRESSURE'ı 300–400'e yükselt
Noktalar birkaç piksel kayıkKalibrasyon aceleyle yapılmışArtılara tam ortasından ve uzun basarak yeniden kalibre et

Dokunmatik buton arayüzü

Adafruit GFX kütüphanesindeki Adafruit_GFX_Button sınıfı, çerçeveli ve yazılı butonları birkaç satırla çizer, dokunmanın butona denk gelip gelmediğini de kendisi hesaplar. Aşağıdaki kod iki butonla A5'e bağlı bir LED'i yakıp söndürür; A5'i seçmemizin sebebi, shield takılıyken Uno'da boş kalan neredeyse tek pin olması. LED'i 220 Ω dirençle bağlamayı unutma.

C++ (Arduino IDE)
1#include <Adafruit_GFX.h>
2#include <MCUFRIEND_kbv.h>
3#include <TouchScreen.h>
4
5MCUFRIEND_kbv tft;
6const int XP = 6, XM = A2, YP = A1, YM = 7;                       // kendi değerlerin / your own values
7const int TS_LEFT = 907, TS_RT = 136, TS_TOP = 942, TS_BOT = 139;
8TouchScreen ts = TouchScreen(XP, YP, XM, YM, 300);
9
10const int LED_PIN = A5;               // shield'in boş bıraktığı pin / the pin the shield leaves unused
11Adafruit_GFX_Button onBtn, offBtn;
12char onLabel[] = "ON";
13char offLabel[] = "OFF";
14
15bool readTouch(int &x, int &y) {
16  TSPoint p = ts.getPoint();
17  pinMode(YP, OUTPUT);
18  pinMode(XM, OUTPUT);
19  digitalWrite(YP, HIGH);
20  digitalWrite(XM, HIGH);
21  if (p.z < 200 || p.z > 1000) return false;
22  x = map(p.x, TS_LEFT, TS_RT, 0, tft.width());
23  y = map(p.y, TS_TOP, TS_BOT, 0, tft.height());
24  return true;
25}
26
27void showState(bool on) {
28  tft.fillRect(20, 40, 200, 60, on ? 0x07E0 : 0x7BEF);  // yeşil ya da gri / green or grey
29  tft.setTextColor(0x0000);
30  tft.setTextSize(3);
31  tft.setCursor(50, 58);
32  tft.print(on ? F("LED ON") : F("LED OFF"));
33}
34
35void setup() {
36  pinMode(LED_PIN, OUTPUT);
37  tft.begin(tft.readID());
38  tft.setRotation(0);
39  tft.fillScreen(0x0000);
40  // merkez x, merkez y, genişlik, yükseklik, çerçeve, dolgu, yazı rengi, etiket, yazı boyu
41  // center x, center y, width, height, outline, fill, text colour, label, text size
42  onBtn.initButton(&tft, 120, 170, 160, 60, 0xFFFF, 0x07E0, 0x0000, onLabel, 3);
43  offBtn.initButton(&tft, 120, 260, 160, 60, 0xFFFF, 0xF800, 0xFFFF, offLabel, 3);
44  onBtn.drawButton();
45  offBtn.drawButton();
46  showState(false);
47}
48
49void loop() {
50  int x = 0, y = 0;
51  bool down = readTouch(x, y);
52  onBtn.press(down && onBtn.contains(x, y));
53  offBtn.press(down && offBtn.contains(x, y));
54  if (onBtn.justPressed()) {
55    onBtn.drawButton(true);             // basılı görünüm / pressed look
56    digitalWrite(LED_PIN, HIGH);
57    showState(true);
58  }
59  if (offBtn.justPressed()) {
60    offBtn.drawButton(true);
61    digitalWrite(LED_PIN, LOW);
62    showState(false);
63  }
64  if (onBtn.justReleased()) onBtn.drawButton();
65  if (offBtn.justReleased()) offBtn.drawButton();
66  delay(20);
67}

press() her turda butonun o an basılı olup olmadığını kaydeder; justPressed() yalnızca basıldığı ilk turda, justReleased() yalnızca bırakıldığı turda doğru döner. Böylece parmağın butonda kaldığı sürece LED'e tekrar tekrar komut gitmez ve ekran gereksiz yere yeniden çizilmez. drawButton(true) butonun renklerini tersine çevirip basılı görünümü verir. LED yerine A5'e bir röle modülü bağlayarak lambayı dokunmatik ekrandan da yönetebilirsin; güvenli bağlantı için röle modülü yazısına bak.

SD karttan resim göstermek

Shield'in arkasındaki microSD yuvası, ekrana tam renkli resim basmanın en kolay yoludur. Resmi bilgisayarında 240×320 (dikey) boyutuna getir ve 24 bit BMP olarak kaydet; Paint'te "24 bit bit eşlem", GIMP'te dışa aktarırken "24 bit" seçeneği yeterli. Dosya adı en fazla 8 karakter olsun (ör. KEDI.BMP), çünkü SD kütüphanesi kısa dosya adlarıyla çalışır. Kartı FAT32 ya da FAT16 olarak biçimlendir; 32 GB'tan büyük kartlar genellikle exFAT gelir ve tanınmaz.

C++ (Arduino IDE)
1#include <SPI.h>
2#include <SD.h>
3#include <Adafruit_GFX.h>
4#include <MCUFRIEND_kbv.h>
5
6MCUFRIEND_kbv tft;
7const int SD_CS = 10;                 // shield üzerindeki SD seçme pini / SD chip select on the shield
8const byte CHUNK = 20;                // tek seferde okunan piksel / pixels read per step (az RAM / low RAM)
9
10uint16_t read16(File &f) { uint16_t v; f.read((uint8_t *)&v, 2); return v; }
11uint32_t read32(File &f) { uint32_t v; f.read((uint8_t *)&v, 4); return v; }
12
13bool drawBMP(const char *name, int x, int y) {
14  File bmp = SD.open(name);
15  if (!bmp) return false;
16  if (read16(bmp) != 0x4D42) { bmp.close(); return false; }   // "BM" imzası / "BM" signature
17  read32(bmp); read32(bmp);                                   // dosya boyutu, ayrılmış / file size, reserved
18  uint32_t offset = read32(bmp);                              // piksel verisinin başı / start of pixel data
19  read32(bmp);                                                // başlık boyutu / header size
20  int32_t w = read32(bmp);
21  int32_t h = read32(bmp);
22  if (read16(bmp) != 1 || read16(bmp) != 24 || read32(bmp) != 0) {  // 1 düzlem, 24 bit, sıkıştırmasız / 1 plane, 24-bit, uncompressed
23    bmp.close();
24    return false;
25  }
26  bool bottomUp = true;                                       // BMP satırları alttan üste / BMP rows are bottom-up
27  if (h < 0) { h = -h; bottomUp = false; }
28  uint32_t rowSize = (w * 3 + 3) & ~3UL;                      // satır 4 bayta tamamlanır / rows padded to 4 bytes
29  uint8_t raw[CHUNK * 3];
30  uint16_t px[CHUNK];
31  for (int32_t row = 0; row < h; row++) {
32    bmp.seek(offset + (bottomUp ? (h - 1 - row) : row) * rowSize);
33    tft.setAddrWindow(x, y + row, x + w - 1, y + row);        // tek satırlık pencere / one-row window
34    bool first = true;
35    for (int32_t col = 0; col < w; col += CHUNK) {
36      int n = (w - col < CHUNK) ? (w - col) : CHUNK;
37      bmp.read(raw, n * 3);
38      for (int i = 0; i < n; i++) {
39        px[i] = tft.color565(raw[i * 3 + 2], raw[i * 3 + 1], raw[i * 3]);   // BGR -> RGB565
40      }
41      tft.pushColors(px, n, first);
42      first = false;
43    }
44  }
45  tft.setAddrWindow(0, 0, tft.width() - 1, tft.height() - 1); // pencereyi sıfırla / reset the window
46  bmp.close();
47  return true;
48}
49
50void setup() {
51  Serial.begin(9600);
52  tft.begin(tft.readID());
53  tft.setRotation(0);                                         // dikey, 240x320 / portrait, 240x320
54  tft.fillScreen(0x0000);
55  if (!SD.begin(SD_CS)) {
56    Serial.println(F("SD kart yok / no SD card"));
57    return;
58  }
59  if (!drawBMP("KEDI.BMP", 0, 0)) {
60    Serial.println(F("BMP okunamadi / BMP not readable"));
61  }
62}
63
64void loop() {
65}

BMP dosyasında satırlar alttan üste doğru saklanır ve her satırın uzunluğu 4 baytın katına tamamlanır; kod bu iki ayrıntıyı rowSize hesabı ve bottomUp bayrağıyla çözer. Her piksel dosyada mavi, yeşil, kırmızı sırasıyla 3 bayttır; color565() bunu ekranın anladığı 16 bitlik renge çevirir. Uno'nun yalnızca 2 KB RAM'i olduğu ve SD kütüphanesi bunun 512 baytını kendi tamponuna ayırdığı için piksel verisini 20'şer 20'şer okuyoruz. Tam ekran bir resim Uno'da birkaç saniyede satır satır çizilir. SD kartın biçimlendirmesi ve dosya işlemleri için SD kart modülü yazısına bakabilirsin.

Arduino Mega ile kullanmak

Shield, Mega'nın başlıklarına da aynı konumda oturur ve MCUFRIEND_kbv Mega'yı tanıdığı için ekran ve dokunmatik kodları değişmeden çalışır. Büyük kazanç pinlerdedir: D22–D53, A5–A15, üç ek seri port ve D20–D21'deki I2C boşta kalır; sensörlü, ekranlı büyük projeler için Mega en rahat seçimdir. Tek sorun SD yuvasıdır: shield SD'yi D10–D13'e bağlar, ama Mega'nın donanım SPI'ı D50–D53'tedir, bu yüzden SD.begin() başarısız olur. Çözüm, SdFat kütüphanesini yazılımsal SPI ile D10–D13 üzerinden kullanmaktır; MCUFRIEND_kbv'nin showBMP_not_Uno örneği bunu hazır olarak gösterir. Mega'nın bütün pinleri için Arduino Mega pinleri yazısına göz atabilirsin.

ESP32 ve Raspberry Pi Pico ile kullanılabilir mi?

Kısa cevap: önerilmez. Paralel shield 13 pin ve 5 V uyumlu bir Uno başlığı bekler. Uno biçimindeki ESP32 kartlarında (ESPDuino-32, D1 R32 gibi) A2–A4 başlıkları çoğunlukla yalnızca giriş olabilen GPIO 34–36'ya gider; ekranın kontrol hatları bu pinlerden sürülemez, dokunmatik de analog okuma için uygun pin bulamaz. Kablo değiştirerek ve TFT_eSPI'nin paralel ayarlarıyla çalıştıranlar var, ama zahmetli bir iştir. ESP32 ve Pico için aynı çözünürlükteki SPI modülü çok daha mantıklıdır: dört beş kabloyla bağlanır ve pinlerin çoğunu boşta bırakır. Ayrıntılar ILI9341 TFT ekran ve daha küçük, daha keskin bir seçenek için ST7789 TFT ekran yazılarında.

2,4 inç TFT shield ile proje fikirleri

  • Dokunmatik hesap makinesi: 4×4 buton ızgarası çiz, sonuçları büyük puntoyla göster; mantığı Arduino hesap makinesi yazısındakiyle aynıdır.
  • Dijital fotoğraf çerçevesi: SD karttaki BMP dosyalarını sırayla göster, ekrana dokununca sonrakine geç.
  • Şifreli kilit: ekranda sayı tuşları çiz, doğru şifrede A5'teki röleyi çek; tuş takımı mantığı için keypad yazısına bak.
  • Oyunlar: Pong, yılan ya da dokunmatik XO oyunu; fikirler için Arduino oyun projeleri.
  • Sıcaklık grafiği: Mega'ya bir DHT11 bağla, son bir saatin sıcaklığını kayan bir çizgi grafikle göster.
  • Basit osiloskop: A5'ten okunan sinyali ekranda dalga olarak çiz; yavaş sinyaller için eğlenceli bir öğrenme aracıdır.
Ekran titriyorsa her turda fillScreen() ile bütün ekranı silme; yalnızca değişen bölgeyi fillRect() ile temizleyip yeniden yaz. Sabit metinleri F() içine almak RAM'den tasarruf ettirir. Rakamlar değişirken arkasının otomatik silinmesi için setTextColor(yazı, arka plan) biçimini kullan.

2,4 inç TFT shield, doğru kütüphaneyle birkaç dakikada çalışan, dokunmatiğiyle projelerine gerçek bir arayüz kazandıran bir ekrandır. Ekranlarla çalışmaya daha basit bir modelle başlamak istersen, BlueGrays uygulamasındaki I2C LCD, 2x16 LCD'de kayan yazı, OLED'de Pong ve T-Rex oyunu ile LCD koşucu oyunu projelerinde devre şemalarını ve kodları adım adım bulabilirsin.

Sıkça sorulan sorular

2,4 inç TFT shield neden beyaz ekran veriyor?

Beyaz ekran, arka ışığın yandığını ama sürücü yonganın başlatılamadığını gösterir. En sık sebep, kullandığın kütüphanenin shield'deki yongayı tanımamasıdır. MCUFRIEND_kbv kütüphanesini kurup tft.readID() ile kimliği okumak ve tft.begin(ID) ile başlatmak sorunu çoğu zaman çözer; kimlik 0x0000 çıkıyorsa shield tam oturmamıştır.

2,4 inç TFT shield için hangi kütüphane kullanılmalı?

Ekran için MCUFRIEND_kbv ile Adafruit GFX Library, dokunmatik için Adafruit TouchScreen, SD kart için Arduino IDE ile gelen SD kütüphanesi yeterlidir. Eski SPFD5408 ve Adafruit_TFTLCD kütüphaneleri yalnızca birkaç yongayı desteklediği için yeni shield'lerde genellikle beyaz ekran verir.

TFT ekranımın sürücü yongasını nasıl öğrenirim?

MCUFRIEND_kbv ile tft.readID() fonksiyonunu çağırıp sonucu seri monitöre yazdır; 0x9341 ILI9341, 0x9325 ILI9325, 0x7783 ST7781 demektir. Kütüphanenin LCD_ID_readreg örneği yonganın bütün kayıtlarını dökerek daha ayrıntılı bilgi verir.

2,4 inç TFT shield Arduino Mega ile çalışır mı?

Evet, shield Mega'ya da takılır ve MCUFRIEND_kbv Mega'yı tanır. Yalnızca SD yuvası doğrudan çalışmaz, çünkü Mega'nın SPI pinleri D50–D53'tedir; SD için SdFat kütüphanesini yazılımsal SPI ile kullanman gerekir. Karşılığında çok sayıda boş pin kazanırsın.

Dokunmatik ters çalışıyor, nasıl düzeltirim?

Önce TouchScreen_Calibr_native örneğiyle kalibrasyonu yeniden yap ve çıkan değerleri koduna yapıştır. Sağ-sol ters ise TS_LEFT ile TS_RT'yi, üst-alt ters ise TS_TOP ile TS_BOT'u yer değiştir. Yatay modda eksenler karışıyorsa x için p.y, y için p.x değerini map etmen gerekir.

TFT shield takılıyken hangi pinler boş kalır?

Uno'da yalnızca A5, USB yüklemesiyle paylaşılan D0–D1 ve SD kart kullanmıyorsan D10–D13 boş kalır. A4 ekranın reset hattı olduğu için I2C kullanılamaz. Daha fazla sensör bağlamak istiyorsan Arduino Mega ya da SPI arayüzlü bir TFT modül daha uygundur.

Tüm projeleri gör
I2C İle LCD Ekran Kullanımı
AR-32Başlangıç
Premium

I2C İle LCD Ekran Kullanımı

Arduino'ya kendi ekranını kazandır ve ilk mesajını yazdır. İki satırlık LCD ekran yalnızca birkaç kabloyla bağlanır; önce üst satıra bir selam, ardından alt satıra ikinci bir yazı gelir, ekran…

4.8(53)
70
2x16 LCD Ekrana Mesaj Yazdırma
AR-29İleri
Premium

2x16 LCD Ekrana Mesaj Yazdırma

Ekranlara yazı yazmanın ilk adımı. İki satırlık LCD ekran önce bir bekleme mesajı gösterir, sonra üst satıra bir selam yazar ve alt satıra bir kelimeyi daktilo gibi harf harf ekler; ardından ekran…

4.6(37)
51
LCD İle Sağa Sola Çarpan Yazı Yazmak
AR-30İleri
Premium

LCD İle Sağa Sola Çarpan Yazı Yazmak

LCD ekranın üst satırında BLUEGRAYS yazısı bir kenardan öbürüne kayar, duvara çarpan bir top gibi geri döner ve bu hiç bitmez.

4.5(29)
40
Raket Topu Oyunu - SSD1306
AR-86Orta
Premium

Raket Topu Oyunu - SSD1306

Bir top, iki raket ve sen: video oyunlarının en eskilerinden masa tenisini küçük bir OLED ekranda oynarsın.

4.5(47)
65
OLED T-Rex Run: Arduino Dinozor Oyunu
AR-87İleri
Premium

OLED T-Rex Run: Arduino Dinozor Oyunu

İnternet kesilince çıkan dinozor oyunu artık masanda: küçük OLED ekranda dinozor koşar, kaktüsler üstüne gelir ve sen tek butonla zıplarsın.

4.7(33)
53
Arduino LCD Koşucu Oyunu
AR-96Orta
Premium

Arduino LCD Koşucu Oyunu

16x2 karakter LCD ekranda çalışan yandan kaydırmalı sonsuz koşucu oyunu. Kahraman otomatik olarak koşar, oyuncu butona basarak engellerin üzerinden zıplar. Alt ve üst sırada rastgele engeller oluşur. Pasif buzzer ile açılış melodisi, zıplama sesi, 50 puan kutlama sesi ve oyun sonu melodisi çalar. Açılışta "BlueGrays — Arduino Projects" splash ekranı gösterilir. Skor ekranın sağ üst köşesinde anlık olarak güncellenir.

4.6(32)
56
Arduino I2C Hesap Makinesi
AR-94Orta
Premium

Arduino I2C Hesap Makinesi

4x4 membran tuş takımı ve 16x2 I2C LCD ekran kullanarak toplama, çıkarma, çarpma ve bölme işlemlerini gerçekleştiren Arduino tabanlı bir hesap makinesi projesidir. I2C sayesinde sadece 2 kablo ile ekran bağlantısı sağlanır, böylece kablo karmaşası azalır ve daha fazla pin kullanıma açık kalır. Ondalıklı sayı girişi ve negatif sayı desteği de bulunmaktadır.

5.0(31)
43
4x4 Keypad LCD Ekran Şifre Uygulaması
AR-64İleri
Premium

4x4 Keypad LCD Ekran Şifre Uygulaması

Doğru şifreyi bilmeyenin giremediği küçük bir elektronik kapı kilidi. Kare tuşuna basıp şifreyi tuş takımından girersin; şifre doğruysa ekranda giriş izni yazar, yeşil LED yanar ve servo motor kapıyı…

4.8(59)
75