部品 · 読了まで11分

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で最初の本格的なインターフェースを作ります。最後のセクションでは、天気表示やスマートホームパネルといったプロジェクトのアイデアと、よくあるトラブルの解決法を取り上げます。

ILI9341ドライバー搭載の2.8インチTFTディスプレイモジュール
単体で売られているILI9341 TFTモジュール。CYDの2.8インチ画面も同じドライバーを使っています。違いは、ESP32とタッチ回路が同じ基板に載っていることです。

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、ILI9341Micro-USBポートのみほとんどのサンプルとこのガイドが基準にしているバージョン
ESP32-2432S028R(USB 2つ)2.8インチ 240×320、たいていST7789Micro-USBとUSB-Cが並んでいる色が反転して見えることがあり、ドライバーかinvertDisplayの変更が必要
ESP32-2432S0242.4インチ 240×320画面が小さいピンやタッチチップが異なる場合がある
ESP32-2432S0323.2インチ 240×320ボードが大きい静電容量方式のバージョンはタッチをI2Cで読み取る
ESP32-3248S0353.5インチ 320×480、ST7796解像度が高い専用のTFT_eSPI設定が必要
USBポートが2つ(Micro-USB + USB-C)あるCYDでは、ディスプレイのドライバーはたいていST7789です。ILI9341の設定でも画面は点灯することがありますが、色がネガのように見えます。黒が白に、青が黄色になります。その場合はUser_Setup.hでST7789_DRIVERを選ぶか、tft.init()の直後にtft.invertDisplay(1)を追加してください。

CYDのピン配置

部品信号とGPIO備考
ディスプレイ(ILI9341)MOSI 13、MISO 12、SCK 14、CS 15、DC 2HSPIバス、RSTはENに接続
バックライトGPIO 21HIGH = 点灯、PWMで調光できる
タッチ(XPT2046)CLK 25、MOSI 32、MISO 39、CS 33、IRQ 36VSPIバス、ディスプレイとは別
microSDSCK 18、MISO 19、MOSI 23、CS 5VSPIの標準ピン
RGB LED赤 4、緑 16、青 17アノードコモン:LOW = 点灯
LDR光センサーGPIO 34入力専用、analogReadで読み取る
スピーカーGPIO 26SC8002Bアンプ、SPEAKコネクタ
BOOTボタンGPIO 0スケッチの中でボタンとして読み取ることもできる
シリアルポート(P1)TX 1、RX 3USBシリアル変換チップと共用
未使用のピン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全般の制約と照らし合わせるには、ピン配置ツールを開いてください。

P3コネクタのGPIO 21は、ディスプレイのバックライトも駆動しています。ここに何かをつないでピンをLOWにすると、画面が暗くなります。GPIO 35は入力専用なので、LEDやリレーは駆動できません。CN1の3.3 Vピンから外部の部品に電源を供給するときは、数百ミリアンペアも引き出さないでください。ボードはすでに、画面とWi-Fiのためにかなりの電流を消費しています。

Arduino IDEのセットアップ:ボード設定とライブラリ

  1. Arduino IDEにESP32のボードパッケージ(ボードマネージャーのesp32 by Espressif)をインストールし、ボードとしてESP32 Dev Moduleを選びます。
  2. ボードをUSBケーブルで接続します。ポートが表示されない場合はCH340ドライバーをインストールし、ケーブルが充電専用ではなくデータ通信に対応していることを確認してください。
  3. ライブラリマネージャーからTFT_eSPI(Bodmer)とXPT2046_Touchscreen(Paul Stoffregen)をインストールします。
  4. TFT_eSPIフォルダーにあるUser_Setup.hの内容を、次のセクションの設定に置き換えます。
  5. 書き込みが「Failed to connect」で止まる場合は、書き込みが始まるときにBOOTボタンを押し続けてください。詳しくはESP32の「Failed to connect」エラーをご覧ください。

TFT_eSPIの設定:User_Setup.h

TFT_eSPIは非常に高速なライブラリで、その速さはコンパイル時に固定されるピン設定から生まれます。設定は、ライブラリのフォルダー(ドキュメント > Arduino > libraries > TFT_eSPI)にあるUser_Setup.hファイルに書かれています。ファイルをバックアップしてから中身をすべて削除し、下の行を貼り付けてください。ライブラリを更新するとこのファイルは初期状態に戻るので、自分用のコピーを安全な場所に保存しておき、更新のたびにコピーし直してください。

