STM32 HAL库串口DMA发送卡死？别慌，三步排查搞定HAL_UART_Transmit_DMA只能发一次

STM32 HAL库串口DMA发送卡死问题深度排查指南

最近在调试STM32的UART DMA发送功能时，遇到了一个典型问题：第一次调用HAL_UART_Transmit_DMA()发送数据正常，但第二次调用时程序就卡住了。这让我不得不深入HAL库内部机制，最终找到了问题的根源。下面我将分享完整的排查思路和解决方案，帮助遇到类似问题的开发者快速定位。

1. 问题现象与初步分析

当使用STM32CubeMX配置UART+DMA发送时，很多开发者会遇到这样的场景：

// 第一次发送 - 工作正常 HAL_UART_Transmit_DMA(&huart1, buffer1, sizeof(buffer1)); // 第二次发送 - 数据发不出去，程序卡住 HAL_UART_Transmit_DMA(&huart1, buffer2, sizeof(buffer2));

这种现象的根本原因在于HAL库的状态机管理机制。HAL库为每个外设维护了状态变量（gState和RxState），而DMA传输也有自己的状态标志。当这些状态没有正确复位时，后续的传输请求就会被拒绝。

2. 关键排查步骤

2.1 检查CubeMX DMA配置

在CubeMX中配置DMA时，有几个关键选项需要注意：

特别注意：默认情况下CubeMX会勾选"NVIC Settings"中的DMA中断使能。这个选项控制着DMA流中断的全局开关，建议保持启用状态。

2.2 验证中断配置

正确的DMA发送需要以下中断协同工作：

1. 串口全局中断：在CubeMX的NVIC配置中启用USARTx全局中断
2. DMA流中断：确保对应DMA流的全局中断已启用
3. DMA传输完成中断：通过HAL_DMA_Start_IT()自动配置

可以通过检查stm32xxxx_hal_msp.c文件确认中断配置：

void HAL_UART_MspInit(UART_HandleTypeDef* huart) { // ... 其他初始化代码 /* 启用DMA流中断 */ HAL_NVIC_SetPriority(DMA2_Stream7_IRQn, 0, 0); HAL_NVIC_EnableIRQ(DMA2_Stream7_IRQn); /* 启用USART全局中断 */ HAL_NVIC_SetPriority(USART1_IRQn, 0, 0); HAL_NVIC_EnableIRQ(USART1_IRQn); }

2.3 分析HAL库状态机

HAL库使用两个关键状态变量管理UART传输：

typedef struct __UART_HandleTypeDef { // ... __IO HAL_UART_StateTypeDef gState; /* UART通信状态 */ __IO HAL_UART_StateTypeDef RxState; /* UART接收状态 */ // ... } UART_HandleTypeDef;

当调用HAL_UART_Transmit_DMA()时，库函数会检查gState是否为HAL_UART_STATE_READY。如果不是，函数会立即返回错误。

状态转换流程：

1. 开始传输：HAL_UART_STATE_READY→HAL_UART_STATE_BUSY_TX
2. 传输完成：HAL_UART_STATE_BUSY_TX→HAL_UART_STATE_READY

如果传输完成后状态没有正确恢复，后续传输就会失败。

3. 根本原因与解决方案

3.1 问题根源分析

通过跟踪HAL库源代码，发现问题的核心在于：

1. DMA传输完成后，回调函数UART_DMATransmitCplt()会禁用DMA请求
2. 但串口传输完成中断UART_EndTransmit_IT()可能没有被触发
3. 导致gState保持HAL_UART_STATE_BUSY_TX状态

3.2 完整解决方案

确保以下三个条件同时满足：

1. 启用串口传输完成中断： 在CubeMX中配置USART时，确保"Transmission Complete Interrupt"已启用

2. 正确实现回调函数：

   void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart) { // 可以在这里处理传输完成事件 }

3. 必要时手动重置状态（临时解决方案）：

   if(huart1.gState != HAL_UART_STATE_READY) { huart1.gState = HAL_UART_STATE_READY; } HAL_UART_Transmit_DMA(&huart1, buffer, length);

3.3 推荐的最佳实践

1. 使用最新版HAL库：ST会不断修复已知问题
2. 完整的中断配置：

   // 在main()中调用 __HAL_UART_ENABLE_IT(&huart1, UART_IT_TC);

3. 错误处理机制：

   HAL_StatusTypeDef status = HAL_UART_Transmit_DMA(&huart1, buf, len); if(status != HAL_OK) { // 处理错误 }

4. 深入HAL库工作机制

理解HAL库的内部机制有助于更好地调试问题：

4.1 DMA传输流程

1. HAL_UART_Transmit_DMA()调用序列：

   • 检查状态
   • 设置DMA参数
   • 启动DMA传输
   • 启用UART DMA请求

2. DMA传输完成时：

   • 触发DMA中断
   • 调用UART_DMATransmitCplt()
   • 禁用DMA请求

4.2 状态机关键点

UART状态转换：

graph LR A[READY] -->|Transmit_DMA| B[BUSY_TX] B -->|TxComplete| A B -->|Error| C[ERROR] C -->|Init| A

常见问题场景：

• 传输完成中断未触发 → 状态卡在BUSY_TX
• DMA错误导致状态变为ERROR
• 中断优先级冲突导致事件丢失

4.3 调试技巧

1. 检查状态变量：

   printf("UART State: %d\n", huart1.gState); printf("DMA State: %d\n", hdma_usart1_tx.State);

2. 使用断点跟踪：

   • 在HAL_UART_Transmit_DMA()入口设置断点
   • 在UART_DMATransmitCplt()设置断点
   • 在UART_EndTransmit_IT()设置断点

3. 逻辑分析仪验证：

   • 监控USART TX引脚
   • 检查DMA请求信号

5. 进阶话题与性能优化

5.1 双缓冲技术

对于高速数据传输，可以采用双缓冲技术：

uint8_t buffer1[256], buffer2[256]; volatile int active_buffer = 0; void DMA_IRQHandler() { if(active_buffer == 0) { // 填充buffer2 HAL_UART_Transmit_DMA(&huart1, buffer2, sizeof(buffer2)); active_buffer = 1; } else { // 填充buffer1 HAL_UART_Transmit_DMA(&huart1, buffer1, sizeof(buffer1)); active_buffer = 0; } }

5.2 DMA循环模式

对于持续数据流，可以使用循环模式：

// 在CubeMX中配置DMA为Circular模式 hdma_usart1_tx.Init.Mode = DMA_CIRCULAR; // 启动传输 HAL_UART_Transmit_DMA(&huart1, buffer, sizeof(buffer));

注意事项：

• 需要更大的缓冲区
• 需要手动管理数据更新
• 不适合精确控制的数据包传输

5.3 性能调优参数

在实际项目中，遇到DMA传输问题不要慌张，按照状态机、中断配置、硬件连接这三个维度系统排查，通常都能快速定位问题根源。