跳到正文
Display Engineer
指南

1.28 英寸圆形显示屏配 ESP32(GC9A01):接线、驱动库与圆形界面技巧

如何用 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

以上任一作为 flush 驱动,配合局部绘制缓冲

GC9A01 页面提供可下载的配置模板。

刷新能有多快?

RGB565 下一整帧为 240 × 240 × 16 位 = 921,600 位(112.5 KB)。SPI 理论上限约为 40 MHz 时 43 fps、80 MHz 时 86 fps。由于命令开销和渲染时间,实际界面会更慢,所以 LVGL 通常只重绘变化的区域。在 ESP32 上,只有专用 SPI 引脚才能跑 80 MHz;40 MHz 是稳妥的默认值。

整帧可以放进内部 RAM,但 LVGL 用两个各为屏幕 1/10 的局部缓冲(约 11 KB)效果就很好,可为应用留出 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 英寸圆形显示屏是什么分辨率?

通常为 240×240 像素,控制器为 GC9A01;可见区域是该正方形的内切圆。

ESP32 能以 60 fps 驱动 GC9A01 吗?

理论上 40 MHz SPI 下整屏重绘约限于 43 fps。LVGL 使用的局部刷新能让常见的仪表和手表界面动画流畅。

GC9A01 显示屏需要哪些引脚?

SCLK、MOSI、CS、DC、复位和背光。MISO 通常不接。

本指南提到的模组

不确定哪款显示屏适合你的设计?

告诉我们尺寸、接口和主控。显示工程师会在 12 小时内回复 2–3 个方案,附规格书和初始化代码。样品 1 片起。