TFT LCD入门指南：从硬件连接到图形编程实战

1. 从零认识TFT LCD：它是什么，为什么选它？

如果你刚开始接触单片机或者Arduino，想给自己的项目加一块能显示彩色图片、文字甚至简单动画的屏幕，那么TFT LCD几乎是你绕不开的选择。我第一次接触TFT屏，是为了给一个环境监测器做个显示界面，当时在琳琅满目的屏幕里挑花了眼，最后发现TFT彩屏是性价比和易用性平衡得最好的那个。简单来说，TFT LCD就是一种“薄膜晶体管液晶显示器”，它和我们手机、电脑屏幕的核心原理是相通的。和单色屏或者段码屏比起来，它的最大魅力就是能显示丰富的色彩和更细腻的图像，让你的项目瞬间变得“高级”起来。

为什么初学者应该从TFT LCD开始？首先，它的生态非常成熟。围绕Arduino、ESP32、STM32这些热门开发板，有大量现成的驱动库和教程，你不需要从零开始写底层的像素驱动代码。其次，硬件接口相对标准化，常见的有SPI和并行8080接口，接线不算复杂。最后，它的可视效果好，能快速给你正反馈，看到彩色的“Hello World”在屏幕上亮起的那一刻，成就感是巨大的。当然，它也有“坑”，比如功耗比单色屏高、刷新速度受限于接口等，但对于绝大多数入门和中级项目来说，这些都不是问题。接下来，我会带你一步步打通从硬件连接到软件驱动的全流程，避开我当年踩过的那些坑。

2. 硬件准备与连接：选对屏幕和接口是关键

动手之前，你得先搞清楚自己需要什么样的屏幕，以及怎么把它和你的主控板连起来。这一步走对了，后面会顺利很多。

2.1 如何挑选你的第一块TFT屏

市面上的TFT模块五花八门，对于Arduino初学者，我强烈建议从带有驱动芯片的模块开始，而不是裸屏。裸屏需要你自行设计驱动电路，难度陡增。常见的驱动芯片有ILI9341、ST7735、ILI9488等，它们都已经被Arduino社区广泛支持。

核心参数怎么看？

• 分辨率：比如240x320、128x160。分辨率越高，显示越细腻，但需要传输的数据量也越大，对微控制器的内存和速度要求更高。对于Arduino Uno这类资源有限的板子，从240x320（俗称2.4寸屏）开始是比较稳妥的选择。
• 接口：这是连接的关键。主要有两种：
  • SPI接口：引脚少（通常只需3-5根数据线+电源），节省IO口，编程简单，但刷新速度相对较慢。非常适合Arduino Uno这种IO口紧张、项目对刷新率要求不高的场景（如显示传感器数据、静态图片）。
  • 并行接口（如8080）：引脚多（需要8位或16位数据线外加控制线），速度快，适合需要快速刷新或动画的场景，但会占用大量IO口。STM32等性能更强的MCU常采用此方式，甚至配合DMA（直接存储器访问）来进一步提升效率。
• 背光：大部分模块集成LED背光，通常由一个IO口通过晶体管控制其开关。有些屏的背光需要较高的电压（如5V），接线时要注意。

提示：购买时，一定要找到卖家提供的资料页，确认驱动芯片型号、接口定义、供电电压（3.3V还是5V）以及初始化代码序列。没有这份资料，调试会非常痛苦。

2.2 实战接线：以Arduino Uno驱动SPI接口ILI9341为例

假设你手上有一块最常见的2.4寸240x320分辨率、驱动芯片为ILI9341、采用SPI接口的TFT模块。我们来看看怎么把它和Arduino Uno连起来。

接线示意图与原理：SPI通信需要四根基本线：SCK（时钟）、MOSI（主机输出从机输入）、MISO（主机输入从机输出）、CS（片选）。对于TFT屏，我们通常只向它发送数据（命令和像素数据），而不读取，所以MISO线有时可以不接。此外，还需要DC（数据/命令选择）和RESET（复位）线。

Arduino Uno 引脚	TFT模块引脚	作用
5V	VCC	电源（务必先确认模块电压！很多3.3V模块接5V会烧毁）
GND	GND	地线
3.3V 或 5V	LED	背光电源（可通过一个220Ω电阻连接，或直接接IO口控制）
D13 (SCK)	SCK	SPI时钟线
D11 (MOSI)	MOSI	SPI数据输出线
D10	CS (或 T_CS)	片选，低电平有效
D9	DC (或 A0)	数据/命令选择。高电平=数据，低电平=命令
D8	RESET	复位，低电平复位（有些库允许用Arduino的RESET引脚，但不推荐）

