HAL库的串口基础学习（包含串口接收不定长数据的实现）

HAL库的串口基础学习（1）

HAL库有一个特点就是对于许多外设的初始化以及功能操作，都提供有一个weak版本的函数，这是充分的展现出库名字的含义（Hardware Abstraction Layer）硬件抽象层。
例如串口的HAL_UART_MspInit()函数和HAL_UART_MspDeInit()函数等，这些都可以供用户在需要时在stm32f1xx_hal_msp.c中进行重写实现功能。

用串口初始化来举例子，用Cube配置UART1使能并生成代码后可以看到有三个关键函数：

1、void MX_USART1_UART_Init(void)

这个函数是Cube配置完成后自动帮我们生成的，存在于用户文件usart.c中（如果Cube中有配置选项生成用户.c文件，否则在main函数中）。里面主要是将USART的结构体初始化成USART1以及我们设置好的参数），并且在最后有一个语句：if (HAL_UART_Init(&huart1) != HAL_OK)通过这个来调用HAL_UART_Init函数。

2、HAL_StatusTypeDef HAL_UART_Init(UART_HandleTypeDef *huart)

这个函数在HAL库文件stm32f1xx_hal_uart.c中，在上一个函数 MX_USART1_UART_Init(void)中有被调用，这个函数将初始化UART1，使能UART1，而重点是里面有调用一个函数HAL_UART_MspInit(huart)

3、__weak void HAL_UART_MspInit(UART_HandleTypeDef *huart)

这个函数也在HAL库文件stm32f1xx_hal_uart.c中，它是weak修饰的，也就是可以重写。我们发现在Cube生成的用户文件usart.c文件中有对这个函数进行重写，主要实现对UART1的TX、RX引脚的IO口配置，以及开启串口中断等设置。

由此，HAL库的串口外设初始化操作就清晰了，也就是说如果我们使用Cube生成代码，要完成对串口的初始化，就要自行对串口的结构体参数进行配置，并对HAL_UART_MspInit函数进行重写。到这里，也能看出HAL库的优越性，用户只需在msp.c中对要实现的函数进行重写，调用相关函数既可实现。

串口初始化完成后，下一步就是实现串口的收发数据，轮询发送很简单，这里主要研究下串口的中断接收，和中断接收有关的函数有下面几个：

1、HAL_StatusTypeDef HAL_UART_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)

函数有是三个参数，分别是串口结构体，要传输的数据指针以及待传输数据的大小，这其实是对中断接收的一个配置函数，指定当接收到Size大小的字节后就产生一次中断进入中断处理。
对比以前的库函数的串口接收协议，可以将这里的Size设置为1，也就是每次接收一个字节就产生一次中断，并将数据存储到pData指向的地址中。这就类似于库函数中的每次中断将数据赋值给临时变量res。需要注意的是，这个函数调用一次只适用于一次中断，如果要连续接收数据的话应该在重写函数中调用它。
如果数据定长接收的话也可以在设置中断时直接使用设置长度，如接收定长的size为8就可以设置HAL_UART_Receive_IT(&huart, &DataBuff, 8)设置后串口接收回调函数就在接收到8字节后进入。
如果串口接收的数据为不定长数据可以通过三种方法来实现，定时器和接收中断配合、DMA和串口中断配合、空闲中断实现。稍后会线介绍下空闲中断的实现方法。

2、USART1_IRQHandler(void)    和    HAL_UART_IRQHandler(&huart1)

第一个是在it.c中的通用的硬件中断入口函数，其中在里面调用了HAL_UART_IRQHandler(&huart1)，也就进入了UART1的中断处理，HAL_UART_IRQHandler函数在stm32f0xx_hal_uart.c文件中，主要进行中断标志的判定，当判定接收到数据时，调用UART_Receive_IT(huart)函数。

3、HAL_StatusTypeDef UART_Receive_IT(UART_HandleTypeDef *huart)

这个函数也在stm32f0xx_hal_uart.c中，这才是真正的处理数据的函数，读取接收寄存器，将数据赋值给结构体huart的pRxBuffer并清除中断标志，当接收数据完成并把串口的接收标志位huart->RxState = HAL_UART_STATE_READY;这个状态很重要，这个状态会直接影响下次中断的使能，因为在HAL_UART_Receive_IT函数中会对此状态进行判断成立时才会对中断进行使能。随后调用了一个函数HAL_UART_RxCpltCallback(huart);

4、__weak void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)

