871 lines
		
	
	
		
			43 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			871 lines
		
	
	
		
			43 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /**
 | |
|   ******************************************************************************
 | |
|   * @file    stm32f7xx_hal_usart.h
 | |
|   * @author  MCD Application Team
 | |
|   * @brief   Header file of USART HAL module.
 | |
|   ******************************************************************************
 | |
|   * @attention
 | |
|   *
 | |
|   * Copyright (c) 2017 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 STM32F7xx_HAL_USART_H
 | |
| #define STM32F7xx_HAL_USART_H
 | |
| 
 | |
| #ifdef __cplusplus
 | |
| extern "C" {
 | |
| #endif
 | |
| 
 | |
| /* Includes ------------------------------------------------------------------*/
 | |
| #include "stm32f7xx_hal_def.h"
 | |
| 
 | |
| /** @addtogroup STM32F7xx_HAL_Driver
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /** @addtogroup USART
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /* Exported types ------------------------------------------------------------*/
 | |
| /** @defgroup USART_Exported_Types USART Exported Types
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @brief USART Init Structure definition
 | |
|   */
 | |
| typedef struct
 | |
| {
 | |
|   uint32_t BaudRate;                  /*!< This member configures the Usart communication baud rate.
 | |
|                                            The baud rate is computed using the following formula:
 | |
|                                               Baud Rate Register[15:4] = ((2 * fclk_pres) /
 | |
|                                               ((huart->Init.BaudRate)))[15:4]
 | |
|                                               Baud Rate Register[3]    = 0
 | |
|                                               Baud Rate Register[2:0]  =  (((2 * fclk_pres) /
 | |
|                                               ((huart->Init.BaudRate)))[3:0]) >> 1
 | |
|                                               where fclk_pres is the USART input clock frequency
 | |
|                                            @note  Oversampling by 8 is systematically applied to
 | |
|                                                   achieve high baud rates. */
 | |
| 
 | |
|   uint32_t WordLength;                /*!< Specifies the number of data bits transmitted or received in a frame.
 | |
|                                            This parameter can be a value of @ref USARTEx_Word_Length. */
 | |
| 
 | |
|   uint32_t StopBits;                  /*!< Specifies the number of stop bits transmitted.
 | |
|                                            This parameter can be a value of @ref USART_Stop_Bits. */
 | |
| 
 | |
|   uint32_t Parity;                   /*!< Specifies the parity mode.
 | |
|                                            This parameter can be a value of @ref USART_Parity
 | |
|                                            @note When parity is enabled, the computed parity is inserted
 | |
|                                                  at the MSB position of the transmitted data (9th bit when
 | |
|                                                  the word length is set to 9 data bits; 8th bit when the
 | |
|                                                  word length is set to 8 data bits). */
 | |
| 
 | |
|   uint32_t Mode;                      /*!< Specifies whether the Receive or Transmit mode is enabled or disabled.
 | |
|                                            This parameter can be a value of @ref USART_Mode. */
 | |
| 
 | |
|   uint32_t CLKPolarity;               /*!< Specifies the steady state of the serial clock.
 | |
|                                            This parameter can be a value of @ref USART_Clock_Polarity. */
 | |
| 
 | |
|   uint32_t CLKPhase;                  /*!< Specifies the clock transition on which the bit capture is made.
 | |
|                                            This parameter can be a value of @ref USART_Clock_Phase. */
 | |
| 
 | |
|   uint32_t CLKLastBit;                /*!< Specifies whether the clock pulse corresponding to the last transmitted
 | |
|                                            data bit (MSB) has to be output on the SCLK pin in synchronous mode.
 | |
|                                            This parameter can be a value of @ref USART_Last_Bit. */
 | |
| 
 | |
| } USART_InitTypeDef;
 | |
| 
 | |
| /**
 | |
|   * @brief HAL USART State structures definition
 | |
|   */
 | |
| typedef enum
 | |
| {
 | |
|   HAL_USART_STATE_RESET             = 0x00U,    /*!< Peripheral is not initialized                  */
 | |
|   HAL_USART_STATE_READY             = 0x01U,    /*!< Peripheral Initialized and ready for use       */
 | |
|   HAL_USART_STATE_BUSY              = 0x02U,    /*!< an internal process is ongoing                 */
 | |
|   HAL_USART_STATE_BUSY_TX           = 0x12U,    /*!< Data Transmission process is ongoing           */
 | |
|   HAL_USART_STATE_BUSY_RX           = 0x22U,    /*!< Data Reception process is ongoing              */
 | |
|   HAL_USART_STATE_BUSY_TX_RX        = 0x32U,    /*!< Data Transmission Reception process is ongoing */
 | |
|   HAL_USART_STATE_TIMEOUT           = 0x03U,    /*!< Timeout state                                  */
 | |
|   HAL_USART_STATE_ERROR             = 0x04U     /*!< Error                                          */
 | |
| } HAL_USART_StateTypeDef;
 | |
| 
 | |
| /**
 | |
|   * @brief  USART clock sources definitions
 | |
|   */
 | |
| typedef enum
 | |
| {
 | |
|   USART_CLOCKSOURCE_PCLK1      = 0x00U,    /*!< PCLK1 clock source     */
 | |
|   USART_CLOCKSOURCE_PCLK2      = 0x01U,    /*!< PCLK2 clock source     */
 | |
|   USART_CLOCKSOURCE_HSI        = 0x02U,    /*!< HSI clock source       */
 | |
|   USART_CLOCKSOURCE_SYSCLK     = 0x04U,    /*!< SYSCLK clock source    */
 | |
|   USART_CLOCKSOURCE_LSE        = 0x08U,    /*!< LSE clock source       */
 | |
|   USART_CLOCKSOURCE_UNDEFINED  = 0x10U     /*!< Undefined clock source */
 | |
| } USART_ClockSourceTypeDef;
 | |
| 
 | |
| /**
 | |
|   * @brief  USART handle Structure definition
 | |
|   */
 | |
| typedef struct __USART_HandleTypeDef
 | |
