部品 · 読了まで12分

2.4インチTFT LCDシールドのArduinoガイド:MCUFRIEND_kbv、タッチ、SD

2.4インチTFT LCDシールドをArduinoで使う方法を解説します。MCUFRIEND_kbvの導入、ドライバーIDの読み取り、白い画面の直し方、タッチのキャリブレーション、ボタン、SDカードからのBMP画像表示、ピンの割り当てまで取り上げます。

Arduino用の2.4インチTFT LCDシールドは、Arduino Unoにそのまま挿せる240×320ピクセルのカラータッチスクリーンです。配線もはんだ付けも不要で、シールドをUnoやMegaのピンソケットに挿し込み、正しいライブラリをインストールすれば、数分後にはカラーの文字、図形、タッチボタン、SDカードの画像を表示できます。安価なので、数えきれないほどのスターターキットや学校のプロジェクトに使われています。その一方で、「なぜ画面が真っ白なの?」という質問がネットでいちばん多い部品の1つでもあります。

このガイドでは、シールドの画面がときどき真っ白になる理由と、MCUFRIEND_kbvライブラリがそれをどう解決するかを説明します。ドライバーIDを調べ、タッチパネルをキャリブレーションし、逆向きに反応するタッチを直し、画面上のボタンでLEDを操作し、microSDカードの画像を表示します。さらに、シールドがどのピンを使い、どのピンが余るのか、そしてMega、ESP32、Picoで使うときの注意点も取り上げます。

Arduino Unoボード
2.4インチTFTシールドはこのボードの上に重なり、ほぼすべてのピンを使います。残るのはA5とD0〜D1、そしてSDカードを使わない場合のD10〜D13だけです。

2.4インチTFTシールドとは?その仕組み

シールドは3つの部分でできています。カラーTFTパネル、その上に貼られた抵抗膜方式のタッチ層、裏面のmicroSDカードスロットです。ディスプレイは、SPIのようなシリアルバスではなく、8ビットのパラレルバスで接続されます。1バイトをまとめて送るので、UnoではSPIモジュールより描画が速い反面、ピンをたくさん使います。パネルのドライバーICは3.3 Vで動作しますが、基板上の3.3 Vレギュレーターと74HC245系のレベルシフタのおかげで、Unoの5 V信号をそのまま安全に使えます。

項目値
ディスプレイ2.4インチTFT、240×320ピクセル
色16ビット(RGB565)、65,536色
インターフェース8ビットパラレル(D0〜D7)+ 制御線5本
ドライバーIC個体によって異なる:ILI9341、ILI9325、ST7781、SPFD5408、HX8347など
タッチ4線式の抵抗膜方式、ディスプレイとピンを共有
SDスロットSPI接続のmicroSD(D10〜D13)
電源5 V(基板上に3.3 Vレギュレーター)
消費電流約80〜120 mA、大部分はバックライト
対応ボードArduino Uno、Arduino Mega 2560

シールドか、SPIモジュールか

同じサイズで別々の製品が2種類売られていて、どちらも「2.4 TFT」と呼ばれています。シールドは、Unoに挿すだけで使えるパラレル方式のモデルです。SPIモジュールは、片側の端にピンヘッダーが1列に並んでいて、ジャンパーワイヤーで配線します。タッチパネルは、たいていXPT2046チップを使ってSPIで読み取ります。このガイドで扱うのはシールドです。SPIモジュールについては、ILI9341 TFTディスプレイのガイドをご覧ください。

SPIインターフェースのILI9341 TFTディスプレイモジュール
シールドの兄弟分にあたるSPIモジュールです。1列のピンヘッダーからジャンパーワイヤーで接続し、ESP32やPicoとの相性はこちらのほうがずっと良好です。
項目2.4インチUnoシールド2.4インチSPIモジュール
接続UnoやMegaに挿すだけ、配線なしジャンパーワイヤー7〜14本
使用するピンD2〜D9、A0〜A4(SDを使う場合はD10〜D13も)ディスプレイに5本、タッチとSDを含めると8〜9本
Unoでの描画速度速い(パラレル)やや遅い(SPI)
ライブラリMCUFRIEND_kbvAdafruit_ILI9341、TFT_eSPI
タッチの読み取りアナログ、ディスプレイとピンを共有XPT2046チップ、SPI経由
ESP32とPico不向き向いている
センサー用の空きピンほとんどないたくさんある

