本文へスキップ
Display Engineer
ガイド

ESP32 で使う 1.28 インチ丸型ディスプレイ(GC9A01):配線、ライブラリ、丸型 UI のコツ

ESP32 で 240×240 GC9A01 丸型 TFT を駆動する方法:SPI 配線、TFT_eSPI / LovyanGFX / ESP-IDF の設定、現実的なフレームレート、円形画面のレイアウトルール。

DEDisplay Engineer Applications Team · ディスプレイ アプリケーションエンジニアエンジニア確認済み(2026年10月11日)

1.28 インチ丸型ディスプレイとは

小型の丸型 TFT のほとんどは、240×240 ピクセルのパネルを円形にカットしたもので、GC9A01 コントローラを搭載しています。コントローラは正方形のフレームバッファのまま動作し、四隅には見えるピクセルがないだけです。ウェアラブル、ノブ、ゲージ、スマートホームのコントローラでこのフォーマットが使われています。

配線(4 線式 SPI)

信号

用途

SCLK

SPI クロック

MOSI (SDA)

パネルへの SPI データ

CS

チップセレクト

DC

データ / コマンド選択

RST

リセット(または MCU のリセットに接続)

BL

バックライト(調光用 PWM)

MISO は通常使いません。動作実績のあるリファレンスのピンマップは、Waveshare ESP32-S3-Touch-LCD-1.28 のボードページをご覧ください。

ライブラリ

ライブラリ

設定

TFT_eSPI (Arduino)

#define GC9A01_DRIVER、240×240

LovyanGFX

lgfx::Panel_GC9A01

ESP-IDF

espressif/esp_lcd_gc9a01 コンポーネント

LVGL

上記いずれかをフラッシュドライバとして使い、部分描画バッファを併用

GC9A01 のページにはダウンロードできる設定テンプレートがあります。

リフレッシュはどのくらい速いか

RGB565 のフルフレームは 240 × 240 × 16 ビット = 921,600 ビット(112.5 KB)です。SPI の理論上限は40 MHz で約 43 fps、80 MHz で約 86 fpsです。実際の UI はコマンドのオーバーヘッドと描画時間のため遅くなるので、LVGL は通常、変化した領域だけを再描画します。ESP32 では 80 MHz は専用の SPI ピンでのみ可能で、40 MHz が安全なデフォルトです。

フルフレームは内部 RAM に収まりますが、LVGL はそれぞれ画面の 1/10(約 11 KB)の部分バッファ 2 つで十分に動作し、アプリケーション用の RAM を残せます。

円形画面のデザイン

  • テキストは内接する正方形の中に収める。240 ピクセルの円に収まる最大の正方形は約 170×170 ピクセルです。ラベルや数字はそこに配置してください。
  • データには円弧やリングを使う。ゲージ、プログレスリング、放射状メニューは、長方形では無駄になる縁を活用できます。
  • タッチは正方形の座標を返す。丸型ボードはパネルに CST816S タッチコントローラを組み合わせることが多く、240×240 の正方形内の x/y を返すため、円の外側のタッチは無視してください。
  • 表示領域をベゼルと照合する。ユーザーに見える範囲を決めるのはガラスではなくパネルのアクティブエリアです。

当社カタログの丸型ディスプレイ

当社直営工場では、1.28 インチ 240×240 IPS SPI モジュール、静電容量式タッチ付きの 1.3 インチ 360×360 版、2.1 インチ 480×480 版などの丸型モジュールを製造しています。丸型 LCD ディスプレイの一覧をご覧ください。他のサイズでは GC9A01 と異なる場合があるため、コントローラはデータシートで確認してください。サンプルは 1 個から。

よくある質問

1.28 インチ丸型ディスプレイの解像度は?

通常は GC9A01 コントローラの 240×240 ピクセルで、表示領域はその正方形に内接する円です。

ESP32 で GC9A01 を 60 fps で駆動できますか?

全画面の再描画は、理論上 40 MHz の SPI で約 43 fps が上限です。LVGL が使う部分更新により、一般的なゲージやウォッチの UI で滑らかなアニメーションが可能になります。

GC9A01 ディスプレイに必要なピンは?

SCLK、MOSI、CS、DC、リセット、バックライトです。MISO は通常接続しません。

このガイドで紹介したモジュール

どのディスプレイが設計に合うか迷っていませんか?

サイズ、インターフェース、ホストプロセッサをお知らせください。ディスプレイエンジニアが 12 時間以内に、データシートと初期化コード付きで 2〜3 件の候補をお返しします。サンプルは 1 個から。