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

STM32H750 DMA驱动SPI LCD与AHT21传感器C语言嵌入式开发实践

news 2026/8/19 22:45:00

1. 项目概述：从传感器到屏幕的C语言直连

最近在捣鼓一个环境监测的小玩意儿，核心需求很简单：用一块小巧的AHT21温湿度传感器采集数据，然后实时显示在一块RT-Spark开发板自带的LCD屏幕上，所有逻辑都用最纯粹的C语言来实现。这听起来像是一个嵌入式开发的“Hello World”项目，但当你真正动手，把数据从I2C总线读到，再通过SPI或者并口驱动LCD显示出来，中间每一步都藏着不少门道。我之所以选择这个组合，AHT21精度和稳定性在同类传感器里口碑不错，而RT-Spark这类基于高性能MCU（比如STM32H750）的开发板，资源丰富，玩转SPI DMA驱动LCD正是检验功力的好场景。这个项目非常适合已经掌握C语言基础、想踏入嵌入式实时系统或硬件交互领域的开发者，它串联了传感器通信、数据处理和图形显示三个核心环节，搞定它，你对嵌入式系统的理解会上一个台阶。

2. 硬件平台与核心组件解析

2.1 RT-Spark开发板与MCU选型考量

RT-Spark通常指的是基于意法半导体STM32H750VBT6这类高性能微控制器的开发板。选择它，不仅仅是看中其主频高（400MHz+的Cortex-M7内核），更是看中了其丰富的外设资源，特别是针对本项目至关重要的DMA控制器和高速SPI接口。驱动LCD，尤其是分辨率稍高的屏，频繁的CPU参与数据传输会是性能瓶颈，并且会严重影响系统实时性。STM32H750的DMA（直接存储器访问）可以将CPU从繁重的数据搬运工作中解放出来，在SPI发送显示数据的同时，CPU可以去处理传感器数据、运行业务逻辑，甚至进入低功耗模式。这就是为什么网络热词中“stm32h750 dma 驱动 spi lcd 问题”搜索量很高——大家都想用好这个功能，但配置起来确实容易踩坑。

2.2 AHT21传感器通信原理

AHT21是一款采用I2C数字接口的温湿度复合传感器。它内部集成了电容式湿度传感元件和一个高精度测温元件，并通过一个专用的ASIC进行信号调理、模数转换和校准。与老款的DHT11/22不同，AHT21输出的是完全校准过的数字量，通信协议也更标准。其核心工作原理是：MCU作为主机，通过I2C总线发送特定的命令字（例如触发测量命令0xAC），传感器收到命令后开始内部测量（这个过程需要一定时间，典型为80ms），测量完成后，MCU再次读取数据寄存器，即可获得6个字节的原始数据，其中包含温度、湿度的校准数字量，再根据数据手册中的公式进行换算，就能得到真实的温湿度值。它的精度（湿度±2%RH，温度±0.3°C）和长期稳定性，使其成为很多对可靠性有要求的项目的首选。

2.3 LCD显示模块接口选择

RT-Spark板载的LCD通常是SPI接口或并口（如FSMC/FMC）驱动的TFT屏幕。SPI接口引脚占用少，接线简单，是中小尺寸屏的常用选择。而并口速度更快，适合刷屏数据量大的场景。“lcd段码屏显示原理”搜索热度高，但需要区分：我们项目用的多是点阵式TFT/LCD，每个像素点独立控制；而段码屏是预先定制好显示 segments，原理不同。本项目假设使用SPI接口的LCD。驱动它的本质，就是通过SPI总线，向屏幕的控制器（如ST7789、ILI9341）发送命令和数据。初始化序列配置屏幕的工作模式、扫描方向、颜色格式等，之后的数据写入操作就是向显存（GRAM）中填充像素颜色值。利用DMA传输这些颜色数据，是保证刷新流畅的关键。

3. 软件开发环境搭建与项目配置

3.1 C语言环境与IDE选择

纯粹用C语言开发，意味着我们要直接操作寄存器或使用标准外设库（如HAL库、LL库）。集成开发环境首推STM32CubeIDE，它集成了STM32CubeMX配置工具和基于Eclipse的编译调试环境，对STM32系列支持最为完善。当然，你也可以使用VSCode配合 ARM GCC 工具链和 Cortex-Debug 插件，这提供了更高的灵活性。网络热词中“vscode配置c/c++环境”和“vscode配置c语言环境”反映了这种需求。对于嵌入式开发，在VSCode中配置的关键在于正确设置includePath、defines和编译器路径，确保代码补全和跳转正常工作。我个人的习惯是，快速原型开发用CubeIDE，追求极致控制和轻量时用VSCode+GCC Makefile。

