STM32串口DMA+队列通信模块设计与实现

1. 项目概述

在嵌入式开发中，串口通信是最基础也最常用的外设接口之一。但传统的串口收发方式存在一个痛点：当短时间内需要发送大量数据时，要么会阻塞主程序运行，要么会导致数据丢失。我在开发STM32项目时，就经常遇到这样的困扰。

这个开源项目就是为了解决这个问题而设计的。它实现了一个基于DMA和队列机制的串口通信模块，具有以下核心特点：

1. 非阻塞式发送：通过DMA传输数据，完全不占用CPU时间
2. 数据可靠性：内置消息队列，即使短时间内连续调用发送函数，数据也不会丢失
3. 高可移植性：虽然基于STM32F103开发，但可以轻松移植到其他MCU平台
4. 多串口支持：模块化设计，同一芯片上的多个串口可以独立使用互不干扰

这个模块特别适合需要频繁进行串口通信的场景，比如：

• 传感器数据实时上传
• 设备调试信息输出
• 与其他设备的命令交互
• 需要保证通信可靠性的工业控制应用

2. 核心设计思路

2.1 为什么需要DMA+队列的方案

传统串口发送方式有两种：

1. 阻塞式发送：调用HAL_UART_Transmit()等函数，CPU需要等待每个字节发送完成
2. 中断式发送：使用发送完成中断，但频繁中断仍会影响系统性能

这两种方式在面对突发的大量数据发送时都会有问题。而DMA+队列的方案则完美解决了这些问题：

• DMA传输：数据搬运完全由DMA控制器完成，CPU只需初始化传输
• 队列缓冲：当DMA忙时，新数据进入队列等待，不会丢失
• 自动续传：DMA发送完成后自动从队列取出下一个数据继续发送

2.2 队列设计的关键考量

队列是这个模块的核心，设计时考虑了以下几点：

1. 循环队列结构：使用头尾指针管理，避免数据搬移
2. 线程安全：通过忙标志(Serial_TxBusy)防止多任务环境下的竞争
3. 边界保护：严格检查字符串长度，防止缓冲区溢出
4. 容量权衡：默认10条消息的队列深度，兼顾内存占用和实用性

实际测试表明，在STM32F103@72MHz下，使用这个模块后，连续调用发送函数的耗时从原来的ms级降低到μs级，性能提升显著。

3. 代码实现详解

3.1 关键数据结构

模块使用以下几个核心变量：

c复制// DMA缓冲区
uint8_t Serial_TxBuffer[SERIAL_TX_BUFFER_SIZE]; // DMA发送缓冲区
uint8_t Serial_RxBuffer[SERIAL_RX_BUFFER_SIZE]; // DMA接收缓冲区

// 发送队列
char Serial_TxQueue[SERIAL_TX_QUEUE_SIZE][SERIAL_TX_BUFFER_SIZE]; // 发送队列
uint8_t Serial_TxQueue_Head = 0; // 队列头指针
uint8_t Serial_TxQueue_Tail = 0; // 队列尾指针

// 状态标志
volatile uint8_t Serial_TxBusy = 0; // 发送忙标志
uint8_t Serial_RxFlag = 0;          // 接收完成标志

3.2 核心发送流程

以Serial_SendString()函数为例，其工作流程如下：

1. 参数检查：

   • 计算字符串长度
   • 检查长度是否合法(0 < length ≤ SERIAL_TX_BUFFER_SIZE)

2. DMA状态判断：

   • 如果DMA空闲(Serial_TxBusy=0)，直接启动DMA发送
   • 如果DMA忙，将数据存入队列

3. 队列管理：

   • 检查队列是否已满
   • 未满时，将字符串拷贝到队列尾部
   • 更新尾指针(循环递增)

4. DMA发送：

   • 将数据拷贝到DMA缓冲区
   • 配置DMA参数(数据长度、内存地址)
   • 启动DMA传输

3.3 中断处理机制

模块使用DMA传输完成中断来自动处理队列中的后续数据：

