当前位置：首页 > news >正文

嵌入式开发实战：SPI与I2C驱动3.5寸电容触摸屏全解析

news 2026/8/2 7:23:26

1. 项目概述：一块3.5寸电容触摸屏能做什么？

如果你玩过树莓派或者STM32这类开发板，大概率会对那些需要外接键盘鼠标、操作起来略显笨拙的小项目感到一丝不便。而一块集成了电容触摸功能的3.5英寸LCD屏，恰恰是解决这个问题的“瑞士军刀”。它不仅仅是一个显示终端，更是一个高度集成的人机交互界面。你可以把它想象成智能手机缩小版的屏幕，直接通过手指点击、滑动就能控制你的嵌入式设备。

这个项目的核心，就是让这块3.5寸电容触摸屏在你的开发板上“活”起来。无论是树莓派这样的Linux单板计算机，还是STM32、ESP32这类微控制器，驱动它都涉及两个层面的工作：一是让LCD显示图像，二是让触摸屏准确报告手指位置。从热搜词就能看出，大家关心的焦点集中在SPI和I2C这两种通信协议上，因为绝大多数这类屏幕都采用这两种接口来与主控通信，以实现低成本、少引脚占用下的高性能显示与触摸。

我经手过不少这类屏幕，从早期的电阻屏到现在的电容屏，感触最深的是电容屏带来的体验提升是质的飞跃，但驱动和调试的“坑”一点也没少。接下来，我就以一个资深嵌入式开发者的视角，带你彻底拆解“3.5inch Capacitive Touch LCD”这个项目，从原理到实操，从选型到避坑，让你不仅能点亮屏幕，更能稳定、流畅地使用它。

2. 屏幕驱动核心：SPI与I2C协议深度解析

驱动这块屏幕，99%的精力都花在和SPI、I2C这两种通信协议打交道上了。网上资料虽多，但往往只讲“怎么配”，很少说清“为什么这么配”。这里，我结合硬件原理和实际波形，帮你把这两个协议掰开揉碎了讲明白。

2.1 SPI协议：高速显示背后的“流水线”

SPI（Serial Peripheral Interface）是驱动LCD显示部分最常用的接口，尤其对于分辨率达到320x480的3.5寸屏，需要传输的像素数据量巨大，SPI的全双工、高速特性使其成为不二之选。

SPI的四种模式与波形关键点热搜里很多人问SPI的四种模式，其实核心就是时钟极性（CPOL）和时钟相位（CPHA）的组合：

模式0 (CPOL=0, CPHA=0)：时钟空闲时为低电平，数据在时钟的第一个边沿（上升沿）采样。这是最常用的模式，也是很多LCD控制器（如ILI9486、ST7789）的默认模式。
模式1 (CPOL=0, CPHA=1)：时钟空闲时为低电平，数据在时钟的第二个边沿（下降沿）采样。
模式2 (CPOL=1, CPHA=0)：时钟空闲时为高电平，数据在时钟的第一个边沿（下降沿）采样。
模式3 (CPOL=1, CPHA=1)：时钟空闲时为高电平，数据在时钟的第二个边沿（上升沿）采样。

注意：屏幕的数据手册（Datasheet）里一定会写明所需的SPI模式。如果模式设错，轻则显示乱码，重则完全无显示。我曾因为想当然地用了模式0，结果折腾半天才发现某款屏需要模式3，教训深刻。

硬件片选 vs. 软件片选这是另一个高频问题。硬件片选（Hardware CS）由SPI控制器自动管理，在数据传输前后自动拉低和拉高片选线，效率高、时序精准。软件片选则需要你在代码里手动控制GPIO电平。

何时用硬件片选：当你的主控SPI控制器支持且屏幕时序要求严格时。例如，使用STM32的HAL库，你可以将CS引脚配置为硬件控制。
何时用软件片选：当你的SPI控制器硬件CS引脚不够用，或者需要驱动多个SPI设备时。手动控制虽然增加了一点CPU开销，但更灵活。

SPI时钟速度（SCK）设置速度不是越快越好。屏幕控制器有一个最大时钟频率限制（通常在大约30-60MHz）。你需要根据数据手册设置。过高的速度会导致数据错误，屏幕出现雪花点或条纹。一个稳妥的做法是，初始化时先使用一个较低的频率（如10MHz），确保通信正常后，再逐步提高至稳定运行的极限值。