3.2 工程结构与外设驱动初始化

一个清晰的项目结构至关重要。我会创建如下目录：

/Project /Core/Src // 主循环、业务逻辑 /Core/Inc // 头文件 /Drivers /AHT21 // AHT21传感器驱动 /LCD // LCD屏幕驱动 /STM32H7xx_HAL_Driver // HAL库文件（如果使用） /Middlewares // 可选，如RTOS

首先，使用STM32CubeMX图形化工具初始化MCU时钟树（将HCLK配置到最高性能，并确保SPI、I2C时钟使能），配置引脚：

I2C引脚：为AHT21配置一个I2C外设（如I2C1），设置标准模式（100kHz）或快速模式（400kHz），引脚通常为上拉模式。
SPI引脚：为LCD配置一个SPI外设（如SPI2），设置为全双工主模式，数据大小8位或16位（取决于LCD控制器数据格式），时钟极性（CPOL）和相位（CPHA）必须严格按照LCD数据手册设置，通常模式0或模式3。同时，别忘了配置一个额外的GPIO作为LCD的片选（CS）、数据/命令选择（DC）和复位（RST）引脚。
DMA配置：为SPI的TX流配置DMA通道，方向为存储器到外设，数据宽度为字节或半字（与SPI数据宽度匹配），并启用内存地址递增。这是实现“无CPU干预”刷屏的核心。

注意：CubeMX生成的代码只是初始化框架。对于LCD，你通常需要根据具体型号，在LCD_Init()函数中补充一长串初始化命令序列，这部分代码通常由屏厂提供或从参考例程中获取。

3.3 基础通信函数封装

在开始业务逻辑前，需要封装最底层的读写函数。对于AHT21（I2C），需要：

// 向AHT21发送命令（单字节或多字节） HAL_StatusTypeDef AHT21_WriteCommand(uint8_t cmd); // 从AHT21读取数据 HAL_StatusTypeDef AHT21_ReadData(uint8_t *data, uint16_t size);

对于LCD（SPI），需要：

// 发送命令（拉低DC引脚） void LCD_WriteCommand(uint8_t cmd); // 发送数据（拉高DC引脚） void LCD_WriteData(uint8_t data); // 使用DMA发送大量数据（如图像缓冲区） void LCD_WriteData_DMA(uint16_t *pData, uint32_t Size);

LCD_WriteData_DMA函数内部会启动SPI的DMA传输，这个函数是非阻塞的，调用后立即返回，数据传输由DMA在后台完成。你需要监听DMA传输完成中断，以便在传输结束后进行后续操作（如切换帧缓冲区）。

4. AHT21传感器数据采集驱动实现

4.1 传感器初始化与校准

AHT21上电后需要一个小延迟（约20-40ms）等待其稳定。之后，首先要发送初始化命令0xBE，这个命令实际上包含了“触发校准”的流程。发送后需要等待约10ms，然后读取一个状态字节。如果状态字节的Bit[3]为0，表示校准使能成功。如果为1，则需要重新上电或再次发送初始化命令。很多初次使用遇到的问题就是忽略了这一步，导致后续读取的数据全是0或错误值。