为什么这样接？

• D10, D9, D8作为控制引脚：在SPI通信中，CS、DC、RESET这类控制引脚不一定是固定的，你可以根据自己板子的空闲IO口灵活分配，只要在代码里对应修改即可。我习惯把靠近SPI引脚（D11,D12,D13）的D10和D9用作CS和DC，方便布线。
• 供电电压是第一个大坑：很多廉价的TFT模块逻辑电平是3.3V，但背光LED需要5V驱动。这时，VCC必须接3.3V，LED接5V。如果模块标明是5V兼容，则可以都接5V。最保险的方法是查阅模块的具体资料或用万用表测量板上LDO（稳压芯片）的型号来判断。
• 复位引脚的处理：有些教程建议把模块的RESET直接接到Arduino的RESET引脚，这样开发板复位时屏幕也复位。但我不推荐这样做，因为有时我们只想复位MCU而不想复位屏幕，或者屏幕复位时序较慢会影响MCU启动。独立控制更灵活可靠。

接好线后，先别急着写代码，用万用表通断档检查一下所有连接是否牢固，电源和地之间有没有短路。硬件上的一个小疏忽，可能会让你在软件调试上浪费好几个小时。

3. 软件驱动与库的选用：让屏幕亮起来

硬件连接妥当后，我们就进入了软件世界。对于Arduino，利用现成的库是最高效的方式。

3.1 安装并理解Adafruit GFX与驱动库

在Arduino IDE中，我们通常需要安装两个库：

1. Adafruit GFX Library：这是一个图形核心库，提供了画点、画线、画矩形、画圆、显示文字等基本图形功能的通用接口。它不直接驱动硬件。
2. 对应的硬件驱动库：例如Adafruit ILI9341。这个库实现了针对ILI9341芯片的具体通信函数（如何发送命令、数据），它依赖于GFX库，并告诉GFX库如何操作这块特定的屏幕。

安装方法：打开Arduino IDE，点击“工具” -> “管理库...”，在搜索框中分别搜索“Adafruit GFX”和“ILI9341”，找到并安装即可。这种“核心库+驱动库”的结构非常清晰，以后你换用ST7735的屏，只需要换装Adafruit ST7735库，而你的图形代码（基于GFX库）大部分无需修改。

3.2 编写第一个测试程序：显示“Hello World”

下面是一个最基础的测试草图，用于验证硬件连接和库是否正常。

#include <SPI.h> #include <Adafruit_GFX.h> #include <Adafruit_ILI9341.h> // 定义我们接线时使用的引脚 #define TFT_CS 10 #define TFT_DC 9 #define TFT_RST 8 // 创建屏幕对象，传入SPI对象和引脚定义 // 使用硬件SPI（速度更快），MOSI和SCK引脚在Arduino Uno上固定为11和13 Adafruit_ILI9341 tft = Adafruit_ILI9341(TFT_CS, TFT_DC, TFT_RST); void setup() { Serial.begin(9600); Serial.println("ILI9341 Test!"); // 初始化屏幕 tft.begin(); // 测试屏幕：填充红色背景 tft.fillScreen(ILI9341_RED); delay(500); // 填充绿色背景 tft.fillScreen(ILI9341_GREEN); delay(500); // 填充蓝色背景 tft.fillScreen(ILI9341_BLUE); delay(500); // 最后填充黑色背景 tft.fillScreen(ILI9341_BLACK); // 设置文本颜色为白色，背景为黑色（透明） tft.setTextColor(ILI9341_WHITE); tft.setTextSize(2); // 设置文本大小为2（约16像素高） // 将光标移动到屏幕中心附近（注意坐标系原点在左上角） tft.setCursor(50, 120); // 打印文本 tft.println("Hello, World!"); } void loop() { // 主循环暂时空置 }

代码逐行解析与避坑点：