| {
 | |
|   USART_TypeDef                 *Instance;               /*!< USART registers base address        */
 | |
| 
 | |
|   USART_InitTypeDef             Init;                    /*!< USART communication parameters      */
 | |
| 
 | |
|   const uint8_t                 *pTxBuffPtr;             /*!< Pointer to USART Tx transfer Buffer */
 | |
| 
 | |
|   uint16_t                      TxXferSize;              /*!< USART Tx Transfer size              */
 | |
| 
 | |
|   __IO uint16_t                 TxXferCount;             /*!< USART Tx Transfer Counter           */
 | |
| 
 | |
|   uint8_t                       *pRxBuffPtr;             /*!< Pointer to USART Rx transfer Buffer */
 | |
| 
 | |
|   uint16_t                      RxXferSize;              /*!< USART Rx Transfer size              */
 | |
| 
 | |
|   __IO uint16_t                 RxXferCount;             /*!< USART Rx Transfer Counter           */
 | |
| 
 | |
|   uint16_t                      Mask;                    /*!< USART Rx RDR register mask          */
 | |
| 
 | |
|   void (*RxISR)(struct __USART_HandleTypeDef *husart);   /*!< Function pointer on Rx IRQ handler  */
 | |
| 
 | |
|   void (*TxISR)(struct __USART_HandleTypeDef *husart);   /*!< Function pointer on Tx IRQ handler  */
 | |
| 
 | |
|   DMA_HandleTypeDef             *hdmatx;                 /*!< USART Tx DMA Handle parameters      */
 | |
| 
 | |
|   DMA_HandleTypeDef             *hdmarx;                 /*!< USART Rx DMA Handle parameters      */
 | |
| 
 | |
|   HAL_LockTypeDef               Lock;                    /*!< Locking object                      */
 | |
| 
 | |
|   __IO HAL_USART_StateTypeDef   State;                   /*!< USART communication state           */
 | |
| 
 | |
|   __IO uint32_t                 ErrorCode;               /*!< USART Error code                    */
 | |
| 
 | |
| #if (USE_HAL_USART_REGISTER_CALLBACKS == 1)
 | |
|   void (* TxHalfCpltCallback)(struct __USART_HandleTypeDef *husart);        /*!< USART Tx Half Complete Callback        */
 | |
|   void (* TxCpltCallback)(struct __USART_HandleTypeDef *husart);            /*!< USART Tx Complete Callback             */
 | |
|   void (* RxHalfCpltCallback)(struct __USART_HandleTypeDef *husart);        /*!< USART Rx Half Complete Callback        */
 | |
|   void (* RxCpltCallback)(struct __USART_HandleTypeDef *husart);            /*!< USART Rx Complete Callback             */
 | |
|   void (* TxRxCpltCallback)(struct __USART_HandleTypeDef *husart);          /*!< USART Tx Rx Complete Callback          */
 | |
|   void (* ErrorCallback)(struct __USART_HandleTypeDef *husart);             /*!< USART Error Callback                   */
 | |
|   void (* AbortCpltCallback)(struct __USART_HandleTypeDef *husart);         /*!< USART Abort Complete Callback          */
 | |
| 
 | |
|   void (* MspInitCallback)(struct __USART_HandleTypeDef *husart);           /*!< USART Msp Init callback                */
 | |
|   void (* MspDeInitCallback)(struct __USART_HandleTypeDef *husart);         /*!< USART Msp DeInit callback              */
 | |
| #endif  /* USE_HAL_USART_REGISTER_CALLBACKS */
 | |
| 
 | |
| } USART_HandleTypeDef;
 | |
| 
 | |
| #if (USE_HAL_USART_REGISTER_CALLBACKS == 1)
 | |
| /**
 | |
|   * @brief  HAL USART Callback ID enumeration definition
 | |
|   */
 | |
| typedef enum
 | |
| {
 | |
|   HAL_USART_TX_HALFCOMPLETE_CB_ID         = 0x00U,    /*!< USART Tx Half Complete Callback ID        */
 | |
|   HAL_USART_TX_COMPLETE_CB_ID             = 0x01U,    /*!< USART Tx Complete Callback ID             */
 | |
|   HAL_USART_RX_HALFCOMPLETE_CB_ID         = 0x02U,    /*!< USART Rx Half Complete Callback ID        */
 | |
|   HAL_USART_RX_COMPLETE_CB_ID             = 0x03U,    /*!< USART Rx Complete Callback ID             */
 | |
|   HAL_USART_TX_RX_COMPLETE_CB_ID          = 0x04U,    /*!< USART Tx Rx Complete Callback ID          */
 | |
|   HAL_USART_ERROR_CB_ID                   = 0x05U,    /*!< USART Error Callback ID                   */
 | |
|   HAL_USART_ABORT_COMPLETE_CB_ID          = 0x06U,    /*!< USART Abort Complete Callback ID          */
 | |
| 
 | |
|   HAL_USART_MSPINIT_CB_ID                 = 0x09U,    /*!< USART MspInit callback ID                 */
 | |
|   HAL_USART_MSPDEINIT_CB_ID               = 0x0AU     /*!< USART MspDeInit callback ID               */
 | |
| 
 | |
| } HAL_USART_CallbackIDTypeDef;
 | |
| 
 | |
| /**
 | |
|   * @brief  HAL USART Callback pointer definition
 | |
|   */
 | |
| typedef  void (*pUSART_CallbackTypeDef)(USART_HandleTypeDef *husart);  /*!< pointer to an USART callback function */
 | |
| 
 | |
| #endif /* USE_HAL_USART_REGISTER_CALLBACKS */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /* Exported constants --------------------------------------------------------*/
 | |
| /** @defgroup USART_Exported_Constants USART Exported Constants
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Error_Definition   USART Error Definition
 | |
|   * @{
 | |
|   */
 | |
| #define HAL_USART_ERROR_NONE             (0x00000000U)    /*!< No error                  */
 | |
| #define HAL_USART_ERROR_PE               (0x00000001U)    /*!< Parity error              */
 | |
| #define HAL_USART_ERROR_NE               (0x00000002U)    /*!< Noise error               */
 | |
