细说ARM MCU的串口接收数据的实现过程

目录

一、硬件及工程

1、硬件

2、软件目的

3、创建.ioc工程

二、 代码修改

1、串口初始化函数MX_USART2_UART_Init()

（1）MX_USART2_UART_Init()串口参数初始化函数

（2）HAL_UART_MspInit()串口功能模块初始化函数

2、串口中断的执行过程

3、启动串口接收中断

4、自动生成main函数

5、启动串口接收函数HAL_UART_Receive_IT()

6、修改main.c函数

7、从定义回调函数 

8、修改while(1)循环

三、下载运行

1、安装串口助手

2、验证串口通讯结果

---

一、硬件及工程

1、硬件

        本文旨在以实例说明STM32单片机通过串口接收数据的实现过程。本文中使用ST的开发板NUCLEO-G474RE，板上MCU型号为STM32G474RET6。配套的扩展板为作者根据说明书自己设计制造，链接：

2、软件目的

        实例运行后，通过串口通讯助手发送0x10时开发板上的LD2灯亮，其它数据灯灭。

3、创建.ioc工程

        配置GPIO→配置时钟源和DEBUG→配置外部中断→配置串口→配置串口中断→配置系统时钟→build生成。

       将PA4、PA5配置为输出GPIO_Output，PP，Pull up；PC13配置为中断模式GPIO_EXTI13，上升沿触发，用于检测按键B1的状态；PA2、PA3分别配置为串口USART2_TX和USART2_RX；外部时钟；Debug设置为Serial Wire；USART2的基本参数，波特率115200，数据长度8bit，无校验，停止位1；PA4别名BUZ，PA5别名LED，PC13别名KEY；串口中断抢占优先级1，外部中断抢占优先级4；

二、 代码修改

        硬件配置完毕后，启动代码生成，IDE自动将配置好的硬件信息转换成代码。

        自动生成的代码有些需要了解（比如初始化函数），而有些是需要修改的（比如while(1)循环里需要增加的代码，一些注释对里需要增加的代码），还有一些需要重写（比如，重写弱函数）。

1、串口初始化函数MX_USART2_UART_Init()

（1）MX_USART2_UART_Init()串口参数初始化函数

        MX_USART2_UART_Init()函数主要完成对USART2的模式和参数配置，如波特率、数据位、停止位等。因为串口模块要比GPIO复杂，所以配置参数也更多。