C++ (Arduino IDE)
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

最初のテスト:画面に文字を表示し、タッチで描く

C++ (Arduino IDE)
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秒ごとに更新されます。

C++ (Arduino IDE)
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カードモジュールのガイドをご覧ください。

C++ (Arduino IDE)
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}
タッチコントローラーとSDカードはどちらもVSPIペリフェラルを使いますが、ピンは別々です。1つのスケッチで両方を使う場合は、タッチパネルをソフトウェアSPIで読み取るライブラリ(たとえばXPT2046_Bitbang)を選ぶか、SDにアクセスする前後でSPIバスを正しいピンで初期化し直してください。そうしないと、片方を使っている間、もう片方が応答しなくなります。

LVGLで作る最初のインターフェース

ボタンやスライダー、グラフをfillRectで1つずつ描いていると、すぐに疲れてしまいます。LVGLはオープンソースのグラフィックライブラリで、スマートフォン風のウィジェット(ボタン、スライダー、リスト、グラフ、タブ)を備え、タッチ入力の処理も任せられます。バージョン9からはTFT_eSPIのサポートが標準で組み込まれているので、ディスプレイ用のflush関数を自分で書く必要はなくなりました。

  1. ライブラリマネージャーからlvglライブラリ(バージョン9.x)をインストールします。
  2. libraries/lvglフォルダーにあるlv_conf_template.hを1つ上の階層、つまりlvglフォルダーの隣にコピーし、名前をlv_conf.hに変えます。
  3. ファイルの先頭にある#if 0を#if 1に変え、LV_USE_TFT_ESPIを1にします。
  4. 大きなフォントを使いたい場合は、LV_FONT_MONTSERRAT_20などの行も1にします。フォントは1つごとにフラッシュメモリを消費します。
C++ (Arduino IDE)
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を押す
Wi-Fiへの接続中にボードが再起動を繰り返し、シリアルモニタに「Brownout detector was triggered」と表示される場合、原因はコードではなく電源です。詳しくはESP32のブラウンアウトとGuru Meditationエラーをご覧ください。

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モジュールで光の強さを読み取る
ES-11初級

ESP32とLDRモジュールで光の強さを読み取る

LDRモジュールの生のADC値と、暗い状態・明るい状態の基準値から計算した相対的な明るさの割合を、シリアルモニタでリアルタイムに確認します。この割合はルクスの測定値ではありません。モジュールの校正の仕組みを学べます。しきい値の決定に使うため、プロジェクト10の前に取り組むのが適しています。

4.6(36)
55
ESP32 HTTPClient+天気API(SSD1306 OLED付き)
ES-32上級
プレミアム

ESP32 HTTPClient+天気API(SSD1306 OLED付き)

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

4.3(10)
22
ESP32 HTTPClient+天気API(LCD付き)
ES-31上級
プレミアム

ESP32 HTTPClient+天気API(LCD付き)

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

4.7(13)
20
ESP32とNTPでインターネットから正確な時刻を取得
ES-26上級
プレミアム

ESP32とNTPでインターネットから正確な時刻を取得

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

4.5(13)
22
ESP32非同期Webサーバー(LCDにIPアドレスを表示)
ES-27上級

ESP32非同期Webサーバー(LCDにIPアドレスを表示)

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

4.8(16)
26
ESP32温度データロガー(DHT22 + DS1307 RTC + microSD + OLED)
ES-40上級
プレミアム

ESP32温度データロガー(DHT22 + DS1307 RTC + microSD + OLED)

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

4.7(7)
12
ESP32でRGB LEDを制御
ES-9初級

ESP32でRGB LEDを制御

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

4.6(29)
52
ESP32とブザーでメロディーを演奏
ES-12初級
プレミアム

ESP32とブザーでメロディーを演奏

パッシブブザーで簡単なメロディー「きらきら星」を演奏します。Arduinoと同じようにtone()とnoTone()で音を鳴らします。ESP32 Arduino Core 3.0+でも同じ構文が使えます。パッシブブザーを使用してください。アクティブブザーではメロディーを演奏できません。

4.8(30)
55