ピン対応表:シールドはどのピンを使う?

シールドのピンArduino Unoのピン役割
LCD_RDA0読み出しストローブ
LCD_WRA1書き込みストローブ(タッチと共有の場合あり)
LCD_RS (CD)A2コマンドかデータかの切り替え(タッチと共有)
LCD_CSA3ディスプレイのチップセレクト(タッチと共有の場合あり)
LCD_RSTA4ディスプレイのリセット
LCD_D0、LCD_D1D8、D9データバスの最初の2ビット
LCD_D2〜LCD_D7D2〜D7データバスの残りの6ビット
SD_SS / SD_DI / SD_DO / SD_SCKD10 / D11 / D12 / D13microSDカード(SPI)
5V、3V3、GND5V、3.3V、GND電源
シールドを取り付けると、Unoにはセンサー用のピンがほとんど残りません。A4がディスプレイのリセット線になるため、A4/A5のI2Cバスは使えず、I2Cのセンサーやディスプレイは追加できません。残るのは、A5(ほとんどのシールドで未接続)、USBでの書き込みと共用のD0〜D1、そしてSDカードを使わない場合のD10〜D13です。もっとセンサーが必要なら、シールドをArduino Megaに載せるか、SPIモジュールに切り替えてください。

MCUFRIEND_kbvライブラリのインストール

  1. Arduino IDEでライブラリマネージャを開き、MCUFRIEND_kbvを検索してインストールします。
  2. 同じ画面からAdafruit GFX Libraryをインストールします。文字、線、円、ボタンの関数はここから提供されます。
  3. タッチ用にAdafruit TouchScreenライブラリをインストールします(コードではTouchScreen.hとしてインクルードします)。
  4. SDカード用には何もインストールする必要はありません。SDライブラリはArduino IDEに付属しています。

なぜMCUFRIEND_kbvなのでしょうか。このシールドは、見た目がまったく同じでも、中のドライバーICが違うことがあります。同じ販売店から2か月違いで買った2枚のシールドが、片方はILI9341、もう片方はST7781だった、ということも起こります。Adafruit_TFTLCDやSPFD5408といった古いライブラリは、ごく一部のチップしか知りません。チップが合わないとディスプレイは初期化されず、あの有名な白い画面になります。MCUFRIEND_kbvは、まずチップにIDを問い合わせ、そのチップに合った初期化コマンドを送ります。

ドライバーIDを調べる:readID()

最初の作業は、シールドに「何者なのか」を尋ねることです。下のコードは、IDをシリアルモニタと画面に表示してから、色の付いた四角を3つ描きます。シリアルモニタは9600 bpsに設定してください。

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}
読み取ったIDチップ対応
0x9341ILI9341最も一般的なモデル。そのまま動く
0x9325 / 0x9328ILI9325 / ILI9328古いが信頼できる。そのまま動く
0x7783ST7781そのまま動く
0x5408SPFD5408そのまま動く。古いSPFD5408ライブラリは不要
0x4747 / 0x9595HX8347-D / HX8347-Iそのまま動く
0x1505 / 0x0154R61505 / S6D0154そのまま動く
0xD3D3読み出し線が接続されていないシールドIDをコードに手で書き込む。2.4インチなら、まず0x9341を試す
0x0000または0xFFFF応答なしシールドが奥まで挿さっていない、ピンが曲がっている、または基板の故障

四角が赤、緑、青の順に表示されれば、問題ありません。赤の代わりに青が表示される場合は、おそらくIDを手で指定していて、間違った初期化コマンドが送られています。readIDが見つけた値を使ってください。色がネガのように反転している場合は、beginのあとにtft.invertDisplay(true)の行を追加します。IDが見慣れない値のときは、ライブラリの「ファイル > スケッチ例 > MCUFRIEND_kbv > LCD_ID_readreg」のサンプルがチップの全レジスタを出力してくれます。その出力が、問題を理解するいちばんの近道です。graphictest_kbvのサンプルを使うと、ディスプレイのすべての機能を一度にテストできます。

白い画面とそのほかの表示トラブル

白い画面は、実は手がかりです。バックライトには電源が来ているのに、ドライバーICが初期化されていないことを示しています。パネルにコマンドが届かないと、ピクセルが光をそのまま通すので、画面全体が白く見えます。表を上から順に確認してください。

