STM32-HAL库串口DMA空闲中断的正确使用方式+解析SBUS信号

  • 一. 问题描述
  • 二. 方法一——使用HAL_UART_Receive_DMA
  • 三. 方法二——使用HAL_UARTEx_ReceiveToIdle_DMA
  • 四. 方法三——使用HAL_UARTEx_ReceiveToIdle_IT（不使用DMA）
  • 五. 总结

一. 问题描述

能够点进这篇文章的小伙伴肯定是对STM32串口DMA空闲中断接收数据感兴趣的啦，今天用这一功能实现串口解析航模遥控器sbus信号时，查阅了很多网友发布的文章（勤劳的搬运工~），包括自己之前写过一篇博客 STM32_HAL库_CubeMx串口DMA通信（DMA发送+DMA空闲接收不定长数据）。本文进一步梳理一下HAL库串口空闲中断三种不同的使用方式，其中前两种使用DMA方式，最后一种使用HAL库自带的空闲中断机制。

本文环境：

  • Keil MDK5.14
  • STM32CubeMX6.2.1
  • 开发板/芯片：自制板/STM32F407ZGT6

实现功能：

  • 串口DMA/非DMA空闲中断接收不定长数据/解析航模遥控器SBUS信号

二. 方法一——使用HAL_UART_Receive_DMA

最常见的方法就是使用HAL_StatusTypeDef HAL_UART_Receive_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)这个库函数，其使用方法类似于HAL_StatusTypeDef HAL_UART_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)，初始化时需要调用一次，然后每次在中断服务函数里面处理完数据后重新调用一次。

使用HAL_UART_Receive_IT只需要打开串口接收中断，即HAL_NVIC_EnableIRQ(UART5_IRQn);

使用HAL_UART_Receive_DMA空闲中断需要在初始化时打开串口空闲中断使能，调用方式为：__HAL_UART_ENABLE_IT(&huart2, UART_IT_IDLE)。

此时DMA中断可开可不开，开了也不用管，因为数据处理是在串口空闲中断中进行的。

1. 串口初始化代码：