| #define HAL_USART_ERROR_FE               (0x00000004U)    /*!< Frame error               */
 | |
| #define HAL_USART_ERROR_ORE              (0x00000008U)    /*!< Overrun error             */
 | |
| #define HAL_USART_ERROR_DMA              (0x00000010U)    /*!< DMA transfer error        */
 | |
| #if (USE_HAL_USART_REGISTER_CALLBACKS == 1)
 | |
| #define HAL_USART_ERROR_INVALID_CALLBACK (0x00000040U)    /*!< Invalid Callback error    */
 | |
| #endif /* USE_HAL_USART_REGISTER_CALLBACKS */
 | |
| #define  HAL_USART_ERROR_RTO              (0x00000080U)    /*!< Receiver Timeout error  */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Stop_Bits  USART Number of Stop Bits
 | |
|   * @{
 | |
|   */
 | |
| #define USART_STOPBITS_0_5                   USART_CR2_STOP_0                     /*!< USART frame with 0.5 stop bit  */
 | |
| #define USART_STOPBITS_1                     0x00000000U                          /*!< USART frame with 1 stop bit    */
 | |
| #define USART_STOPBITS_1_5                  (USART_CR2_STOP_0 | USART_CR2_STOP_1) /*!< USART frame with 1.5 stop bits */
 | |
| #define USART_STOPBITS_2                     USART_CR2_STOP_1                     /*!< USART frame with 2 stop bits   */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Parity    USART Parity
 | |
|   * @{
 | |
|   */
 | |
| #define USART_PARITY_NONE                   0x00000000U                      /*!< No parity   */
 | |
| #define USART_PARITY_EVEN                   USART_CR1_PCE                    /*!< Even parity */
 | |
| #define USART_PARITY_ODD                    (USART_CR1_PCE | USART_CR1_PS)   /*!< Odd parity  */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Mode   USART Mode
 | |
|   * @{
 | |
|   */
 | |
| #define USART_MODE_RX                       USART_CR1_RE                    /*!< RX mode        */
 | |
| #define USART_MODE_TX                       USART_CR1_TE                    /*!< TX mode        */
 | |
| #define USART_MODE_TX_RX                    (USART_CR1_TE |USART_CR1_RE)    /*!< RX and TX mode */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Clock  USART Clock
 | |
|   * @{
 | |
|   */
 | |
| #define USART_CLOCK_DISABLE                 0x00000000U       /*!< USART clock disable */
 | |
| #define USART_CLOCK_ENABLE                  USART_CR2_CLKEN   /*!< USART clock enable  */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Clock_Polarity  USART Clock Polarity
 | |
|   * @{
 | |
|   */
 | |
| #define USART_POLARITY_LOW                  0x00000000U      /*!< Driver enable signal is active high */
 | |
| #define USART_POLARITY_HIGH                 USART_CR2_CPOL   /*!< Driver enable signal is active low  */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Clock_Phase   USART Clock Phase
 | |
|   * @{
 | |
|   */
 | |
| #define USART_PHASE_1EDGE                   0x00000000U      /*!< USART frame phase on first clock transition  */
 | |
| #define USART_PHASE_2EDGE                   USART_CR2_CPHA   /*!< USART frame phase on second clock transition */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Last_Bit  USART Last Bit
 | |
|   * @{
 | |
|   */
 | |
| #define USART_LASTBIT_DISABLE               0x00000000U      /*!< USART frame last data bit clock pulse not output to SCLK pin */
 | |
| #define USART_LASTBIT_ENABLE                USART_CR2_LBCL   /*!< USART frame last data bit clock pulse output to SCLK pin     */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| 
 | |
| /** @defgroup USART_Request_Parameters  USART Request Parameters
 | |
|   * @{
 | |
|   */
 | |
| #define USART_RXDATA_FLUSH_REQUEST        USART_RQR_RXFRQ        /*!< Receive Data flush Request  */
 | |
| #define USART_TXDATA_FLUSH_REQUEST        USART_RQR_TXFRQ        /*!< Transmit data flush Request */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Flags      USART Flags
 | |
|   *        Elements values convention: 0xXXXX
 | |
|   *           - 0xXXXX  : Flag mask in the ISR register
 | |
|   * @{
 | |
|   */
 | |
| #define USART_FLAG_REACK                    USART_ISR_REACK         /*!< USART receive enable acknowledge flag      */
 | |
| #define USART_FLAG_TEACK                    USART_ISR_TEACK         /*!< USART transmit enable acknowledge flag     */
 | |
| #define USART_FLAG_BUSY                     USART_ISR_BUSY          /*!< USART busy flag                            */
 | |
| #define USART_FLAG_TXE                      USART_ISR_TXE           /*!< USART transmit data register empty         */
 | |
| #define USART_FLAG_RTOF                     USART_ISR_RTOF          /*!< USART receiver timeout flag                */
 | |
| #define USART_FLAG_TC                       USART_ISR_TC            /*!< USART transmission complete                */
 | |
| #define USART_FLAG_RXNE                     USART_ISR_RXNE          /*!< USART read data register not empty         */
 | |
| #define USART_FLAG_IDLE                     USART_ISR_IDLE          /*!< USART idle flag                            */
 | |
| #define USART_FLAG_ORE                      USART_ISR_ORE           /*!< USART overrun error                        */
 | |
| #define USART_FLAG_NE                       USART_ISR_NE            /*!< USART noise error                          */
 | |
| #define USART_FLAG_FE                       USART_ISR_FE            /*!< USART frame error                          */
 | |
| #define USART_FLAG_PE                       USART_ISR_PE            /*!< USART parity error                         */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Interrupt_definition USART Interrupts Definition
 | |
|   *        Elements values convention: 0000ZZZZ0XXYYYYYb
 | |
|   *           - YYYYY  : Interrupt source position in the XX register (5bits)
 | |
|   *           - XX  : Interrupt source register (2bits)
 | |
|   *                 - 01: CR1 register
 | |
|   *                 - 10: CR2 register
 | |
|   *                 - 11: CR3 register
 | |
|   *           - ZZZZ  : Flag position in the ISR register(4bits)
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| #define USART_IT_PE                          0x0028U     /*!< USART parity error interruption                 */
 | |
| #define USART_IT_TXE                         0x0727U     /*!< USART transmit data register empty interruption */
 | |
| #define USART_IT_TC                          0x0626U     /*!< USART transmission complete interruption        */
 | |
| #define USART_IT_RXNE                        0x0525U     /*!< USART read data register not empty interruption */
 | |
| #define USART_IT_IDLE                        0x0424U     /*!< USART idle interruption                         */
 | |
| #define USART_IT_ERR                         0x0060U     /*!< USART error interruption                        */
 | |
| #define USART_IT_ORE                         0x0300U     /*!< USART overrun error interruption                */
 | |
| #define USART_IT_NE                          0x0200U     /*!< USART noise error interruption                  */
 | |
| #define USART_IT_FE                          0x0100U     /*!< USART frame error interruption                  */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_IT_CLEAR_Flags    USART Interruption Clear Flags
 | |
|   * @{
 | |
|   */
 | |
| #define USART_CLEAR_PEF                       USART_ICR_PECF            /*!< Parity Error Clear Flag             */
 | |
| #define USART_CLEAR_FEF                       USART_ICR_FECF            /*!< Framing Error Clear Flag            */
 | |
| #define USART_CLEAR_NEF                       USART_ICR_NCF             /*!< Noise Error detected Clear Flag     */
 | |
| #define USART_CLEAR_OREF                      USART_ICR_ORECF           /*!< OverRun Error Clear Flag            */
 | |
| #define USART_CLEAR_IDLEF                     USART_ICR_IDLECF          /*!< IDLE line detected Clear Flag       */
 | |
| #define USART_CLEAR_TCF                       USART_ICR_TCCF            /*!< Transmission Complete Clear Flag    */
 | |
| #define USART_CLEAR_RTOF                      USART_ICR_RTOCF           /*!< USART receiver timeout clear flag  */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @defgroup USART_Interruption_Mask    USART Interruption Flags Mask
 | |
|   * @{
 | |
|   */
 | |
| #define USART_IT_MASK                             0x001FU     /*!< USART interruptions flags mask */
 | |
| #define USART_CR_MASK                             0x00E0U     /*!< USART control register mask */
 | |
| #define USART_CR_POS                              5U          /*!< USART control register position */
 | |
| #define USART_ISR_MASK                            0x1F00U     /*!< USART ISR register mask         */
 | |
| #define USART_ISR_POS                             8U          /*!< USART ISR register position     */
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /* Exported macros -----------------------------------------------------------*/
 | |
| /** @defgroup USART_Exported_Macros USART Exported Macros
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /** @brief Reset USART handle state.
 | |
|   * @param  __HANDLE__ USART handle.
 | |
|   * @retval None
 | |
|   */
 | |
| #if (USE_HAL_USART_REGISTER_CALLBACKS == 1)
 | |
| #define __HAL_USART_RESET_HANDLE_STATE(__HANDLE__)  do{                                            \
 | |
|                                                         (__HANDLE__)->State = HAL_USART_STATE_RESET; \
 | |
|                                                         (__HANDLE__)->MspInitCallback = NULL;        \
 | |
|                                                         (__HANDLE__)->MspDeInitCallback = NULL;      \
 | |
|                                                       } while(0U)
 | |
| #else
 | |
| #define __HAL_USART_RESET_HANDLE_STATE(__HANDLE__)  ((__HANDLE__)->State = HAL_USART_STATE_RESET)
 | |
| #endif /* USE_HAL_USART_REGISTER_CALLBACKS */
 | |
| 
 | |
| /** @brief  Check whether the specified USART flag is set or not.
 | |
|   * @param  __HANDLE__ specifies the USART Handle
 | |
|   * @param  __FLAG__ specifies the flag to check.
 | |
|   *        This parameter can be one of the following values:
 | |
|   *            @arg @ref USART_FLAG_REACK Receive enable acknowledge flag
 | |
|   *            @arg @ref USART_FLAG_TEACK Transmit enable acknowledge flag
 | |
|   *            @arg @ref USART_FLAG_BUSY  Busy flag
 | |
|   *            @arg @ref USART_FLAG_TXE   Transmit data register empty flag
 | |
|   *            @arg @ref USART_FLAG_TC    Transmission Complete flag
 | |
|   *            @arg @ref USART_FLAG_RXNE  Receive data register not empty flag
 | |
|   *            @arg @ref USART_FLAG_RTOF  Receiver Timeout flag
 | |
|   *            @arg @ref USART_FLAG_IDLE  Idle Line detection flag
 | |
|   *            @arg @ref USART_FLAG_ORE   OverRun Error flag
 | |
|   *            @arg @ref USART_FLAG_NE    Noise Error flag
 | |
|   *            @arg @ref USART_FLAG_FE    Framing Error flag
 | |
|   *            @arg @ref USART_FLAG_PE    Parity Error flag
 | |
|   * @retval The new state of __FLAG__ (TRUE or FALSE).
 | |
|   */
 | |
| #define __HAL_USART_GET_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->ISR & (__FLAG__)) == (__FLAG__))
 | |
| 
 | |
| /** @brief  Clear the specified USART pending flag.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @param  __FLAG__ specifies the flag to check.
 | |
|   *          This parameter can be any combination of the following values:
 | |
|   *            @arg @ref USART_CLEAR_PEF      Parity Error Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_FEF      Framing Error Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_NEF      Noise detected Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_OREF     Overrun Error Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_IDLEF    IDLE line detected Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_TCF      Transmission Complete Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_RTOF     Receiver Timeout clear flag
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = (__FLAG__))
 | |
| 
 | |
| /** @brief  Clear the USART PE pending flag.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_CLEAR_PEFLAG(__HANDLE__)   __HAL_USART_CLEAR_FLAG((__HANDLE__), USART_CLEAR_PEF)
 | |
| 
 | |
| /** @brief  Clear the USART FE pending flag.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_CLEAR_FEFLAG(__HANDLE__)   __HAL_USART_CLEAR_FLAG((__HANDLE__), USART_CLEAR_FEF)
 | |
| 
 | |
| /** @brief  Clear the USART NE pending flag.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_CLEAR_NEFLAG(__HANDLE__)  __HAL_USART_CLEAR_FLAG((__HANDLE__), USART_CLEAR_NEF)
 | |
| 
 | |
| /** @brief  Clear the USART ORE pending flag.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_CLEAR_OREFLAG(__HANDLE__)   __HAL_USART_CLEAR_FLAG((__HANDLE__), USART_CLEAR_OREF)
 | |
| 
 | |
| /** @brief  Clear the USART IDLE pending flag.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_CLEAR_IDLEFLAG(__HANDLE__)   __HAL_USART_CLEAR_FLAG((__HANDLE__), USART_CLEAR_IDLEF)
 | |
| 
 | |
| 
 | |
| 
 | |
| /** @brief  Enable the specified USART interrupt.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @param  __INTERRUPT__ specifies the USART interrupt source to enable.
 | |
|   *          This parameter can be one of the following values:
 | |
|   *            @arg @ref USART_IT_TXE   Transmit Data Register empty interrupt
 | |
|   *            @arg @ref USART_IT_TC    Transmission complete interrupt
 | |
|   *            @arg @ref USART_IT_RXNE  Receive Data register not empty interrupt
 | |
|   *            @arg @ref USART_IT_IDLE  Idle line detection interrupt
 | |
|   *            @arg @ref USART_IT_PE    Parity Error interrupt
 | |
|   *            @arg @ref USART_IT_ERR   Error interrupt(Frame error, noise error, overrun error)
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_ENABLE_IT(__HANDLE__, __INTERRUPT__)\
 | |
|   (((((__INTERRUPT__) & USART_CR_MASK) >> USART_CR_POS) == 1U)?\
 | |
|    ((__HANDLE__)->Instance->CR1 |= (1U << ((__INTERRUPT__) & USART_IT_MASK))): \
 | |
|    ((((__INTERRUPT__) & USART_CR_MASK) >> USART_CR_POS) == 2U)?\
 | |
|    ((__HANDLE__)->Instance->CR2 |= (1U << ((__INTERRUPT__) & USART_IT_MASK))): \
 | |
|    ((__HANDLE__)->Instance->CR3 |= (1U << ((__INTERRUPT__) & USART_IT_MASK))))
 | |
| 
 | |
| /** @brief  Disable the specified USART interrupt.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @param  __INTERRUPT__ specifies the USART interrupt source to disable.
 | |
|   *          This parameter can be one of the following values:
 | |
|   *            @arg @ref USART_IT_TXE   Transmit Data Register empty interrupt
 | |
|   *            @arg @ref USART_IT_TC    Transmission complete interrupt
 | |
|   *            @arg @ref USART_IT_RXNE  Receive Data register not empty interrupt
 | |
|   *            @arg @ref USART_IT_IDLE  Idle line detection interrupt
 | |
|   *            @arg @ref USART_IT_PE    Parity Error interrupt
 | |
|   *            @arg @ref USART_IT_ERR   Error interrupt(Frame error, noise error, overrun error)
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_DISABLE_IT(__HANDLE__, __INTERRUPT__)\
 | |
|   (((((__INTERRUPT__) & USART_CR_MASK) >> USART_CR_POS) == 1U)?\
 | |
|    ((__HANDLE__)->Instance->CR1 &= ~ (1U << ((__INTERRUPT__) & USART_IT_MASK))): \
 | |
|    ((((__INTERRUPT__) & USART_CR_MASK) >> USART_CR_POS) == 2U)?\
 | |
|    ((__HANDLE__)->Instance->CR2 &= ~ (1U << ((__INTERRUPT__) & USART_IT_MASK))): \
 | |
|    ((__HANDLE__)->Instance->CR3 &= ~ (1U << ((__INTERRUPT__) & USART_IT_MASK))))
 | |
| 
 | |
| /** @brief  Check whether the specified USART interrupt has occurred or not.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @param  __INTERRUPT__ specifies the USART interrupt source to check.
 | |
|   *          This parameter can be one of the following values:
 | |
|   *            @arg @ref USART_IT_TXE   Transmit Data Register empty interrupt
 | |
|   *            @arg @ref USART_IT_TC    Transmission complete interrupt
 | |
|   *            @arg @ref USART_IT_RXNE  Receive Data register not empty interrupt
 | |
|   *            @arg @ref USART_IT_IDLE  Idle line detection interrupt
 | |
|   *            @arg @ref USART_IT_ORE   OverRun Error interrupt
 | |
|   *            @arg @ref USART_IT_NE    Noise Error interrupt
 | |
|   *            @arg @ref USART_IT_FE    Framing Error interrupt
 | |
|   *            @arg @ref USART_IT_PE    Parity Error interrupt
 | |
|   * @retval The new state of __INTERRUPT__ (SET or RESET).
 | |
|   */
 | |
| #define __HAL_USART_GET_IT(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->ISR\
 | |
|                                                          & (0x01U << (((__INTERRUPT__) & USART_ISR_MASK)>>\
 | |
|                                                                       USART_ISR_POS))) != 0U) ? SET : RESET)
 | |
| 
 | |
| /** @brief  Check whether the specified USART interrupt source is enabled or not.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @param  __INTERRUPT__ specifies the USART interrupt source to check.
 | |
|   *          This parameter can be one of the following values:
 | |
|   *            @arg @ref USART_IT_TXE   Transmit Data Register empty interrupt
 | |
|   *            @arg @ref USART_IT_TC    Transmission complete interrupt
 | |
|   *            @arg @ref USART_IT_RXNE  Receive Data register not empty interrupt
 | |
|   *            @arg @ref USART_IT_IDLE  Idle line detection interrupt
 | |
|   *            @arg @ref USART_IT_ORE   OverRun Error interrupt
 | |
|   *            @arg @ref USART_IT_NE    Noise Error interrupt
 | |
|   *            @arg @ref USART_IT_FE    Framing Error interrupt
 | |
|   *            @arg @ref USART_IT_PE    Parity Error interrupt
 | |
|   * @retval The new state of __INTERRUPT__ (SET or RESET).
 | |
|   */
 | |
| #define __HAL_USART_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((((((uint8_t)(__INTERRUPT__)) >> 0x05U) == 0x01U) ?\
 | |
|                                                                  (__HANDLE__)->Instance->CR1 : \
 | |
|                                                                  (((((uint8_t)(__INTERRUPT__)) >> 0x05U) == 0x02U) ?\
 | |
|                                                                   (__HANDLE__)->Instance->CR2 : \
 | |
|                                                                   (__HANDLE__)->Instance->CR3)) & (0x01U <<\
 | |
|                                                                       (((uint16_t)(__INTERRUPT__)) &\
 | |
|                                                                        USART_IT_MASK)))  != 0U) ? SET : RESET)
 | |
| 
 | |
| /** @brief  Clear the specified USART ISR flag, in setting the proper ICR register flag.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @param  __IT_CLEAR__ specifies the interrupt clear register flag that needs to be set
 | |
|   *                       to clear the corresponding interrupt.
 | |
|   *          This parameter can be one of the following values:
 | |
|   *            @arg @ref USART_CLEAR_PEF      Parity Error Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_FEF      Framing Error Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_NEF      Noise detected Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_OREF     Overrun Error Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_IDLEF    IDLE line detected Clear Flag
 | |
|   *            @arg @ref USART_CLEAR_RTOF     Receiver timeout clear flag
 | |
|   *            @arg @ref USART_CLEAR_TCF      Transmission Complete Clear Flag
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_CLEAR_IT(__HANDLE__, __IT_CLEAR__) ((__HANDLE__)->Instance->ICR = (uint32_t)(__IT_CLEAR__))
 | |
| 
 | |
| /** @brief  Set a specific USART request flag.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @param  __REQ__ specifies the request flag to set.
 | |
|   *          This parameter can be one of the following values:
 | |
|   *            @arg @ref USART_RXDATA_FLUSH_REQUEST Receive Data flush Request
 | |
|   *            @arg @ref USART_TXDATA_FLUSH_REQUEST Transmit data flush Request
 | |
|   *
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_SEND_REQ(__HANDLE__, __REQ__)      ((__HANDLE__)->Instance->RQR |= (uint16_t)(__REQ__))
 | |
| 
 | |
| /** @brief  Enable the USART one bit sample method.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_ONE_BIT_SAMPLE_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR3|= USART_CR3_ONEBIT)
 | |
| 
 | |
| /** @brief  Disable the USART one bit sample method.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_ONE_BIT_SAMPLE_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR3 &= ~USART_CR3_ONEBIT)
 | |
| 
 | |
| /** @brief  Enable USART.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_ENABLE(__HANDLE__)                 ((__HANDLE__)->Instance->CR1 |= USART_CR1_UE)
 | |
| 
 | |
| /** @brief  Disable USART.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @retval None
 | |
|   */
 | |
| #define __HAL_USART_DISABLE(__HANDLE__)                ((__HANDLE__)->Instance->CR1 &= ~USART_CR1_UE)
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /* Private macros --------------------------------------------------------*/
 | |
| /** @defgroup USART_Private_Macros   USART Private Macros
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /** @brief  BRR division operation to set BRR register in 8-bit oversampling mode.
 | |
|   * @param  __PCLK__ USART clock.
 | |
|   * @param  __BAUD__ Baud rate set by the user.
 | |
|   * @retval Division result
 | |
|   */
 | |
| #define USART_DIV_SAMPLING8(__PCLK__, __BAUD__)   ((((__PCLK__)*2U) + ((__BAUD__)/2U)) / (__BAUD__))
 | |
| 
 | |
| /** @brief  Report the USART clock source.
 | |
|   * @param  __HANDLE__ specifies the USART Handle.
 | |
|   * @param  __CLOCKSOURCE__ output variable.
 | |
|   * @retval the USART clocking source, written in __CLOCKSOURCE__.
 | |
|   */
 | |
| #define USART_GETCLOCKSOURCE(__HANDLE__, __CLOCKSOURCE__)      \
 | |
|   do {                                                         \
 | |
|     if((__HANDLE__)->Instance == USART1)                       \
 | |
|     {                                                          \
 | |
|       switch(__HAL_RCC_GET_USART1_SOURCE())                    \
 | |
|       {                                                        \
 | |
|         case RCC_USART1CLKSOURCE_PCLK2:                        \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK2;         \
 | |
|           break;                                               \
 | |
|         case RCC_USART1CLKSOURCE_HSI:                          \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI;           \
 | |
|           break;                                               \
 | |
|         case RCC_USART1CLKSOURCE_SYSCLK:                       \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK;        \
 | |
|           break;                                               \
 | |
|         case RCC_USART1CLKSOURCE_LSE:                          \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE;           \
 | |
|           break;                                               \
 | |
|         default:                                               \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED;     \
 | |
|           break;                                               \
 | |
|       }                                                        \
 | |
|     }                                                          \
 | |
|     else if((__HANDLE__)->Instance == USART2)                  \
 | |
|     {                                                          \
 | |
|       switch(__HAL_RCC_GET_USART2_SOURCE())                    \
 | |
|       {                                                        \
 | |
|         case RCC_USART2CLKSOURCE_PCLK1:                        \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK1;         \
 | |
|           break;                                               \
 | |
|         case RCC_USART2CLKSOURCE_HSI:                          \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI;           \
 | |
|           break;                                               \
 | |
|         case RCC_USART2CLKSOURCE_SYSCLK:                       \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK;        \
 | |
|           break;                                               \
 | |
|         case RCC_USART2CLKSOURCE_LSE:                          \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE;           \
 | |
|           break;                                               \
 | |
|         default:                                               \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED;     \
 | |
|           break;                                               \
 | |
|       }                                                        \
 | |
|     }                                                          \
 | |
|     else if((__HANDLE__)->Instance == USART3)                  \
 | |
|     {                                                          \
 | |
|       switch(__HAL_RCC_GET_USART3_SOURCE())                    \
 | |
|       {                                                        \
 | |
|         case RCC_USART3CLKSOURCE_PCLK1:                        \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK1;         \
 | |
|           break;                                               \
 | |
|         case RCC_USART3CLKSOURCE_HSI:                          \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI;           \
 | |
|           break;                                               \
 | |
|         case RCC_USART3CLKSOURCE_SYSCLK:                       \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK;        \
 | |
|           break;                                               \
 | |
|         case RCC_USART3CLKSOURCE_LSE:                          \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE;           \
 | |
|           break;                                               \
 | |
|         default:                                               \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED;     \
 | |
|           break;                                               \
 | |
|       }                                                        \
 | |
|     }                                                          \
 | |
|     else if((__HANDLE__)->Instance == USART6)                  \
 | |
|     {                                                          \
 | |
|       switch(__HAL_RCC_GET_USART6_SOURCE())                    \
 | |
|       {                                                        \
 | |
|         case RCC_USART6CLKSOURCE_PCLK2:                        \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK2;         \
 | |
|           break;                                               \
 | |
|         case RCC_USART6CLKSOURCE_HSI:                          \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI;           \
 | |
|           break;                                               \
 | |
|         case RCC_USART6CLKSOURCE_SYSCLK:                       \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK;        \
 | |
|           break;                                               \
 | |
|         case RCC_USART6CLKSOURCE_LSE:                          \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE;           \
 | |
|           break;                                               \
 | |
|         default:                                               \
 | |
|           (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED;     \
 | |
|           break;                                               \
 | |
|       }                                                        \
 | |
|     }                                                          \
 | |
|     else                                                       \
 | |
|     {                                                          \
 | |
|       (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED;         \
 | |
|     }                                                          \
 | |
|   } while(0U)
 | |
| 
 | |
| /** @brief  Check USART Baud rate.
 | |
|   * @param  __BAUDRATE__ Baudrate specified by the user.
 | |
|   *         The maximum Baud Rate is derived from the maximum clock on F7 (i.e. 216 MHz)
 | |
|   *         divided by the smallest oversampling used on the USART (i.e. 8)
 | |
|   * @retval SET (__BAUDRATE__ is valid) or RESET (__BAUDRATE__ is invalid)  */
 | |
| #define IS_USART_BAUDRATE(__BAUDRATE__) ((__BAUDRATE__) <= 27000000U)
 | |
| 
 | |
| /**
 | |
|   * @brief Ensure that USART frame number of stop bits is valid.
 | |
|   * @param __STOPBITS__ USART frame number of stop bits.
 | |
|   * @retval SET (__STOPBITS__ is valid) or RESET (__STOPBITS__ is invalid)
 | |
|   */
 | |
| #define IS_USART_STOPBITS(__STOPBITS__) (((__STOPBITS__) == USART_STOPBITS_0_5) || \
 | |
|                                          ((__STOPBITS__) == USART_STOPBITS_1)   || \
 | |
|                                          ((__STOPBITS__) == USART_STOPBITS_1_5) || \
 | |
|                                          ((__STOPBITS__) == USART_STOPBITS_2))
 | |
| 
 | |
| /**
 | |
|   * @brief Ensure that USART frame parity is valid.
 | |
|   * @param __PARITY__ USART frame parity.
 | |
|   * @retval SET (__PARITY__ is valid) or RESET (__PARITY__ is invalid)
 | |
|   */
 | |
| #define IS_USART_PARITY(__PARITY__) (((__PARITY__) == USART_PARITY_NONE) || \
 | |
|                                      ((__PARITY__) == USART_PARITY_EVEN) || \
 | |
|                                      ((__PARITY__) == USART_PARITY_ODD))
 | |
| 
 | |
| /**
 | |
|   * @brief Ensure that USART communication mode is valid.
 | |
|   * @param __MODE__ USART communication mode.
 | |
|   * @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid)
 | |
|   */
 | |
| #define IS_USART_MODE(__MODE__) ((((__MODE__) & 0xFFFFFFF3U) == 0x00U) && ((__MODE__) != 0x00U))
 | |
| 
 | |
| /**
 | |
|   * @brief Ensure that USART clock state is valid.
 | |
|   * @param __CLOCK__ USART clock state.
 | |
|   * @retval SET (__CLOCK__ is valid) or RESET (__CLOCK__ is invalid)
 | |
|   */
 | |
| #define IS_USART_CLOCK(__CLOCK__) (((__CLOCK__) == USART_CLOCK_DISABLE) || \
 | |
|                                    ((__CLOCK__) == USART_CLOCK_ENABLE))
 | |
| 
 | |
| /**
 | |
|   * @brief Ensure that USART frame polarity is valid.
 | |
|   * @param __CPOL__ USART frame polarity.
 | |
|   * @retval SET (__CPOL__ is valid) or RESET (__CPOL__ is invalid)
 | |
|   */
 | |
| #define IS_USART_POLARITY(__CPOL__) (((__CPOL__) == USART_POLARITY_LOW) || ((__CPOL__) == USART_POLARITY_HIGH))
 | |
| 
 | |
| /**
 | |
|   * @brief Ensure that USART frame phase is valid.
 | |
|   * @param __CPHA__ USART frame phase.
 | |
|   * @retval SET (__CPHA__ is valid) or RESET (__CPHA__ is invalid)
 | |
|   */
 | |
| #define IS_USART_PHASE(__CPHA__) (((__CPHA__) == USART_PHASE_1EDGE) || ((__CPHA__) == USART_PHASE_2EDGE))
 | |
| 
 | |
| /**
 | |
|   * @brief Ensure that USART frame last bit clock pulse setting is valid.
 | |
|   * @param __LASTBIT__ USART frame last bit clock pulse setting.
 | |
|   * @retval SET (__LASTBIT__ is valid) or RESET (__LASTBIT__ is invalid)
 | |
|   */
 | |
| #define IS_USART_LASTBIT(__LASTBIT__) (((__LASTBIT__) == USART_LASTBIT_DISABLE) || \
 | |
|                                        ((__LASTBIT__) == USART_LASTBIT_ENABLE))
 | |