这个是用户真正可以进行重写实现自己所需功能的函数，在msp.c中将其重写。前面我们设置了参数使得每接收一个字节就产生中断，于是可以重写这个函数，在里面将每次接收到的数据存放在自己定义的UART1RXBuffer中。另外，上面有提到配置中断参数的函数 HAL_UART_Receive_IT()每次调用仅适用于一次中断，如果要实现连续采用中断接收数据，也要这个函数中调用HAL_UART_Receive_IT()。因为这个回调函数是每次中断发生都会调用，也就相当于每次发生中断处理完数据后又将中断打开，从而实现连续中断接收数据。
下面介绍一下利用空闲中断实现不定长数据的接收。
1、在HAL_UART_MspInit函数中使能中断。HAL_UART_Receive_IT( &huart1, aucUsart1RecBuff, DATA_FIRST_LEN );
DATA_FIRST_LEN 数据长度可以是接收数据缓冲区的大小，不用考虑接收数据的长度，只要保证此数值大于接收数据的可能长度即可。
2、在stm32f1xx_hal_uart.c文件中找到UART_Receive_IT函数（在接收到数据时会在HAL_UART_IRQHandler中调用）添加__HAL_UART_ENABLE_IT(huart,UART_IT_IDLE);

static HAL_StatusTypeDef UART_Receive_IT(UART_HandleTypeDef *huart)
{
  uint16_t* tmp;
  
  /* Check that a Rx process is ongoing */
  if(huart->RxState == HAL_UART_STATE_BUSY_RX) 
  {
    //Add for kong 20190106
    __HAL_UART_ENABLE_IT(huart,UART_IT_IDLE);
      
    if(huart->Init.WordLength == UART_WORDLENGTH_9B)
    {
      tmp = (uint16_t*) huart->pRxBuffPtr;
      if(huart->Init.Parity == UART_PARITY_NONE)
      {
        *tmp = (uint16_t)(huart->Instance->DR & (uint16_t)0x01FF);
        huart->pRxBuffPtr += 2U;
      }
      else
      {
        *tmp = (uint16_t)(huart->Instance->DR & (uint16_t)0x00FF);
        huart->pRxBuffPtr += 1U;
      }
    }
    else
    {
      if(huart->Init.Parity == UART_PARITY_NONE)
      {
        *huart->pRxBuffPtr++ = (uint8_t)(huart->Instance->DR & (uint8_t)0x00FF);
      }
      else
      {
        *huart->pRxBuffPtr++ = (uint8_t)(huart->Instance->DR & (uint8_t)0x007F);
      }
    }

    if(--huart->RxXferCount == 0U)
    {
      /* Disable the IRDA Data Register not empty Interrupt */
      __HAL_UART_DISABLE_IT(huart, UART_IT_RXNE);

      /* Disable the UART Parity Error Interrupt */
      __HAL_UART_DISABLE_IT(huart, UART_IT_PE);
        /* Disable the UART Error Interrupt: (Frame error, noise error, overrun error) */
        __HAL_UART_DISABLE_IT(huart, UART_IT_ERR);

      /* Rx process is completed, restore huart->RxState to Ready */
      huart->RxState = HAL_UART_STATE_READY;

      HAL_UART_RxCpltCallback(huart);

      return HAL_OK;
    }
    return HAL_OK;
  }
  else
  {
    return HAL_BUSY;
  }
}

3、在uart.c文件中添加void HAL_UART_IDLECallback( UART_HandleTypeDef* huart )回调函数

void HAL_UART_IDLECallback( UART_HandleTypeDef* huart )
{
    __HAL_UART_CLEAR_IDLEFLAG(&huart1);                                     //清除空闲中断flag
    __HAL_UART_DISABLE_IT(&huart1,UART_IT_IDLE);
    __HAL_UART_DISABLE_IT(&huart1,UART_IT_RXNE);
    
    huart1.RxState = HAL_UART_STATE_READY;                                  //此状态在整个接收数据缓冲区满的时候会被置位，但是空闲中断响应的时候很可能数据缓冲区还没有被填充满，如果没有此操作会引起下次开中断的失败
    
   /*
  添加用户程序*/
    HAL_UART_Receive_IT( &huart1, aucUsart1RecBuff, DATA_FIRST_LEN );
}

4、修改中断函数，也可以修改HAL_UART_IRQHandler(UART_HandleTypeDef *huart)在函数中添加此判断。

void USART1_IRQHandler(void)
{
    uint32_t isrflags   = READ_REG(huart1.Instance->SR);
    uint32_t cr1its     = READ_REG(huart1.Instance->CR1);
    
    if(((isrflags & USART_SR_IDLE) != RESET) && ((cr1its & USART_CR1_IDLEIE) != RESET))
    {
        HAL_UART_IDLECallback(&huart1);  
    }
    
	HAL_UART_IRQHandler(&huart1);
}

以上就是利用串口空闲中断完成的接收不定长数据的程序。