
ST7789(240×240 ディスプレイ)を買ったので ESP32 で jpeg 画像を表示してみた
はじめに
先週、240×240 ピクセルの ST7789 ディスプレイモジュールを購入したので、ESP32 と組み合わせて JPEG 画像を表示するプロジェクトに挑戦してみました。思った以上にハマりどころが多く、デバッグに時間がかかりましたが、最終的には個人的に満足できる仕上がりの画像表示システムを完成させることができました。
今回は、ESP32 DevKit と Seeeduino Xiao ESP32-C3 の両方で動作するシステムを構築したので、その過程と結果をまとめてみます。
尚、筆者は電子工作はまだ学習中であり、本記事の回路図やプログラム、説明の多くは生成 AI の助力を受けて作成しています。記載に誤りや不十分な点が含まれる可能性がありますので、実作業や改変を行う際は自己責任で確認・検証をお願いします。

プロジェクトの構成と前提
今回のプロジェクトでは、以下の構成で画像表示システムを構築しました:
システム構成
マイコン: ESP32 DevKit または Seeeduino Xiao ESP32-C3
ディスプレイ: ST7789 240×240 TFT ディスプレイ
ストレージ: microSD カードモジュール + microSD カード
画像形式: JPEG(RGB565 形式で表示)
制御方式: SPI 通信による直接制御
使用ライブラリ
TJpg_Decoder: JPEG 画像のデコード
SPI: ESP32 標準 SPI 通信
SD: microSD カード制御
画像仕様
形式: JPEG(.jpg, .jpeg)
サイズ: 2MB 以下推奨
解像度: 任意(自動スケーリング対応)
色深度: 24 ビット RGB → 16 ビット RGB565 に変換
SD カード内の JPEG 画像を自動検索し、5 秒間隔でスライドショー表示する仕組みです。
使用部品
今回のプロジェクトで使用した部品は以下の通りです:
マイコン
ディスプレイ
ST7789 240×240 TFT ディスプレイ: 秋月電子
ストレージ
その他
ブレッドボード
ジャンパーワイヤー

配線方法
ESP32 DevKit 版

※SD カードの MOSI/CLK は ST7789 と共有
Seeeduino Xiao ESP32-C3 版

※こちらもSD カードの MOSI/CLK は ST7789 と共有
プログラム実装
ESP32 DevKit 版の実装
ESP32 DevKit 版では、TFT_eSPI ライブラリを使用した標準的な実装が可能です。
User_Setup.h の設定(重要)
TFT_eSPI ライブラリの`User_Setup.h`ファイルを以下のように設定します:
#define ST7789_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 240
// ピン設定
#define TFT_MISO 19
#define TFT_MOSI 23
#define TFT_SCLK 18
#define TFT_CS 21
#define TFT_DC 22
#define TFT_RST 4
// 色順序設定(重要)
#define TFT_RGB_ORDER TFT_BGR
// SPI設定
#define SPI_FREQUENCY 20000000
#define SUPPORT_TRANSACTIONSUser_Setup.hとプログラムの全容は下記GoogleDriveフォルダに入れています。https://drive.google.com/drive/folders/1Y5rYN2IsHCOcRwRdmXL2NM62qbuZDSiD?usp=sharing
注意点:
`TFT_RGB_ORDER TFT_BGR`の設定が色表示の正確性に重要
`TJpgDec.setSwapBytes(true)`との組み合わせで正常な色表示が可能
User_Setup.h の場所:`C:\Users${userName}\OneDrive\ドキュメント\Arduino\libraries\TFT_eSPI\User_Setup.h`
Seeeduino Xiao ESP32-C3 版の実装
Xiao ESP32-C3 版では、TFT_eSPI ライブラリとの互換性問題があったため、直接 SPI 制御による実装を採用しました。
主な特徴:
TFT_eSPI ライブラリを使用せず、SPI で直接 ST7789 を制御
全ビット反転による色補正
色補正の実装:
// 正確な色表示のための全ビット反転
inline uint16_t convertColor(uint16_t color) {
return ~color; // 全ビット反転
}プログラムの全容は下記GoogleDriveフォルダに入れています。
https://drive.google.com/drive/folders/1Y5rYN2IsHCOcRwRdmXL2NM62qbuZDSiD?usp=sharing
セットアップ方法
1. Arduino IDE 環境構築
詳細は割愛。
2. 画像の準備
画像は以下の仕様で用意する必要があります。
JPEG 画像の仕様:
ファイルサイズ: 2MB 以下推奨(メモリ制約のため)
解像度: 任意(240×240 以上は自動スケーリング)
色深度: 24 ビット RGB
圧縮: ベースライン JPEG(プログレッシブ JPEG は非対応)
ファイル名: 英数字推奨(日本語ファイル名は避ける)
画像変換の手順:
上記の仕様を満たすようにオンラインツールを利用しても良いですが、私の場合は ImageMagicというツールをダウンロードして一括変換することにしました。初めて利用しましたが結構使いやすいと思いました。
以下のコードはフォルダ内にある画像ファイルを仕様に沿ってベースライン jpeg 画像に一括変換するスクリプトです。
png の background white -flatten: 透明部分を白で埋める
resize "240x240>": アスペクト比維持、拡大しない
quality 80: JPEG 品質(1-100)
interlace none: ベースライン JPEG
# PowerShell
Get-ChildItem *.png,*.jpg,*.jpeg,*.webp | ForEach-Object { magick $_.Name -background white -flatten -resize "240x240>" -quality 80 -interlace none "resized_$($_.BaseName).jpg" }TJpg_Decoder ライブラリの制約:
プログレッシブ JPEG は非対応
CMYK 色空間は非対応
極端に大きな画像(4096×4096 以上)は処理困難
メタデータ(EXIF)は無視される
3. SD カードの準備
フォーマット: FAT32 でフォーマット
容量: 32GB 以下推奨(FAT32 制限)
画像配置: ルートディレクトリに直接配置
ファイル名: 英数字のみ使用
実行結果
実際に動かしてみた結果は以下です。

