ESP32 Cheap Yellow Display(CYD):ピン配置、セットアップ、LVGL
ESP32 Cheap Yellow Display(ESP32-2432S028R)のガイド。ピン配置、TFT_eSPIとXPT2046タッチの設定、キャリブレーション、SDカード、スピーカー、LVGLで作る最初のUIを解説します。
ESP32 Cheap Yellow Display(略してCYD)は、ESP32-2432S028Rという型番で販売されている完成品の開発ボードです。ESP32、2.8インチのカラータッチスクリーン、microSDスロット、RGB LED、光センサー、スピーカー出力を1枚の黄色い基板にまとめています。愛称がすべてを表しています。黄色くて、安くて、ディスプレイが付いたボードです。USBケーブルを1本つないでスケッチを書き込めば、はんだ付けもジャンパーワイヤー1本の配線もなしで、タッチ操作のインターフェースが手に入ります。
このガイドでは、ボードに載っている部品、バージョンの見分け方、完全なピン配置を紹介します。続いてArduino IDEでTFT_eSPIとXPT2046_Touchscreenライブラリを設定し、画面に文字を表示し、タッチパネルをキャリブレーションし、画面上のボタンでRGB LEDを切り替え、microSDカードにデータを記録し、LVGLで最初の本格的なインターフェースを作ります。最後のセクションでは、天気表示やスマートホームパネルといったプロジェクトのアイデアと、よくあるトラブルの解決法を取り上げます。

