单片机与物联网 / 系统课时
用空闲中断识别不定长接收帧
用空闲中断识别不定长接收帧
串口接收长度不固定时,定长 DMA 会等不到短消息的完成回调,逐字节中断又增加负担。下面用 STM32F407 的 USART2、循环 DMA 与 IDLE 事件检测接收间隙,把跨半区、跨回绕的字节拼成一条消息并得出有效长度。
学习目标
- 配置 USART2 的 DMA 循环接收与空闲中断。
- 正确把回调中的
Size转换为本次新增字节数。 - 处理连续分段、缓冲区回绕、消息过长和消费不及时的情况。
配置 USART2 和循环 DMA
示例使用 STM32F407、STM32CubeF4 HAL1(建议使用包含 HAL_UARTEx_ReceiveToIdle_DMA() 的 1.26.2 或更新版本)。使用 3.3 V USB-UART 转换器连接:转换器 TX 接 PA3(USART2_RX)、RX 接 PA2(USART2_TX),双方 GND 相连;不可将 RS-232 电平直接接入 MCU。
- 在 STM32CubeMX 或 STM32CubeIDE 的
Pinout & Configuration > Connectivity > USART2中启用Asynchronous,设波特率115200、字长8 Bits、奇偶校验None、停止位1、硬件流控None。 - 在
USART2 > DMA Settings添加USART2_RX,选择DMA1 Stream5 / Channel 4、Peripheral to Memory、Byte数据宽度、Memory Increment和Circular模式。 - 在
USART2 > NVIC Settings启用USART2 global interrupt,同时启用DMA1 Stream5中断。生成代码后确认USART2_IRQHandler()调用HAL_UART_IRQHandler(&huart2),DMA1_Stream5_IRQHandler()调用HAL_DMA_IRQHandler(&hdma_usart2_rx)。 - 确认初始化时先执行
MX_DMA_Init()再执行MX_USART2_UART_Init(),并由 HAL MSP 配置将接收 DMA 句柄关联至huart2.hdmarx。
此处选 64 字节 DMA 环形缓冲区、128 字节消息缓冲区。DMA 负责持续收字节,USART 中断负责报告空闲,不要每次 IDLE 后重新启动循环 DMA。
用事件判断新增数据和消息边界
对 115200、8N1 串口,一个字符占 10 位,约 10 / 115200 = 86.8 μs。接收线在最后一个字节后持续空闲约一个字符时间,会产生 IDLE 事件;它代表一段物理接收间隙,不一定等于应用协议中的一帧。
HAL_UARTEx_RxEventCallback() 可能由半传输 HT、传输完成 TC 或 IDLE 触发。循环模式下,Size 是 DMA 当前写入结束位置(上界可等于缓冲区容量),不是本次收到的长度。保存上次位置 old_pos 后才能算新增字节。
| 事件 | Size |
此次新增 | 是否提交消息 |
|---|---|---|---|
| HT(前 32 字节) | 32 | 32 | 否 |
| TC(写满 64 字节) | 64 | 32 | 否 |
| IDLE(回绕后又收 6 字节) | 6 | 6 | 是,合计 70 |

