STM32 HAL库中串口空闲中断+DMA 实现串口数据的不定长接收

阅读原文时间：2021年04月20日阅读：1

本文开发环境：

MCU型号：STM32F051R8T6

IDE环境： MDK 5.25

代码生成工具：STM32CubeMx 5.2.0

HAL库版本：v1.10.0（STM32Cube MCU Package for STM32F0 Series）

本文内容：

不定长数据接收的原理

串口接收中断的配置

串口接收DMA线的配置

示例程序及起运行流程

附件：代码工程（MDK）

重要提示：

由于本文运行的硬件环境预留了BootLoader，固工程的地址做了对应的偏移，若需要使用附件工程，请读者自行修改，否则直接下载会无法运行：

此处请根据具体工程改正，若不清楚值，请直接参考其他可以正常运行的工程。

勘误

自定义的 void USER_UART_IRQHandler(UART_HandleTypeDef *huart)函数是所有串口中断都会调用的函数，其函数内判断具体某个串口发生中断时，原判断语句if(USART1 == huart1.Instance)有误, 此处应写 if(huart->Instance == USART1)，感谢评论区m0_37204608 指正。

文章目录

* * 重要提示：
* 勘误
一、不定长数据接收的原理及其解决的问题
二、STM32CubeMx 中 UART 和 DMA 的配置
* 1. UART 的配置
- * 1.1 UART 基本参数的配置
三、编程步骤
四、程序示例
* 1. 开启串口空闲中断
- 2. 配置 DMA 接收
- 3. 添加中断处理函数和回调函数
附件

一、不定长数据接收的原理及其解决的问题

在 STM32 中，UART是最为常见的通信方式——它每次接收一个字节。我们可以使用轮询的方式，但是对于某些数据不固定时间发送的数据，轮询的方式有时候不够灵活。也可以使用中断的方式，如每一个字节都中断一次，当时比较消耗系统资源。特别是HAL库中，从中断到回调函数运行了不少的程序，频繁的中断很可能造成数据溢出。在本文使用F051单片机中，这种情更加明显。为了避免这个问题，我们使用指定接收一定长度的数据，再调用回调函数，这会让我们可以接收大数据，但是这种情况则造成了，要求每次的包是固定长度。为了解决以上一些问题，网上最常用的办法是使用空闲中断，即在串口空闲的时候，触发一次中断，通知内核，本次运输完成了。串口空闲中断的判定是：当串口开始接收数据后，检测到1字节数据的时间内没有数据发送，则认为串口空闲了。由于我们的内核在串口接收数据到空闲这段时间，是不受理串口数据的，所以我们还需要使用DMA来协助我们把数据传送到指定的地方，当数据传输完成后，通知内核去处理。

二、STM32CubeMx 中 UART 和 DMA 的配置

当然，这里省略了每一个工程都需要配置的系统时钟，晶振部分，如果你还不熟悉这些通用的配置或通过Cubemx建立一个工程，请参考：STM32CubeMx 初始化和读/写 IO口操作

1. UART 的配置

1.1 UART 基本参数的配置

首先需要配置串口的基本参数，波特率可根据实际情况设置，一般设置为115200bps，9600bps 等：

1.2 使能串口 NVIC 中断并生成代码

接着需要使能中断，让串口内核可以相应串口的中断：

注意，这里还要配置NVIC生成代码，否则中断无法正常响应：

1.3 DMA 的配置

接着配置DMA，让DMA和串口接收联系起来，实现DMA串口数据的运输，记得切换回USART1选项。

1.4 配置串口 IO 口模式

某些电路可能已经配置有了外部上拉，本文在默认的模式下也可以通信，但为了保证更稳定的电平，这里配置为上拉输入：

至此，我们已经把串口，以及和串口相关的NVIC和DMA配置完毕，接下来就可以开始程序的实现了。

三、编程步骤

开启串口空闲中断：在程序初始化时候，使能串口中断
定义串口空闲中断处理函数：在串口中断中添加串口空间中断处理函数
定义串口空闲中断回调函数：用以标记数据接收完成，计算接收到数据的长度

四、程序示例

首先，我们在初始化的时候，使能串口空闲中断，让串口在中断的时候，MCU可以调用串口中断函数：

1. 开启串口空闲中断

File main.c :