症状考えられる原因対処法
古いライブラリで白い画面になるライブラリがそのチップを知らないMCUFRIEND_kbvをインストールし、readIDを使って初期化する
白い画面で、IDが0x0000または0xFFFFシールドが奥まで挿さっていない、またはピンが曲がっているシールドを外してピンをまっすぐに直し、奥までしっかり押し込む
白い画面で、IDが0xD3D3読み出し線がないため、IDを読み取れないtft.begin(0x9341)のようにIDを手で指定する。だめなら0x9325と0x7783を試す
色がネガのように反転する(白が黒に見える)チップの反転設定が異なるbeginのあとにtft.invertDisplay(true)を書く
赤と青が入れ替わる手で指定したIDがチップと合っていないreadIDが見つけたIDを使い、ライブラリを最新版に更新する
文字が鏡像になる手で指定したIDがパネルと合っていないreadIDでIDを取得する。aspect_kbvのサンプルで4方向すべてを確認する
タッチすると表示が乱れるタッチの読み取り後、共有ピンが入力のままになっているgetPointのあとでYPとXMをOUTPUTに戻す
Unoでは動くのに、Megaでは白い画面になるライブラリがMegaのピン配置を知らないMCUFRIEND_kbvはMegaに対応している。古いライブラリは削除する

タッチパネルのキャリブレーション

抵抗膜方式のタッチパネルは、わずかなすき間をあけて重ねた2枚の薄い抵抗膜でできています。押すと2枚の膜が接触します。ライブラリは片方の膜に電圧をかけ、もう片方の膜の電圧をアナログ入力で読み取ることで、XとYの位置を求めます。この読み取り値は、およそ100から900の生の数値で、パネルごとに異なります。そのため、ピクセルに変換するにはキャリブレーションが必要です。また、タッチパネルはディスプレイとピンを共有していて、どの4本がタッチ層につながっているかはシールドによって違います。

  1. 「ファイル > スケッチ例 > MCUFRIEND_kbv」からTouchScreen_Calibr_nativeのサンプルを開き、書き込みます。
  2. シリアルモニタを9600 bpsで開きます。サンプルは、最初にタッチ用のピンを自動で割り出します。
  3. 画面に表示される十字マークを1つずつ押します。指かスタイラスを、表示が変わるまでそれぞれの十字の上に当て続けてください。
  4. 終わると、シリアルモニタの「COPY-PASTE」という見出しの下に2行が表示されます。const int XP=...,XM=...,YP=...,YM=...という行と、const int TS_LEFT=...,TS_RT=...,TS_TOP=...,TS_BOT=...という行です。
  5. その2行を、下のスケッチの先頭にあるサンプルの値に上書きして貼り付けます。
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}

この小さなお絵かきプログラムは、キャリブレーションを確かめるのに最適です。点が指のほぼ真下に表示されるはずです。p.zは押す強さです。MINPRESSUREとMAXPRESSUREの間に入っていなければタッチとして扱わないので、軽く触れただけの場合や電気的なノイズを除外できます。readTouch()の中のpinModeの行は非常に重要です。TouchScreenライブラリは、読み取りの際に共有ピンをアナログ入力に切り替え、そのままにしてしまいます。この行がないと、そのあとの描画コマンドがディスプレイに届かず、表示が乱れます。ヒントを1つ。抵抗膜方式のパネルは圧力で動作するので、指の腹よりも爪やスタイラスのほうが正確に描けます。

症状原因対処法
右をタッチすると、点が左に出るX軸が反転しているTS_LEFTとTS_RTの値を入れ替える
上をタッチすると、点が下に出るY軸が反転しているTS_TOPとTS_BOTの値を入れ替える
横向きにするとXとYが入れ替わるsetRotation(1)で軸が回転したxにはp.yを、yにはp.xをmapする。または縦向きのまま使う
タッチがまったく検出されないXP、XM、YP、YMが間違っているキャリブレーションのサンプルをもう一度実行し、表示されたピンを使う
触っていないのに点が出る圧力のしきい値が低すぎるMINPRESSUREを300〜400に上げる
点が数ピクセルずれるキャリブレーションを急いで行った十字のちょうど中心を長めに押して、キャリブレーションをやり直す