c复制void DMA1_Channel4_IRQHandler(void)
{
    if(DMA_GetITStatus(DMA1_IT_TC4))
    {
        DMA_ClearITPendingBit(DMA1_IT_TC4);
        
        // 检查队列中是否有待发送数据
        if(!Serial_TxQueue_IsEmpty()) 
        {
            // 从队列头部取出数据
            char* nextMsg = Serial_TxQueue[Serial_TxQueue_Head];
            uint16_t length = strlen(nextMsg);
            
            // 更新队列头指针
            Serial_TxQueue_Head = (Serial_TxQueue_Head + 1) % SERIAL_TX_QUEUE_SIZE;
            
            // 启动下一次DMA发送
            memcpy(Serial_TxBuffer, nextMsg, length);
            DMA1_Channel4->CNDTR = length;
            DMA1_Channel4->CMAR = (uint32_t)Serial_TxBuffer;
            DMA_Cmd(DMA1_Channel4, ENABLE);
        }
        else
        {
            // 队列为空，清除忙标志
            Serial_TxBusy = 0;
        }
    }
}

4. 使用指南

4.1 快速上手步骤

1. 添加文件到工程：

   • 将Serial_1.c和Serial_1.h添加到项目
   • 包含头文件：#include "Serial_1.h"

2. 初始化串口：

   c复制Serial_Init(); // 系统启动时调用一次
   

3. 发送数据：

   c复制// 发送字符串
   Serial_SendString("Hello World!\n");
   
   // 格式化输出
   Serial_Printf("Temperature: %.1f°C\n", tempValue);
   
   // 发送数组
   uint8_t data[] = {0x01, 0x02, 0x03};
   Serial_SendArray(data, sizeof(data));
   

4. 接收数据处理：

   c复制if(Serial_RxFlag) // 检查是否有新数据
   {
       // 处理Serial_RxPacket中的数据
       Serial_RxFlag = 0; // 清除标志
   }
   

4.2 移植注意事项

移植到其他平台时需要注意：

1. DMA配置：

   • 修改Serial_Init()中的DMA通道配置
   • 更新中断向量表中的DMA中断处理函数名

2. 无DMA的平台：

   • 可以使用串口发送完成中断实现类似功能
   • 在中断处理函数中从队列取出下一个数据发送

3. 引脚配置：

   • 根据目标MCU的引脚定义修改GPIO初始化代码
   • 注意复用功能映射可能不同

5. 性能优化建议

5.1 内存占用优化

对于资源紧张的MCU，可以调整以下参数：

c复制#define SERIAL_TX_BUFFER_SIZE 128  // 减小发送缓冲区大小
#define SERIAL_TX_QUEUE_SIZE 5     // 减少队列深度

5.2 发送策略优化

默认情况下，队列满时会丢弃新数据。可以根据需求修改为：

1. 覆盖最旧数据：

   c复制// 在Serial_SendString()中修改队列满的处理
   if(Serial_TxQueue_IsFull()) {
       // 覆盖最旧的数据
       Serial_TxQueue_Head = (Serial_TxQueue_Head + 1) % SERIAL_TX_QUEUE_SIZE;
   }
   

2. 阻塞等待：

   c复制while(Serial_TxQueue_IsFull()) {
       // 等待队列有空位
   }
   

5.3 多串口使用技巧

模块支持多个串口同时使用，建议：

1. 为每个串口创建独立的.c/.h文件(如Serial_1, Serial_2)
2. 使用不同的DMA通道和中断处理函数
3. 在头文件中使用命名空间区分(如USART1_SendString, USART2_SendString)

6. 常见问题排查

6.1 数据发送不完整

可能原因及解决方法：

1. DMA配置错误：

   • 检查DMA通道是否使能
   • 确认DMA内存/外设地址设置正确

2. 缓冲区溢出：

   • 检查发送数据长度是否超过SERIAL_TX_BUFFER_SIZE
   • 增大缓冲区大小或分割长数据

6.2 队列不起作用

排查步骤：

1. 确认Serial_TxBusy标志正常工作
2. 检查队列头尾指针更新逻辑
3. 验证DMA传输完成中断是否触发

6.3 接收数据异常

常见问题：

1. 数据错位：检查波特率设置是否匹配
2. 数据丢失：增大接收缓冲区大小
3. 解析错误：确认数据结束符处理正确

7. 实际应用案例

7.1 在电动滑板项目中的应用