/*** @brief USART2 Initialization Function* @param None* @retval None*/
static void MX_USART2_UART_Init(void)
{/* USER CODE BEGIN USART2_Init 0 *//* USER CODE END USART2_Init 0 *//* USER CODE BEGIN USART2_Init 1 *//* USER CODE END USART2_Init 1 */huart2.Instance = USART2;huart2.Init.BaudRate = 115200;huart2.Init.WordLength = UART_WORDLENGTH_8B;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;huart2.Init.OneBitSampling = UART_ONE_BIT_SAMPLE_DISABLE;huart2.Init.ClockPrescaler = UART_PRESCALER_DIV1;huart2.AdvancedInit.AdvFeatureInit = UART_ADVFEATURE_NO_INIT;if (HAL_UART_Init(&huart2) != HAL_OK){Error_Handler();}if (HAL_UARTEx_SetTxFifoThreshold(&huart2, UART_TXFIFO_THRESHOLD_1_8) != HAL_OK){Error_Handler();}if (HAL_UARTEx_SetRxFifoThreshold(&huart2, UART_RXFIFO_THRESHOLD_1_8) != HAL_OK){Error_Handler();}if (HAL_UARTEx_DisableFifoMode(&huart2) != HAL_OK){Error_Handler();}

        MX_USART2_UART_Init()自动生成于main.c中；

        该函数内部出现的HAL_UART_Init(UART_HandleTypeDef *huart)在stm32g4xx_hal_uart.c中。

（2）HAL_UART_MspInit()串口功能模块初始化函数

        对于串口来说，针对引脚等参数的配置，是在文件stm32g4xx_hal_msp.c中。msp是MCU support package的缩写，指的是MCU相关的支持包。关于串口有3个支持包：

HAL_MspInit(void)
HAL_UART_MspInit(UART_HandleTypeDef *huart)
HAL_UART_MspDeInit(UART_HandleTypeDef *huart)

        由函数名可见，其中都带有MspInit字样。这类函数的作用是进行MCU功能模块（譬如串口、定时器、ADC等）的初始化。在固件库中，通常是采用这种方式将MCU的模块初始化代码集中起来，以方便代码在不同型号的MCU上移植。

        上述函数中，第一个是初始化全局Msp。后面两个函数的参数完全一样，函数名也很类似；区别是后一个函数名中多了两个字母“De”，是Default的缩写。

        HAL_UART_MspInit()函数可以对串口硬件初始化、配置引脚模式以及设置中断优先级并使能中断，与对GPIO进行初始化的MX_GPIO_Init()函数所完成的功类似。

        HAL_UART_MspDeInit()函数可以把串口复位成初始值，关闭串口并关闭串口中断。

        HAL_UART_MspInit()函数是由函数HAL_UART_Init()（在stm32g4xx_hal_uart.c文件中定义）调用的。而HAL_UART_Init()是由MX_USART2_UART_Init()函数调用的（在if语句的条件表达式中调用）。

2、串口中断的执行过程

        由于配置了串口的中断功能，所以当中断发生后就会调用相应的中断服务函数来完成一定的任务。

void HAL_UART_IRQHandler(UART_HandleTypeDef *huart)
{... .../*if no error occurs */errorflags = (isrflags & (uint32_t）(USART_ISR_PE|USART_ISR_FE|USART_ISR_ORE|USART_ISR_NE));if(errorflags == 0U){/*------UART in mode Receiver-------*/if(((isrflags & USART_ISR_RXNE_RXFNE) != 0U) && (((crlits & USART_CR1_RXNEIE_RXFNEIE) != 0U)||((cr3its & USART_CR3_RXFTIE) != 0U))){if(huart->RxISR != NULL){huart->RxISR(huart);}return;}}
... ...
}

        当程序执行到huart →RxISR(huart)时，会调用UART_RxISR_8BIT()函数（如果配置数据字长为7位或8位，则调用此函数；如果数据字长为9位，则会调用另一函数UART_RxISR_16BIT），并且在该函数中会调用回调函数HAL_UART_RxCpltCallback()。这个回调函数是在stm32g4xx_hal_ uart.c中定义的弱函数。用户需要重写该函数，可以写在main.c中。

3、启动串口接收中断

        在使用中断之前，还要用到函数HAL_UART_Receive_IT()。该函数的格式如下：

HAL_UART_Receive_IT(UART_HandleTypeDef *huart,uint8_t *pData,uint16_t Size)

        该函数是给将要接收的数据定义一个缓冲区pData，并指定接收数据的长度为Size（也就是要接收的字节数）。这个Size决定了调用回调函数的频率。如果Size大于1，则不会每次中断都调用回调函数，而是到Size次之后，才会再调用一次回调函数。此外，这个函数还有开启接收中断的功能，所以需要在main函数的初始化代码中调用一次HAL_UART_Receive_IT()函数。这样就可以确保开启接收中断。在执行一次回调函数时，接收中断会关闭，所以还需要再次开启接收中断。这个再次开启中断的动作，也可以在回调函数中通过调用HAL_UART_Receive_IT()函数来实现。

4、自动生成main函数

        完成上面的硬件配置，并自动生成代码后，然后在main.c中的初始化部分调用HAL_UART_ Receive _IT()函数设置参数并开启接收中断，然后写回调函HAL_UART_RxCpltCallback()，以便对接收的数据进行处理。删除了一些注释对。

#include "main.h"
UART_HandleTypeDef huart2;
/* USER CODE BEGIN PV */
/* USER CODE END PV */
void SystemClock_Config(void);
static void MX_GPIO_Init(void);
static void MX_USART2_UART_Init(void);
int main(void)
{HAL_Init();SystemClock_Config();MX_GPIO_Init();MX_USART2_UART_Init();/* USER CODE BEGIN 2 *//* USERCODE END 2 */while(1){}
}

        main函数中出现了一个串口初始化函数MX_USART2_UART_Init()。此外，在main.c中，首先定义了一个全局变量huart2，类型为UART_HandleTypeDef。huart2是一个结构体变量，通常也称为串口句柄。这个结构体是关于UART的，它的成员有很多，有的成员本身也是结构体类型。这个结构体有些复杂。在串口初始化函数MX_USART2_UART_Init中，使用了huart2变量。

static void MX_USART2_UART_Init(void)
{huart2.Instance = USART2;huart2.Init.BaudRate = 115200;huart2.Init.WordLength = UART_WORDLENGTH_8B;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;... ...
}

        由此可见，在MX_USART2_UART_Init函数中，第一句huart2.Instance =USART2,就将前面配置的USART2与结构体变量huart2关联了起来。

5、启动串口接收函数HAL_UART_Receive_IT()

        要实现串口接收中断，需要在主程序的初始化代码中调用HAL_UART_Receive_IT()函数。该函数的结构如下：

HAL_UART_Receive_IT(UART_HandleTypeDef *huart,uint8_t *pData,uint16_t Size)

        该函数有三个参数，第一个参数的类型就是UART_HandleTypeDef，所以要将该参数与USART2关联起来。因此，HAL_UART_Receive_IT()函数的调用要可将该函数放到MX_USART2 _UART_Init()函数之后的注释对中。

        HAL_UART_Receive_IT()函数的第二个参数是设置接收数据的缓冲区，可以定义一个长度为RXBUFFERSIZE的数组RxBuffer [RXBUFFERSIZE]，当然这个数组以及RXBUFFERSIZE都需要另外定义（后面会将它们定义为全局变量）。

        HAL_UART_Receive_IT()函数的第三个参数用于指定接收数据的长度，这个数据长度可以与接收缓冲区的长度相同，即RXBUFFERSIZE。

        将RxBuffer[RXBUFFERSIZE]定义为全局变量（需要放到注释对中），并将对HAL_UART_ Receive_IT()函数的调用放置到MX_USART2_UART_Init()语句之后的注释对/* USER CODE BEGIN 2 */与/* USER CODE END 2 */中。

6、修改main.c函数

#include "main.h"
UART_HandleTypeDef huart2;
/* USER CODE BEGIN PV */
/* 直接使用了变量RXBUFFERSIZE */
uint8_t RxBuffer[RXBUFFERSIZE];
/* USER CODE END PV */
/*Private function prototypes */
void SystemClock_Config(void);
static void MX_GPIO_Init(void);
static void MX_USART2_UART_Init(void);
int main(void)
{HAL_Init();SystemClock_Config();MX_GPIO_Init();MX_USART2_UART_Init();/* USER CODE BEGIN2 */HAL_UART_Receive_IT(&huart2,(uint8_t*)RxBuffer,RXBUFFERSIZE);/* USER CODE END2 */while(1){}
}

        上面直接使用了变量RXBUFFERSIZE。对该变量的定义可以放到main.h头文件中，可以用define宏（也需放置到注释对中）：

/* USER CODE BEGIN Private defines */
#define RXBUFFERSIZE 1 //接收缓冲区的长度
/* USER CODE END Private defines */

        将RXBUFFERSIZE定义为1，也就是1字节。

7、从定义回调函数 

        重定义串口中断接收的回调函数HAL_UART_RxCpltCallback()。这个函数已经在stm32g4xx_ hal_uart.c中有定义，只不过被定义为弱函数，实际就是一个空函数。需要重写它。与写EXTI的回调函数类似，也将该函数写在main.c中。

        串口有数据送来，会执行中断服务函数USART2_IRQHandler()，然后该函数又会调用函数HAL_UART_IRQHandler()。调用一定次数的HAL_UART_IRQHandler()函数后，就会自动执行回调函数HAL_UART_RxCpltCallback()。这里的“一定次数”是由HAL_UART_Receive_IT()函数的第三个参数决定的，也就是前面在主程序中用到的常量RXBUFFERSIZE。由于把RXBUFFERSIZE定义为1，所以串口收到1字节的数据后，会调用一次回调函数HAL_UART_RxCpltCallback()。当调用回调函数之时，1字节的数据已经放到了接收缓冲区中，也就是放到前面定义的数组RxBuffer中。 

        调用HAL_UART_Receive_IT()函数，不但实现了定义缓冲区并设置接收数据长度的功能，而且还有开启串口中断接收的功能。因此，在接收完指定长度的数据之后，需要重新开启接收中断的功能，否则后面就不会再进入中断了。可以在回调函数HAL_UART_RxCpltCallback()中调用一下HAL_UART_Receive_IT()函数，重新开启接收中断。对该函数的调用，可以连同EXTI的回调函数HAL GPIO_EXTI_Callback()一起写在main.c后面的注释对中：

/*USER CODE BEGIN 4 */
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{HAL_UART_Receive_IT(&huart2,(uint8_t *)RxBuffer,RXBUFFERSIZE);
}
void HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin)
{HAL_GPIO_WritePin(BUZ_GPIO_Port,BUZ_Pin,GPIO_PIN_RESET);HAL_Delay(100);	//延时HAL_GPIO_WritePin(BUZ_GPIO_Port,BUZ_Pin,GPIO_PIN_SET);
}
/*USER CODE END 4 */

        在EXTI的回调函数中使用了中断的方式实现：当按键按下时，让蜂鸣器响一声。

8、修改while(1)循环

        根据串口送来的数据，控制发光二极管的亮灭。当接收到的数据为0x10（十六进制）时，点亮LD2；当接收到的数据不是0x10时，熄灭LD2。

/*USER CODE BEGIN WHILE */
while(1)
{/*USER CODE BEGIN 3 */if(RxBuffer[0] == 0x10)HAL_GPIO_WritePin(LED_GPIO_Port,LED_Pin,GPIO_PIN_SET);elseHAL_GPIO_WritePin(LED_GPIO_Port,LED_Pin,GPIO_PIN_RESET);
}
/*USER CODE END 3 */

三、下载运行

1、安装串口助手

        好用的 Win10 串口调试助手 + 网口调试 - 知乎  https://zhuanlan.zhihu.com/p/109941792?eqid=a328954a0002e745000000066477efb6&utm_id=0

2、验证串口通讯结果

        开启串口通讯，发送0x10，开大坂上的LD2亮，发送其它内容，比如0x20，LD2灭。