| 
 | |
| /**
 | |
|   * @brief Ensure that USART request parameter is valid.
 | |
|   * @param __PARAM__ USART request parameter.
 | |
|   * @retval SET (__PARAM__ is valid) or RESET (__PARAM__ is invalid)
 | |
|   */
 | |
| #define IS_USART_REQUEST_PARAMETER(__PARAM__) (((__PARAM__) == USART_RXDATA_FLUSH_REQUEST) || \
 | |
|                                                ((__PARAM__) == USART_TXDATA_FLUSH_REQUEST))
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /* Include USART HAL Extended module */
 | |
| #include "stm32f7xx_hal_usart_ex.h"
 | |
| 
 | |
| /* Exported functions --------------------------------------------------------*/
 | |
| /** @addtogroup USART_Exported_Functions USART Exported Functions
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /** @addtogroup USART_Exported_Functions_Group1 Initialization and de-initialization functions
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /* Initialization and de-initialization functions  ****************************/
 | |
| HAL_StatusTypeDef HAL_USART_Init(USART_HandleTypeDef *husart);
 | |
| HAL_StatusTypeDef HAL_USART_DeInit(USART_HandleTypeDef *husart);
 | |
| void HAL_USART_MspInit(USART_HandleTypeDef *husart);
 | |
| void HAL_USART_MspDeInit(USART_HandleTypeDef *husart);
 | |