• tft.begin()：这个函数至关重要，它完成了对ILI9341芯片的初始化序列。不同的屏幕驱动芯片，甚至同芯片不同厂商的模块，其初始化序列可能略有差异。如果你发现屏幕亮但显示乱码或花屏，很大概率是初始化不对。这时可以尝试在begin()函数里传入特定的初始化参数，或者去驱动库的源码里查找是否有针对你屏幕型号的特定begin函数。
• fillScreen(color)：填充整个屏幕。颜色可以用预定义宏如ILI9341_RED，也可以用16位的RGB565颜色值，例如tft.fillScreen(0xF800);也是红色。
• setCursor(x, y)：设置文本起始坐标。坐标系原点(0,0)在屏幕的左上角，x轴向右增长，y轴向下增长。这是计算机图形学的惯例，但刚接触时容易搞反。
• setTextSize(n)：设置文本放大倍数，基础字体是5x7像素，setTextSize(2)会将其放大为10x14像素。

上传与调试： 上传代码后，你应该看到屏幕依次闪烁红、绿、蓝，最后在黑色背景上显示白色的“Hello, World!”。如果没有：

1. 屏幕不亮：检查背光（LED）引脚是否供电。
2. 屏幕亮但白屏或花屏：首先检查CS、DC、RST引脚定义是否与代码一致。其次，尝试在tft.begin();后加一个长延时delay(1000);，给屏幕足够的初始化时间。最棘手的情况是初始化序列不匹配，这就需要去网上搜索你的具体屏幕型号（通常印在FPC排线上）和“Arduino 初始化代码”。
3. 显示内容错位：检查坐标计算。有时屏幕的显示方向（旋转）默认不是0，可以尝试调用tft.setRotation(0);、tft.setRotation(1);等来旋转屏幕（0-3分别代表0°, 90°, 180°, 270°旋转）。

4. 深入图形与文本编程：绘制你的界面

当基本的显示功能工作后，你就可以开始创建更复杂的用户界面了。Adafruit GFX库提供了一整套图形函数。

4.1 基本图形绘制函数实战

让我们画一个简单的仪表盘轮廓。