如果 Size > old_pos,新数据位于 [old_pos, Size);如果 Size < old_pos,先处理 [old_pos, 64),再处理 [0, Size)。同一位置重复回调时新增长度为零,但 IDLE 仍可结束先前累积的消息。
在回调中拼接跨区数据
下面是 main.c 的片段示例,依赖 CubeMX 生成的 huart2、GPIO、DMA、NVIC 和中断处理函数。把全局变量与函数放在 USER CODE 的函数外区域;完成外设初始化后调用 UART_RxStart(),在 while (1) 中反复调用 UART_PollFrame()。
#include <stdio.h>
#define DMA_CAP 64U
#define FRAME_CAP 128U
static uint8_t dma_rx[DMA_CAP];
static uint8_t frames[2][FRAME_CAP];
static uint16_t old_pos, building_len, ready_len;
static uint8_t building_slot, ready_slot, too_long;
static volatile uint8_t frame_ready;
static volatile uint32_t dropped_frames;
/* 复制 DMA 本次新增的半开区间;超限后丢弃整条消息。 */
static void AppendRange(uint16_t first, uint16_t last)
{
for (uint16_t i = first; i < last; ++i) {
if (too_long) return;
if (building_len == FRAME_CAP) {
too_long = 1U;
return;
}
frames[building_slot][building_len++] = dma_rx[i];
}
}
void UART_RxStart(void)
{
if (HAL_UARTEx_ReceiveToIdle_DMA(&huart2, dma_rx, DMA_CAP) != HAL_OK) {
Error_Handler();
}
}
void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)
{
if (huart->Instance != USART2 || Size == 0U || Size > DMA_CAP) return;
/* HT、TC、IDLE 都按同一 DMA 写入游标提取新数据。 */
if (Size > old_pos) {
AppendRange(old_pos, Size);
} else if (Size < old_pos) {
AppendRange(old_pos, DMA_CAP);
AppendRange(0U, Size);
}
old_pos = Size;
if (HAL_UARTEx_GetRxEventType(huart) == HAL_UART_RXEVENT_IDLE) {
if (too_long || frame_ready) {
++dropped_frames;
} else if (building_len > 0U) {
ready_slot = building_slot;
ready_len = building_len;
building_slot ^= 1U; /* 双缓冲:主循环消费旧槽,DMA 收集新槽。 */
__DMB();
frame_ready = 1U;
}
building_len = 0U;
too_long = 0U;
}
}
void UART_PollFrame(void)
{
if (!frame_ready) return;
__DMB();
/* 演示用串口回显在主循环执行,不能放进接收回调。 */
uint8_t slot = ready_slot;
uint16_t len = ready_len;
char header[24];
int n = snprintf(header, sizeof(header), "LEN=%u\r\n", (unsigned)len);
if (n > 0 && n < (int)sizeof(header)) {
(void)HAL_UART_Transmit(&huart2, (uint8_t *)header, (uint16_t)n, 100U);
(void)HAL_UART_Transmit(&huart2, frames[slot], len, 100U);
(void)HAL_UART_Transmit(&huart2, (uint8_t *)"\r\n", 2U, 100U);
}
__DMB();
frame_ready = 0U;
}预期结果:串口工具设置 115200 8N1,以原始字节发送 ABC(不要自动追加换行),接收端回显:
LEN=3
ABC这里 HT 和 TC 只搬运新增片段,IDLE 才发布消息。即使收到 70 个连续字节、DMA 已回绕一次,也只会提交一条长度为 70 的消息。frame_ready 已占用时,新完成的消息不会覆盖尚未消费的槽,而会计入 dropped_frames。
验收边界与常见故障
- 分别发送 3、40、70、128 字节的连续数据,观察
LEN是否正确;特别测试 64、128 字节这些 DMA 容量整数倍边界。若某 HAL 版本未在 TC 后报告相应 IDLE,应核对驱动实现并加入协议长度或软件超时判定,不要把每次 TC 误当消息结束。 - 故意把数据分成两次发送。若中间空闲超过约
86.8 μs,硬件可能给出两条消息;需要严格报文边界时使用长度字段、结束符与校验,而不能只依赖 IDLE。 - 发送超过 128 字节的单段消息,应看到
dropped_frames增加;主循环长期忙于回显也可能使待处理槽占满。量产程序应改用消息队列和非阻塞发送,并按中断最大延迟调整 DMA 容量。 - 如果回调完全不触发,先检查 DMA
Circular模式、USART2 global interrupt、DMA1 Stream5中断以及两个 IRQHandler 的 HAL 调用;检查启动函数返回HAL_OK。遇到 ORE 等串口错误时,先记录错误、终止受影响的接收并在复位应用游标后恢复 DMA。
循环 DMA 模式下 IDLE 不会自动停止接收,回调结束后硬件仍在写入;因此必须及时复制尚未被覆盖的数据。长时间屏蔽中断可能让 DMA 在两次处理之间绕满一圈,单靠 Size 无法发现这种丢失,必须监控丢帧并留足吞吐裕量。