使用STM32F407
串口:PA9、PA10(利用CH340G驱动)
1.stm32f4xx_hal_uart.c 函数说明
- HAL_UART_Init 函数
要使用一个外设首先要对它进行初始化,所以先看串口的初始化函数,其声明如下:
HAL_StatusTypeDef HAL_UART_Init(UART_HandleTypeDef *huart);
⚫ 函数描述:
用于初始化异步模式的收发器。
⚫ 函数形参:
形参 1 是串口的句柄,UART_HandleTypeDef 结构体类型,其定义如下:
1)Instance:指向 UART 寄存器基地址。实际上这个基地址 HAL 库已经定义好了,可以选择范围:USART1~ USART3、USART6、UART4、UART5。
2)Init:UART 初始化结构体,用于配置通讯参数,如波特率、数据位数、停止位等等。下面我们再详细讲解这个结构体。
3)AdvancedInit:用于配置高级功能,如自动波特率,MSB 先行等。
4)pTxBuffPtr,TxXferSize,TxXferCount:分别是指向发送数据缓冲区的指针,发送数据的大小,发送数据的个数。
5)pRxBuffPtr,RxXferSize,RxXferCount:分别是指向接收数据缓冲区的指针,接受数据的大小,接收数据的个数。
6)Mask:UART 数据接收寄存器的掩码,用于存放数据的校验位。
7)hdmatx,hdmarx:配置串口发送接收数据的 DMA 具体参数。
8)Lock:对资源操作增加操作锁保护,可选 HAL_UNLOCKED 或者 HAL_LOCKED 两个参数。如果 gState 的值等于 HAL_UART_STATE_RESET,则认为串口未被初始化,此时,分配锁资源,并且调用 HAL_UART_MspInit 函数来对串口的 GPIO 和时钟进行初始化。
9)gState,RxState:分别是 UART 的发送状态、工作状态的结构体和 UART 接受状态的结构
体。HAL_UART_StateTypeDef 是一个枚举类型,列出串口在工作过程中的状态值,有些值只
适用于 gState,如 HAL_UART_STATE_BUSY。
10)ErrorCode:串口错误操作信息。主要用于存放串口操作的错误信息。
UART_InitTypedef:
1)BaudRate:波特率设置。一般设置为 2400、9600、19200、115200。
2)WordLength:数据帧字长,可选 8 位或 9 位。这里我们设置为 8 位字长数据格式。
3)StopBits:停止位设置,可选 0.5 个、1 个、1.5 个和 2 个停止位,一般我们选择 1 个停止位。
4)Parity:奇偶校验控制选择,我们设定为无奇偶校验位。
5)Mode:UART 模式选择,可以设置为只收模式,只发模式,或者收发模式。这里我们设置为全双工收发模式。
6)HwFlowCtl:硬件流控制选择,我们设置为无硬件流控制。
7)OverSampling:过采样选择,选择 8 倍过采样或者 16 过采样,一般选择 16 过采样。
⚫ 函数返回值:
HAL_StatusTypeDef 枚举类型的值,有 4 个,分别是 HAL_OK 表示成功,HAL_ERROR 表示错误,HAL_BUSY 表示忙碌,HAL_TIMEOUT 超时。后续遇到该结构体也是一样的。