ESP32 Cheap Yellow Displayとは?ボードには何が載っている?
ボードの中心にはESP32-WROOM-32モジュールがあります。最大240 MHzで動くデュアルコアプロセッサー、520 KBのSRAM、4 MBのフラッシュ、2.4 GHzのWi-FiとBluetoothを備えています。ESP32とは?で学んだことは、ここでもすべて当てはまります。ディスプレイはESP32のHSPIバスにつながっていて、抵抗膜方式のタッチパネルを読み取るXPT2046チップは、専用のピンで2つ目のSPIバス(VSPI)につながっています。この点は重要です。一般的なTFTのサンプルはタッチがディスプレイと同じバスにある前提で書かれているため、CYDでは動きません。PSRAMはないので、フレーム全体をメモリに保持するのではなく、画像を少しずつ分けて描画します。
| 項目 | 値 |
|---|---|
| プロセッサーモジュール | ESP32-WROOM-32(デュアルコア、240 MHz) |
| メモリ | 520 KB SRAM、4 MBフラッシュ、PSRAMなし |
| ディスプレイ | 2.8インチTFT、240×320ピクセル、16ビットカラー(RGB565) |
| ディスプレイドライバー | ILI9341(USBが2つのバージョンはたいていST7789) |
| タッチ | 抵抗膜方式パネル、XPT2046コントローラー |
| ストレージ | microSDカードスロット(SPI) |
| その他の機能 | RGB LED、LDR光センサー、スピーカー出力(SC8002Bアンプ) |
| USBと電源 | Micro-USB、CH340 USBシリアル変換チップ、5 V |
| ボタン | BOOT(GPIO 0)とRST |
ボードのバージョン:ESP32-2432S028Rという名前の意味は?
型番は仕様の要約になっています。2432は解像度(240×320)、S028は画面サイズ(2.8インチ)、末尾のRは抵抗膜方式(resistive)のタッチを表します。同じシリーズには、Cで終わるボード(静電容量方式タッチ)とNで終わるボード(タッチなし)もあります。販売店はどれも「Cheap Yellow Display」と呼ぶので、注文する前に正確な型番を確認してください。バージョンによって、ピンの割り当てやディスプレイドライバーが変わることがあります。
| ボード | ディスプレイ | 見分け方 | 注意点 |
|---|---|---|---|
| ESP32-2432S028R(USB 1つ) | 2.8インチ 240×320、ILI9341 | Micro-USBポートのみ | ほとんどのサンプルとこのガイドが基準にしているバージョン |
| ESP32-2432S028R(USB 2つ) | 2.8インチ 240×320、たいていST7789 | Micro-USBとUSB-Cが並んでいる | 色が反転して見えることがあり、ドライバーかinvertDisplayの変更が必要 |
| ESP32-2432S024 | 2.4インチ 240×320 | 画面が小さい | ピンやタッチチップが異なる場合がある |
| ESP32-2432S032 | 3.2インチ 240×320 | ボードが大きい | 静電容量方式のバージョンはタッチをI2Cで読み取る |
| ESP32-3248S035 | 3.5インチ 320×480、ST7796 | 解像度が高い | 専用のTFT_eSPI設定が必要 |
CYDのピン配置
| 部品 | 信号とGPIO | 備考 |
|---|---|---|
| ディスプレイ(ILI9341) | MOSI 13、MISO 12、SCK 14、CS 15、DC 2 | HSPIバス、RSTはENに接続 |
| バックライト | GPIO 21 | HIGH = 点灯、PWMで調光できる |
| タッチ(XPT2046) | CLK 25、MOSI 32、MISO 39、CS 33、IRQ 36 | VSPIバス、ディスプレイとは別 |
| microSD | SCK 18、MISO 19、MOSI 23、CS 5 | VSPIの標準ピン |
| RGB LED | 赤 4、緑 16、青 17 | アノードコモン:LOW = 点灯 |
| LDR光センサー | GPIO 34 | 入力専用、analogReadで読み取る |
| スピーカー | GPIO 26 | SC8002Bアンプ、SPEAKコネクタ |
| BOOTボタン | GPIO 0 | スケッチの中でボタンとして読み取ることもできる |
| シリアルポート(P1) | TX 1、RX 3 | USBシリアル変換チップと共用 |
| 未使用のピン | GPIO 22、27(CN1)、GPIO 35(P3) | 35は入力専用 |
基板の端に並ぶ小さなJSTコネクタ(1.25 mmピッチ)が、外の世界への入口です。CN1にはGND、GPIO 22、GPIO 27、3.3 Vが出ていて、I2Cセンサーにぴったりです。Wire.begin(27, 22)を呼び出せば、BME280などのセンサーを直接つなげます。P3にはGPIO 35、22、21が出ていて、P1には5 V入力とシリアルのTX/RXがあります。これらのピンをESP32全般の制約と照らし合わせるには、ピン配置ツールを開いてください。
Arduino IDEのセットアップ:ボード設定とライブラリ
- Arduino IDEにESP32のボードパッケージ(ボードマネージャーのesp32 by Espressif)をインストールし、ボードとしてESP32 Dev Moduleを選びます。
- ボードをUSBケーブルで接続します。ポートが表示されない場合はCH340ドライバーをインストールし、ケーブルが充電専用ではなくデータ通信に対応していることを確認してください。
- ライブラリマネージャーからTFT_eSPI(Bodmer)とXPT2046_Touchscreen(Paul Stoffregen)をインストールします。
- TFT_eSPIフォルダーにあるUser_Setup.hの内容を、次のセクションの設定に置き換えます。
- 書き込みが「Failed to connect」で止まる場合は、書き込みが始まるときにBOOTボタンを押し続けてください。詳しくはESP32の「Failed to connect」エラーをご覧ください。
TFT_eSPIの設定:User_Setup.h
TFT_eSPIは非常に高速なライブラリで、その速さはコンパイル時に固定されるピン設定から生まれます。設定は、ライブラリのフォルダー(ドキュメント > Arduino > libraries > TFT_eSPI)にあるUser_Setup.hファイルに書かれています。ファイルをバックアップしてから中身をすべて削除し、下の行を貼り付けてください。ライブラリを更新するとこのファイルは初期状態に戻るので、自分用のコピーを安全な場所に保存しておき、更新のたびにコピーし直してください。
1// TFT_eSPI/User_Setup.h: CYD (ESP32-2432S028R) ayarı / setup for the CYD
2#define ILI9341_2_DRIVER // iki USB'li kartta ST7789_DRIVER / two-USB board: ST7789_DRIVER
3#define TFT_WIDTH 240
4#define TFT_HEIGHT 320
5#define TFT_BL 21 // arka ışık / backlight
6#define TFT_BACKLIGHT_ON HIGH
7#define TFT_MISO 12
8#define TFT_MOSI 13
9#define TFT_SCLK 14
10#define TFT_CS 15
11#define TFT_DC 2
12#define TFT_RST -1 // EN'e bağlı / tied to EN
13#define USE_HSPI_PORT // ekran HSPI hattında / display on the HSPI bus
14
15#define LOAD_GLCD
16#define LOAD_FONT2
17#define LOAD_FONT4
18#define LOAD_FONT6
19#define LOAD_FONT7
20#define LOAD_FONT8
21#define LOAD_GFXFF
22#define SMOOTH_FONT
23
24#define SPI_FREQUENCY 55000000 // sorun olursa 27000000 / use 27000000 if unstable
25#define SPI_READ_FREQUENCY 20000000
26#define SPI_TOUCH_FREQUENCY 2500000最初のテスト:画面に文字を表示し、タッチで描く
1#include <SPI.h>
2#include <TFT_eSPI.h>
3#include <XPT2046_Touchscreen.h>
4
5// Dokunmatik (XPT2046) kendi SPI hattında / touch (XPT2046) on its own SPI bus
6#define XPT2046_IRQ 36
7#define XPT2046_MOSI 32
8#define XPT2046_MISO 39
9#define XPT2046_CLK 25
10#define XPT2046_CS 33
11
12SPIClass touchSpi(VSPI);
13XPT2046_Touchscreen ts(XPT2046_CS, XPT2046_IRQ);
14TFT_eSPI tft;
15
16void setup() {
17 Serial.begin(115200);
18 touchSpi.begin(XPT2046_CLK, XPT2046_MISO, XPT2046_MOSI, XPT2046_CS);
19 ts.begin(touchSpi);
20 ts.setRotation(1); // ekranla aynı yön / same orientation as the screen
21
22 tft.init();
23 tft.setRotation(1); // yatay 320x240 / landscape 320x240
24 tft.fillScreen(TFT_BLACK);
25 tft.setTextColor(TFT_WHITE, TFT_BLACK);
26 tft.drawCentreString("BlueGrays CYD", 160, 10, 4);
27 tft.drawCentreString("Ekrana dokun / Touch the screen", 160, 40, 2);
28}
29
30void loop() {
31 if (ts.tirqTouched() && ts.touched()) {
32 TS_Point p = ts.getPoint();
33 // Ham değerleri piksele çevir / convert raw values to pixels
34 int x = map(p.x, 200, 3700, 0, 319);
35 int y = map(p.y, 240, 3800, 0, 239);
36 x = constrain(x, 0, 319);
37 y = constrain(y, 0, 239);
38 tft.fillCircle(x, y, 3, TFT_YELLOW);
39 Serial.printf("ham/raw x=%d y=%d z=%d -> piksel/pixel %d,%d\n", p.x, p.y, p.z, x, y);
40 }
41}いちばん重要なのはSPIClass touchSpi(VSPI)の行です。タッチコントローラーをディスプレイとは独立に、専用のピンで2つ目のSPIバスに割り当てます。ts.setRotation(1)とtft.setRotation(1)には同じ値を指定する必要があります。値が違うと、触れた場所と画面に描かれる点が一致しません。横向きでは、座標はxが0〜319、yが0〜239の範囲です。書き込んだら、スタイラスで画面に文字を書いてみてください。線が手の動きについてくれば、ディスプレイとタッチは正しく設定されています。
タッチスクリーンのキャリブレーション(XPT2046)
XPT2046が返すのはピクセルではなく、0〜4095の生の値です。コード中の200, 3700と240, 3800という数値は、その生の範囲のうち画面の端に対応する部分で、ボードごとに少しずつ違います。キャリブレーションするには、シリアルモニタを115200 baudで開き、スタイラスで四隅をタップして、xとyの生の値の最小と最大を書き留めます。この4つの数値をmap()の行に入れると、触れた位置と描かれる点のずれは数ピクセルまで小さくなります。抵抗膜方式のパネルは押す強さも測定します。ライブラリのtouched()はもともと十分に強く押したときだけtrueを返しますが、端の近くで値がふらつく場合は、p.zにもっと高いしきい値を設定できます。
RGB LED、LDR、スピーカー:タッチ操作パネル
ボードの裏面にあるRGB LED、LDR、スピーカー出力があれば、最初のプロジェクトには十分です。下のコードは大きなボタンを3つ描画します。ボタンをタップするとその色のLEDがオン・オフし、スピーカーから短いクリック音が鳴ります。画面下の黄色いバーは光センサーの読み取り値を示し、0.5秒ごとに更新されます。
1#include <SPI.h>
2#include <TFT_eSPI.h>
3#include <XPT2046_Touchscreen.h>
4
5#define XPT2046_IRQ 36
6#define XPT2046_MOSI 32
7#define XPT2046_MISO 39
8#define XPT2046_CLK 25
9#define XPT2046_CS 33
10
11const int LED_PINS[3] = {4, 16, 17}; // RGB LED: kırmızı, yeşil, mavi (LOW = yanar) / red, green, blue (LOW = on)
12const int LDR_PIN = 34; // ışık sensörü / light sensor
13const int SPEAKER_PIN = 26; // hoparlör yükselticisi / speaker amplifier
14const char* NAMES[3] = {"RED", "GREEN", "BLUE"};
15const uint16_t COLORS[3] = {TFT_RED, TFT_GREEN, TFT_BLUE};
16
17SPIClass touchSpi(VSPI);
18XPT2046_Touchscreen ts(XPT2046_CS, XPT2046_IRQ);
19TFT_eSPI tft;
20
21bool ledOn[3] = {false, false, false};
22bool wasTouched = false;
23unsigned long lastLdr = 0;
24
25void drawButton(int i) {
26 int x = 8 + i * 104; // 3 düğme yan yana / 3 buttons side by side
27 tft.fillRoundRect(x, 60, 96, 80, 10, ledOn[i] ? COLORS[i] : TFT_DARKGREY);
28 tft.setTextColor(TFT_WHITE);
29 tft.drawCentreString(NAMES[i], x + 48, 92, 2);
30}
31
32void setup() {
33 for (int i = 0; i < 3; i++) {
34 pinMode(LED_PINS[i], OUTPUT);
35 digitalWrite(LED_PINS[i], HIGH); // HIGH = sönük / HIGH = off
36 }
37 touchSpi.begin(XPT2046_CLK, XPT2046_MISO, XPT2046_MOSI, XPT2046_CS);
38 ts.begin(touchSpi);
39 ts.setRotation(1);
40 tft.init();
41 tft.setRotation(1);
42 tft.fillScreen(TFT_BLACK);
43 tft.setTextColor(TFT_WHITE, TFT_BLACK);
44 tft.drawString("BlueGrays panel", 8, 12, 4);
45 for (int i = 0; i < 3; i++) drawButton(i);
46}
47
48void loop() {
49 bool touchedNow = ts.tirqTouched() && ts.touched();
50 if (touchedNow && !wasTouched) { // yalnız ilk dokunuşta / only on the first touch
51 TS_Point p = ts.getPoint();
52 int x = map(p.x, 200, 3700, 0, 319);
53 int y = map(p.y, 240, 3800, 0, 239);
54 if (y > 60 && y < 140) {
55 int i = constrain((x - 8) / 104, 0, 2);
56 ledOn[i] = !ledOn[i];
57 digitalWrite(LED_PINS[i], ledOn[i] ? LOW : HIGH);
58 drawButton(i);
59 tone(SPEAKER_PIN, 2000, 30); // kısa tık sesi / short click sound
60 }
61 }
62 wasTouched = touchedNow;
63
64 if (millis() - lastLdr > 500) { // yarım saniyede bir / every half second
65 lastLdr = millis();
66 int light = analogRead(LDR_PIN); // 0-4095
67 tft.fillRect(8, 170, 304, 20, TFT_BLACK);
68 tft.fillRect(8, 170, map(light, 0, 4095, 0, 304), 20, TFT_YELLOW);
69 tft.setTextColor(TFT_WHITE, TFT_BLACK);
70 tft.drawString("LDR: " + String(light) + " ", 8, 200, 2);
71 }
72}RGB LEDはアノードコモンで配線されているため、論理が逆になります。LOWを書き込むとその色が点灯し、HIGHで消灯します。setup()で最初に3本のピンをすべてHIGHにしているのはそのためです。wasTouched変数は、指が画面に触れている間にボタンが何度も切り替わるのを防ぎます。数えるのはタッチが始まった瞬間だけです。LDRの読み取り値は、ボード上の分圧抵抗の影響で狭い範囲にとどまることがあります。自分の部屋で暗いときと明るいときの値を測り、そこからしきい値を決めてください。スピーカーコネクタには小型の8 Ωスピーカーを接続でき、tone()でビープ音や簡単なメロディを鳴らせます。
microSDカードにデータを記録する
カードスロットはESP32の標準のVSPIピン(18、19、23、CSは5)を使うので、SD.begin(5)と書くだけで済みます。カードはFAT32でフォーマットしてください。32 GBまでのカードなら問題なく動きます。下の例は、5秒ごとに時刻と明るさをlog.csvに追記します。このファイルは、後から表計算ソフトで開けます。SDカードの一般的な使い方は、SDカードモジュールのガイドをご覧ください。
1#include <SPI.h>
2#include <SD.h>
3
4const int SD_CS = 5; // microSD: SCK 18, MISO 19, MOSI 23, CS 5
5const int LDR_PIN = 34;
6
7void setup() {
8 Serial.begin(115200);
9 if (!SD.begin(SD_CS)) { // varsayılan SPI pinleri / default SPI pins
10 Serial.println("SD kart yok / no SD card");
11 return;
12 }
13 Serial.printf("SD: %llu MB\n", SD.cardSize() / (1024 * 1024));
14}
15
16void loop() {
17 File f = SD.open("/log.csv", FILE_APPEND); // dosyanın sonuna ekle / append to the file
18 if (f) {
19 f.printf("%lu,%d\n", millis() / 1000, analogRead(LDR_PIN));
20 f.close();
21 }
22 delay(5000);
23}LVGLで作る最初のインターフェース
ボタンやスライダー、グラフをfillRectで1つずつ描いていると、すぐに疲れてしまいます。LVGLはオープンソースのグラフィックライブラリで、スマートフォン風のウィジェット(ボタン、スライダー、リスト、グラフ、タブ)を備え、タッチ入力の処理も任せられます。バージョン9からはTFT_eSPIのサポートが標準で組み込まれているので、ディスプレイ用のflush関数を自分で書く必要はなくなりました。
- ライブラリマネージャーからlvglライブラリ(バージョン9.x)をインストールします。
- libraries/lvglフォルダーにあるlv_conf_template.hを1つ上の階層、つまりlvglフォルダーの隣にコピーし、名前をlv_conf.hに変えます。
- ファイルの先頭にある#if 0を#if 1に変え、LV_USE_TFT_ESPIを1にします。
- 大きなフォントを使いたい場合は、LV_FONT_MONTSERRAT_20などの行も1にします。フォントは1つごとにフラッシュメモリを消費します。
1#include <SPI.h>
2#include <lvgl.h>
3#include <TFT_eSPI.h>
4#include <XPT2046_Touchscreen.h>
5
6#define XPT2046_IRQ 36
7#define XPT2046_MOSI 32
8#define XPT2046_MISO 39
9#define XPT2046_CLK 25
10#define XPT2046_CS 33
11#define SCREEN_WIDTH 240
12#define SCREEN_HEIGHT 320
13#define DRAW_BUF_SIZE (SCREEN_WIDTH * SCREEN_HEIGHT / 10 * (LV_COLOR_DEPTH / 8))
14
15SPIClass touchSpi(VSPI);
16XPT2046_Touchscreen ts(XPT2046_CS, XPT2046_IRQ);
17uint32_t drawBuf[DRAW_BUF_SIZE / 4]; // ekranın 1/10'u kadar tampon / buffer for 1/10 of the screen
18lv_obj_t* valueLabel;
19
20// LVGL'e dokunuşu bildir / report touches to LVGL
21void touchRead(lv_indev_t* indev, lv_indev_data_t* data) {
22 if (ts.tirqTouched() && ts.touched()) {
23 TS_Point p = ts.getPoint();
24 data->point.x = map(p.x, 200, 3700, 1, SCREEN_WIDTH);
25 data->point.y = map(p.y, 240, 3800, 1, SCREEN_HEIGHT);
26 data->state = LV_INDEV_STATE_PRESSED;
27 } else {
28 data->state = LV_INDEV_STATE_RELEASED;
29 }
30}
31
32uint32_t tickMs() { return millis(); } // LVGL'in saat kaynağı / LVGL time source
33
34void onLedButton(lv_event_t* e) {
35 lv_obj_t* btn = lv_event_get_target_obj(e);
36 bool on = lv_obj_has_state(btn, LV_STATE_CHECKED);
37 digitalWrite(4, on ? LOW : HIGH); // kırmızı LED / red LED
38}
39
40void onSlider(lv_event_t* e) {
41 lv_obj_t* slider = lv_event_get_target_obj(e);
42 lv_label_set_text_fmt(valueLabel, "%d %%", (int)lv_slider_get_value(slider));
43}
44
45void lvglSetup() {
46 pinMode(4, OUTPUT);
47 digitalWrite(4, HIGH);
48 touchSpi.begin(XPT2046_CLK, XPT2046_MISO, XPT2046_MOSI, XPT2046_CS);
49 ts.begin(touchSpi);
50 ts.setRotation(2);
51
52 lv_init();
53 lv_tick_set_cb(tickMs);
54 lv_display_t* disp = lv_tft_espi_create(SCREEN_WIDTH, SCREEN_HEIGHT, drawBuf, sizeof(drawBuf));
55 lv_display_set_rotation(disp, LV_DISPLAY_ROTATION_270); // yatay kullanım / landscape
56 lv_indev_t* indev = lv_indev_create();
57 lv_indev_set_type(indev, LV_INDEV_TYPE_POINTER);
58 lv_indev_set_read_cb(indev, touchRead);
59
60 lv_obj_t* title = lv_label_create(lv_screen_active());
61 lv_label_set_text(title, "BlueGrays + LVGL");
62 lv_obj_align(title, LV_ALIGN_TOP_MID, 0, 10);
63
64 lv_obj_t* btn = lv_button_create(lv_screen_active());
65 lv_obj_set_size(btn, 120, 50);
66 lv_obj_align(btn, LV_ALIGN_CENTER, 0, -30);
67 lv_obj_add_flag(btn, LV_OBJ_FLAG_CHECKABLE); // aç-kapa düğmesi / toggle button
68 lv_obj_add_event_cb(btn, onLedButton, LV_EVENT_VALUE_CHANGED, NULL);
69 lv_obj_t* btnLabel = lv_label_create(btn);
70 lv_label_set_text(btnLabel, "LED");
71 lv_obj_center(btnLabel);
72
73 lv_obj_t* slider = lv_slider_create(lv_screen_active());
74 lv_obj_set_width(slider, 220);
75 lv_obj_align(slider, LV_ALIGN_CENTER, 0, 40);
76 lv_obj_add_event_cb(slider, onSlider, LV_EVENT_VALUE_CHANGED, NULL);
77 valueLabel = lv_label_create(lv_screen_active());
78 lv_label_set_text(valueLabel, "0 %");
79 lv_obj_align_to(valueLabel, slider, LV_ALIGN_OUT_BOTTOM_MID, 0, 10);
80}
81
82void lvglLoop() {
83 lv_timer_handler(); // LVGL çizim ve olayları / LVGL drawing and events
84 delay(5);
85}このコードの末尾にsetup()とloop()を追加します。setup()ではlvglSetup()だけを、loop()ではlvglLoop()だけを呼び出してください。画面は、画面サイズの10分の1(約15 KB)のバッファを使って少しずつ描画されます。PSRAMのないCYDにはちょうどよいバランスです。回転はLVGL自身が処理するので、タッチ座標は縦向き(240×320)の並びで渡し、LVGLがそれを横向きの画面に変換します。ボタンはチェック可能(checkable)に設定してあるので、タップするたびに赤色LEDが切り替わり、スライダーはその下のラベルにパーセント値を書き込みます。
CYDのプロジェクトアイデア:気象ステーションとスマートホームパネル
- 天気表示:ESP32の天気APIのガイドを使い、気温、湿度、1日の予報をアイコン付きで表示します。
- スマートホームパネル:MQTTとHome Assistantを使い、画面上のボタンで照明やスマートプラグを操作します。
- 卓上時計:NTPで取得したインターネット時刻を大きな数字で表示し、夜はLDRに合わせてバックライトを暗くします。
- センサーダッシュボード:CN1につないだI2Cセンサーの温度、湿度、気圧をリアルタイムのグラフに描きます。
- データロガー:測定値をmicroSDカードに保存し、直近24時間のグラフを表示します。
- タッチゲーム:スタイラスで遊ぶ三目並べ、スネークゲーム、神経衰弱を作ります。
よくあるトラブルと解決法
| 症状 | 考えられる原因 | 解決法 |
|---|---|---|
| 画面が真っ白または真っ黒のまま | User_Setup.hが未設定か、ドライバーが違う | このガイドの設定をコピーし、USBが2つのボードではST7789を試す |
| 色がネガのように見える | ドライバーか色反転の設定が合っていない | tft.invertDisplay(1)を追加するか、ドライバーを切り替える |
| タッチが反応しない | タッチがディスプレイと同じSPIバスにあると想定している | touchSpi(VSPI)でピン25、32、39、33を使う |
| 触れた位置と描画がずれる | キャリブレーション値がボードに合っていない | 四隅の生の値を測り、map()の行を更新する |
| ちらつきや乱れた線が出る | SPIクロックが高すぎる | SPI_FREQUENCYを27000000に下げる |
| Wi-Fiが起動するとリセットする | USBポートかケーブルが十分な電流を供給できない | 短くて品質の良いケーブルと、定格1 A以上のアダプターを使う |
| 書き込みが始まらない | CH340ドライバーがないか、ボードがダウンロードモードになっていない | ドライバーをインストールし、書き込み開始時にBOOTを押す |
ESP32 Cheap Yellow Displayは、ディスプレイ付きのESP32プロジェクトへのいちばんの近道です。配線の絡まりも、はんだ付けもなく、あるのはコードだけです。個別のモジュールで作業したい場合は、ILI9341 TFTディスプレイのガイドが、同じドライバーをブレッドボード上で解説しています。BlueGraysアプリには、天気、NTP時計、Webサーバー、LDRのプロジェクトがステップごとの回路図とコード付きで用意されていて、そのままCYDの画面に移せます。
よくある質問
Arduino IDEでCheap Yellow Displayにはどのボードを選べばよいですか?
ESP32 Dev Moduleを選んでください。CYDには標準のESP32-WROOM-32モジュールが載っているためです。フラッシュサイズは4 MBのままにし、書き込みに失敗する場合は書き込み速度を115200に下げます。ポートが表示されない場合は、CH340ドライバーをインストールしてください。
CYDの画面が真っ白なのはなぜですか?
画面が白いのは、バックライトは点灯しているのに、ディスプレイドライバーに正しいデータが届いていない状態です。ほとんどの場合、TFT_eSPIのUser_Setup.hがCYD用に設定されていないか、ドライバーの選択が間違っています。ピン設定を確認し、USBポートが2つあるボードではILI9341の代わりにST7789ドライバーを試してください。
ESP32 Cheap Yellow Displayではどのピンが使えますか?
使えるピンは、CN1コネクタのGPIO 22と27、P3のGPIO 35です。GPIO 35は入力専用です。I2CセンサーにはWire.begin(27, 22)を呼び出し、CN1の3.3 VとGNDからセンサーに電源を供給します。GPIO 21はバックライトを駆動しているので、ほかの用途には使わないでください。
PSRAMのないCYDでLVGLは動きますか?
はい、LVGL 9はCYDでなめらかに動きます。PSRAMがないため、フレーム全体ではなく、画面の10分の1(約15 KB)の描画バッファを使います。大きなフォントや画像をたくさん追加すると、フラッシュとRAMが実際の制約になるので、使わないフォントはlv_conf.hで無効にしてください。
タッチスクリーンとSDカードは同時に使えますか?
はい、ただし追加の設定が必要です。どちらもESP32のVSPIペリフェラルを別々のピンで使うためです。いちばん簡単なのは、ソフトウェアSPIを使うタッチライブラリを選ぶ方法です。もう1つの方法は、カードにアクセスする前にSDのピンで、アクセスした後にタッチのピンで、SPIバスを初期化し直すことです。
Cheap Yellow Displayはバッテリーで動かせますか?
ボードは5 Vで動作し、バックライトとWi-Fiがオンの状態でたいてい100〜250 mAを消費します。バッテリーで動かすには、Li-ionセルにTP4056充電モジュールと5 V昇圧コンバーターを組み合わせるか、手軽にモバイルバッテリーを使います。バッテリーを長持ちさせるには、使わないときに画面とWi-Fiをオフにし、ESP32をスリープさせてください。
この記事を読んだ後に作れるプロジェクト
全プロジェクトを見る
ESP32とLDRモジュールで光の強さを読み取る
LDRモジュールの生のADC値と、暗い状態・明るい状態の基準値から計算した相対的な明るさの割合を、シリアルモニタでリアルタイムに確認します。この割合はルクスの測定値ではありません。モジュールの校正の仕組みを学べます。しきい値の決定に使うため、プロジェクト10の前に取り組むのが適しています。