void MX_USART2_UART_Init(void){huart2.Instance = USART2;huart2.Init.BaudRate = 100000;huart2.Init.WordLength = UART_WORDLENGTH_9B;huart2.Init.StopBits = UART_STOPBITS_1;huart2.Init.Parity = UART_PARITY_EVEN;huart2.Init.Mode = UART_MODE_TX_RX;huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE;huart2.Init.OverSampling = UART_OVERSAMPLING_16;if (HAL_UART_Init(&huart2) != HAL_OK){Error_Handler();}__HAL_UART_ENABLE_IT(&huart2, UART_IT_IDLE);// 开启串口空闲中断，必须调用HAL_UART_Receive_DMA(&huart2,USART2_RX_BUF,USART_REC_LEN);// 启动DMA接收}void HAL_UART_MspInit(UART_HandleTypeDef* uartHandle){if(uartHandle->Instance==USART2){ __HAL_RCC_USART2_CLK_ENABLE(); __HAL_RCC_GPIOA_CLK_ENABLE();GPIO_InitStruct.Pin = GPIO_PIN_2|GPIO_PIN_3; GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH; GPIO_InitStruct.Alternate = GPIO_AF7_USART2; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); hdma_usart2_rx.Instance = DMA1_Stream5; hdma_usart2_rx.Init.Channel = DMA_CHANNEL_4; hdma_usart2_rx.Init.Direction = DMA_PERIPH_TO_MEMORY; hdma_usart2_rx.Init.PeriphInc = DMA_PINC_DISABLE; hdma_usart2_rx.Init.MemInc = DMA_MINC_ENABLE; hdma_usart2_rx.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE; hdma_usart2_rx.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE; hdma_usart2_rx.Init.Mode = DMA_NORMAL; hdma_usart2_rx.Init.Priority = DMA_PRIORITY_MEDIUM; hdma_usart2_rx.Init.FIFOMode = DMA_FIFOMODE_DISABLE; if (HAL_DMA_Init(&hdma_usart2_rx) != HAL_OK) { Error_Handler(); } __HAL_LINKDMA(uartHandle,hdmarx,hdma_usart2_rx); /* USART2 interrupt Init */ HAL_NVIC_SetPriority(USART2_IRQn, 0, 0); HAL_NVIC_EnableIRQ(USART2_IRQn);}}

初始化中调用__HAL_UART_ENABLE_IT(&huart2, UART_IT_IDLE)开启空闲中断，HAL_UART_Receive_DMA(&huart2,USART2_RX_BUF,USART_REC_LEN)启动DMA串口接收，USART2_RX_BUF是接收缓冲区，USART_REC_LEN是定义的DMA接收缓冲区长度，接收的数据不能超过这个长度。

2. 中断处理：

中断处理有两种方式，第一种是直接定义在void USART1_IRQHandler(void)中，第二种是自定义一个函数，然后在void USART1_IRQHandler(void)中调用。注意网上很多资源自定义了中断回调函数但代码又没贴全，读者可能以为是HAL库自带的回调函数，结果因为没有在void USART1_IRQHandler(void)中调用导致失败。

第一种形式——直接定义：

void USART2_IRQHandler(void){uint32_t tmp_flag ;u8 len;u8 data[25];tmp_flag= __HAL_UART_GET_FLAG(&huart2, UART_FLAG_IDLE);if( tmp_flag!= RESET){__HAL_UART_CLEAR_IDLEFLAG(&huart2);//清除标志位HAL_UART_DMAStop(&huart2); //停止DMA接收，防止数据出错len = USART_REC_LEN - __HAL_DMA_GET_COUNTER(&hdma_usart2_rx);// 获取DMA中传输的数据个数// 以下为用户数据处理，将数据拷贝出去if(len == 25){memcpy(data,USART2_RX_BUF,len);update_sbus(data);}HAL_UART_Receive_DMA(&huart2,USART2_RX_BUF,USART_REC_LEN); //打开DMA接收，数据存入rx_buffer数组中。}HAL_UART_IRQHandler(&huart2); //调用HAL库中断处理公用函数}

第二种形式——自定义回调函数：

void HAL_UART_IdleCpltCallback(UART_HandleTypeDef *huart){uint32_t tmp_flag ;u8 len;u8 data[25];if (huart->Instance == USART2){tmp_flag= __HAL_UART_GET_FLAG(huart, UART_FLAG_IDLE);if( tmp_flag!= RESET){__HAL_UART_CLEAR_IDLEFLAG(huart);//清除标志位HAL_UART_DMAStop(huart); //停止DMA接收len = USART_REC_LEN - __HAL_DMA_GET_COUNTER(&hdma_usart2_rx);// 获取DMA中传输的数据个数// 以下为用户数据处理，将数据拷贝出去if(len == 25){memcpy(data,USART2_RX_BUF,len);update_sbus(data);}HAL_UART_Receive_DMA(huart,USART2_RX_BUF,USART_REC_LEN); //打开DMA接收，数据存入rx_buffer数组中。}}}void USART2_IRQHandler(void){HAL_UART_IdleCpltCallback(&huart2)HAL_UART_IRQHandler(&huart2); //调用HAL库中断处理公用函数}

再次提醒一下，HAL库中并没有类似void HAL_UART_IdleCpltCallback(UART_HandleTypeDef *huart)这样的回调函数，大家不要看到了以为是自带的回调函数而不在void USART2_IRQHandler(void)中调用而导致失败。

中断处理中的函数说明：
__HAL_UART_GET_FLAG(huart, UART_FLAG_IDLE)：返回中断标志位，产生空闲中断后会返回1；
__HAL_UART_CLEAR_IDLEFLAG(&huart2)：清除空闲中断标志位，必须调用；
HAL_UART_DMAStop(&huart2)：停止DMA接收，防止数据处理出错，数据处理完成后重新打开；
__HAL_DMA_GET_COUNTER(&hdma_usart2_rx)：返回DMA中未传输的数据量，用缓冲区总长减去未传输数量就是已接收的数据长度；
HAL_UART_Receive_DMA(huart,USART2_RX_BUF,USART_REC_LEN)：重新打开DMA接收。

以上就能成功实现不定长数据的接受了，其实只要步骤对了还是很简单的。

三. 方法二——使用HAL_UARTEx_ReceiveToIdle_DMA

第二种方式是使用HAL_StatusTypeDef HAL_UARTEx_ReceiveToIdle_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)这个库函数，并重定义void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)这个中断回调函数。

Attention：__weak void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)是正儿八经的库函数（弱函数），不是自定义的，我们可以重定义它。

使用这个库函数，串口初始化代码中就不需要调用__HAL_UART_ENABLE_IT(&huart2, UART_IT_IDLE)了，因为HAL_UARTEx_ReceiveToIdle_DMA函数内部已经打开了空闲中断，当然你加上也没事。

1. 串口初始化代码：

void MX_USART2_UART_Init(void){huart2.Instance = USART2;huart2.Init.BaudRate = 100000;huart2.Init.WordLength = UART_WORDLENGTH_9B;huart2.Init.StopBits = UART_STOPBITS_1;huart2.Init.Parity = UART_PARITY_NONE;huart2.Init.Mode = UART_MODE_TX_RX;huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE;huart2.Init.OverSampling = UART_OVERSAMPLING_16;if (HAL_UART_Init(&huart2) != HAL_OK){Error_Handler();}//__HAL_UART_ENABLE_IT(&huart2, UART_IT_IDLE);// 开启串口空闲中断，可省略HAL_UARTEx_ReceiveToIdle_DMA(&huart2,USART2_RX_BUF,USART_REC_LEN);// 使用串口DMA空闲中断,会自动开启空空闲中断}void HAL_UART_MspInit(UART_HandleTypeDef* uartHandle){if(uartHandle->Instance==USART2){ __HAL_RCC_USART2_CLK_ENABLE(); __HAL_RCC_GPIOA_CLK_ENABLE();GPIO_InitStruct.Pin = GPIO_PIN_2|GPIO_PIN_3; GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH; GPIO_InitStruct.Alternate = GPIO_AF7_USART2; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); hdma_usart2_rx.Instance = DMA1_Stream5; hdma_usart2_rx.Init.Channel = DMA_CHANNEL_4; hdma_usart2_rx.Init.Direction = DMA_PERIPH_TO_MEMORY; hdma_usart2_rx.Init.PeriphInc = DMA_PINC_DISABLE; hdma_usart2_rx.Init.MemInc = DMA_MINC_ENABLE; hdma_usart2_rx.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE; hdma_usart2_rx.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE; hdma_usart2_rx.Init.Mode = DMA_NORMAL; hdma_usart2_rx.Init.Priority = DMA_PRIORITY_MEDIUM; hdma_usart2_rx.Init.FIFOMode = DMA_FIFOMODE_DISABLE; if (HAL_DMA_Init(&hdma_usart2_rx) != HAL_OK) { Error_Handler(); } __HAL_LINKDMA(uartHandle,hdmarx,hdma_usart2_rx); /* USART2 interrupt Init */ HAL_NVIC_SetPriority(USART2_IRQn, 0, 0); HAL_NVIC_EnableIRQ(USART2_IRQn);}}

这里__HAL_UART_ENABLE_IT(&huart2, UART_IT_IDLE)是可省略的，HAL_UARTEx_ReceiveToIdle_DMA(&huart2,USART2_RX_BUF,USART_REC_LEN)启动DMA串口空闲中断接收，USART2_RX_BUF是接收缓冲区，USART_REC_LEN是定义的DMA接收缓冲区长度，接收的数据不能超过这个长度。

2. 中断处理：

中断处理定义在void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)这个中断回调函数中。

void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size){u8 len;u8 data[25];if(huart->Instance == USART2){HAL_UART_DMAStop(huart);len = USART_REC_LEN - __HAL_DMA_GET_COUNTER(&hdma_usart2_rx);// 获取DMA中传输的数据个数if (USART2_RX_BUF[0] == 0x0F && len == 25)//接受完一帧数据{memcpy(data,USART2_RX_BUF,len);update_sbus(data);}HAL_UARTEx_ReceiveToIdle_DMA(&huart2,USART2_RX_BUF,USART_REC_LEN);// 再次开启DMA空闲中断}}void USART2_IRQHandler(void){HAL_UART_IRQHandler(&huart2); //调用HAL库中断处理公用函数}

当然也可以像方法一种一样，中断逻辑处理直接定义在void USART2_IRQHandler(void)中。

四. 方法三——使用HAL_UARTEx_ReceiveToIdle_IT（不使用DMA）

这种方法参考这篇文章： STM32 hal库串口空闲中断最新用法

使用方法：
1、在主函数中调用HAL_UARTEx_ReceiveToIdle_IT(）
2、在回调函数HAL_UARTEx_RxEventCallback()中做中断逻辑处理。

这里我换用串口4，实现上位机发送，单片机原封不动返回数据。

1. 串口初始化代码：

void MX_UART4_Init(void){huart4.Instance = UART4;huart4.Init.BaudRate = 115200;huart4.Init.WordLength = UART_WORDLENGTH_8B;huart4.Init.StopBits = UART_STOPBITS_1;huart4.Init.Parity = UART_PARITY_NONE;huart4.Init.Mode = UART_MODE_TX_RX;huart4.Init.HwFlowCtl = UART_HWCONTROL_NONE;huart4.Init.OverSampling = UART_OVERSAMPLING_16;if (HAL_UART_Init(&huart4) != HAL_OK){Error_Handler();}// HAL_UARTEx_ReceiveToIdle_IT同时开启空闲中断，开启接收HAL_UARTEx_ReceiveToIdle_IT(&huart4,USART4_RX_BUF,USART_REC_LEN);}void HAL_UART_MspInit(UART_HandleTypeDef* uartHandle){if(uartHandle->Instance==UART4){ __HAL_RCC_UART4_CLK_ENABLE();__HAL_RCC_GPIOC_CLK_ENABLE();GPIO_InitStruct.Pin = GPIO_PIN_10|GPIO_PIN_11;GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;GPIO_InitStruct.Pull = GPIO_PULLUP;GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;GPIO_InitStruct.Alternate = GPIO_AF8_UART4;HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);HAL_NVIC_SetPriority(UART4_IRQn, 0, 0);HAL_NVIC_EnableIRQ(UART4_IRQn);}}

可以看到这里是没有使用DMA的，初始化中调用了HAL_UARTEx_ReceiveToIdle_IT(&huart4,USART4_RX_BUF,USART_REC_LEN)来开启串口4的空闲中断，USART4_RX_BUF是接收缓冲区，USART_REC_LEN是缓冲区的长度。这里可以看下库中HAL_UARTEx_ReceiveToIdle_IT的定义和提示：

框1的地方说，这个函数用于在中断模式下接收一定量数据，直到指定的数据长度被接收到或者空闲中断产生。也就是说，如果USART_REC_LEN定义很小，还没到产生空闲中断，接收就会完成。

框2的地方，即是打开串口空闲中断。所以不需要额外再去开启空闲中断了。

2. 中断处理：

中断处理定义在void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)这个中断回调函数中。注意到，和使用DMA传输时是同一个回调函数。

void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size){u8 len=0;u8 data[25];u8 uart4_len=0;u8 uart4_data[50];if(huart->Instance == USART2){HAL_UART_DMAStop(huart);len = USART_REC_LEN - __HAL_DMA_GET_COUNTER(&hdma_usart2_rx);// 获取DMA中传输的数据个数if (USART2_RX_BUF[0] == 0x0F && len == 25)//接受完一帧数据{memcpy(data,USART2_RX_BUF,len);update_sbus(data);}HAL_UARTEx_ReceiveToIdle_DMA(&huart2,USART2_RX_BUF,USART_REC_LEN);// 再次开启DMA空闲中断}if(huart->Instance == UART4){while (USART4_RX_BUF[uart4_len] != '\0')uart4_len++;memcpy(uart4_data,USART4_RX_BUF,uart4_len);HAL_UART_Transmit(&huart4,uart4_data,uart4_len,0xff);// 调用printf是使用串口1printf("data: %s\r\n", uart4_data);printf("data length: %d\r\n", uart4_len);memset(USART4_RX_BUF, 0, USART_REC_LEN); memset(uart4_data, 0, sizeof(uart4_data)); HAL_UARTEx_ReceiveToIdle_IT(&huart4,USART4_RX_BUF,USART_REC_LEN);}}void USART2_IRQHandler(void){HAL_UART_IRQHandler(&huart2); //调用HAL库中断处理公用函数}void UART4_IRQHandler(void){HAL_UART_IRQHandler(&huart4); //调用HAL库中断处理公用函数}

回调函数中就是读取USART4_RX_BUF缓冲区的数据和数据长度，然后做相应处理，这里只是简单的原数据发送回去，如果是SBSU信号或Modbus或其他带协议帧的数据，则可根据帧头帧尾、数据长度、校验位等做进一步处理。

最终实现的效果就是上位机发送什么，单片机返回什么，如图：

五. 总结

以上三种方式都能实现串口空闲中断接收不定长数据，适合用于处理不定长数据接收、减少CPU负担，相比较而言，方法三不使用DMA，使用上更简洁。方法一、二使用DMA，好处是可以减少CPU负担。