跳到正文
Display Engineer
驱动 IC · Ilitek

ILI9341:规格书、引脚定义与初始化代码

ILI9341 驱动 240×320 TFT 面板,是 2.2″–3.2″ SPI 显示模组和 ESP32“Cheap Yellow Display”背后的经典控制器。

DEDisplay Engineer Applications Team · 显示应用工程师工程师审核于 2026年10月11日
厂商Ilitek
类型显示驱动
接口SPI / MCU(8080 并口) / RGB(并口)
最大分辨率240×320

什么是 ILI9341?

ILI9341 是一款 26.2 万色 TFT 驱动,片上 GRAM 为 172,800 字节,正好是一整帧 18 位色的 240×320。它已成为 2.4″ 和 2.8″ 创客及工业 SPI 模组的默认控制器。

在 ESP32 上使用 ILI9341

在 ESP32 上,面板通常以 40 MHz SPI 配合 DMA 驱动。要让 LVGL 界面流畅,请使用屏幕 1/10 大小的局部缓冲,在没有 PSRAM 的设计中启用双缓冲。

相关

ILI9341 库支持

库驱动 / 类备注
TFT_eSPI (Arduino)ILI9341_DRIVER (or ILI9341_2_DRIVER)
LovyanGFX (Arduino / ESP-IDF)lgfx::Panel_ILI9341
ESP-IDF esp_lcdespressif/esp_lcd_ili9341
下载 ILI9341 配置模板

User_Setup_ILI9341.h · LGFX_ILI9341.hpp. 引脚为占位符;增加经过测试的配置后会邮件通知你。

使用 ILI9341 的开发板

使用 ILI9341 的显示模组

ILI9341 排障与常见问题

ILI9341 与 ST7789:该选哪个?

两者都是带 GRAM 的 240×320 驱动。ILI9341 模组通常是 2.4″–3.2″ 的 TN 或 IPS;ST7789 主导更小的 IPS 面板。两者的库支持都很好,请按面板尺寸、视角和供货情况选择。

为什么我的 ILI9341 白屏?

最常见的原因是复位缺失或错误、MISO/MOSI 接反、只接了背光电源,或者库配置成了别的驱动。可读取 0xD3 寄存器确认驱动 ID。

ILI9341 模组搭配什么触摸控制器?

电阻触摸版本通常用 SPI 接口的 XPT2046。电容触摸版本通常用 I2C 接口的 FT6206/FT6336。

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

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