2.2 I2C协议：触摸数据的“通讯员”

电容触摸控制器（通常是FT6236、GT911等芯片）几乎无一例外地使用I2C（Inter-Integrated Circuit）接口上报触摸坐标。I2C协议简单，但细节魔鬼。

为什么I2C需要上拉电阻？这是I2C的经典问题。I2C总线是“线与”结构，依靠上拉电阻将总线电平拉到高电平。当主机或从机输出低电平时，才能将总线拉低。如果没有上拉电阻，总线处于高阻态，电平不确定，通信必然失败。电阻值通常在2.2KΩ到10KΩ之间，需根据总线电容和通信速度选择。速度越快（如400kHz Fast Mode），电阻值应越小，以提供更快的上升沿。

I2C时序：建立时间与保持时间这是保证数据稳定读写的关键参数。从时序图上看：

建立时间（tSU;DAT）：数据必须在时钟线（SCL）上升沿到来之前，提前一段时间保持稳定。
保持时间（tHD;DAT）：时钟线下降沿之后，数据还必须再保持稳定一段时间。许多微控制器的硬件I2C模块会自动处理这些时序，但如果你使用GPIO模拟I2C（软件I2C），就必须在代码的延时中考虑这些时间，否则在高速下极易出错。

地址与读写位I2C设备都有一个7位地址。例如，FT6236的地址可能是0x38。在通信时，主机发送的第一个字节是(地址 << 1) | 读写位。读写位为0表示写，为1表示读。很多新手会直接发送0x38，实际上应该发送0x38 << 1即0x70（写）或0x71（读）。像STM32 HAL库这类高级库会自动处理这个读写位，但如果你直接操作寄存器或模拟时序，这里就是个坑。

电平转换与倒灌电流当主控是3.3V系统（如树莓派、STM32），而触摸芯片是5V供电或兼容5V时，就需要电平转换。简单的可以用两个NMOS管搭建双向转换电路，也可以用专用的电平转换芯片（如TXB0104）。

重要提示：使用二极管或电阻分压进行单向电平转换时，务必小心“倒灌”电流问题。即当总线一侧为高电平（3.3V），另一侧为更高电压（5V）且通过上拉电阻连接时，电流可能会通过IO口内部的保护二极管倒灌进低压侧芯片，导致芯片损坏或工作异常。因此，双向通信强烈推荐使用专用的双向电平转换器。

3. 硬件连接与驱动选型实战

理论懂了，动手才是关键。这一部分，我们分别针对树莓派和STM32平台，给出具体的硬件连接图和驱动选型思路。

3.1 树莓派驱动方案：利用FBTFT与libinput

树莓派驱动这类屏幕最为方便，因为有成熟的社区驱动框架。

硬件连接通常，3.5寸SPI屏会占用树莓派以下引脚：

SPI0:
- SCLK (GPIO11)
- MOSI (GPIO10)
- MISO (GPIO9) -注意：部分屏只写不读，此引脚可能不用
- CE0 (GPIO8) 或 CE1 (GPIO7) 作为LCD片选
GPIO:
- 一个GPIO（如GPIO25）作为LCD的复位引脚（RST）
- 一个GPIO（如GPIO24）作为LCD的数据/命令选择引脚（DC或RS）
- 背光控制（BL）可接PWM引脚（如GPIO18）实现调光，或直接接3.3V常亮。
I2C:
- SDA (GPIO2)
- SCL (GPIO3)
- 用于触摸芯片。

驱动安装（FBTFT + 设备树覆盖）

启用SPI和I2C接口：使用sudo raspi-config在Interfacing Options中启用SPI和I2C。
安装FBTFT驱动：编辑/boot/config.txt，在末尾添加设备树覆盖（Overlay）。不同的屏幕型号有不同的覆盖文件。例如，对于一些基于ILI9486的屏，你可能需要添加：
```
dtoverlay=waveshare35c:rotate=270
```
waveshare35c是一个常见的覆盖名，rotate设置旋转角度。关键点：你需要根据屏幕卖家提供的资料或屏幕主控芯片型号，找到正确的覆盖名。有时需要自己编译或修改覆盖文件。
配置触摸：触摸通常由ads7846（电阻屏）或edt-ft5x06（电容屏，如FT6236）等驱动支持。同样在config.txt中添加，并指定中断引脚：
```
dtoverlay=edt-ft5x06,interrupt=25,rotate=270
```
重启：sudo reboot后，屏幕应该能作为/dev/fb1显示控制台，触摸设备为/dev/input/eventX。