現代のスマホの画像と比べるとクオリティはかなり劣りますが、それでも昔のディスプレイに画像を表示しているみたいな気分になってなんかエモい感じがしてこれはこれで結構気に入りました。
開発で遭遇した課題と解決策
初心者ということもあり以下の点で躓いていました。正直まだ理解できていない部分も多々ありますが、記録として簡単に残しておきます。
1. TFT_eSPI ライブラリの互換性問題
問題: Xiao ESP32-C3 で TFT_eSPI ライブラリ使用時にパニックエラーが発生
解決策: 直接 SPI 制御による実装に変更
TFT_eSPI ライブラリを使用せず、SPI.transfer()で直接制御
ST7789 の初期化コマンドを手動で送信
2. 色表示の問題
問題: 画像の色が青っぽく表示される
解決策:
ESP32 DevKit: `TFT_RGB_ORDER TFT_BGR` + `setSwapBytes(true)`
Xiao ESP32-C3: 全ビット反転(パターン 8)による色補正
3. ピン配置の混乱
問題: Xiao ESP32-C3 の D ピン番号と GPIO 番号の混同。
プログラム上の PIN 番号を GPIO 番号ではなく D ピン番号で指定していた。
解決策: 正確なピン配置図に基づく GPIO 番号での直接指定
感想と今後の展望
感想
今回のプロジェクトを通じて、いくつかの印象的な発見がありました。
ディスプレイサイズについて:
思った以上にディスプレイが小さく、240×240 ピクセルという解像度は現代の基準では非常にコンパクトでした。しかし、その小ささが逆に愛らしく、デスク上のアクセサリーとしては丁度良いサイズだと感じました。
デバッグの苦労と達成感:
色表示の問題やライブラリの互換性問題など、予想以上に多くの技術的課題に直面しました。特に Xiao ESP32-C3 での実装では、TFT_eSPI ライブラリが使えずに直接 SPI 制御を実装する必要があり、かなりの時間をデバッグに費やしました。しかし、最終的に画像が正しく表示された瞬間の喜びは格別で、技術的な困難を乗り越えた達成感を強く感じました。基本的に電子工作はまだ始めたばかりの初心者ですべてのコード生成と回路図制作を生成 AI 頼りにしていますが、基本的なことを抑えておく必要があると感じました。特に Xiao ESP32-C3 でうまく動かない問題はピンの指定方法を間違えていたことでした。基本的なことを理解していればデバッグもすんなりできたのでは?と感じました。
レトロな魅力:
実際に画像を表示してみると、240×240 という解像度と 16 ビット色深度の制約により、どこか懐かしい雰囲気の画質になりました。現代のスマートフォンの高精細ディスプレイに慣れた目には新鮮で、昔のデジタルフォトフレームや携帯ゲーム機を思い出すようなエモーショナルな体験でした。この「あえての低解像度」が持つ独特の魅力を再発見できたのも、このプロジェクトの副産物でした。
今後の展望
240px ってどのくらいのサイズなの?ってことが分からずに購入し、想像の倍以上小さいのが来てしまい戸惑いましたが、せっかくということで画像表示までやってみました。
レトロな魅力を出せるディスプレイなので、せっかくだから小型電子フォトフレームにしてみようかな的なことを考えましたがが、どうやら電子ペーパーの方が電力消費に優れていることを今日知りましたので、電子フォトフレーム DIY は電子ペーパーを買ってから挑戦してみようと思います。