TFT_eSPI 15分钟上手从零点亮 ESP32 与 Pico 的 TFT 彩屏【免费下载链接】TFT_eSPIArduino and PlatformIO IDE compatible TFT library optimised for the Raspberry Pi Pico (RP2040), STM32, ESP8266 and ESP32 that supports different driver chips项目地址: https://gitcode.com/GitHub_Trending/tf/TFT_eSPITFT_eSPI 是一个面向 ESP32、ESP8266、STM32 和树莓派 PicoRP2040的 Arduino / PlatformIO TFT 图形库负责初始化屏幕驱动芯片并绘制文字、图形和图片。它内置 ILI9341、ST7789、GC9A01 等常见芯片的驱动把引脚和芯片型号配好后自带的任意示例都能直接编译运行。这个库适合想给单片机项目加一块彩屏、却卡在接线和配置上的人。 场景给设备加一块 2.4 寸彩屏你手上有一块 ESP32 和一块 2.4 寸 ILI9341 屏幕线都接好了上传一段清屏变色的代码后屏幕却一片黑或者颜色乱七八糟。问题通常不在你的代码而在两件必须提前告诉库的事屏幕里用的是哪颗驱动芯片以及每个信号接到了哪个引脚。这两处没配好任何绘制函数都不会有输出。️ 从零跑起来安装Arduino IDE 里用库管理器搜 TFT_eSPI 安装PlatformIO 在platformio.ini里加一行lib_deps TFT_eSPI手动安装则执行下面的命令。git clone https://gitcode.com/GitHub_Trending/tf/TFT_eSPI最小配置库把屏幕参数放在库目录里的User_Setup.h你不需要在草图里写配置。最省事的做法是在 User_Setups/ 里挑一个接近你硬件的预设如Setup1_ILI9341.h再在User_Setup_Select.h里把对应的一行#include取消注释。自己改的话只需写对两处#define ILI9341_DRIVER指定驱动芯片#define TFT_CS、#define TFT_DC、#define TFT_RST指定片选、数据/命令、复位三个引脚号。接线SPI 屏一般接 6 根信号线。下图标注了 CS、DC、RST、MOSI、MISO、SCK 以及电源的对应关系MISO 在只读屏时可以悬空。最短可运行代码上传后如果屏幕变蓝说明驱动芯片和引脚都配对了。#include TFT_eSPI.h TFT_eSPI tft TFT_eSPI(); void setup() { tft.init(); tft.fillScreen(TFT_BLUE); } void loop() {}✨ 一个看得见的例子在点亮的屏幕上画一个红圆加一行居中文本10 行以内就能确认绘制函数可用。屏幕中央会出现一个红色实心圆下方是白色 TFT_eSPI 字样。#include TFT_eSPI.h TFT_eSPI tft TFT_eSPI(); void setup() { tft.init(); tft.fillScreen(TFT_BLACK); tft.fillCircle(160, 120, 50, TFT_RED); tft.setTextColor(TFT_WHITE); tft.drawCentreString(TFT_eSPI, 0, 200, 2); } void loop() {} 按场景来用想让横竖屏切换调用tft.setRotation(0)到tft.setRotation(3)就能改屏幕方向四个值对应四种 90 度旋转。改完坐标原点也会跟着转后续所有绘制位置都要按新原点来算。频繁刷新不想闪烁用库自带的 Sprite精灵类先在一块内存缓冲区上画好整帧再一次贴到屏幕上就不会出现逐条重画的闪烁。16 位色一张全屏 Sprite 在 ESP32 上大约需要 80KB RAM内存不够时改用 8 位或 1 位色来换空间。要显示中文或平滑字体内置位图字体较小且不能缩放中文和抗锯齿字体要用 Smooth Font在 Tools/ 的 Create_Smooth_Font 里用 Processing 把 TTF 生成.vlw文件存到 LittleFS 或直接转成 C 数组烧进 Flash再加载到屏幕上就能渲染任意 16 位 Unicode 字符。给 ESP32 UNO 接 8 位并口屏并口屏比 SPI 快ESP32 UNO 这块板需要飞线改装把板底 IO15、IO33、IO32 分别引到 LCD_RD、LCD_CS、LCD_RST原焊脚 35/34/36 是输入脚必须改到可输出口。下面的图给出了改装走线。⚠️ 避坑清单屏幕全黑→ 驱动芯片宏或引脚号填错 → 核对User_Setup.h里的#define芯片名和TFT_CS/TFT_DC/TFT_RST一次只改一处再重新编译。颜色红蓝互换→ 颜色位序不对 → 加#define TFT_RGB_ORDER TFT_RGB或TFT_BGR两种各试一次。整体反白白变黑→ 显示极性反了 → 加#define TFT_INVERSION_ON或TFT_INVERSION_OFF试一遍。升级库后配置没了→ 自定义的User_Setup被新版覆盖 → 把配置放到库外文件夹在User_Setup_Select.h里#include过去。SPI 屏加 SD 卡后 SD 用不了→ 引脚没显式声明 → 在User_Setup.h里明确写出TFT_MISO、TFT_MOSI、TFT_SCLK即使用的是默认 SPI 脚。 下一步去哪官方文档docs/示例代码examples/硬件配置、字体与工具User_Setups/、Fonts/、Tools/打开 examples/ 里 320 x 240 的TFT_Rainbow_one_lib例程按你的屏幕改好User_Setup.h再编译上传看到彩虹色流动就说明整条链路通了。接着把 Sprite 和 Smooth Font 两个例程各跑一遍你就覆盖了这个库最核心的三类用法。【免费下载链接】TFT_eSPIArduino and PlatformIO IDE compatible TFT library optimised for the Raspberry Pi Pico (RP2040), STM32, ESP8266 and ESP32 that supports different driver chips项目地址: https://gitcode.com/GitHub_Trending/tf/TFT_eSPI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考