タッチボタンのインターフェース

Adafruit GFXライブラリのAdafruit_GFX_Buttonクラスを使うと、枠線とラベルの付いたボタンを数行で描けます。タッチがボタンの上だったかどうかも、クラスが自分で判定します。下のコードは、2つのボタンでA5につないだLEDをオン/オフします。A5を選んだのは、シールドを取り付けたUnoで実質的に残る唯一のピンだからです。LEDは必ず220 Ωの抵抗を通して接続してください。

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()は、その時点でボタンが押されているかどうかを毎周記録します。justPressed()は押された最初の周だけ、justReleased()は離された周だけtrueを返します。これにより、指がボタンの上にある間じゅうLEDに同じ命令が送られ続けることがなく、画面も無駄に再描画されません。drawButton(true)は、ボタンの色を反転させて、押された見た目にします。LEDの代わりにリレーモジュールをA5につなげば、タッチスクリーンから照明をオン/オフできます。安全な配線については、リレーモジュールのガイドをご覧ください。

SDカードの画像を表示する

裏面のmicroSDスロットは、フルカラーの画像を画面に表示するいちばん簡単な方法です。パソコンで画像を240×320(縦向き)にリサイズし、24ビットのBMP形式で保存します。ペイントでは「24ビット ビットマップ」を選び、GIMPではエクスポート時に24ビットのオプションを選びます。SDライブラリは短いファイル名しか扱えないので、ファイル名は最大8文字にしてください(例:CAT.BMP)。そして、コード内の「KEDI.BMP」を自分のファイル名に書き換えます。カードはFAT32またはFAT16でフォーマットします。32 GBを超えるカードはたいていexFATでフォーマットされていて、認識されません。

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ファイルでは、行が下から上の順に保存され、各行は4バイトの倍数になるように詰め物がされています。コードは、rowSizeの計算とbottomUpフラグで、この2つの点に対応しています。各ピクセルは青、緑、赤の順に3バイトを使い、color565()がそれをディスプレイが理解できる16ビットの色に変換します。UnoのRAMは2 KBしかなく、そのうち512バイトをSDライブラリがバッファとして確保するので、ピクセルは20個ずつ読み込みます。Unoでは、全画面の画像が数秒かけて1行ずつ描画されます。カードのフォーマットとファイルの扱い方については、SDカードモジュールのガイドをご覧ください。

Arduino Megaで使う

シールドはMegaのピンソケットにも同じ位置で挿さり、MCUFRIEND_kbvがMegaを認識するので、ディスプレイとタッチのコードはそのまま動きます。大きな利点はピンの数です。D22〜D53、A5〜A15、追加のシリアルポート3つ、D20〜D21のI2Cバスがすべて空くので、センサーとディスプレイを組み合わせた大きなプロジェクトには、Megaがいちばん扱いやすい選択肢になります。唯一の問題はSDスロットです。シールドはSDカードをD10〜D13に配線していますが、MegaのハードウェアSPIはD50〜D53にあるため、SD.begin()が失敗します。解決策は、SdFatライブラリを使い、D10〜D13でソフトウェアSPIを動かすことです。MCUFRIEND_kbvのshowBMP_not_Unoのサンプルが、まさにその方法を示しています。Megaのすべてのピンについては、Arduino Megaのピン配置のガイドをご覧ください。

ESP32やRaspberry Pi Picoで使えますか?

結論から言うと、おすすめしません。パラレル方式のシールドは、13本のピンと、5 Vに対応したUnoのピンソケットを前提にしています。Uno形状のESP32ボード(ESPDuino-32、D1 R32など)では、A2〜A4のソケットがたいてい入力専用のGPIO 34〜36につながっています。そこからはディスプレイの制御線を駆動できず、タッチパネルもアナログ読み取りに適したピンを見つけられません。配線をやり直し、TFT_eSPIのパラレル設定を使って動かしている人もいますが、手間のかかる作業です。ESP32やPicoには、同じ解像度のSPIモジュールのほうがはるかに合理的です。4本か5本のワイヤーで接続でき、ほとんどのピンが空いたまま残ります。詳しくはILI9341 TFTディスプレイのガイドを、より小型で高精細な選択肢についてはST7789 TFTディスプレイのガイドをご覧ください。