| 
 | |
| /* Callbacks Register/UnRegister functions  ***********************************/
 | |
| #if (USE_HAL_USART_REGISTER_CALLBACKS == 1)
 | |
| HAL_StatusTypeDef HAL_USART_RegisterCallback(USART_HandleTypeDef *husart, HAL_USART_CallbackIDTypeDef CallbackID,
 | |
|                                              pUSART_CallbackTypeDef pCallback);
 | |
| HAL_StatusTypeDef HAL_USART_UnRegisterCallback(USART_HandleTypeDef *husart, HAL_USART_CallbackIDTypeDef CallbackID);
 | |
| #endif /* USE_HAL_USART_REGISTER_CALLBACKS */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @addtogroup USART_Exported_Functions_Group2 IO operation functions
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /* IO operation functions *****************************************************/
 | |
| HAL_StatusTypeDef HAL_USART_Transmit(USART_HandleTypeDef *husart, const uint8_t *pTxData, uint16_t Size, uint32_t Timeout);
 | |
| HAL_StatusTypeDef HAL_USART_Receive(USART_HandleTypeDef *husart, uint8_t *pRxData, uint16_t Size, uint32_t Timeout);
 | |
| HAL_StatusTypeDef HAL_USART_TransmitReceive(USART_HandleTypeDef *husart, const uint8_t *pTxData, uint8_t *pRxData,
 | |
|                                             uint16_t Size, uint32_t Timeout);
 | |