实操心得：树莓派OS版本（Bullseye, Bookworm）更新后，图形界面（Wayland）的触摸配置可能更复杂。如果触摸在命令行生效但在桌面环境无效，可能需要额外配置libinput。一个排查方法是：在桌面环境下打开终端，运行evtest，选择你的触摸设备，然后触摸屏幕看是否有坐标输出。如果有，说明驱动层是好的，问题在桌面环境配置。

3.2 STM32驱动方案：HAL库与底层优化

在STM32上驱动，更能体现嵌入式开发的精髓。我们分显示和触摸两部分。

LCD显示驱动（以SPI为例）

CubeMX配置：
- 在Connectivity中启用一个SPI，模式设为Full-Duplex Master或Transmit Only Master，数据大小8 Bits，模式根据屏幕手册设置（通常是Mode 0）。
- 将CS、DC、RST、BL引脚配置为GPIO Output。
- 正确设置SPI的预分频器，确保时钟频率在屏幕允许范围内。
编写驱动函数：
- 写命令/写数据：这是最基本的两个函数。通过DC引脚电平区分命令和数据。
```
void LCD_Write_Cmd(uint8_t cmd) { LCD_DC_LOW(); // DC置低，表示命令 HAL_SPI_Transmit(&hspi1, &cmd, 1, HAL_MAX_DELAY); } void LCD_Write_Data(uint8_t data) { LCD_DC_HIGH(); // DC置高，表示数据 HAL_SPI_Transmit(&hspi1, &data, 1, HAL_MAX_DELAY); }
```
- 初始化序列：这是最繁琐的一步。你需要严格按照屏幕数据手册或卖家提供的示例代码，依次写入几十个初始化命令和参数。一个命令都不能错，一个延时都不能少。建议：将初始化序列整理成一个常量数组，清晰明了。
- 画点与填充：基于LCD_Write_Cmd/Data实现设置坐标窗口和写入GRAM的函数，然后实现画点函数。填充矩形或全屏清屏时，一定要使用“设置窗口+连续写GRAM”的模式，这比单点循环快几十倍。

电容触摸驱动（以I2C为例）

CubeMX配置I2C：启用一个I2C，设置为标准模式（100kHz）或快速模式（400kHz）。务必在引脚图上检查，STM32的I2C引脚是固定的（如I2C1的SDA/SCL对应PB7/PB6或PB9/PB8），不能随意映射。

读取触摸数据：以FT6236为例，其触摸点坐标寄存器地址是固定的。

#define FT6236_ADDR 0x38 // 7位地址 #define FT6236_REG_P1_XH 0x03 // 第一个触摸点X坐标高字节寄存器 uint8_t data[4]; HAL_I2C_Mem_Read(&hi2c1, FT6236_ADDR << 1, FT6236_REG_P1_XH, I2C_MEMADD_SIZE_8BIT, data, 4, HAL_MAX_DELAY); // 解析data[0], data[1]得到X坐标， data[2], data[3]得到Y坐标

中断方式优化：触摸芯片通常有INT中断引脚，当有触摸发生时，会拉低该引脚。将STM32对应的GPIO配置为外部中断下降沿触发，在中断服务函数里设置一个标志位，然后在主循环中查询该标志位并读取数据。这比轮询方式高效得多。

DMA加速SPI传输对于STM32H750等高阶芯片，使用DMA驱动SPI LCD是提升刷屏效率的关键。但热搜也提到了“stm32h750 dma 驱动 spi lcd 问题”。