在我的开源电动滑板项目中，这个串口模块用于：

1. 遥控器通信：

   • 实时传输速度、电量等数据
   • 处理来自遥控器的控制命令

2. 调试输出：

   • 输出电机参数、传感器数据
   • 故障诊断信息记录

3. 固件升级：

   • 通过串口实现Bootloader功能

7.2 工业传感器采集系统

在一个温湿度监测系统中，模块被用来：

1. 定时上传传感器数据到上位机
2. 接收配置参数(如采样间隔)
3. 在突发大量数据时保证不丢失

8. 进阶开发建议

8.1 添加流控制功能

可以扩展模块支持硬件流控制(RTS/CTS)：

1. 在初始化中添加GPIO配置
2. 在发送前检查CTS状态
3. 在接收端使用RTS控制数据流

8.2 实现协议解析

建议在接收端添加协议解析层：

1. 定义简单的帧结构(如: HEADER+LEN+DATA+CRC)
2. 在接收中断中实现状态机解析
3. 校验通过后才设置Serial_RxFlag

8.3 内存管理优化

对于频繁大量数据传输：

1. 改用动态内存分配管理队列
2. 实现零拷贝机制(直接传递指针而非数据拷贝)
3. 添加内存池管理减少碎片

9. 移植到其他平台

9.1 无DMA的MCU移植

在没有DMA的平台上，可以用中断实现类似功能：

1. 发送逻辑：

   • 在发送完成中断中处理队列中的下一个数据
   • 使用忙标志防止中断重入

2. 接收逻辑：

   • 在接收中断中填充缓冲区
   • 检测帧结束条件后设置标志

9.2 不同开发环境适配

1. Keil/IAR：

   • 直接添加源文件即可
   • 注意中断处理函数名称可能不同

2. Arduino：

   • 封装为C++类
   • 使用HardwareSerial底层接口

3. RTOS环境：

   • 添加互斥锁保护共享资源
   • 可以使用RTOS提供的队列替代自定义队列

10. 测试与验证方法

10.1 压力测试建议

验证模块的可靠性：

1. 连续发送测试：

   • 在循环中连续发送不同长度数据
   • 验证是否所有数据都能完整接收

2. 极限长度测试：

   • 发送等于缓冲区大小的数据
   • 检查边界条件处理是否正确

3. 队列深度测试：

   • 快速发送超过队列深度的数据
   • 验证队列满时的处理策略

10.2 性能评估指标

1. 吞吐量：

   • 测量单位时间内能发送的最大数据量
   • 比较有/无队列时的差异

2. CPU占用率：

   • 在发送过程中测量CPU负载
   • 验证DMA是否真正解放了CPU

3. 延迟测试：

   • 测量从调用发送函数到实际发送完成的时间
   • 评估队列引入的额外延迟

11. 模块扩展思路

11.1 添加优先级队列

对于重要数据，可以实现：

1. 定义高/低优先级队列
2. 高优先级数据可以插队发送
3. DMA空闲时优先检查高优先级队列

11.2 支持二进制数据

当前实现主要针对字符串，可以扩展：

1. 添加BinarySend函数
2. 使用长度前缀而非NULL终止
3. 修改队列存储结构

11.3 统计功能

添加运行统计信息：

1. 记录发送/接收字节数
2. 统计队列使用率
3. 记录错误次数(队列满、校验错等)

12. 替代方案比较

12.1 与RTOS队列对比

优势：

1. 更轻量级，适合资源受限的MCU
2. 不依赖特定RTOS，可移植性更好
3. 实现简单，调试方便

劣势：

1. 缺少RTOS提供的阻塞/超时机制
2. 多任务环境下需要额外保护

12.2 与商业库对比

优势：

1. 完全开源，可自由修改
2. 代码透明，无黑箱
3. 针对STM32优化，效率高

劣势：

1. 功能相对单一
2. 需要自行维护

13. 开发经验分享

13.1 调试技巧

1. 利用IO口调试：

   • 在关键流程中添加GPIO翻转
   • 用逻辑分析仪观察时序

2. 打印调试信息：

   • 在中断处理中添加条件打印
   • 输出队列状态、指针位置等信息

3. 边界测试：

   • 特意测试空队列、满队列等边界条件
   • 验证异常处理是否健壮

