stm32g4xx_hal_uart_ex.h

转到此文件的文档。

/**
  ******************************************************************************
  * @file    stm32g4xx_hal_uart_ex.h
  * @author  MCD Application Team
  * @brief   Header file of UART HAL Extended module.
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2019 STMicroelectronics.
  * All rights reserved.
  *
  * This software is licensed under terms that can be found in the LICENSE file
  * in the root directory of this software component.
  * If no LICENSE file comes with this software, it is provided AS-IS.
  *
  ******************************************************************************
  */

/* Define to prevent recursive inclusion -------------------------------------*/
#ifndef STM32G4xx_HAL_UART_EX_H
#define STM32G4xx_HAL_UART_EX_H

#ifdef __cplusplus
extern "C" {
#endif

/* Includes ------------------------------------------------------------------*/
#include "stm32g4xx_hal_def.h"

/** @addtogroup STM32G4xx_HAL_Driver
  * @{
  */

/** @addtogroup UARTEx
  * @{
  */

/* Exported types ------------------------------------------------------------*/
/** @defgroup UARTEx_Exported_Types UARTEx 导出类型
  * @{
  */

/**
  * @brief  UART从停止模式唤醒参数
  */
typedef struct
{
  uint32_t WakeUpEvent;        /*!< 指定哪个事件将激活从停止模式唤醒标志（WUF）。
                                    此参数可以是@ref UART_WakeUp_from_Stop_Selection的值。
                                    如果设置为UART_WAKEUP_ON_ADDRESS，则必须填充下面两个字段。 */
                                    */

  uint16_t AddressLength;      /*!< 指定地址是4位还是7位长。
                                    此参数可以是@ref UARTEx_WakeUp_Address_Length的值。  */

  uint8_t Address;             /*!< UART/USART节点地址（最大7位长）。 */
} UART_WakeUpTypeDef;

/**
  * @}
  */

/* Exported constants --------------------------------------------------------*/
/** @defgroup UARTEx_Exported_Constants UARTEx 导出常量
  * @{
  */

/** @defgroup UARTEx_Word_Length UARTEx 字长
  * @{
  */
#define UART_WORDLENGTH_7B          USART_CR1_M1   /*!< 7位长UART帧 */
#define UART_WORDLENGTH_8B          0x00000000U    /*!< 8位长UART帧 */
#define UART_WORDLENGTH_9B          USART_CR1_M0   /*!< 9位长UART帧 */
/**
  * @}
  */

/** @defgroup UARTEx_WakeUp_Address_Length UARTEx 唤醒地址长度
  * @{
  */
#define UART_ADDRESS_DETECT_4B      0x00000000U      /*!< 4位长唤醒地址 */
#define UART_ADDRESS_DETECT_7B      USART_CR2_ADDM7  /*!< 7位长唤醒地址 */
/**
  * @}
  */

/** @defgroup UARTEx_FIFO_mode UARTEx FIFO模式
  * @brief    UART FIFO模式
  * @{
  */
#define UART_FIFOMODE_DISABLE       0x00000000U       /*!< 禁用FIFO模式 */
#define UART_FIFOMODE_ENABLE        USART_CR1_FIFOEN  /*!< 使能FIFO模式  */
/**
  * @}
  */

/** @defgroup UARTEx_TXFIFO_threshold_level UARTEx TXFIFO阈值电平
  * @brief    UART TXFIFO阈值电平
  * @{
  */
#define UART_TXFIFO_THRESHOLD_1_8   0x00000000U                               /*!< TX FIFO达到其深度的1/8 */
#define UART_TXFIFO_THRESHOLD_1_4   USART_CR3_TXFTCFG_0                       /*!< TX FIFO达到其深度的1/4 */
#define UART_TXFIFO_THRESHOLD_1_2   USART_CR3_TXFTCFG_1                       /*!< TX FIFO达到其深度的1/2 */
#define UART_TXFIFO_THRESHOLD_3_4   (USART_CR3_TXFTCFG_0|USART_CR3_TXFTCFG_1) /*!< TX FIFO达到其深度的3/4 */
#define UART_TXFIFO_THRESHOLD_7_8   USART_CR3_TXFTCFG_2                       /*!< TX FIFO达到其深度的7/8 */
#define UART_TXFIFO_THRESHOLD_8_8   (USART_CR3_TXFTCFG_2|USART_CR3_TXFTCFG_0) /*!< TX FIFO变空            */
/**
  * @}
  */

/** @defgroup UARTEx_RXFIFO_threshold_level UARTEx RXFIFO阈值电平
  * @brief    UART RXFIFO阈值电平
  * @{
  */
#define UART_RXFIFO_THRESHOLD_1_8   0x00000000U                               /*!< RX FIFO达到其深度的1/8 */
#define UART_RXFIFO_THRESHOLD_1_4   USART_CR3_RXFTCFG_0                       /*!< RX FIFO达到其深度的1/4 */
#define UART_RXFIFO_THRESHOLD_1_2   USART_CR3_RXFTCFG_1                       /*!< RX FIFO达到其深度的1/2 */
#define UART_RXFIFO_THRESHOLD_3_4   (USART_CR3_RXFTCFG_0|USART_CR3_RXFTCFG_1) /*!< RX FIFO达到其深度的3/4 */
#define UART_RXFIFO_THRESHOLD_7_8   USART_CR3_RXFTCFG_2                       /*!< RX FIFO达到其深度的7/8 */
#define UART_RXFIFO_THRESHOLD_8_8   (USART_CR3_RXFTCFG_2|USART_CR3_RXFTCFG_0) /*!< RX FIFO变满             */
/**
  * @}
  */

/**
  * @}
  */

/* Exported macros -----------------------------------------------------------*/
/* Exported functions --------------------------------------------------------*/
/** @addtogroup UARTEx_Exported_Functions
  * @{
  */