从Arduino到STM32：SPI LCD驱动与DMA优化实战指南

1. 项目缘起从“点灯”到“显示”的跨越如果你玩过Arduino或者STM32第一个项目大概率是“点灯”——让一个LED闪烁。这确实是电子世界的“Hello World”它验证了硬件连接、代码烧录和最基本的GPIO控制。但当你成功点亮第一个LED后那种兴奋感很快就会消退因为你会发现除了亮和灭你无法从这个小灯珠上获得任何更丰富的信息。它无法告诉你传感器读到了什么值无法显示系统当前的状态更无法进行人机交互。这时你就会自然而然地想到下一个里程碑式的项目驱动一块LCD屏幕。“项目六 – LCD演示”这个标题听起来简单甚至有些平淡但它恰恰是无数嵌入式爱好者、学生和创客从“硬件控制”迈向“信息呈现”的关键一步。LCD液晶显示器就像是为你的微控制器项目打开了一扇窗让内部运行的数据、逻辑和状态能够直观地“说”给你听。无论是显示一句“Hello World”还是实时绘制传感器波形LCD都是连接数字世界与物理世界的桥梁。我最初接触LCD时觉得它比LED复杂十倍不止但真正上手后才发现只要理清了通信协议、初始化流程和显示缓冲区的概念它带来的成就感也是点灯的十倍。今天我就结合Arduino和STM32这两个最流行的平台来拆解LCD驱动的核心特别是大家常踩的坑比如STM32H750用DMA驱动SPI LCD时那些让人头疼的问题。2. LCD驱动基础协议、接口与初始化时序在动手写代码之前我们必须搞清楚LCD屏幕是怎么“听”我们的话的。这不像LED给个高电平就亮。LCD内部是一个复杂的矩阵我们需要告诉它点亮哪些像素、显示什么颜色。这个“告诉”的过程就是通过通信协议完成的。2.1 常见通信协议SPI、I2C与8080/6800并行对于小型LCD比如常见的1.3寸、1.8寸、2.4寸屏主流的通信方式有三种它们各有优劣选择哪种往往由屏幕本身的控制器和你的项目需求决定。SPI串行外设接口这是目前最常见的选择尤其是在Arduino生态中。它的优点是引脚占用少通常只需要4根线SCK时钟、MOSI主机输出、MISO主机输入、CS片选如果不需要读回屏幕数据MISO甚至可以省掉。通信速率快适合刷新图片或简单动画。市面上绝大多数为Arduino设计的“Grove”接口LCD模块或插接式LCD扩展板都采用SPI接口。它的工作模式是主从式微控制器作为主机发送时钟和数据给作为从机的LCD控制器。I2CInter-Integrated Circuit如果你觉得4根线还是太多那么I2C是更好的选择它只需要2根线SDA数据、SCL时钟。它通过地址来寻址总线上不同的设备可以很方便地挂载多个传感器和屏幕。但代价是速度较慢因为它是半双工通信且协议开销比SPI大。通常只用于刷新率要求不高的字符显示比如显示几行温湿度数据。很多OLED小屏喜欢用I2C。8080/6800并行接口这是一种古老的、但仍在一些中大尺寸屏或高性能场合使用的接口。它采用8位或16位的数据总线配合读、写、使能等控制线一次性传输一个字节或一个字的数据。优点是速度极快适合刷屏或显示视频。缺点是极其占用IO口动辄十几二十根线布线复杂。STM32的FSMC灵活静态存储器控制器外设就是专门用来高效驱动这类并行屏的。对于初学者和大多数创意项目SPI接口的LCD是最佳起点。它平衡了速度、复杂度和资源占用。我们后续的讨论也将以SPI为主。2.2 理解LCD控制器并非直接控制像素这里有一个关键概念我们写的代码并不是直接控制LCD面板上的每一个液晶分子。我们是在与一块集成在屏幕背后的LCD驱动控制器芯片通信。常见的控制器有ST7789、ILI9341、ILI9488等。我们的所有命令和数据都是发给这个控制器的。控制器内部有显存GRAM。你可以把它想象成一块画布。我们的任务就是通过SPI总线把想要显示的图像数据“画”到这块GRAM里。控制器会自动地、持续地从GRAM中读取数据转换成对应的电压去驱动LCD面板上的像素点。所以所谓的“刷新屏幕”其实就是更新GRAM的内容。2.3 核心操作命令与数据与LCD控制器的通信分为两种类型发送命令和发送数据。这是所有LCD驱动的基石。命令Command / Register用来设置控制器的工作模式。比如设置屏幕的扫描方向横屏还是竖屏、颜色格式RGB565还是RGB888、进入或退出睡眠模式、开启或关闭显示等。每个命令都有一个唯一的命令码Command Code。数据Data在发送某些命令后需要跟随发送的参数或实际的像素数据。例如发送设置“列地址”的命令后需要跟两个字节的数据来指定起始列和结束列发送“写GRAM”的命令后后面跟着的所有数据都会被当作像素颜色值写入GRAM。在SPI通信中通常用一根额外的引脚DC或A0来区分当前发送的是命令还是数据。例如拉低DC引脚表示接下来发送的是命令拉高则表示发送的是数据。这是硬件上的约定必须在代码中正确控制。初始化序列在LCD上电后必须按照控制器数据手册Datasheet提供的一段固定的命令序列进行初始化。这个序列可能包含几十条命令用于复位控制器、设置伽马校正、电源控制、像素格式等。这段代码通常又长又枯燥但至关重要。幸运的是流行的LCD库如Arduino的TFT_eSPI、STM32的LTDC驱动库都已经为我们写好了针对不同控制器的初始化代码。3. 在Arduino平台上驱动LCD从库函数到底层理解Arduino的伟大之处在于其丰富的库生态让驱动LCD变得异常简单。但作为学习者我们不能只停留在调用库函数的层面。3.1 常用库与硬件连接最强大的库之一是TFT_eSPI。它支持海量的SPI和并行屏驱动程序经过高度优化。使用步骤如下安装库在Arduino IDE的库管理中搜索“TFT_eSPI”并安装。配置驱动这是最关键的一步。找到Arduino安装目录下的libraries/TFT_eSPI/User_Setup.h文件。你需要根据自己屏幕的型号、控制器、分辨率、引脚连接来修改这个文件。// 例如驱动一块ILI9341的2.4寸SPI屏连接如下 // TFT_CS - Arduino pin 10 // TFT_DC - Arduino pin 9 // TFT_RST - Arduino pin 8 // TFT_MOSI - Arduino pin 11 (Arduino Uno的硬件SPI引脚) // TFT_SCLK - Arduino pin 13 (Arduino Uno的硬件SPI引脚) // TFT_MISO - Arduino pin 12 (可不用如果不需要读屏) // TFT_LED - 接一个PWM引脚控制背光 #define ILI9341_DRIVER // 告诉库你用的控制器 #define TFT_WIDTH 240 // 屏幕宽度 #define TFT_HEIGHT 320 // 屏幕高度 // 定义引脚 #define TFT_CS 10 #define TFT_DC 9 #define TFT_RST 8 // 使用硬件SPI #define USE_HSPI_PORT修改并保存后库在编译时就会根据你的配置生成对应的底层驱动代码。编写应用代码现在你可以像使用高级图形API一样轻松绘图了。#include TFT_eSPI.h TFT_eSPI tft TFT_eSPI(); void setup() { tft.init(); tft.setRotation(1); // 设置屏幕方向 tft.fillScreen(TFT_BLACK); tft.setTextColor(TFT_WHITE, TFT_BLACK); tft.drawString(Hello World!, 50, 100, 4); } void loop() { // 动态显示传感器数据 int sensorValue analogRead(A0); tft.fillRect(50, 150, 100, 20, TFT_BLACK); // 清空之前的数据区域 tft.drawNumber(sensorValue, 50, 150, 2); delay(100); }注意TFT_eSPI库默认使用SPI的transfer()函数进行通信。对于简单的字符和图形刷新这完全足够。但当你需要快速刷新全屏图片或动画时软件SPI用digitalWrite模拟会非常慢务必使用硬件SPI引脚并考虑启用库中的帧缓冲Frame Buffer功能虽然会消耗更多内存但可以避免刷新时的闪烁。3.2 避开Arduino IDE的“慢”坑很多新手会遇到编译慢、上传慢、库管理失败的问题。除了网络原因一些设置可以改善不要安装在中文路径或系统盘将Arduino IDE安装到D:\Arduino这样的纯英文、无空格路径下。使用国内镜像在“文件”-“首选项”的“附加开发板管理器网址”中添加国内的板子列表镜像可以加速开发板包的下载。管理库文件夹手动下载的库ZIP文件可以通过“项目”-“加载库”-“添加.ZIP库”来安装比IDE内下载更可靠。关于版本Arduino IDE 2.x 界面更现代但1.8.x版本依然稳定且资源占用小。对于ESP32等板子在2.0中安装支持包可能更快。根据你的电脑和网络情况选择即可。4. 进军STM32硬件SPI与DMA的威力当你觉得Arduino的性能或灵活性不够时STM32是自然的进阶选择。STM32的硬件SPI外设性能强大如果再配上DMA直接存储器访问就能实现“解放CPU”的高效刷屏。4.1 环境搭建STM32在Arduino框架下是的STM32也可以用Arduino框架来开发这降低了入门门槛。你需要在Arduino IDE中通过“开发板管理器”安装“STM32 MCU based boards”支持包。选择对应的开发板型号如Nucleo-144, Generic STM32H7 series等。像在Arduino Uno上一样使用TFT_eSPI库。但需要根据STM32的引脚定义重新修改User_Setup.h。STM32的硬件SPI引脚是固定的如SPI1的SCKPA5, MOSIPA7, MISOPA6你需要将TFT的引脚连接到这些硬件SPI引脚上并在配置中启用正确的SPI端口如#define USE_HSPI_PORT对于STM32可能不适用需要查看库文档或示例。这种方式让你可以快速将Arduino项目迁移到性能更强的STM32上但可能无法充分发挥STM32的全部硬件特性。4.2 深入HAL库配置硬件SPI要追求极致性能和控制力必须使用STM32CubeIDE和HAL库或LL库进行开发。以STM32H750驱动SPI LCD为例步骤如下CubeMX配置在Pinout Configuration标签页启用一个SPI外设如SPI1为全双工主模式。配置引脚SCK, MOSI, MISO可选另外手动配置两个GPIO输出一个作为CS片选一个作为DC命令/数据。配置SPI参数时钟预分频器决定SPI速度如PCLK/4、数据大小8位或16位、时钟极性和相位CPOL/CPHA这必须与LCD控制器数据手册要求一致通常为Mode 0或Mode 3。在DMA Settings标签页为SPI的TX发送流添加一个DMA通道如DMA1 Stream3方向为存储器到外设数据宽度为字节或半字与SPI数据大小匹配。生成代码CubeMX会生成初始化代码。关键函数是HAL_SPI_Transmit()阻塞式和HAL_SPI_Transmit_DMA()非阻塞DMA式。编写驱动函数你需要封装两个基础函数void LCD_WriteCommand(uint8_t cmd) { HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_RESET); // DC拉低写命令 HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_RESET); // CS拉低选中设备 HAL_SPI_Transmit(hspi1, cmd, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_SET); // CS拉高 } void LCD_WriteData(uint8_t data) { HAL_GPIO_WritePin(LCD_DC_GPIO_Port, LCD_DC_Pin, GPIO_PIN_SET); // DC拉高写数据 HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, data, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(LCD_CS_GPIO_Port, LCD_CS_Pin, GPIO_PIN_SET); }然后用LCD_WriteCommand和LCD_WriteData组合实现初始化序列和设置显示窗口等功能。4.3 DMA驱动的陷阱与排错以STM32H750为例这是本文的重中之重也是很多人在STM32H7系列上栽跟头的地方。你按照教程配置了DMA代码编译通过但屏幕就是一片漆黑或者花屏。问题可能出在以下几个层面4.3.1 内存一致性Cache问题STM32H750具有高速缓存Cache。当你使用DMA时数据流是这样的CPU准备显示数据写入到SRAM中的数组缓冲区- DMA引擎从SRAM中读取数据 - 通过SPI发送给LCD。 问题在于CPU写入的数据可能还停留在Cache里并没有真正刷到SRAM中。而DMA是直接访问SRAM的它读到的就是“过时的”或错误的数据导致屏幕显示乱码。解决方案在启动DMA传输前必须确保缓存数据写回到了内存。对于存放发送数据的数组使用__attribute__((section(.dma_buffer)))将其定义到特定的、可缓存性配置的内存段如DTCM或AXI SRAM并在CubeMX的System Core-MPU内存保护单元中配置该内存区域为“Write-through”或“Non-cacheable”。更简单的软件方法在启动DMA传输前调用SCB_CleanDCache_by_Addr()函数强制清理数据缓存中对应缓冲区地址范围的数据。这是最常用且有效的办法。uint16_t frame_buffer[320*240]; // 显示缓冲区 // ... 填充frame_buffer ... // 在调用HAL_SPI_Transmit_DMA前清理缓存 SCB_CleanDCache_by_Addr((uint32_t*)frame_buffer, sizeof(frame_buffer)); HAL_SPI_Transmit_DMA(hspi1, (uint8_t*)frame_buffer, sizeof(frame_buffer));4.3.2 SPI时钟速度与DMA带宽不匹配STM32H750的SPI时钟可以设置得非常高理论上可达系统时钟分频后的高速。但DMA从内存搬运数据到SPI数据寄存器DR的速度是有限的。如果SPI时钟设得太快DMA来不及供应数据就会导致SPI underrun错误发送的数据不完整。解决方案适当降低SPI的时钟分频系数不要一开始就追求极限速度。优化DMA源数据地址的对齐和传输位宽。如果SPI数据宽度是16位那么DMA的源数据地址最好是半字对齐2字节对齐传输位宽也设置为半字。检查DMA通道的优先级确保其有足够高的优先级不被其他中断长时间打断。4.3.3 DMA传输完成中断TC与连续刷屏当你用DMA发送完一帧数据后会进入DMA传输完成中断回调函数HAL_SPI_TxCpltCallback()。如果你想实现动画就需要在这个回调函数里准备下一帧数据并再次启动DMA传输。这里有个关键细节在本次DMA传输真正、完全结束之前不要修改发送缓冲区。否则DMA可能读到正在被修改的数据。解决方案使用双缓冲区Double Buffering。准备两个缓冲区BufferA和BufferB。当DMA正在从BufferA发送数据时CPU在BufferB中绘制下一帧。在HAL_SPI_TxCpltCallback()中断中交换缓冲区指针让DMA下一次从BufferB发送而CPU去填充BufferA。这样实现了绘制和传输的并行避免了数据竞争也能获得更流畅的动画效果。4.3.4 硬件连接与电源别忽略了硬件SPI时钟线SCK过长或靠近干扰源会导致信号畸变。确保所有信号线尽可能短并检查连接是否牢固。另外LCD模块的背光需要足够的电流驱动如果直接从MCU引脚取电可能导致背光暗淡或MCU复位。最好使用三极管或MOS管来驱动背光。排查DMA驱动问题时一个有效的思路是先让阻塞模式工作。即先用HAL_SPI_Transmit()函数实现最基本的显示如清屏为某种颜色。如果阻塞模式正常说明硬件连接、SPI基本配置、初始化序列都是对的。然后再切换到DMA模式并依次排查缓存、速度、缓冲区管理这些问题。5. 进阶应用从显示数据到绘制波形当你能稳定驱动LCD后就可以玩些更有趣的了。比如实现一个简单的示波器或频谱显示。核心思路数据采集使用ADC以固定频率采样信号。坐标映射将ADC的采样值如0-4095映射到LCD屏幕的Y轴坐标如0-239。同时X轴代表时间每个采样点占据一个或几个像素的宽度。绘制波形最简单的方法是画线Line或画点Pixel。从第一个点开始依次用线段连接相邻的采样点。为了消除闪烁可以采用“先擦后画”的方式在绘制新一帧波形前先用背景色重绘上一帧波形所在的区域即局部清屏然后再绘制新波形。FFT频谱显示如果你采集的是一段音频或振动信号可以对采样数据进行快速傅里叶变换FFT得到其频率分量。然后将每个频率分量的幅度强度映射为LCD上的一列垂直柱状图的高度。这需要你集成一个FFT库如ARM的CMSIS-DSP库并对复数运算和窗函数有一定了解。这个项目将综合运用ADC、定时器、DMA用于ADC、LCD驱动、甚至DSP知识是一个非常好的综合性练习。它让你从“让屏幕显示东西”进化到“用屏幕分析东西”。驱动LCD尤其是用好DMA是嵌入式开发中的一个经典课题。它涉及GPIO、SPI、DMA、中断、内存管理等多个核心概念。从Arduino的简单库函数调用到STM32 HAL库的配置再到H7系列上解决Cache一致性问题这个过程本身就是一次扎实的学习之旅。当你第一次看到自己编写的代码在屏幕上流畅地画出波形时那种感觉和第一次点亮LED是完全不同的——你创造了一个能与现实世界交互的窗口。希望这篇长文能帮你少走些弯路更快地享受到这种创造的乐趣。