问题核心：SPI DMA传输时，需要确保传输的数据对齐和内存地址问题。例如，使用16位颜色（RGB565）时，发送的数据缓冲区应该是uint16_t类型，并且地址需要对齐。
常见坑点：
1. 缓存一致性：如果使用了D-Cache（数据缓存），在启动DMA传输前，必须调用SCB_CleanDCache_by_Addr()函数清理缓存，确保DMA控制器读到的是内存中最新的数据。
2. 传输完成中断：在DMA传输完成中断（或SPI传输完成中断）中，不要立即开始下一次传输，应先检查状态，并处理好帧缓冲区切换，避免撕裂现象。
3. SPI数据寄存器（DR）：对于只支持发送的SPI DMA，配置为SPI_DMA_ONLY或SPI_DMA_LAST模式时，要注意最后一个数据的发送可能需要特殊处理。

4. 软件框架与图形库选择

驱动调通只是第一步，要在上面做出漂亮的UI，还需要图形库。

4.1 嵌入式平台：LVGL与TouchGFX

LVGL (Light and Versatile Graphics Library)：开源、免费，资源占用可调，从几十KB到几百KB RAM/Flash均可运行。它支持多种输入设备（包括我们通过I2C读取的触摸坐标），拥有丰富的控件和动画效果。将LVGL移植到STM32上，主要工作是实现其lv_port_disp（显示）和lv_port_indev（输入设备）接口，把我们写好的画点函数和触摸坐标读取函数对接进去即可。社区活跃，资料极多。
TouchGFX (ST收购)：专为STM32优化，性能强大，UI设计器非常专业，但通常需要配合STM32高性能系列（如F4, F7, H7）且外扩SDRAM使用。对于3.5寸屏，如果项目UI复杂且追求极致流畅，TouchGFX是商业项目的优选，但学习成本和硬件要求较高。

4.2 树莓派平台：标准Linux GUI

树莓派上就自由多了，你可以：

直接使用FrameBuffer：如果你只需要简单的图形绘制，可以直接操作/dev/fb1这个设备文件，用内存映射（mmap）的方式读写显存。这是最底层、最高效的方式，但需要自己处理一切绘图逻辑。
使用SDL2/PyGame：对于Python或C/C++应用，SDL2是一个跨平台的多媒体库，它封装了对FrameBuffer和输入事件（包括触摸）的访问，让你可以更轻松地开发2D游戏或图形应用。
集成到桌面环境：如前所述，配置好触摸驱动后，屏幕可以作为扩展显示器或主显示器，直接使用Raspberry Pi OS自带的桌面环境。

5. 调试技巧与常见问题排查实录

驱动屏幕的过程，就是与各种奇怪现象斗争的过程。这里我列一个“踩坑实录”，希望能帮你快速定位问题。

5.1 屏幕显示问题排查表

现象	可能原因	排查步骤
白屏	背光未开启；初始化序列错误；电源问题。	1. 测量背光引脚电压。2. 用逻辑分析仪抓取SPI初始化时序，与数据手册对比。3. 检查屏幕供电电压（通常是3.3V和5V）是否稳定。
花屏/条纹	SPI时钟速度过快；初始化参数错误（如颜色格式、扫描方向）；GRAM写入时序错误。	1. 降低SPI时钟频率。2. 仔细核对初始化命令，特别是设置像素格式（如RGB565）、扫描方向（MADCTL）的命令。3. 检查“设置坐标窗口”后，是否连续写入GRAM数据。
显示偏移/错位	扫描方向（MADCTL）设置错误；显存大小与物理屏幕区域不匹配。	修改MADCTL寄存器的值，尝试0x00, 0x40, 0x80, 0xC0等不同组合，分别对应0°、90°、180°、270°旋转及镜像。
颜色不对	颜色格式不匹配。屏幕是RGB565，但你发送了RGB888数据，或者红蓝通道（R/B）反了。	确认屏幕支持的颜色格式，并在初始化时正确设置。发送像素数据时，确保每个像素的字节顺序正确（例如RGB565是高位在前还是低位在前）。

5.2 触摸问题排查表