ESP32 HTTPClient+天気API(SSD1306 OLED付き)
このプロジェクトでは、ESP32でHTTPClient.hを使い、インターネット経由で天気API(wttr.in)をREST APIとして呼び出します。前のI2C LCD版とは異なり、SSD1306 OLED(128×64)ディスプレイを使うため、大きな文字やベクターアイコンで、1つの画面に豊かな表現ができます。天気を表す7種類のベクターアイコン(晴れ、晴れ時々曇り、曇り、雨、雪、嵐、霧)を実行時に描画するので、ビットマップファイルは不要です。気温は中央に3倍の大きさの文字で表示します。

ESP32 HTTPClient+天気API(LCD付き)
このプロジェクトでは、ESP32でHTTPClient.hを使い、インターネット経由で天気API(wttr.in)をREST APIとして呼び出します。返されたJSONレスポンスをArduinoJson v7で解析し、都市名、気温、湿度、天気、風の情報をI2C LCDディスプレイにトルコ語と英語で表示します。wttr.inは無料で、APIキーも不要です。都市名を入力するだけで、その都市の現在の天気を取得できます。30分ごとに自動更新し、表示画面ごとに異なるLEDの光り方で状態を知らせます。

ESP32とNTPでインターネットから正確な時刻を取得
ESP32をWi-Fiに接続し、NTP(Network Time Protocol)サーバーからミリ秒精度の現在時刻を取得します。configTzTime()関数でタイムゾーンを自動適用し、夏時間を採用する国ではPOSIX TZ文字列で夏時間と標準時間の切り替えも自動管理します。時刻はシリアルモニタと、必要に応じて接続するI2C LCDに表示します。configTzTime()がSNTPサービスを開始し、ネットワークにアクセスできる間は定期的に再同期します。

