跳到正文
Display Engineer
Sunton · 显示开发板

ESP32-2432S024 显示屏:参数、驱动版本与配置

CYD 系列中的 2.4 英寸 240×320 SPI TFT ESP32 主板。与 2.8 英寸板一样,搭配 ILI9341 或 ST7789 控制器出货,ST7789 版本把背光改到了 GPIO 27。

工程师审核于 2026年10月11日

ESP32-2432S024 显示参数

MCUESP32
显示屏2.4″ · 240×320
显示总线SPI
驱动 ICILI9341 或 ST7789
触摸视版本为电阻(R)或电容(C)触摸

你手上的 ESP32-2432S024 是哪个版本?

同名板子会搭配不同的显示驱动 IC 出货。为一个版本写的代码在另一个版本上会出现白屏、颜色错误或完全不显示,所以请先确认你手上的版本。

版本驱动 IC识别方法库设置
ILI9341 版本ILI9341可用 ILI9341_2_DRIVERTFT_eSPI:ILI9341_2_DRIVER,TFT_INVERSION_OFF
ST7789 版本ST7789用 ILI9341 设置时白屏或无显示TFT_eSPI:ST7789_DRIVER;背光为 GPIO 27

同规格显示屏,用于批量生产

在 ESP32-2432S024 上做的原型?这些直营工厂模组的面板尺寸和分辨率相同,附规格书,每个生产批次固定驱动 IC,样品 1 片起。起订量和交期按项目商定。

从 ESP32-2432S024 原型到量产

开发板很适合验证界面,但它们的面板是从公开市场采购的:控制器可能在批次之间更换(这块板就已经换过),很少有规格书,寿命也没有保证。做产品时,请选用每个生产批次固定驱动 IC、有规格书和生命周期承诺的模组。

我们的直营工厂生产同为 2.4″ 240×320 规格的模组。样品 1 片起;起订量和交期由销售团队按项目商定。

调试代码之前

  1. 先确认你手上的版本(见上表):驱动 IC 变更是白屏最常见的原因。
  2. 检查背光引脚没有在你的代码中被复用。
  3. 一次只改一个设置(驱动、反转、颜色顺序),并保留一个已知正常的示例用于对比。

配置示例

TFT_eSPI: ILI9341 version (driver block)c
#define ILI9341_2_DRIVER
#define TFT_WIDTH  240
#define TFT_HEIGHT 320
#define TFT_INVERSION_OFF
#define SPI_FREQUENCY      55000000
#define SPI_READ_FREQUENCY 20000000
参考资料· Community / vendor configuration (see sources)
TFT_eSPI: ST7789 version (driver block)c
#define ST7789_DRIVER
#define TFT_WIDTH  240
#define TFT_HEIGHT 320
#define TFT_BL 27   // backlight moves to GPIO 27 on the ST7789 version
参考资料· Community / vendor configuration (see sources)

常见问题

ESP32-2432S024 和 CYD 是一样的吗?

属于同一系列,但面板是 2.4 英寸,而且 ST7789 版本的背光用 GPIO 27 而不是 21。

后缀 R 和 C 是什么意思?

R 是电阻触摸版本,C 是电容触摸版本。

资料来源

  1. ESP32-Cheap-Yellow-Display:各版本
  2. F1ATB:ESP32-2432S028 / S024 配置

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

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