uint8_t AHT21_Init(void) { uint8_t status = 0; HAL_Delay(40); // 上电延时 // 发送初始化/校准命令 0xBE if (AHT21_WriteCommand(0xBE) != HAL_OK) return 1; HAL_Delay(10); // 读取状态字 if (AHT21_ReadData(&status, 1) != HAL_OK) return 2; // 检查校准使能位（Bit3） if ((status & 0x08) == 0) { return 0; // 成功 } else { return 3; // 校准未完成 } }

4.2 触发测量与数据读取流程

采集数据的标准流程是“触发-等待-读取”。首先发送触发测量命令0xAC，后面跟着两个命令参数0x33和0x00。发送后，传感器进入测量状态，此时不应再发送其他I2C命令。我们需要不断读取状态字（大约每10ms一次），直到状态字的Bit[7]（忙标志位）从1变为0，表示测量完成。这个过程通常需要80ms左右。

测量完成后，连续读取6个字节的数据。这6个字节包含：状态字（再次）、湿度数据高8位、湿度数据低8位、湿度数据第3位（仅高4位有效）与温度数据高8位、温度数据低8位、温度数据第3位（仅高4位有效）以及一个CRC校验字节（可选，本项目为简化未使用）。

4.3 原始数据解析与物理量换算

从传感器读回的是20位的原始数据（湿度和温度各20位）。需要将其组合成32位整数，再套用公式计算。

void AHT21_Calculate(uint8_t data[6], float *humidity, float *temperature) { uint32_t hum_raw, temp_raw; // 组合20位湿度原始值 hum_raw = ((uint32_t)data[1] << 12) | ((uint32_t)data[2] << 4) | ((uint32_t)data[3] >> 4); // 组合20位温度原始值 temp_raw = (((uint32_t)data[3] & 0x0F) << 16) | ((uint32_t)data[4] << 8) | data[5]; // 转换为实际物理量 *humidity = (float)hum_raw * 100.0f / 1048576.0f; // 2^20 = 1048576 *temperature = (float)temp_raw * 200.0f / 1048576.0f - 50.0f; }

这里的公式直接来源于AHT21数据手册。1048576是2的20次方，代表20位ADC的全量程。计算出的湿度单位是%RH，温度单位是摄氏度。

实操心得：AHT21的数据手册中公式有时会写成(RAW / 2^20) * 100%，在代码中直接使用1048576.0f这个魔数比每次计算powf(2,20)效率高得多。另外，传感器有大约2秒的刷新周期，过于频繁的触发测量（短于2秒）并不会得到新数据，反而可能干扰传感器。

5. LCD显示驱动与DMA刷屏优化

5.1 LCD初始化与基本绘图函数

在调用LCD_Init()完成硬件初始化序列后，我们需要实现一组基本的绘图函数来构建显示界面。

LCD_SetWindow(x_start, y_start, x_end, y_end): 设置接下来要写入数据的显示区域。这是高效刷新的前提，设置好窗口后，连续写入的数据会自动填充该区域。
LCD_DrawPixel(x, y, color): 画一个点。基础中的基础，但直接调用它来画图效率极低。
LCD_FillRect(x, y, width, height, color): 填充一个矩形区域。这是绘制背景、清屏、显示数据框最常用的函数。
LCD_WriteString(x, y, str, font, fg_color, bg_color): 显示字符串。需要集成字库（如取模工具生成的数组字体）。

实现LCD_FillRect时，常规做法是循环调用LCD_WriteData发送颜色值。但对于一个区域，这会产生成千上万次SPI写入调用，CPU被完全占用。

5.2 使用DMA进行高效数据填充

这就是DMA大显身手的地方。我们可以改造LCD_FillRect函数：

调用LCD_SetWindow设置要填充的矩形区域。
计算这个区域的总像素数：total_pixels = width * height。
准备一个颜色缓冲区。对于单色填充，我们甚至不需要一个真实的数组，可以创建一个包含单个颜色值的变量，然后让DMA源地址固定指向这个变量，并设置DMA为“存储器到外设”的“循环模式”（但需注意SPI数据寄存器需要字节/半字数据流）。更通用的做法是，创建一个足够大的缓冲区（例如一行像素的颜色数组），用目标颜色值填充它，然后分多次DMA传输。
调用LCD_WriteData_DMA，传入缓冲区地址和传输大小。
函数立即返回。CPU可以去执行其他任务（如读取AHT21）。
在DMA传输完成中断回调函数中，判断是否完成整个区域的填充，如果未完成，则更新窗口或缓冲区地址，启动下一次DMA传输。

// 简化示例：使用DMA填充一行 void LCD_FillRect_DMA(uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint16_t color) { uint16_t line_buffer[BUFFER_SIZE]; // 假设BUFFER_SIZE足够大或等于width for(int i=0; i<BUFFER_SIZE; i++) { line_buffer[i] = color; } LCD_SetWindow(x, y, x+width-1, y+height-1); // 分多次传输，每次传输一行或一部分 for(int row=0; row<height; row++) { // 等待上一次DMA传输完成（可通过信号量或标志位） while(!dma_transfer_done); dma_transfer_done = 0; // 启动本次DMA传输 LCD_WriteData_DMA(line_buffer, width); // 更新窗口的Y坐标（如果LCD控制器支持自动换行，可能不需要） // 更优方案是使用双缓冲区（ping-pong buffer）避免等待 } }

5.3 双缓冲与局部刷新策略

对于动态变化的温湿度数据，我们不需要刷新整个屏幕。最优策略是“局部刷新”。

静态界面一次绘制：在程序初始化时，用DMA快速绘制好所有不变的UI元素（边框、标题、标签等）。
动态数据区域局部更新：为温湿度数值预留一个固定区域（矩形）。当新数据到来时，只刷新这个区域。
双缓冲防撕裂：在内存中创建两个与显示区域大小相同的缓冲区（FrameBuffer）。一个用于CPU/业务逻辑绘制（后台缓冲区），另一个正在被DMA送往屏幕（前台缓冲区）。当后台缓冲区绘制完成一帧后，交换两个缓冲区的指针，然后启动DMA从前台缓冲区读取数据。这可以防止屏幕在传输过程中显示不完整的图像（撕裂效应）。对于STM32H750，其丰富的内存（1MB RAM）完全支持为一块小区域建立双缓冲。

6. 系统整合与主程序逻辑设计

6.1 数据采集与显示的时序安排

主程序的设计核心是合理安排AHT21数据采集和LCD刷新这两个周期性任务的时序，避免冲突（如同时访问SPI和I2C总线）并保证显示的实时性。一个简单可靠的架构是使用状态机配合定时器中断。

定时器中断：设置一个基本定时器（如1ms中断一次）。在这个中断服务函数里，维护几个软件计时器（sensor_read_tick,lcd_refresh_tick）。
主循环状态机：在主循环中，检查这些计时器的标志。
- 状态SENSOR_IDLE：检查sensor_read_tick是否达到2000（即2秒）。若达到，切换到SENSOR_TRIGGER状态，发送AHT21触发命令，并启动一个80ms的“测量等待”计时器。
- 状态SENSOR_WAIT：等待“测量等待”计时器超时，然后切换到SENSOR_READ状态，读取传感器数据并解析。
- 状态SENSOR_READ：读取数据，计算温湿度，更新显示缓冲区中的数值，然后状态回到SENSOR_IDLE。
- 显示刷新：lcd_refresh_tick可以设置得更快（如100ms）。每当超时，检查显示缓冲区的数据是否有更新。如果有，则调用局部刷新函数，仅更新数值区域。刷新过程使用DMA，是非阻塞的。

6.2 用户界面设计与信息呈现

一个清晰的UI能极大提升体验。我们可以设计一个简单的界面：

+-------------------+ | 环境监测系统 | +-------------------+ | 温度: 25.6 °C | | | | 湿度: 60.3 %RH | | | +-------------------+

实现步骤：

初始化时，用LCD_FillRect_DMA填充背景色。
用LCD_WriteString绘制静态文本：“环境监测系统”、“温度:”、“湿度:”、“°C”、“%RH”。
为“25.6”和“60.3”这两个数值区域各定义一个字符缓冲区（如char temp_str[10]）和一个对应的“脏标志”（temp_updated）。
当AHT21读取到新数据后，使用sprintf(temp_str, "%.1f", temperature)格式化字符串，并将temp_updated标志置1。
在显示刷新任务中，如果temp_updated为1，则先使用背景色填充旧的数值区域（擦除旧值），再在新的位置绘制temp_str，最后将temp_updated清零。对湿度同理。

6.3 低功耗与稳定性考量

虽然本项目对功耗不敏感，但良好的习惯可以提升系统稳定性。

I2C上拉电阻：确保I2C总线上有合适的上拉电阻（通常4.7kΩ），否则通信可能失败。
电源去耦：在AHT21的VDD和GND引脚附近放置一个100nF的陶瓷电容，以滤除电源噪声，保证测量精度。
错误处理：在I2C和SPI通信函数中，一定要检查HAL库返回的状态（HAL_OK,HAL_ERROR,HAL_BUSY,HAL_TIMEOUT）。发生错误时，可以进行有限次数的重试，并在重试失败后执行软复位或记录错误日志。
看门狗：启用独立看门狗（IWDG），在主循环中定期喂狗。防止程序跑飞导致系统死机。

7. 常见问题排查与调试技巧

7.1 传感器无响应或数据全为零

这是最常遇到的问题，排查顺序如下：

硬件连接：用万用表检查VCC、GND是否接好，SDA、SCL线是否连通，上拉电阻是否焊接。I2C地址是否正确（AHT21的7位地址是0x38，写地址0x70，读地址0x71）。
软件初始化：确认I2C外设已正确初始化（时钟、引脚模式）。使用逻辑分析仪或示波器抓取I2C波形，看起始信号、地址字节、ACK信号是否正常。特别注意：AHT21初始化命令0xBE必须执行成功，且状态字校准位为0。
时序问题：在发送触发测量命令0xAC后，必须等待足够长的时间（>80ms）再读取数据。检查代码中的延时或状态查询逻辑。
电源问题：确保供电电压在AHT21的工作范围内（1.8V - 3.6V），且稳定。用示波器观察VCC引脚是否有毛刺。

7.2 LCD白屏、花屏或显示错位

复位与电源：首先确保LCD的RST引脚完成了正确的复位序列（拉低>1ms，再拉高）。检查LCD的VCC、背光电源是否正常。
SPI时序：这是“stm32h750 dma 驱动 spi lcd 问题”的重灾区。花屏几乎都是SPI的CPOL和CPHA设置与LCD控制器不匹配导致的。务必核对数据手册，通常ST7789/ILI9341在SPI模式0或模式3下工作。用逻辑分析仪抓取SPI的CLK、MOSI、CS、DC信号，与数据手册的时序图对比。
初始化序列：LCD驱动IC型号繁多，初始化命令序列可能有细微差别。确保你使用的序列完全匹配你的屏幕型号和驱动IC。一个命令错误就可能导致颜色反转、扫描方向错乱等问题。
数据格式：确认SPI发送的数据宽度（8位/16位）与LCD控制器期望的是否一致。颜色格式是RGB565还是RGB888？LCD_WriteData发送的数据是否匹配。
DMA配置错误：如果使用DMA后花屏，检查DMA的源数据地址、目标外设地址、数据宽度、是否开启内存地址递增。如果内存地址没有递增，DMA会一直发送缓冲区的第一个颜色值。

7.3 DMA传输不完整或系统卡死

缓冲区溢出：确保DMA要传输的数据量不超过你设定的缓冲区大小。特别是使用sizeof(array)计算大小时，注意数组类型是uint8_t还是uint16_t。
中断冲突：DMA传输完成中断、SPI发送完成中断的优先级设置不当，可能导致中断嵌套问题，甚至硬故障。合理设置中断优先级，在中断服务函数中尽量快速处理。
内存对齐：STM32H7的DMA对内存地址对齐有要求（尤其是使用DMA2D时）。确保你用于DMA传输的内存缓冲区地址是对齐的（例如4字节对齐）。可以使用__attribute__((aligned(4)))来定义数组。
Cache一致性（高级问题）：STM32H750有数据缓存（D-Cache）。如果你直接操作DMA的源缓冲区（位于CPU的缓存中），而DMA从物理内存读取数据，可能会读到旧数据（缓存未写回）。解决方法是在启动DMA传输前，调用SCB_CleanDCache_by_Addr()函数清理缓存。或者，将DMA缓冲区定义在不被缓存的内存区域（如使用__attribute__((section(".ram_d2")))，具体需参考链接脚本）。

7.4 调试工具与手段

printf调试：通过串口输出关键变量值（如原始数据、状态字、错误代码）。这是最直接的方法。
逻辑分析仪：对于I2C、SPI通信问题，一个几十块钱的逻辑分析仪配合PulseView或Saleae软件，可以直观地看到每一位波形、每一个数据包，是排查时序和协议问题的终极利器。
ST-Link调试器：配合STM32CubeIDE或Keil的在线调试功能，可以设置断点、单步执行、实时查看变量和存储器内容，对于分析复杂的程序逻辑流非常有效。
示波器：查看电源纹波、复位信号质量、中断信号等模拟特性。

这个项目从传感器数据采集到图形化显示，涵盖了嵌入式开发中硬件驱动、外设通信、实时处理和性能优化等多个核心技能点。把每个环节的“为什么”搞清楚，远比单纯复制代码更有价值。当你看到准确的温湿度数值稳定地显示在你自己驱动的屏幕上时，那种对系统从头到尾的掌控感，正是嵌入式开发的乐趣所在。

查看全文

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