ESP32非同期Webサーバー(LCDにIPアドレスを表示)
このプロジェクトでは、ESP32を同じWi-Fiネットワーク上のスマートフォンやパソコンから操作できる非同期Webサーバーにします。ESPAsyncWebServerライブラリを使うと、従来のWebServer.hのように1つのリクエストで処理がブロックされず、複数のリクエストを同時に処理できます。ブラウザーでESP32のIPアドレスを開き、ON/OFFボタン(/onと/offのルート)を押すと、GPIO 5に接続したLEDを点灯・消灯できます。

ESP32温度データロガー(DHT22 + DS1307 RTC + microSD + OLED)
ESP32で日時付きの温度・湿度記録システムを作ります!DHT22で1分ごとに温度と湿度を読み取り、DS1307 RTCから取得した日時とともにmicroSDカードへCSV形式で記録します。OLEDには最新の温度を大きな文字で表示し、湿度のパーセント値、日時、総記録数も表示します。SDカードの/temp_log.csvファイルはExcel、Google Sheets、Pythonのpandasで開いて分析できます。温室の監視、家や部屋の温度管理、実験室のデータ収集、食品の保管環境や養蜂箱の監視に適しています。

ESP32でRGB LEDを制御
3個の個別のLEDの代わりに、1個のRGB LEDで無数の色を作ります。Arduinoと同じようにanalogWrite()でR/G/Bの値を調整し、虹色に変化させます。赤と緑を混ぜると黄色になるなど、色の仕組みを実際に確認できます。

ESP32とブザーでメロディーを演奏
パッシブブザーで簡単なメロディー「きらきら星」を演奏します。Arduinoと同じようにtone()とnoTone()で音を鳴らします。ESP32 Arduino Core 3.0+でも同じ構文が使えます。パッシブブザーを使用してください。アクティブブザーではメロディーを演奏できません。
ほかの記事
BlueGraysアプリ
この回路をスマホでステップごとに作る
回路図、コード、部品リストを1つの画面で確認できます。Arduino、ESP32、Picoのプロジェクトを500件以上用意しています。