现象	可能原因	排查步骤
完全无触摸	I2C通信失败；触摸芯片供电或复位不正常；中断引脚未配置。	1. 用示波器或逻辑分析仪检查I2C总线上是否有波形。2. 测量触摸芯片VDD和复位引脚电压。3. 检查INT中断引脚连接和配置，尝试改为轮询模式读取芯片ID寄存器，验证通信。
触摸坐标不准	坐标映射错误；屏幕旋转后映射未调整；触摸屏校准数据问题。	1. 读取的原始坐标是相对于触摸传感器本身的，需要映射到LCD像素坐标。公式：`LCD_X = (Touch_X - Xmin) * LCD_WIDTH / (Xmax - Xmin)`。2. 如果LCD显示旋转了，触摸坐标也需要做相应的旋转变换。3. 部分触摸芯片支持自动校准或需写入校准参数。
触摸跳动/漂移	电源噪声；I2C上拉电阻过大导致边沿缓慢；触摸面板受干扰。	1. 为触摸芯片的电源引脚增加一个0.1uF的退耦电容。2. 尝试减小I2C上拉电阻（如从10k换成4.7k）。3. 确保触摸屏排线远离电机、继电器等噪声源。

5.3 进阶调试工具：逻辑分析仪是你的“眼睛”

对于SPI/I2C通信问题，一个几十块钱的逻辑分析仪（配合PulseView/Saleae Logic软件）是必备神器。

连接：将分析仪的通道连接到SCLK, MOSI, MISO, CS, DC等关键引脚。
抓取初始化序列：在上电复位后，抓取主控发送给屏幕的第一批SPI数据。在软件里解码为SPI信号，你就可以清晰地看到每一个命令（CMD）和数据（DATA）字节，与数据手册一一比对。
检查I2C通信：同样，抓取SDA和SCL线，软件可以自动解码出I2C的地址、读写位、寄存器地址和数据，一眼就能看出通信是否成功，数据是否正确。

我个人的习惯是，任何新屏幕到手，第一件事就是用逻辑分析仪抓一下卖家提供的示例代码的通信波形，保存为参考波形。当自己驱动不成功时，再抓自己的波形进行对比，差异点就是问题所在，这个方法百试百灵。

6. 性能优化与进阶应用

当基础功能实现后，如何让显示更流畅、UI更复杂？这里有一些进阶思路。

1. 双帧缓冲与局部刷新

双帧缓冲：在内存中开辟两块与屏幕大小相同的显示缓冲区（Frame Buffer）。当LCD正在显示缓冲区A的内容时，你的图形库或应用在缓冲区B中绘制下一帧。绘制完成后，交换两个缓冲区的角色，将B的内容通过DMA快速传输到屏幕。这能有效避免屏幕撕裂。
局部刷新：不要每次都刷新整个屏幕。LVGL等图形库内部实现了脏矩形检测，只刷新UI中发生变化的部分区域。在自定义绘制时，也应遵循此原则，只更新需要更新的区域，可以极大减少SPI数据传输量。

2. 利用硬件加速对于STM32F7/H7等带有Chrom-ART加速器（DMA2D）的型号，一定要利用起来。DMA2D可以硬件加速以下操作：

填充矩形：用指定颜色填充一块显存区域。
图像复制：将一块内存数据复制到另一块（可用于缓冲交换）。
图像混合：带Alpha通道的图层混合。这些操作原本需要CPU大量计算，现在由DMA2D硬件完成，速度极快，且不占用CPU时间。在移植LVGL时，可以启用其DMA2D支持，UI流畅度会有质的提升。

3. 项目创意拓展一块可触摸的屏幕，能让你的嵌入式项目“活”起来：

智能家居中控屏：显示温湿度、控制灯光插座，所有操作一指搞定。
工业仪表盘：实时显示传感器数据（波形、频谱），通过触摸屏设置参数阈值。
便携式游戏机：基于STM32和LVGL，可以复刻一些经典小游戏。
树莓派一体机：将树莓派和屏幕集成，做成一个超迷你Linux电脑，用于编程学习、网络监控等。

驱动一块3.5寸电容屏，从硬件连接到软件调试，是一个典型的嵌入式全栈实践。它串联了GPIO、SPI、I2C、中断、DMA、图形库等多个核心知识点。过程中遇到的每一个问题，从白屏到触摸漂移，都是加深你对底层硬件理解的机会。我的建议是，不要只满足于点亮屏幕，尝试去优化它的性能，在上面构建一个真正的交互应用，这个过程中获得的经验，远比屏幕本身显示的内容更有价值。当你看到自己编写的UI流畅地响应指尖触摸时，那种成就感，就是嵌入式开发最大的乐趣所在。

查看全文

http://www.cnnetsun.cn/news/3794624.html