STM32 HAL_UART_Receive_IT接收异常："off"指令无法稳定识别

问题背景 #

使用STM32F429IDISC1开发板编写程序，通过UART接收终端发送的"on"和"off"字符串控制LED开关。发送"on"能正常识别并点亮LED，但发送"off"时经常无法完整接收，仅打印最后一个字符，导致LED无法关闭，需多次发送才成功。原代码使用HAL_UART_Receive_IT中断接收，但问题仍存在。

原代码：

int main(void)
{
  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_USART1_UART_Init();
  /* USER CODE BEGIN 2 */
  //uint8_t data;
  uint8_t LED_status = GPIO_PIN_RESET;
  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  char buffer[5];
  while (1)
  {
        HAL_UART_Receive_IT(&huart1, (uint8_t *) buffer, 5);
        printf("Received buffer: %s\r\n", buffer);
        if (strncmp(buffer, "on", 2U) == 0 && LED_status == GPIO_PIN_RESET)
        {
            HAL_GPIO_WritePin(USER_LED_GPIO_Port, USER_LED_Pin, GPIO_PIN_SET);
            LED_status = GPIO_PIN_SET;
            printf("LED turned on\r\n");
        } else if (strncmp(buffer, "off", 3U) == 0 && LED_status == GPIO_PIN_SET)
        {
            HAL_GPIO_WritePin(USER_LED_GPIO_Port, USER_LED_Pin, GPIO_PIN_RESET);
            LED_status = GPIO_PIN_RESET;
            printf("LED turned off\r\n");
        }
        memset(buffer, 0, sizeof(buffer));
        HAL_Delay(1000);
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}

问题根源 #

HAL_UART_Receive_IT是非阻塞的中断模式接收函数，调用后仅开启UART接收中断，不会等待指定长度的数据接收完成就立刻返回。原代码存在以下错误：

• 调用HAL_UART_Receive_IT后立刻读取buffer处理，此时数据大概率未接收完整（尤其是"off"长度更长，接收耗时更久），导致只读到部分字符。
• HAL_Delay期间虽然中断会触发接收数据，但主循环的memset会在Delay结束后清空buffer，直接覆盖刚接收到的完整数据。
• 主循环每次迭代都重复调用HAL_UART_Receive_IT，会覆盖上一次未完成的接收请求，引发接收异常。

解决方案 #

正确的中断接收流程是：在主循环中初始开启一次接收中断，然后在**接收完成回调函数HAL_UART_RxCpltCallback**中处理数据，并重新开启下一次接收。

修改后的代码示例：

// 定义全局/静态变量，确保回调函数可访问
static char buffer[5];
static uint8_t LED_status = GPIO_PIN_RESET;

int main(void)
{
  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  HAL_Init();
  SystemClock_Config();
  MX_GPIO_Init();
  MX_USART1_UART_Init();

  /* USER CODE BEGIN 2 */
  // 初始开启一次中断接收，指定接收4个字节（适配"on\r\n"或"off\r\n"格式）
  HAL_UART_Receive_IT(&huart1, (uint8_t *)buffer, 4);
  /* USER CODE END 2 */

  /* Infinite loop */
  while (1)
  {
    // 主循环仅处理其他任务，无需重复调用接收函数
    HAL_Delay(100);
  }
}

// 实现UART接收完成回调函数
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
  if (huart->Instance == USART1)
  {
    printf("Received buffer: %s\r\n", buffer);

    // 处理"on"指令
    if (strncmp(buffer, "on", 2) == 0 && LED_status == GPIO_PIN_RESET)
    {
      HAL_GPIO_WritePin(USER_LED_GPIO_Port, USER_LED_Pin, GPIO_PIN_SET);
      LED_status = GPIO_PIN_SET;
      printf("LED turned on\r\n");
    }
    // 处理"off"指令
    else if (strncmp(buffer, "off", 3) == 0 && LED_status == GPIO_PIN_SET)
    {
      HAL_GPIO_WritePin(USER_LED_GPIO_Port, USER_LED_Pin, GPIO_PIN_RESET);
      LED_status = GPIO_PIN_RESET;
      printf("LED turned off\r\n");
    }

    // 清空buffer，准备下一次接收
    memset(buffer, 0, sizeof(buffer));
    // 重新开启下一次中断接收
    HAL_UART_Receive_IT(&huart1, (uint8_t *)buffer, 4);
  }
}

额外优化建议 #

为了提升命令接收的可靠性，建议用换行符（\r\n）作为命令结束标志，而非固定接收长度。可以改为逐字节接收，直到检测到换行符再处理命令，避免因终端发送格式差异导致的接收异常。

内容的提问来源于stack exchange，提问作者Nicolas Murcia