13.2 性能优化历程

在开发过程中，通过以下优化显著提升了性能：

1. memcpy替代循环拷贝：

   • 发送缓冲区填充速度提升3倍

2. DMA参数直接配置：

   • 相比库函数调用，减少了一半的配置时间

3. volatile关键字使用：

   • 解决了编译器优化导致的状态标志问题

14. 资源占用分析

在STM32F103C8T6上的资源占用：

1. Flash：

   • 约2KB代码空间(包含所有功能)

2. RAM：

   • 发送缓冲区：200字节
   • 接收缓冲区：200字节
   • 队列存储：2000字节(10x200)
   • 总计：约2.4KB

3. CPU：

   • 纯DMA发送时CPU占用接近0%
   • 队列处理时的额外开销<1%

15. 未来改进方向

1. 动态配置：

   • 运行时调整缓冲区大小
   • 灵活设置队列深度

2. 错误恢复：

   • 添加超时重传机制
   • 实现自动波特率检测

3. 功耗优化：

   • 在空闲时自动进入低功耗模式
   • 根据数据量动态调整时钟

16. 开源协作建议

欢迎社区贡献：

1. 移植适配：

   • 为更多MCU平台提供支持
   • 添加不同开发环境的示例

2. 功能扩展：

   • 实现更丰富的协议支持
   • 添加网络隧道功能

3. 文档完善：

   • 编写更详细的使用指南
   • 添加API参考文档

17. 常见使用误区

17.1 缓冲区大小设置不当

常见问题：

1. 发送缓冲区小于实际数据长度

   • 导致数据截断
   • 解决方案：合理评估最大数据长度

2. 队列深度不足

   • 在突发数据时容易丢包
   • 解决方案：根据业务特点调整

17.2 中断优先级配置错误

错误现象：

1. 串口通信不稳定
2. 数据丢失或错乱

正确做法：

1. 设置合适的DMA中断优先级
2. 避免与其他高优先级中断冲突

17.3 多线程访问未保护

风险：

1. 在RTOS环境中可能引发竞态条件
2. 导致数据损坏或系统崩溃

解决方案：

1. 添加互斥锁保护共享资源
2. 或者限制在单线程中使用

18. 性能实测数据

在STM32F103C8T6@72MHz环境下的测试结果：

19. 模块API参考

19.1 初始化函数

c复制/**
 * @brief 初始化串口模块
 * @param 无
 * @retval 无
 */
void Serial_Init(void);

19.2 数据发送函数

c复制/**
 * @brief 发送单个字节
 * @param Byte: 要发送的字节(0-255)
 */
void Serial_SendByte(uint8_t Byte);

/**
 * @brief 发送字节数组
 * @param Array: 数组首地址
 * @param Length: 数组长度
 */
void Serial_SendArray(uint8_t *Array, uint16_t Length);

/**
 * @brief 发送字符串
 * @param String: 以'\0'结尾的字符串
 */
void Serial_SendString(char *String);

/**
 * @brief 发送数字
 * @param Number: 要发送的数字
 * @param Length: 显示的数字位数(不足补0)
 */
void Serial_SendNumber(uint32_t Number, uint8_t Length);

/**
 * @brief 格式化输出
 * @param format: 格式化字符串
 * @param ...: 可变参数
 */
void Serial_Printf(char *format, ...);

19.3 接收相关

c复制/**
 * @brief 接收数据包(外部变量)
 * @note 当Serial_RxFlag=1时有效
 */
extern uint8_t Serial_RxPacket[SERIAL_RX_BUFFER_SIZE];

/**
 * @brief 接收完成标志
 * @note 1=有新数据,0=无新数据
 */
extern uint8_t Serial_RxFlag;

20. 结语

这个串口模块经过多个项目的实际验证，确实能显著提升STM32的串口通信效率和可靠性。它的优势在于：

1. 简单易用：API设计直观，学习成本低
2. 稳定可靠：内置的队列机制防止数据丢失
3. 高效节能：DMA传输最大程度节省CPU资源

在实际使用中，建议根据具体需求调整缓冲区大小和队列深度。对于更复杂的应用场景，可以考虑在此基础上添加协议解析、流控制等功能。