void drawDashboard() { // 1. 清屏为深灰色 tft.fillScreen(0x2104); // RGB565的深灰色 // 2. 画一个圆角矩形作为主面板 tft.drawRoundRect(10, 10, 220, 300, 10, ILI9341_WHITE); // 3. 画一个实心矩形作为标题栏 tft.fillRoundRect(15, 15, 210, 40, 5, ILI9341_BLUE); tft.setTextColor(ILI9341_WHITE); tft.setTextSize(2); tft.setCursor(60, 28); tft.println("SYSTEM INFO"); // 4. 画一个圆作为模拟仪表 tft.drawCircle(120, 200, 50, ILI9341_GREEN); // 圆心(120,200)，半径50，绿色边框 // 在圆中心画一个小的实心圆 tft.fillCircle(120, 200, 5, ILI9341_RED); // 5. 画一条从圆心出发的“指针线”（模拟角度） int angle = 45; // 假设角度45度 float rad = angle * 3.14159 / 180; int x2 = 120 + 40 * sin(rad); // 指针长度40像素 int y2 = 200 - 40 * cos(rad); // 注意屏幕Y轴向下，所以用减号 tft.drawLine(120, 200, x2, y2, ILI9341_YELLOW); // 6. 显示一些文本标签 tft.setTextColor(ILI9341_CYAN); tft.setTextSize(1); tft.setCursor(30, 80); tft.print("Temperature: "); tft.print(25.6); // 假设的温度值 tft.println(" C"); tft.setCursor(30, 100); tft.print("Pressure: "); tft.print(1013); tft.println(" hPa"); }

关键点解析：

• 颜色值：除了使用预定义宏，你可以用tft.color565(red, green, blue)函数来生成RGB565颜色，其中red, green, blue是0-255的值。例如tft.color565(255, 128, 0)生成橙色。
• 绘图顺序：后绘制的图形会覆盖先绘制的。利用这个特性，我们可以先画背景，再画图形，最后画文本。
• 画线算法：上面的指针计算用到了简单的三角函数。在嵌入式环境中，频繁使用sin、cos等浮点运算可能会影响性能。对于固定的几个角度，可以预先计算好数值存入数组，或者使用查表法来优化。

4.2 显示图像与自定义字体

显示图标或logo能极大提升界面美观度。TFT屏显示图像，通常需要先将图片转换为C语言数组格式。

步骤一：转换图片

1. 准备一张尺寸合适的BMP或PNG图片。
2. 使用工具将其转换为C数组。推荐使用Image2Lcd或LCD Image Converter等软件，或者在线转换工具。
3. 在转换时，关键设置包括：输出数据类型选择C Array，扫描方向根据你的屏幕旋转设置调整（通常为Vertical或Horizontal），色彩选择16-bit (RGB565)。
4. 转换后会得到一个.c或.h文件，里面是一个巨大的数组，如const unsigned char gImage_logo[] = { ... };。

步骤二：在Arduino项目中显示

1. 在Arduino IDE中，点击“草图”->“添加文件”，将生成的.h文件加入项目。
2. 使用tft.drawBitmap(x, y, bitmap_array, width, height, color)函数来显示。但注意，这个函数适用于单色位图。对于彩色位图，Adafruit库提供了tft.drawRGBBitmap(x, y, bitmap_array, width, height)，但要求数组数据已经是RGB565格式并按正确顺序排列。

注意：将大图片存入Arduino的Flash（程序存储空间）而不是RAM（内存）至关重要。Uno的RAM只有2KB，一张240x320的彩色图（RGB565）需要150KB！你需要使用PROGMEM关键字将数组存储在Flash中，并使用特殊的函数来读取。很多转换工具会直接生成带PROGMEM的代码。对于大图片，更常见的做法是使用SD卡来存储和读取。

使用自定义字体： GFX库也支持使用自定义字体（.glc或.vlw格式）。你需要先用工具（如Adafruit提供的）生成字体文件，然后通过#include引入，并使用tft.setFont(&custom_font)来设置。自定义字体很耗存储空间，在Uno上要谨慎使用。

5. 性能优化与进阶话题

当你的界面元素多起来，或者需要显示动画时，可能会遇到刷新慢、闪烁的问题。这时就需要一些优化技巧。

5.1 解决屏幕闪烁与提升刷新率

屏幕闪烁的根本原因是：我们在直接向屏幕绘制内容时，用户能看到绘制过程。解决方法是双缓冲或局部更新。但Arduino Uno内存极小，无法实现真正的全屏双缓冲。因此，我们采用以下策略：

1. 局部重绘：只更新屏幕上发生变化的部分，而不是每次都重绘全屏。例如，更新温度数值时，只清除原来数字的区域，然后绘制新数字。

   // 不好的做法：每次更新都重绘整个背景和文本 // 好的做法： tft.setTextColor(ILI9341_BLACK, 0x2104); // 设置文字颜色为黑色，背景色为面板的深灰色 tft.setCursor(30, 80); tft.print("25.6"); // 用背景色“覆盖”旧值（实际上是在旧值上画背景色矩形更稳妥） tft.setTextColor(ILI9341_CYAN, 0x2104); // 设置新颜色 tft.setCursor(30, 80); tft.print("26.1"); // 绘制新值

   更严谨的做法是计算旧文本的像素宽度，然后用fillRect画一个背景色矩形块擦除，再写新文本。

2. 避免在loop()中频繁调用fillScreen：fillScreen()会操作整个屏幕的像素，非常耗时。除非必要场景，不要每帧都清屏。

3. 使用startWrite()和endWrite()：在连续进行一系列绘图操作时，用tft.startWrite()和tft.endWrite()包裹起来。这会暂时禁止中断，防止在传输像素数据的过程中被中断打断，从而提升连续绘图的效率，有时也能减少撕裂感。

   tft.startWrite(); tft.drawFastHLine(...); tft.drawPixel(...); // ... 更多连续绘图 tft.endWrite();

5.2 与STM32等高性能MCU的差异

如果你后续使用像STM32（尤其是STM32H750这类高性能型号）来驱动TFT，玩法将完全不同，性能瓶颈从MCU转移到了接口。

1. 接口选择：STM32通常使用FSMC（Flexible Static Memory Controller）或FMC来驱动8080并行接口的屏幕，这相当于给屏幕分配了一个内存地址，CPU像读写内存一样读写屏幕，速度极快。这是SPI接口无法比拟的。

2. DMA的应用：这是STM32驱动LCD的核心优化手段。你可以配置DMA，将内存中的一块图像数据（缓冲区）自动地、不经过CPU干预地搬运到LCD的显存中。CPU在此期间可以处理其他任务（如传感器读取、逻辑计算），实现了刷新与计算的并行。

   • 问题：网络热词中提到的“stm32h750 dma 驱动 spi lcd 问题”，很可能就是配置DMA时遇到的典型坑。例如：DMA传输完成中断（TCIF）没有正确清除，导致后续传输无法启动；或者SPI的DR（数据寄存器）在DMA传输期间被意外访问；又或者是内存缓冲区地址没有对齐，导致DMA传输错误。解决这类问题需要仔细查阅芯片参考手册的DMA和SPI章节，确保中断标志位正确管理，并使用__attribute__((aligned(4)))来确保缓冲区地址对齐。

3. 库的差异：在STM32的HAL库或标准外设库环境下，你可能不会直接使用Adafruit GFX。而是使用如STemWin、LVGL、TouchGFX等更强大的嵌入式GUI库。这些库本身通常就支持DMA加速和双缓冲，能轻松实现流畅的UI动画。

5.3 触摸功能的集成

很多TFT模块还集成了电阻式或电容式触摸屏。以常见的电阻屏（通常使用XPT2046控制器）为例，除了之前的显示接线，还需要连接四根线（T_CLK, T_CS, T_DIN, T_DOUT）到MCU的另外一组SPI或普通IO口进行模拟。

你需要额外安装触摸芯片的库（如Adafruit_STMPE610或XPT2046_Touchscreen）。编程逻辑通常是：循环读取触摸坐标，判断其是否在某个按钮区域内，然后执行相应操作。实现一个稳定的触摸检测，还需要考虑去抖动、校准（因为触摸屏的原始坐标和像素坐标不是线性对应的）等问题。

6. 项目实战：构建一个简单的系统状态显示器

让我们综合运用以上知识，创建一个周期性地从模拟引脚读取“传感器数据”并显示在屏幕上的小项目。这个项目模拟了一个简单的数据监控界面。

硬件增强：除了TFT屏，我们在Arduino Uno的A0引脚连接一个电位器（模拟电压输入），模拟一个温度传感器。

软件思路：

1. 在setup()中初始化屏幕，绘制静态界面（边框、标题、标签）。
2. 在loop()中：
   • 读取A0的模拟值（0-1023）。
   • 将其映射到一个模拟仪表的角度范围（如0-300度）和温度范围（如0-50°C）。
   • 更新仪表指针（需要先擦除旧指针，再画新指针）。
   • 更新温度数字显示。
   • 添加一个简单的延时来控制刷新频率（如200ms一次）。

核心代码片段（动态更新部分）：

int lastAngle = -1; // 保存上一次指针角度 float lastTemp = -1; // 保存上一次温度值 void loop() { int sensorValue = analogRead(A0); // 映射为角度 (0-1023 -> 30-330度，留出一些边界) int newAngle = map(sensorValue, 0, 1023, 30, 330); // 映射为温度 (0-1023 -> 0.0-50.0度) float newTemp = map(sensorValue, 0, 1023, 0, 500) / 10.0; // 1. 更新模拟仪表指针 if (lastAngle != newAngle) { // 擦除旧指针：用背景色（黑色）重画旧指针线 drawPointer(120, 200, 40, lastAngle, ILI9341_BLACK); // 绘制新指针 drawPointer(120, 200, 40, newAngle, ILI9341_YELLOW); lastAngle = newAngle; } // 2. 更新温度数字 if (abs(lastTemp - newTemp) > 0.1) { // 避免频繁重绘 tft.setTextColor(ILI9341_BLACK, 0x2104); // 背景色与静态界面一致 tft.setCursor(130, 80); // 定位到温度值显示位置 tft.print(lastTemp, 1); // 用背景色覆盖旧值 tft.setTextColor(ILI9341_CYAN, 0x2104); tft.setCursor(130, 80); tft.print(newTemp, 1); // 显示新值，保留一位小数 lastTemp = newTemp; } delay(200); // 控制刷新频率 } // 画指针的函数 void drawPointer(int cx, int cy, int length, int angle, uint16_t color) { float rad = angle * 3.14159 / 180; int x2 = cx + length * sin(rad); int y2 = cy - length * cos(rad); tft.drawLine(cx, cy, x2, y2, color); }

这个项目虽然简单，但涵盖了硬件连接、库使用、图形绘制、动态更新和局部刷新等核心概念。当你成功运行它后，就已经跨过了TFT LCD入门最核心的门槛。接下来，你可以尝试添加更多传感器、制作菜单系统、或者移植到性能更强的ESP32、STM32平台，去探索更复杂的图形界面和动画效果。记住，硬件驱动是基础，而好的界面设计和对性能的把握，才是让你的项目脱颖而出的关键。