... ...
void main(void)
{
    .. ...
    __HAL_UART_ENABLE_IT(&huart1, UART_IT_IDLE);
    while(1)
    {
    .. ..
    }
}
... ...

当添加这个函数到工程以后，每发送一次数据，都会调用一次USART1_IRQHandler()函数，你可以在该函数中插入打印语句，来验证是否空闲中断正常。

2. 配置 DMA 接收

虽然我们使用的CubeMx来配置DMA，但只是配置DMA模式为串口到内存，所以还需要在程序中进一步指定：DMA具体搬运到内存的哪一个位置中，我们建立一个数组用以存放DMA搬运的串口数据，并使用HAL_UART_Receive_DMA()函数来配置，具体代码如下所示：
File main.c :

... ...
uint8_t receive_buff[255];                //定义接收数组
... ...
void main(void)
{
    .. ...
    __HAL_UART_ENABLE_IT(&huart1, UART_IT_IDLE);
    HAL_UART_Receive_DMA(&huart1, (uint8_t*)receive_buff, 255);     //设置DMA传输，讲串口1的数据搬运到recvive_buff中，
                                                                    //每次255个字节
    while(1)
    {
    .. ..
    }
}
... ...

注意：由于main.c 和 usart.c 中都需要用到数组的大小，所以在uart.h 中进行定义

File usart.h ：

... ...
#define  BUFFER_SIZE  (255)
... ...

3. 添加中断处理函数和回调函数

CubeMx 按上述操作后，生成的工程中，已经有了串口中断的处理函数 HAL_UART_IRQHandler()，但是其里面未发现该函数中对空闲中断的处理，所以我们额外添加一个函数： USER_UART_IRQHandler()，添加后完整代码如下：

File stm32f0xx_it.c :

void USART1_IRQHandler(void)
{
    /* USER CODE BEGIN USART1_IRQn 0 */
    /* USER CODE END USART1_IRQn 0 */

    HAL_UART_IRQHandler(&huart1);

    /* USER CODE BEGIN USART1_IRQn 1 */
    USER_UART_IRQHandler(&huart1);                                //新添加的函数，用来处理串口空闲中断
    /* USER CODE END USART1_IRQn 1 */
}

当然，还需要对该函数进行定义。
File usart.c:

void USER_UART_IRQHandler(UART_HandleTypeDef *huart)
{
    if(USART1 == huart1.Instance)                                   //判断是否是串口1（！此处应写(huart->Instance == USART1)
    {
        if(RESET != __HAL_UART_GET_FLAG(&huart1, UART_FLAG_IDLE))   //判断是否是空闲中断
        {
            __HAL_UART_CLEAR_IDLEFLAG(&huart1);                     //清楚空闲中断标志（否则会一直不断进入中断）
            printf("\r\nUART1 Idle IQR Detected\r\n");
            USAR_UART_IDLECallback(huart);                          //调用中断处理函数
        }
    }
}

至此，我们已经可以正常的响应串口中断，并调用了一个新的函数：USAR_UART_IDLECallback()，它是专门用来处理空闲中断的一个回调函数，其定义如下（写在 usart.c 文件即可）：

extern uint8_t receive_buff[255];                                                  //声明外部变量 
void USAR_UART_IDLECallback(UART_HandleTypeDef *huart)
{
    HAL_UART_DMAStop(&huart1);                                                     //停止本次DMA传输

    uint8_t data_length  = BUFFER_SIZE - __HAL_DMA_GET_COUNTER(&hdma_usart1_rx);   //计算接收到的数据长度

    printf("Receive Data(length = %d): ",data_length);
    HAL_UART_Transmit(&huart1,receive_buff,data_length,0x200);                     //测试函数：将接收到的数据打印出去
    printf("\r\n");

    memset(receive_buff,0,data_length);                                            //清零接收缓冲区
    data_length = 0;
    HAL_UART_Receive_DMA(&huart1, (uint8_t*)receive_buff, 255);                    //重启开始DMA传输 每次255字节数据
}

关于计算数据长度可以具体了解HAL库函数的操作，简单来说__HAL_DMA_GET_COUNTER()函数将返回待接收的数据。将设置需要接收的数据长度，减去待接收的数据，就得到了已经接收到的数据。

至此，我们使用了DMA+串口空闲中断的方式来实现不定长数据的接收。