STM32 串口中断接收方式笔记：HAL_UART_Receive_IT vs __HAL_UART_ENABLE_IT

📘 STM32 串口中断接收方式笔记：HAL_UART_Receive_IT vs __HAL_UART_ENABLE_IT

🧠 1. 两者作用简述

🔧 2. HAL_UART_Receive_IT() 的工作机制

HAL_UART_Receive_IT(&huart1, rx_buf, 10);

• 作用：启动一个“异步接收任务”，要求 HAL 接收 10 个字节 存入 rx_buf 中。
• 内部做了以下几件事：
  1. 设置接收缓冲区指针 huart->pRxBuffPtr
  2. 设置接收长度 huart->RxXferSize
  3. 状态切换为 BUSY_RX
  4. 使能 RXNE 中断
• 当 HAL 中断服务函数 HAL_UART_IRQHandler() 检测到接收到的数据后，会自动读取数据放入缓冲区，直到接收满为止。
• 满足接收条件后，会自动调用：

  void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart);
  

注意：接收完成后，不会自动重新启动接收，需要你手动再次调用 HAL_UART_Receive_IT()。

⚠️ 3. 使用 __HAL_UART_ENABLE_IT() 的注意事项

__HAL_UART_ENABLE_IT(&huart1, UART_IT_RXNE);

• 只是打开了 USART1 的接收中断 RXNE。
• 并不会设置 HAL 的接收状态、缓冲区等内部变量。
• 如果你还调用了 HAL_UART_IRQHandler()，会因 HAL 状态未准备好，导致：
  • 中断进来了
  • RXNE 置位
  • HAL 不消费数据
  • RXNE 不会被清除
  • 中断一直触发 → 卡死！

✅ 正确用法对比

✅ 【方式1】HAL自动管理方式（推荐新手/结构清晰）

// 初始化接收任务
HAL_UART_Receive_IT(&huart1, rx_buf, 1);

// 实现接收完成回调
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
    if (huart->Instance == USART1) {
        // 处理数据 rx_buf[0]
        HAL_UART_Receive_IT(&huart1, rx_buf, 1);  // 继续接收
    }
}

✅ 【方式2】裸中断方式（适合自定义接收流程）

// 手动使能接收中断
__HAL_UART_ENABLE_IT(&huart1, UART_IT_RXNE);

void USART1_IRQHandler(void)
{
    if (__HAL_UART_GET_FLAG(&huart1, UART_FLAG_RXNE)) {
        uint8_t ch = (uint8_t)(huart1.Instance->RDR);
        // 自定义缓冲区存储、协议解析等
    }
}

🔄 4. 总结对比表

🧪 5. 常见问题