| HAL_StatusTypeDef HAL_USART_Transmit_IT(USART_HandleTypeDef *husart, const uint8_t *pTxData, uint16_t Size);
 | |
| HAL_StatusTypeDef HAL_USART_Receive_IT(USART_HandleTypeDef *husart, uint8_t *pRxData, uint16_t Size);
 | |
| HAL_StatusTypeDef HAL_USART_TransmitReceive_IT(USART_HandleTypeDef *husart, const uint8_t *pTxData, uint8_t *pRxData,
 | |
|                                                uint16_t Size);
 | |
| HAL_StatusTypeDef HAL_USART_Transmit_DMA(USART_HandleTypeDef *husart, const uint8_t *pTxData, uint16_t Size);
 | |
| HAL_StatusTypeDef HAL_USART_Receive_DMA(USART_HandleTypeDef *husart, uint8_t *pRxData, uint16_t Size);
 | |
| HAL_StatusTypeDef HAL_USART_TransmitReceive_DMA(USART_HandleTypeDef *husart, const uint8_t *pTxData, uint8_t *pRxData,
 | |
|                                                 uint16_t Size);
 | |
| HAL_StatusTypeDef HAL_USART_DMAPause(USART_HandleTypeDef *husart);
 | |
| HAL_StatusTypeDef HAL_USART_DMAResume(USART_HandleTypeDef *husart);
 | |