2.4インチTFTシールドのプロジェクトアイデア

  • タッチ式電卓:4×4のボタンを格子状に描き、結果を大きなフォントで表示します。ロジックはArduino電卓のガイドと同じです。
  • デジタルフォトフレーム:SDカードのBMPファイルを順番に表示し、画面にタッチすると次の画像に進みます。
  • 暗証番号ロック:画面にテンキーを描き、正しい番号が入力されたらA5のリレーを切り替えます。キーパッドのロジックはキーパッドのガイドをご覧ください。
  • ゲーム:Pong、スネーク、タッチで遊ぶ三目並べなどです。アイデアはArduinoゲームプロジェクトで見つかります。
  • 温度グラフ:MegaにDHT11をつなぎ、直近1時間の温度をスクロールする折れ線グラフで表示します。
  • 簡易オシロスコープ:A5で読み取った信号を波形として描きます。ゆっくりした信号なら、楽しい学習ツールになります。
画面がちらつく場合は、毎周fillScreen()で画面全体を消すのをやめ、変化する領域だけをfillRect()で消して描き直してください。固定の文字列をF()の中に入れると、RAMを節約できます。変化する数値の背景を自動で消すには、setTextColor(text, background)の形式を使います。

正しいライブラリさえあれば、2.4インチTFTシールドは数分で動き出し、そのタッチパネルがプロジェクトに本格的なユーザーインターフェースを与えてくれます。もっとシンプルなディスプレイから始めたい方のために、BlueGraysアプリには、I2C LCD、2x16 LCDのスクロール文字、OLEDで遊ぶPongとT-Rexゲーム、LCDのランナーゲームといったプロジェクトがあり、回路図とコードが付いたステップごとの手順で進められます。

よくある質問

2.4インチTFTシールドの画面が真っ白になるのはなぜですか?

白い画面は、バックライトは点いているのにドライバーICが初期化されていないことを意味します。いちばん多い原因は、使っているライブラリがシールドのチップを認識していないことです。MCUFRIEND_kbvをインストールし、tft.readID()でIDを読み取り、tft.begin(ID)でディスプレイを初期化すれば、ほとんどの場合は直ります。IDが0x0000で返ってくる場合は、シールドが正しく挿さっていません。

2.4インチTFTシールドにはどのライブラリを使えばいいですか?

ディスプレイにはMCUFRIEND_kbvとAdafruit GFX Libraryを、タッチにはAdafruit TouchScreenを、カードにはArduino IDEに付属のSDライブラリを使います。古いSPFD5408やAdafruit_TFTLCDのライブラリは一部のチップにしか対応していないため、新しいシールドではたいてい白い画面になります。

TFTディスプレイのドライバーICを調べるにはどうすればいいですか?

MCUFRIEND_kbvでtft.readID()を呼び出し、結果をシリアルモニタに出力します。0x9341ならILI9341、0x9325ならILI9325、0x7783ならST7781です。さらに詳しく知りたいときは、ライブラリのLCD_ID_readregのサンプルがチップの全レジスタを出力してくれます。

2.4インチTFTシールドはArduino Megaで使えますか?

はい、シールドはMegaにも挿せて、MCUFRIEND_kbvも対応しています。ただし、SDスロットだけはそのままでは動きません。MegaのSPIピンがD50〜D53にあるためです。SDカードを使うには、SdFatライブラリとソフトウェアSPIが必要です。その代わり、空きピンがたくさん手に入ります。

TFTシールドのタッチが反転しているときはどう直しますか?

まずTouchScreen_Calibr_nativeのサンプルをもう一度実行し、出力された値をコードに貼り付けます。左右が入れ替わっている場合はTS_LEFTとTS_RTを、上下が入れ替わっている場合はTS_TOPとTS_BOTを入れ替えます。横向きモードで軸が入れ替わる場合は、xにはp.yを、yにはp.xをmapしてください。

TFTシールドを取り付けると、どのピンが残りますか?

Unoで残るのは、A5、D0〜D1(USBでの書き込みと共用)、そしてSDカードを使わない場合のD10〜D13だけです。A4がディスプレイのリセット線になるため、I2Cは使えません。もっと多くのセンサーをつなぎたいなら、Arduino MegaかSPIインターフェースのTFTモジュールのほうが適しています。

