STM32如何判断串口DMA传输完成？

Question

在使用STM32的串口配合DMA进行数据发送时，如何准确判断DMA传输已完成是一个常见难题。许多开发者发现，即使调用HAL_UART_Transmit_DMA()后，无法及时获知传输结束状态，导致重复启动DMA或数据覆盖。典型问题如下：在DMA中断未正确处理或回调函数未被触发的情况下，程序无法感知传输完成，进而影响后续通信时序。尤其在连续发送多帧数据时，若未通过__HAL_DMA_GET_COUNTER()或DMA传输完成中断（TC标志）进行判断，极易引发总线冲突或数据丢失。因此，如何可靠检测DMA传输完成事件，成为确保串口高效稳定通信的关键。

Answer 1

STM32串口DMA发送完成状态的精准判断机制

1. 问题背景与典型场景分析

在嵌入式通信系统中，STM32系列MCU广泛采用USART配合DMA实现高效串行数据传输。然而，在调用HAL_UART_Transmit_DMA()后，开发者常面临无法及时感知DMA传输结束的问题。

典型故障现象包括：

• DMA通道未释放，重复启动导致HardFault
• 缓冲区被提前覆盖，造成数据错乱
• 连续帧发送时序紊乱，引发接收端解析失败
• TC（Transfer Complete）中断未触发，回调函数未执行

这些问题根源在于对DMA传输完成事件的检测机制理解不深或实现不当。

2. 基础原理：DMA与串口协同工作机制

DMA控制器在STM32中独立于CPU运行，当调用HAL_UART_Transmit_DMA()时，UART外设会请求DMA从指定内存地址搬运数据至TX寄存器，直至计数器归零。

DMA传输完成的关键标志位位于DMA状态寄存器中：

标志位	含义	对应中断
TCIFx	传输完成中断标志	TC中断
HTIFx	半传输中断标志	HT中断
TEIFx	传输错误中断标志	TE中断

其中，TCIF是判断发送完成的核心依据。

3. 软件层面的三种主流检测方法

1. 中断回调机制：通过重写HAL_UART_TxCpltCallback()
2. 轮询计数器：使用__HAL_DMA_GET_COUNTER()查询剩余字节数
3. 事件标志同步：结合FreeRTOS信号量或事件组进行任务同步

4. 中断回调实现详解

void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)
{
    if (huart->Instance == USART1) {
        // 标记发送完成
        tx_complete_flag = 1;
        
        // 可在此处启动下一批数据发送
        // HAL_UART_Transmit_DMA(&huart1, next_buffer, size);
    }
}

注意：必须确保NVIC中DMA中断已使能，且优先级配置合理，避免中断被阻塞。

5. 轮询方式的适用场景与代码示例

在无操作系统或中断不可靠环境下，可采用轮询DMA剩余计数器方式：

uint8_t wait_dma_completion(UART_HandleTypeDef *huart, uint32_t timeout_ms)
{
    uint32_t start = HAL_GetTick();
    while (__HAL_DMA_GET_COUNTER(huart->hdmatx) != 0) {
        if ((HAL_GetTick() - start) > timeout_ms) {
            return HAL_TIMEOUT;
        }
        HAL_Delay(1); // 小延时避免CPU满载
    }
    return HAL_OK;
}

6. 多帧连续发送的高级控制策略

为避免总线冲突和数据覆盖，推荐采用双缓冲+环形队列管理：

graph TD
    A[准备数据帧] --> B{缓冲区空闲?}
    B -- 是 --> C[启动DMA发送]
    B -- 否 --> D[加入发送队列]
    C -- DMA TC中断 --> E[释放缓冲区]
    E --> F[从队列取下一帧]
    F -- 存在 --> C
    F -- 无 --> G[等待新数据]

7. 常见陷阱与调试建议

• 忘记使能DMA中断：需调用__HAL_DMA_ENABLE_IT()
• 回调函数命名错误：必须为HAL_UART_TxCpltCallback
• DMA缓冲区位于栈上，函数退出后失效
• 未处理DMA传输错误（如TEIF置位）
• 在回调中再次调用HAL_UART_Transmit_DMA()前未检查状态

8. 系统级优化：结合RTOS的任务调度

在FreeRTOS环境中，可通过信号量实现发送完成通知：

void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)
{
    if (huart == &huart1) {
        xSemaphoreGiveFromISR(tx_sem, NULL);
    }
}

// 发送任务中
HAL_UART_Transmit_DMA(&huart1, buf, len);
xSemaphoreTake(tx_sem, portMAX_DELAY); // 阻塞等待完成

9. 硬件层注意事项

DMA传输可靠性还受以下硬件因素影响：

项目	建议值	说明
DMA优先级	Medium/High	避免被其他DMA抢占
内存对齐	32位对齐	提升DMA效率
缓冲区位置	SRAM1或CCM	避免Flash访问延迟

10. 综合诊断流程图

graph LR
    Start[调用HAL_UART_Transmit_DMA] --> Check1{DMA是否忙?}
    Check1 -- 忙 --> Err[返回BUSY状态]
    Check1 -- 空闲 --> Launch[启动DMA传输]
    Launch --> Wait[等待完成事件]
    Wait -- 中断方式 --> ISR[TC中断触发]
    ISR --> Callback[执行TxCpltCallback]
    Wait -- 轮询方式 --> Poll[循环读取DMA_CNDTR]
    Poll -- 计数为0 --> Done
    Callback --> Done[传输完成]
    Done --> Next[处理后续逻辑]