| HAL_StatusTypeDef HAL_USART_DMAStop(USART_HandleTypeDef *husart);
 | |
| /* Transfer Abort functions */
 | |
| HAL_StatusTypeDef HAL_USART_Abort(USART_HandleTypeDef *husart);
 | |
| HAL_StatusTypeDef HAL_USART_Abort_IT(USART_HandleTypeDef *husart);
 | |
| 
 | |
| void HAL_USART_IRQHandler(USART_HandleTypeDef *husart);
 | |
| void HAL_USART_TxHalfCpltCallback(USART_HandleTypeDef *husart);
 | |
| void HAL_USART_TxCpltCallback(USART_HandleTypeDef *husart);
 | |
| void HAL_USART_RxCpltCallback(USART_HandleTypeDef *husart);
 | |
| void HAL_USART_RxHalfCpltCallback(USART_HandleTypeDef *husart);
 | |
| void HAL_USART_TxRxCpltCallback(USART_HandleTypeDef *husart);
 | |
| void HAL_USART_ErrorCallback(USART_HandleTypeDef *husart);
 | |
| void HAL_USART_AbortCpltCallback(USART_HandleTypeDef *husart);
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /** @addtogroup USART_Exported_Functions_Group4 Peripheral State and Error functions
 | |
|   * @{
 | |
|   */
 | |
| 
 | |
| /* Peripheral State and Error functions ***************************************/
 | |
| HAL_USART_StateTypeDef HAL_USART_GetState(USART_HandleTypeDef *husart);
 | |
| uint32_t               HAL_USART_GetError(USART_HandleTypeDef *husart);
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| /**
 | |
|   * @}
 | |
|   */
 | |
| 
 | |
| #ifdef __cplusplus
 | |
| }
 | |
| #endif
 | |
| 
 | |
| #endif /* STM32F7xx_HAL_USART_H */
 | |
| 
 |