STM32F4 串口 DMA 双缓冲环形队列：指针回绕与半满中断竞态深度解析
👁 1 阅读 · 2026-08-27 · 嵌入式
在 STM32F4 系列嵌入式开发中，利用 DMA 双缓冲接收不定长串口数据是提升实时性与降低 CPU 负载的常用方案。然而，环形队列的指针回绕与 DMA 半满/全满中断之间隐藏着微妙的竞态条件，处理不当会导致数据错乱或丢失。本文深入剖析该竞态产生的根源，并给出基于硬件双缓冲与软件环形队列的同步机制、完整代码示例及工程注意事项，帮助开发者构建稳定可靠的高性能串口接收链路。
# STM32F4 串口 DMA 双缓冲环形队列：指针回绕与半满中断竞态深度解析
## 一、背景与挑战
在嵌入式系统中，串口接收不定长数据（如 GPS 报文、AT 指令响应）时，传统中断逐字节接收会频繁打断 CPU。STM32F4 的 DMA 控制器支持双缓冲模式（Double Buffer Mode），可自动在两个内存缓冲区之间切换，配合 DMA 传输完成中断（TC）和半传输中断（HT），能显著降低中断频率。但若将两个缓冲区抽象为环形队列，则必须处理**指针回绕**（写指针从尾部跳到头部）与**半满中断**（HT 触发时 DMA 正在写第二个缓冲区）之间的竞态。
## 二、原理剖析：双缓冲与环形队列的冲突
### 2.1 DMA 双缓冲机制
- 使能 DMA 的 DBM（Double Buffer Mode）后，DMA 使用 Memory0 和 Memory1 两个地址，每传输完一个缓冲区（大小为固定值）自动切换目标内存，并触发 HT（半传输，即第一个缓冲区完成）或 TC（全传输，即第二个缓冲区完成）中断。
- 对于串口接收，DMA 始终在后台搬运数据，CPU 只需在中断中处理已填满的缓冲区。
### 2.2 环形队列设计
- 将两个 DMA 缓冲区（假设各为 `BUF_SIZE` 字节）视为环形队列的存储区，逻辑上连续。维护 `read_index`（读指针）和 `write_index`（写指针），其中 `write_index` 由 DMA 硬件更新（实际是 DMA 当前目标地址偏移）。
- 问题：当 DMA 完成一个缓冲区（HT 或 TC）时，软件需要更新 `write_index`，但此时 DMA 可能已经切换到另一个缓冲区并开始写入。若软件错误地认为 `write_index` 等于缓冲区边界，就会与正在进行的 DMA 写入产生竞态。
### 2.3 竞态场景
- 假设缓冲区大小为 64 字节，DMA 先写 Memory0（0~63），触发 HT 中断时，DMA 已切换到 Memory1（64~127）并开始写入。若在 HT 中断中，软件将 `write_index` 设为 64，但此时 DMA 可能已写入 Memory1 的若干字节（如 10 字节），则 `write_index` 应指向 74 而非 64。若直接设为 64，后续读取会漏掉这 10 字节。
- 反之，若在 TC 中断中，DMA 已回绕到 Memory0，软件需正确计算回绕后的偏移。
## 三、解决方案：基于硬件状态的同步策略
核心思想：**不在中断中直接计算 `write_index`，而是通过读取 DMA 当前目标地址寄存器（如 `NDTR` 或 `CMAR`）来获取实时写位置**，并利用双缓冲标志判断当前正在使用的缓冲区。
### 3.1 关键寄存器
- `DMA_GetCurrentMemoryTarget()`：返回当前 DMA 正在使用的内存目标（0 或 1）。
- `DMA_GetCurrDataCounter()`：返回剩余待传输字节数（NDTR），则当前写位置 = 当前缓冲区基址 + (缓冲区大小 - NDTR)。
### 3.2 环形队列结构定义
```c
typedef struct {
uint8_t buffer[2][BUF_SIZE]; // 双缓冲
volatile uint16_t read_index; // 读指针（软件维护）
volatile uint8_t current_mem; // 上次中断时的内存目标
} RingQueue;
```
### 3.3 中断处理函数（HT 和 TC 共用）
```c
void DMA1_Stream5_IRQHandler(void) {
if (DMA_GetITStatus(DMA1_Stream5, DMA_IT_HT) != RESET) {
DMA_ClearITPendingBit(DMA1_Stream5, DMA_IT_HT);
UpdateWriteIndex();
}
if (DMA_GetITStatus(DMA1_Stream5, DMA_IT_TC) != RESET) {
DMA_ClearITPendingBit(DMA1_Stream5, DMA_IT_TC);
UpdateWriteIndex();
}
}
void UpdateWriteIndex(void) {
uint8_t mem_target = DMA_GetCurrentMemoryTarget(DMA1_Stream5);
uint16_t ndtr = DMA_GetCurrDataCounter(DMA1_Stream5);
uint16_t current_pos;
// 计算当前 DMA 写到的绝对位置（相对于环形队列起始）
if (mem_target == 0) {
current_pos = (BUF_SIZE - ndtr); // 正在写 Memory0
} else {
current_pos = BUF_SIZE + (BUF_SIZE - ndtr); // 正在写 Memory1
}
// 更新写指针（注意：read_index 可能大于 current_pos，需处理回绕）
// 这里假设 read_index 始终落后于 write_index，且队列未满
if (current_pos >= read_index) {
write_index = current_pos;
} else {
// 回绕情况：写指针已绕过尾部，但读指针还在前面
write_index = current_pos + 2 * BUF_SIZE; // 扩展逻辑地址
}
// 记录当前内存目标，供下次判断
queue.current_mem = mem_target;
}
```
### 3.4 数据读取函数（供应用层调用）
```c
uint16_t ReadData(uint8_t *dest, uint16_t len) {
uint16_t available = (uint16_t)(write_index - read_index); // 注意逻辑回绕
if (available == 0) return 0;
if (len > available) len = available;
for (uint16_t i = 0; i < len; i++) {
uint16_t idx = read_index % (2 * BUF_SIZE); // 映射到物理缓冲区
dest[i] = queue.buffer[idx / BUF_SIZE][idx % BUF_SIZE];
read_index++;
}
return len;
}
```
## 四、配置步骤（以 USART1 + DMA2 Stream5 为例）
1. **使能时钟**：`RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_DMA2, ENABLE);` 和 `RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE);`
2. **配置 DMA**：
- 设置外设地址为 `&USART1->DR`，内存地址为 `queue.buffer[0]` 和 `queue.buffer[1]`。
- 方向：外设到内存；模式：循环模式（Circular）；双缓冲使能。
- 数据宽度：字节；缓冲区大小：`BUF_SIZE`。
3. **配置 USART**：使能 DMA 接收请求（`USART_DMACmd(USART1, USART_DMAReq_Rx, ENABLE);`）。
4. **使能 DMA 中断**：HT 和 TC 中断，并编写中断服务函数。
5. **初始化队列**：`read_index = 0; write_index = 0; current_mem = 0;` 并启动 DMA。
## 五、注意事项
- **缓冲区大小必须小于等于 DMA 最大传输量（65535）**，且建议为 2 的幂，便于取模运算。
- **竞态窗口**：在 `UpdateWriteIndex` 中，读取 `NDTR` 和内存目标时，DMA 可能仍在写入，但这两个寄存器是实时更新的，因此读取到的值总是最新的，不存在中间态。但需注意，在 HT 中断触发时，DMA 可能已写入第二个缓冲区少量字节，此时 `NDTR` 已反映该偏移，所以计算出的 `current_pos` 是准确的。
- **队列溢出**：若应用层读取速度跟不上 DMA 写入，`write_index` 可能追上 `read_index`，导致数据覆盖。需在写入前检查剩余空间，或使用更大的缓冲区。
- **内存屏障**：在读取 `write_index` 时，建议使用 `__DMB()` 或 `volatile` 确保编译器不优化乱序。
- **中断优先级**：确保 DMA 中断优先级高于可能访问队列的其他中断，避免嵌套竞态。
## 六、总结
通过利用 DMA 的实时寄存器状态（`NDTR` 和当前内存目标），可以精确计算环形队列的写指针，从而规避指针回绕与半满中断的竞态。此方案无需禁用中断或加锁，适用于高波特率、大数据量的嵌入式场景。开发者需结合具体 STM32F4 型号的参考手册，调整 DMA 流和中断配置，并充分测试边界条件（如缓冲区恰好填满、回绕瞬间）。