初始化和配置函数。更多...

函数
HAL_StatusTypeDef	HAL_USART_Init (USART_HandleTypeDef *husart)
	根据USART_InitTypeDef中指定的参数初始化USART模式，并初始化相关的句柄。
HAL_StatusTypeDef	HAL_USART_DeInit (USART_HandleTypeDef *husart)
	去初始化USART外设。
__weak void	HAL_USART_MspInit (USART_HandleTypeDef *husart)
	初始化USART MSP。
__weak void	HAL_USART_MspDeInit (USART_HandleTypeDef *husart)
	去初始化USART MSP。
HAL_StatusTypeDef	HAL_USART_RegisterCallback (USART_HandleTypeDef *husart, HAL_USART_CallbackIDTypeDef CallbackID, pUSART_CallbackTypeDef pCallback)
	注册用户USART回调函数，用于覆盖弱预定义的回调函数。
HAL_StatusTypeDef	HAL_USART_UnRegisterCallback (USART_HandleTypeDef *husart, HAL_USART_CallbackIDTypeDef CallbackID)
	注销USART回调函数 USART回调被重定向到弱预定义的回调函数。

详细说明

初始化和配置函数。

 ===============================================================================
            ##### 初始化和配置函数 #####
 ===============================================================================
    [..]
    本节提供了一组函数，用于在同步SPI主/从模式下初始化USART。
      (+) 仅对于同步SPI模式，可以配置以下参数：
        (++) 波特率
        (++) 字长
        (++) 停止位
        (++) 奇偶校验：如果使能了奇偶校验，则写入数据寄存器的数据的MSB位
             会被传输，但会被奇偶校验位更改。
        (++) USART极性
        (++) USART相位
        (++) USART最后一位
        (++) 接收/发送模式

    [..]
    HAL_USART_Init()函数遵循USART同步SPI配置程序
    （程序的详细信息可在参考手册中找到）。

根据M1和M0位定义的帧长度（7位、8位或9位），下表列出了可能的USART格式。

表1。USART帧格式。 +-----------------------------------------------------------------------+ | M1位 | M0位 | PCE位 | USART帧 | |---------|---------|-----------|---------------------------------------| | 0 | 0 | 0 | | SB | 8位数据 | STB | | |---------|---------|-----------|---------------------------------------| | 0 | 0 | 1 | | SB | 7位数据 | PB | STB | | |---------|---------|-----------|---------------------------------------| | 0 | 1 | 0 | | SB | 9位数据 | STB | | |---------|---------|-----------|---------------------------------------| | 0 | 1 | 1 | | SB | 8位数据 | PB | STB | | |---------|---------|-----------|---------------------------------------| | 1 | 0 | 0 | | SB | 7位数据 | STB | | |---------|---------|-----------|---------------------------------------| | 1 | 0 | 1 | | SB | 6位数据 | PB | STB | | +-----------------------------------------------------------------------+

函数文档

HAL_StatusTypeDef HAL_USART_DeInit ( USART_HandleTypeDef * husart )

去初始化USART外设。

参数：

husart USART句柄。

返回值：

HAL 状态

定义于文件338行，文件stm32g4xx_hal_usart.c。

引用 assert_param, __USART_HandleTypeDef::ErrorCode, HAL_USART_ERROR_NONE, HAL_USART_MspDeInit(), HAL_USART_STATE_BUSY, HAL_USART_STATE_RESET, __USART_HandleTypeDef::Instance, __USART_HandleTypeDef::MspDeInitCallback, 和 __USART_HandleTypeDef::State。

HAL_StatusTypeDef HAL_USART_Init ( USART_HandleTypeDef * husart )

根据USART_InitTypeDef中指定的参数初始化USART模式，并初始化相关的句柄。

参数：

husart USART句柄。

返回值：

HAL 状态

定义于文件276行，文件stm32g4xx_hal_usart.c。

引用 __HAL_USART_DISABLE, __HAL_USART_ENABLE, assert_param, HAL_USART_MspInit(), HAL_USART_STATE_BUSY, HAL_USART_STATE_RESET, __USART_HandleTypeDef::Instance, __USART_HandleTypeDef::Lock, __USART_HandleTypeDef::MspInitCallback, __USART_HandleTypeDef::State, USART_CheckIdleState(), USART_InitCallbacksToDefault(), 和 USART_SetConfig()。

void HAL_USART_MspDeInit ( USART_HandleTypeDef * husart )

去初始化USART MSP。

参数：

husart USART句柄。

返回值：

无

定义于文件396行，文件stm32g4xx_hal_usart.c。

引用 UNUSED。

被以下函数引用：HAL_USART_DeInit()，和HAL_USART_UnRegisterCallback()。

void HAL_USART_MspInit ( USART_HandleTypeDef * husart )

初始化USART MSP。

参数：

husart USART句柄。

返回值：

无

定义于文件381行，文件stm32g4xx_hal_usart.c。

引用 UNUSED。

被以下函数引用：HAL_USART_Init()，和HAL_USART_UnRegisterCallback()。

HAL_StatusTypeDef HAL_USART_RegisterCallback	(	USART_HandleTypeDef *	husart,
		HAL_USART_CallbackIDTypeDef	CallbackID,
		pUSART_CallbackTypeDef	pCallback
	)

注册用户USART回调函数，用于覆盖弱预定义的回调函数。

注意：: HAL_USART_RegisterCallback()可在HAL_USART_Init()之前在HAL_USART_STATE_RESET状态下调用，以注册HAL_USART_MSPINIT_CB_ID和HAL_USART_MSPDEINIT_CB_ID的回调函数

参数：

husart	usart句柄
CallbackID	要注册的回调函数ID 此参数可以是以下值之一： HAL_USART_TX_HALFCOMPLETE_CB_ID 发送半完成回调函数ID HAL_USART_TX_COMPLETE_CB_ID 发送完成回调函数ID HAL_USART_RX_HALFCOMPLETE_CB_ID 接收半完成回调函数ID HAL_USART_RX_COMPLETE_CB_ID 接收完成回调函数ID HAL_USART_TX_RX_COMPLETE_CB_ID 接收完成回调函数ID HAL_USART_ERROR_CB_ID 错误回调函数ID HAL_USART_ABORT_COMPLETE_CB_ID 中止完成回调函数ID HAL_USART_RX_FIFO_FULL_CB_ID 接收FIFO满回调函数ID HAL_USART_TX_FIFO_EMPTY_CB_ID 发送FIFO空回调函数ID HAL_USART_MSPINIT_CB_ID MspInit回调函数ID HAL_USART_MSPDEINIT_CB_ID MspDeInit回调函数ID
pCallback	指向回调函数的指针

返回值：

HAL 状态 +

定义于文件429行，文件stm32g4xx_hal_usart.c。

引用 __USART_HandleTypeDef::AbortCpltCallback, __USART_HandleTypeDef::ErrorCallback, __USART_HandleTypeDef::ErrorCode, HAL_USART_ABORT_COMPLETE_CB_ID, HAL_USART_ERROR_CB_ID, HAL_USART_ERROR_INVALID_CALLBACK, HAL_USART_MSPDEINIT_CB_ID, HAL_USART_MSPINIT_CB_ID, HAL_USART_RX_COMPLETE_CB_ID, HAL_USART_RX_FIFO_FULL_CB_ID, HAL_USART_RX_HALFCOMPLETE_CB_ID