全プロジェクトを見る
I2CでLCDディスプレイを使う
AR-32初級
プレミアム

I2CでLCDディスプレイを使う

Arduinoにディスプレイを接続し、最初のメッセージを表示します。2行のLCDディスプレイは数本の配線だけで接続できます。まず上の行にあいさつを表示し、次に下の行にもう1つのメッセージを表示します。その後、表示を消去して最初から繰り返します。温度や時刻、スコアを表示するプロジェクトは、すべてこのステップから始まります。

4.8(53)
70
2x16 LCDディスプレイにメッセージを表示
AR-29上級
プレミアム

2x16 LCDディスプレイにメッセージを表示

ディスプレイに文字を表示するための最初のステップです。2行のLCDディスプレイにまず待機メッセージを表示し、次に上の行にあいさつを表示します。下の行にはタイプライターのように単語を1文字ずつ表示し、その後ディスプレイを消去して最初から繰り返します。文字の表示位置を指定する方法を、実際の表示で確かめられます。

4.6(37)
51
LCDで文字が左右に跳ね返るアニメーション
AR-30上級
プレミアム

LCDで文字が左右に跳ね返るアニメーション

LCDディスプレイの上の行でBLUEGRAYSという文字が端から端へ動き、壁に当たるボールのように跳ね返る動きを繰り返します。必要なのはArduino、2x16 LCDディスプレイ、文字の見やすさを調整する可変抵抗だけです。文字のスクロールや簡単な表示アニメーションを作る最初のステップです。

4.5(29)
40
パドルボールゲーム(SSD1306)
AR-86中級
プレミアム

パドルボールゲーム(SSD1306)

ボール1個とパドル2本で遊ぶ、ビデオゲームの原点の1つである卓球ゲームを、小さなOLEDディスプレイで楽しめます。2つのボタンで右のパドルを上下に動かします。左のパドルはコンピューターがボールを追いながら操作し、ボールを打つたびにブザーが短く鳴ります。先に9点を取ると勝ちです。その後、新しいゲームが自動で始まります。

4.5(47)
65
OLED T-Rexラン:Arduino恐竜ゲーム
AR-87上級
プレミアム

OLED T-Rexラン:Arduino恐竜ゲーム

インターネットが切れると現れる恐竜ゲームを、机の上で楽しめます。小さなOLEDディスプレイを恐竜が走り、迫るサボテンを1つのボタンでジャンプして避けます。横の4桁ディスプレイには得点がリアルタイムで表示され、100点ごとにブザーがお祝いの音を鳴らします。サボテンにぶつかるとゲーム終了です。ボタンを押すと、もう一度始められます。

4.7(33)
53
Arduino LCDランナーゲーム
AR-96中級
プレミアム

Arduino LCDランナーゲーム

16x2文字のLCDディスプレイで動作する横スクロール型のエンドレスランナーゲームです。キャラクターは自動で走り、ボタンを押すとジャンプして障害物を飛び越えます。障害物は上段と下段にランダムに現れます。パッシブブザーで開始時のメロディー、ジャンプ音、50点獲得を祝う音、ゲーム終了時のメロディーを鳴らします。起動時には「BlueGrays — Arduino Projects」の画面を表示します。スコアは画面右上でリアルタイムに更新されます。

4.6(32)
56
Arduino I2C計算ツール
AR-94中級
プレミアム

Arduino I2C計算ツール

4x4のメンブレンキーパッドと16x2のI2C LCDディスプレイを使い、足し算、引き算、掛け算、割り算を行うArduinoベースの計算ツールのプロジェクトです。I2Cにより、ディスプレイを2本のケーブルだけで接続できるため、配線を整理しやすく、ほかの用途に使えるピンも多く残せます。小数の入力と負の数にも対応しています。

5.0(31)
43
4x4キーパッドとLCDで暗証番号ロック
AR-64上級
プレミアム

4x4キーパッドとLCDで暗証番号ロック

正しい暗証番号を知らないと開けられない、小さな電子ドアロックです。ハッシュキーを押してキーパッドから暗証番号を入力します。正しければ画面に入室許可が表示され、緑のLEDが点灯し、サーボモーターがドアを5秒間開けてから再び閉めます。間違っていれば赤のLEDが点灯します。建物や金庫のロックの仕組みを自分で作ります。

4.8(59)
75