mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_NUCLEO_F303RE/TOOLCHAIN_ARM_MICRO/stm32f3xx_hal_uart.h@171:3a7713b1edbc, 2018-11-08 (annotated)

Committer:
AnnaBridge
Date:
Thu Nov 08 11:45:42 2018 +0000
Revision:
171:3a7713b1edbc
Parent:
TARGET_DISCO_F303VC/TARGET_STM/TARGET_STM32F3/device/stm32f3xx_hal_uart.h@168:b9e159c1930a 
mbed library. Release version 164

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 163:e59c8e839560 1 /**
AnnaBridge 163:e59c8e839560 2 ******************************************************************************
AnnaBridge 163:e59c8e839560 3 * @file stm32f3xx_hal_uart.h
AnnaBridge 163:e59c8e839560 4 * @author MCD Application Team
AnnaBridge 163:e59c8e839560 5 * @brief Header file of UART HAL module.
AnnaBridge 163:e59c8e839560 6 ******************************************************************************
AnnaBridge 163:e59c8e839560 7 * @attention
AnnaBridge 163:e59c8e839560 8 *
AnnaBridge 163:e59c8e839560 9 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
AnnaBridge 163:e59c8e839560 10 *
AnnaBridge 163:e59c8e839560 11 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 163:e59c8e839560 12 * are permitted provided that the following conditions are met:
AnnaBridge 163:e59c8e839560 13 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 163:e59c8e839560 14 * this list of conditions and the following disclaimer.
AnnaBridge 163:e59c8e839560 15 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 163:e59c8e839560 16 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 163:e59c8e839560 17 * and/or other materials provided with the distribution.
AnnaBridge 163:e59c8e839560 18 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 163:e59c8e839560 19 * may be used to endorse or promote products derived from this software
AnnaBridge 163:e59c8e839560 20 * without specific prior written permission.
AnnaBridge 163:e59c8e839560 21 *
AnnaBridge 163:e59c8e839560 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 163:e59c8e839560 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 163:e59c8e839560 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 163:e59c8e839560 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 163:e59c8e839560 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 163:e59c8e839560 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 163:e59c8e839560 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 163:e59c8e839560 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 163:e59c8e839560 30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 163:e59c8e839560 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 163:e59c8e839560 32 *
AnnaBridge 163:e59c8e839560 33 ******************************************************************************
AnnaBridge 163:e59c8e839560 34 */
AnnaBridge 163:e59c8e839560 35
AnnaBridge 163:e59c8e839560 36 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 163:e59c8e839560 37 #ifndef __STM32F3xx_HAL_UART_H
AnnaBridge 163:e59c8e839560 38 #define __STM32F3xx_HAL_UART_H
AnnaBridge 163:e59c8e839560 39
AnnaBridge 163:e59c8e839560 40 #ifdef __cplusplus
AnnaBridge 163:e59c8e839560 41 extern "C" {
AnnaBridge 163:e59c8e839560 42 #endif
AnnaBridge 163:e59c8e839560 43
AnnaBridge 163:e59c8e839560 44 /* Includes ------------------------------------------------------------------*/
AnnaBridge 163:e59c8e839560 45 #include "stm32f3xx_hal_def.h"
AnnaBridge 163:e59c8e839560 46
AnnaBridge 163:e59c8e839560 47 /** @addtogroup STM32F3xx_HAL_Driver
AnnaBridge 163:e59c8e839560 48 * @{
AnnaBridge 163:e59c8e839560 49 */
AnnaBridge 163:e59c8e839560 50
AnnaBridge 163:e59c8e839560 51 /** @addtogroup UART
AnnaBridge 163:e59c8e839560 52 * @{
AnnaBridge 163:e59c8e839560 53 */
AnnaBridge 163:e59c8e839560 54
AnnaBridge 163:e59c8e839560 55 /* Exported types ------------------------------------------------------------*/
AnnaBridge 163:e59c8e839560 56 /** @defgroup UART_Exported_Types UART Exported Types
AnnaBridge 163:e59c8e839560 57 * @{
AnnaBridge 163:e59c8e839560 58 */
AnnaBridge 163:e59c8e839560 59
AnnaBridge 163:e59c8e839560 60 /**
AnnaBridge 163:e59c8e839560 61 * @brief UART Init Structure definition
AnnaBridge 163:e59c8e839560 62 */
AnnaBridge 163:e59c8e839560 63 typedef struct
AnnaBridge 163:e59c8e839560 64 {
AnnaBridge 163:e59c8e839560 65 uint32_t BaudRate; /*!< This member configures the UART communication baud rate.
AnnaBridge 163:e59c8e839560 66 The baud rate register is computed using the following formula:
AnnaBridge 163:e59c8e839560 67 - If oversampling is 16 or in LIN mode,
AnnaBridge 163:e59c8e839560 68 Baud Rate Register = ((PCLKx) / ((huart->Init.BaudRate)))
AnnaBridge 163:e59c8e839560 69 - If oversampling is 8U,
AnnaBridge 163:e59c8e839560 70 Baud Rate Register[15:4] = ((2U * PCLKx) / ((huart->Init.BaudRate)))[15:4]
AnnaBridge 163:e59c8e839560 71 Baud Rate Register[3] = 0
AnnaBridge 163:e59c8e839560 72 Baud Rate Register[2:0] = (((2U * PCLKx) / ((huart->Init.BaudRate)))[3:0]) >> 1 */
AnnaBridge 163:e59c8e839560 73
AnnaBridge 163:e59c8e839560 74 uint32_t WordLength; /*!< Specifies the number of data bits transmitted or received in a frame.
AnnaBridge 163:e59c8e839560 75 This parameter can be a value of @ref UARTEx_Word_Length. */
AnnaBridge 163:e59c8e839560 76
AnnaBridge 163:e59c8e839560 77 uint32_t StopBits; /*!< Specifies the number of stop bits transmitted.
AnnaBridge 163:e59c8e839560 78 This parameter can be a value of @ref UART_Stop_Bits. */
AnnaBridge 163:e59c8e839560 79
AnnaBridge 163:e59c8e839560 80 uint32_t Parity; /*!< Specifies the parity mode.
AnnaBridge 163:e59c8e839560 81 This parameter can be a value of @ref UART_Parity
AnnaBridge 163:e59c8e839560 82 @note When parity is enabled, the computed parity is inserted
AnnaBridge 163:e59c8e839560 83 at the MSB position of the transmitted data (9th bit when
AnnaBridge 163:e59c8e839560 84 the word length is set to 9 data bits; 8th bit when the
AnnaBridge 163:e59c8e839560 85 word length is set to 8 data bits). */
AnnaBridge 163:e59c8e839560 86
AnnaBridge 163:e59c8e839560 87 uint32_t Mode; /*!< Specifies whether the Receive or Transmit mode is enabled or disabled.
AnnaBridge 163:e59c8e839560 88 This parameter can be a value of @ref UART_Mode. */
AnnaBridge 163:e59c8e839560 89
AnnaBridge 163:e59c8e839560 90 uint32_t HwFlowCtl; /*!< Specifies whether the hardware flow control mode is enabled
AnnaBridge 163:e59c8e839560 91 or disabled.
AnnaBridge 163:e59c8e839560 92 This parameter can be a value of @ref UART_Hardware_Flow_Control. */
AnnaBridge 163:e59c8e839560 93
AnnaBridge 163:e59c8e839560 94 uint32_t OverSampling; /*!< Specifies whether the Over sampling 8 is enabled or disabled, to achieve higher speed (up to f_PCLK/8U).
AnnaBridge 163:e59c8e839560 95 This parameter can be a value of @ref UART_Over_Sampling. */
AnnaBridge 163:e59c8e839560 96
AnnaBridge 163:e59c8e839560 97 uint32_t OneBitSampling; /*!< Specifies whether a single sample or three samples' majority vote is selected.
AnnaBridge 163:e59c8e839560 98 Selecting the single sample method increases the receiver tolerance to clock
AnnaBridge 163:e59c8e839560 99 deviations. This parameter can be a value of @ref UART_OneBit_Sampling. */
AnnaBridge 163:e59c8e839560 100 }UART_InitTypeDef;
AnnaBridge 163:e59c8e839560 101
AnnaBridge 163:e59c8e839560 102 /**
AnnaBridge 163:e59c8e839560 103 * @brief UART Advanced Features initalization structure definition
AnnaBridge 163:e59c8e839560 104 */
AnnaBridge 163:e59c8e839560 105 typedef struct
AnnaBridge 163:e59c8e839560 106 {
AnnaBridge 163:e59c8e839560 107 uint32_t AdvFeatureInit; /*!< Specifies which advanced UART features is initialized. Several
AnnaBridge 163:e59c8e839560 108 Advanced Features may be initialized at the same time .
AnnaBridge 163:e59c8e839560 109 This parameter can be a value of @ref UART_Advanced_Features_Initialization_Type. */
AnnaBridge 163:e59c8e839560 110
AnnaBridge 163:e59c8e839560 111 uint32_t TxPinLevelInvert; /*!< Specifies whether the TX pin active level is inverted.
AnnaBridge 163:e59c8e839560 112 This parameter can be a value of @ref UART_Tx_Inv. */
AnnaBridge 163:e59c8e839560 113
AnnaBridge 163:e59c8e839560 114 uint32_t RxPinLevelInvert; /*!< Specifies whether the RX pin active level is inverted.
AnnaBridge 163:e59c8e839560 115 This parameter can be a value of @ref UART_Rx_Inv. */
AnnaBridge 163:e59c8e839560 116
AnnaBridge 163:e59c8e839560 117 uint32_t DataInvert; /*!< Specifies whether data are inverted (positive/direct logic
AnnaBridge 163:e59c8e839560 118 vs negative/inverted logic).
AnnaBridge 163:e59c8e839560 119 This parameter can be a value of @ref UART_Data_Inv. */
AnnaBridge 163:e59c8e839560 120
AnnaBridge 163:e59c8e839560 121 uint32_t Swap; /*!< Specifies whether TX and RX pins are swapped.
AnnaBridge 163:e59c8e839560 122 This parameter can be a value of @ref UART_Rx_Tx_Swap. */
AnnaBridge 163:e59c8e839560 123
AnnaBridge 163:e59c8e839560 124 uint32_t OverrunDisable; /*!< Specifies whether the reception overrun detection is disabled.
AnnaBridge 163:e59c8e839560 125 This parameter can be a value of @ref UART_Overrun_Disable. */
AnnaBridge 163:e59c8e839560 126
AnnaBridge 163:e59c8e839560 127 uint32_t DMADisableonRxError; /*!< Specifies whether the DMA is disabled in case of reception error.
AnnaBridge 163:e59c8e839560 128 This parameter can be a value of @ref UART_DMA_Disable_on_Rx_Error. */
AnnaBridge 163:e59c8e839560 129
AnnaBridge 163:e59c8e839560 130 uint32_t AutoBaudRateEnable; /*!< Specifies whether auto Baud rate detection is enabled.
AnnaBridge 163:e59c8e839560 131 This parameter can be a value of @ref UART_AutoBaudRate_Enable */
AnnaBridge 163:e59c8e839560 132
AnnaBridge 163:e59c8e839560 133 uint32_t AutoBaudRateMode; /*!< If auto Baud rate detection is enabled, specifies how the rate
AnnaBridge 163:e59c8e839560 134 detection is carried out.
AnnaBridge 163:e59c8e839560 135 This parameter can be a value of @ref UART_AutoBaud_Rate_Mode. */
AnnaBridge 163:e59c8e839560 136
AnnaBridge 163:e59c8e839560 137 uint32_t MSBFirst; /*!< Specifies whether MSB is sent first on UART line.
AnnaBridge 163:e59c8e839560 138 This parameter can be a value of @ref UART_MSB_First. */
AnnaBridge 163:e59c8e839560 139 } UART_AdvFeatureInitTypeDef;
AnnaBridge 163:e59c8e839560 140
AnnaBridge 163:e59c8e839560 141 /**
AnnaBridge 163:e59c8e839560 142 * @brief UART wake up from stop mode parameters
AnnaBridge 163:e59c8e839560 143 */
AnnaBridge 163:e59c8e839560 144 typedef struct
AnnaBridge 163:e59c8e839560 145 {
AnnaBridge 163:e59c8e839560 146 uint32_t WakeUpEvent; /*!< Specifies which event will activat the Wakeup from Stop mode flag (WUF).
AnnaBridge 163:e59c8e839560 147 This parameter can be a value of @ref UART_WakeUp_from_Stop_Selection.
AnnaBridge 163:e59c8e839560 148 If set to UART_WAKEUP_ON_ADDRESS, the two other fields below must
AnnaBridge 163:e59c8e839560 149 be filled up. */
AnnaBridge 163:e59c8e839560 150
AnnaBridge 163:e59c8e839560 151 uint16_t AddressLength; /*!< Specifies whether the address is 4 or 7-bit long.
AnnaBridge 163:e59c8e839560 152 This parameter can be a value of @ref UART_WakeUp_Address_Length. */
AnnaBridge 163:e59c8e839560 153
AnnaBridge 163:e59c8e839560 154 uint8_t Address; /*!< UART/USART node address (7-bit long max). */
AnnaBridge 163:e59c8e839560 155 } UART_WakeUpTypeDef;
AnnaBridge 163:e59c8e839560 156
AnnaBridge 163:e59c8e839560 157 /**
AnnaBridge 163:e59c8e839560 158 * @brief HAL UART State structures definition
AnnaBridge 163:e59c8e839560 159 * @note HAL UART State value is a combination of 2 different substates: gState and RxState.
AnnaBridge 163:e59c8e839560 160 * - gState contains UART state information related to global Handle management
AnnaBridge 163:e59c8e839560 161 * and also information related to Tx operations.
AnnaBridge 163:e59c8e839560 162 * gState value coding follow below described bitmap :
AnnaBridge 163:e59c8e839560 163 * b7-b6 Error information
AnnaBridge 163:e59c8e839560 164 * 00 : No Error
AnnaBridge 163:e59c8e839560 165 * 01 : (Not Used)
AnnaBridge 163:e59c8e839560 166 * 10 : Timeout
AnnaBridge 163:e59c8e839560 167 * 11 : Error
AnnaBridge 163:e59c8e839560 168 * b5 IP initilisation status
AnnaBridge 163:e59c8e839560 169 * 0 : Reset (IP not initialized)
AnnaBridge 163:e59c8e839560 170 * 1 : Init done (IP not initialized. HAL UART Init function already called)
AnnaBridge 163:e59c8e839560 171 * b4-b3 (not used)
AnnaBridge 163:e59c8e839560 172 * xx : Should be set to 00
AnnaBridge 163:e59c8e839560 173 * b2 Intrinsic process state
AnnaBridge 163:e59c8e839560 174 * 0 : Ready
AnnaBridge 163:e59c8e839560 175 * 1 : Busy (IP busy with some configuration or internal operations)
AnnaBridge 163:e59c8e839560 176 * b1 (not used)
AnnaBridge 163:e59c8e839560 177 * x : Should be set to 0
AnnaBridge 163:e59c8e839560 178 * b0 Tx state
AnnaBridge 163:e59c8e839560 179 * 0 : Ready (no Tx operation ongoing)
AnnaBridge 163:e59c8e839560 180 * 1 : Busy (Tx operation ongoing)
AnnaBridge 163:e59c8e839560 181 * - RxState contains information related to Rx operations.
AnnaBridge 163:e59c8e839560 182 * RxState value coding follow below described bitmap :
AnnaBridge 163:e59c8e839560 183 * b7-b6 (not used)
AnnaBridge 163:e59c8e839560 184 * xx : Should be set to 00
AnnaBridge 163:e59c8e839560 185 * b5 IP initilisation status
AnnaBridge 163:e59c8e839560 186 * 0 : Reset (IP not initialized)
AnnaBridge 163:e59c8e839560 187 * 1 : Init done (IP not initialized)
AnnaBridge 163:e59c8e839560 188 * b4-b2 (not used)
AnnaBridge 163:e59c8e839560 189 * xxx : Should be set to 000
AnnaBridge 163:e59c8e839560 190 * b1 Rx state
AnnaBridge 163:e59c8e839560 191 * 0 : Ready (no Rx operation ongoing)
AnnaBridge 163:e59c8e839560 192 * 1 : Busy (Rx operation ongoing)
AnnaBridge 163:e59c8e839560 193 * b0 (not used)
AnnaBridge 163:e59c8e839560 194 * x : Should be set to 0.
AnnaBridge 163:e59c8e839560 195 */
AnnaBridge 163:e59c8e839560 196 typedef enum
AnnaBridge 163:e59c8e839560 197 {
AnnaBridge 163:e59c8e839560 198 HAL_UART_STATE_RESET = 0x00U, /*!< Peripheral is not initialized
AnnaBridge 163:e59c8e839560 199 Value is allowed for gState and RxState */
AnnaBridge 163:e59c8e839560 200 HAL_UART_STATE_READY = 0x20U, /*!< Peripheral Initialized and ready for use
AnnaBridge 163:e59c8e839560 201 Value is allowed for gState and RxState */
AnnaBridge 163:e59c8e839560 202 HAL_UART_STATE_BUSY = 0x24U, /*!< an internal process is ongoing
AnnaBridge 163:e59c8e839560 203 Value is allowed for gState only */
AnnaBridge 163:e59c8e839560 204 HAL_UART_STATE_BUSY_TX = 0x21U, /*!< Data Transmission process is ongoing
AnnaBridge 163:e59c8e839560 205 Value is allowed for gState only */
AnnaBridge 163:e59c8e839560 206 HAL_UART_STATE_BUSY_RX = 0x22U, /*!< Data Reception process is ongoing
AnnaBridge 163:e59c8e839560 207 Value is allowed for RxState only */
AnnaBridge 163:e59c8e839560 208 HAL_UART_STATE_BUSY_TX_RX = 0x23U, /*!< Data Transmission and Reception process is ongoing
AnnaBridge 163:e59c8e839560 209 Not to be used for neither gState nor RxState.
AnnaBridge 163:e59c8e839560 210 Value is result of combination (Or) between gState and RxState values */
AnnaBridge 163:e59c8e839560 211 HAL_UART_STATE_TIMEOUT = 0xA0U, /*!< Timeout state
AnnaBridge 163:e59c8e839560 212 Value is allowed for gState only */
AnnaBridge 163:e59c8e839560 213 HAL_UART_STATE_ERROR = 0xE0U /*!< Error
AnnaBridge 163:e59c8e839560 214 Value is allowed for gState only */
AnnaBridge 163:e59c8e839560 215 }HAL_UART_StateTypeDef;
AnnaBridge 163:e59c8e839560 216
AnnaBridge 163:e59c8e839560 217 /**
AnnaBridge 163:e59c8e839560 218 * @brief UART clock sources definition
AnnaBridge 163:e59c8e839560 219 */
AnnaBridge 163:e59c8e839560 220 typedef enum
AnnaBridge 163:e59c8e839560 221 {
AnnaBridge 163:e59c8e839560 222 UART_CLOCKSOURCE_PCLK1 = 0x00U, /*!< PCLK1 clock source */
AnnaBridge 163:e59c8e839560 223 UART_CLOCKSOURCE_PCLK2 = 0x01U, /*!< PCLK2 clock source */
AnnaBridge 163:e59c8e839560 224 UART_CLOCKSOURCE_HSI = 0x02U, /*!< HSI clock source */
AnnaBridge 163:e59c8e839560 225 UART_CLOCKSOURCE_SYSCLK = 0x04U, /*!< SYSCLK clock source */
AnnaBridge 163:e59c8e839560 226 UART_CLOCKSOURCE_LSE = 0x08U, /*!< LSE clock source */
AnnaBridge 163:e59c8e839560 227 UART_CLOCKSOURCE_UNDEFINED = 0x10U /*!< Undefined clock source */
AnnaBridge 163:e59c8e839560 228 }UART_ClockSourceTypeDef;
AnnaBridge 163:e59c8e839560 229
AnnaBridge 163:e59c8e839560 230 /**
AnnaBridge 163:e59c8e839560 231 * @brief UART handle Structure definition
AnnaBridge 163:e59c8e839560 232 */
AnnaBridge 163:e59c8e839560 233 typedef struct
AnnaBridge 163:e59c8e839560 234 {
AnnaBridge 163:e59c8e839560 235 USART_TypeDef *Instance; /*!< UART registers base address */
AnnaBridge 163:e59c8e839560 236
AnnaBridge 163:e59c8e839560 237 UART_InitTypeDef Init; /*!< UART communication parameters */
AnnaBridge 163:e59c8e839560 238
AnnaBridge 163:e59c8e839560 239 UART_AdvFeatureInitTypeDef AdvancedInit; /*!< UART Advanced Features initialization parameters */
AnnaBridge 163:e59c8e839560 240
AnnaBridge 163:e59c8e839560 241 uint8_t *pTxBuffPtr; /*!< Pointer to UART Tx transfer Buffer */
AnnaBridge 163:e59c8e839560 242
AnnaBridge 163:e59c8e839560 243 uint16_t TxXferSize; /*!< UART Tx Transfer size */
AnnaBridge 163:e59c8e839560 244
AnnaBridge 163:e59c8e839560 245 __IO uint16_t TxXferCount; /*!< UART Tx Transfer Counter */
AnnaBridge 163:e59c8e839560 246
AnnaBridge 163:e59c8e839560 247 uint8_t *pRxBuffPtr; /*!< Pointer to UART Rx transfer Buffer */
AnnaBridge 163:e59c8e839560 248
AnnaBridge 163:e59c8e839560 249 uint16_t RxXferSize; /*!< UART Rx Transfer size */
AnnaBridge 163:e59c8e839560 250
AnnaBridge 163:e59c8e839560 251 __IO uint16_t RxXferCount; /*!< UART Rx Transfer Counter */
AnnaBridge 163:e59c8e839560 252
AnnaBridge 163:e59c8e839560 253 uint16_t Mask; /*!< UART Rx RDR register mask */
AnnaBridge 163:e59c8e839560 254
AnnaBridge 163:e59c8e839560 255 DMA_HandleTypeDef *hdmatx; /*!< UART Tx DMA Handle parameters */
AnnaBridge 163:e59c8e839560 256
AnnaBridge 163:e59c8e839560 257 DMA_HandleTypeDef *hdmarx; /*!< UART Rx DMA Handle parameters */
AnnaBridge 163:e59c8e839560 258
AnnaBridge 163:e59c8e839560 259 HAL_LockTypeDef Lock; /*!< Locking object */
AnnaBridge 163:e59c8e839560 260
AnnaBridge 163:e59c8e839560 261 __IO HAL_UART_StateTypeDef gState; /*!< UART state information related to global Handle management
AnnaBridge 163:e59c8e839560 262 and also related to Tx operations.
AnnaBridge 163:e59c8e839560 263 This parameter can be a value of @ref HAL_UART_StateTypeDef */
AnnaBridge 163:e59c8e839560 264
AnnaBridge 163:e59c8e839560 265 __IO HAL_UART_StateTypeDef RxState; /*!< UART state information related to Rx operations.
AnnaBridge 163:e59c8e839560 266 This parameter can be a value of @ref HAL_UART_StateTypeDef */
AnnaBridge 163:e59c8e839560 267
AnnaBridge 163:e59c8e839560 268 __IO uint32_t ErrorCode; /*!< UART Error code */
AnnaBridge 163:e59c8e839560 269
AnnaBridge 163:e59c8e839560 270 }UART_HandleTypeDef;
AnnaBridge 163:e59c8e839560 271
AnnaBridge 163:e59c8e839560 272 /**
AnnaBridge 163:e59c8e839560 273 * @}
AnnaBridge 163:e59c8e839560 274 */
AnnaBridge 163:e59c8e839560 275
AnnaBridge 163:e59c8e839560 276 /* Exported constants --------------------------------------------------------*/
AnnaBridge 163:e59c8e839560 277 /** @defgroup UART_Exported_Constants UART Exported Constants
AnnaBridge 163:e59c8e839560 278 * @{
AnnaBridge 163:e59c8e839560 279 */
AnnaBridge 163:e59c8e839560 280
AnnaBridge 163:e59c8e839560 281 /** @defgroup UART_Error UART Error
AnnaBridge 163:e59c8e839560 282 * @{
AnnaBridge 163:e59c8e839560 283 */
AnnaBridge 163:e59c8e839560 284 #define HAL_UART_ERROR_NONE (0x00000000U) /*!< No error */
AnnaBridge 163:e59c8e839560 285 #define HAL_UART_ERROR_PE (0x00000001U) /*!< Parity error */
AnnaBridge 163:e59c8e839560 286 #define HAL_UART_ERROR_NE (0x00000002U) /*!< Noise error */
AnnaBridge 163:e59c8e839560 287 #define HAL_UART_ERROR_FE (0x00000004U) /*!< frame error */
AnnaBridge 163:e59c8e839560 288 #define HAL_UART_ERROR_ORE (0x00000008U) /*!< Overrun error */
AnnaBridge 163:e59c8e839560 289 #define HAL_UART_ERROR_DMA (0x00000010U) /*!< DMA transfer error */
AnnaBridge 163:e59c8e839560 290 #define HAL_UART_ERROR_BUSY (0x00000020U) /*!< Busy Error */
AnnaBridge 163:e59c8e839560 291 /**
AnnaBridge 163:e59c8e839560 292 * @}
AnnaBridge 163:e59c8e839560 293 */
AnnaBridge 163:e59c8e839560 294
AnnaBridge 163:e59c8e839560 295 /** @defgroup UART_Stop_Bits UART Number of Stop Bits
AnnaBridge 163:e59c8e839560 296 * @{
AnnaBridge 163:e59c8e839560 297 */
AnnaBridge 163:e59c8e839560 298 #define UART_STOPBITS_0_5 USART_CR2_STOP_0 /*!< UART frame with 0.5 stop bit */
AnnaBridge 163:e59c8e839560 299 #define UART_STOPBITS_1 (0x00000000U) /*!< UART frame with 1 stop bit */
AnnaBridge 163:e59c8e839560 300 #define UART_STOPBITS_1_5 ((uint32_t)(USART_CR2_STOP_0 | USART_CR2_STOP_1)) /*!< UART frame with 1.5 stop bits */
AnnaBridge 163:e59c8e839560 301 #define UART_STOPBITS_2 ((uint32_t)USART_CR2_STOP_1) /*!< UART frame with 2 stop bits */
AnnaBridge 163:e59c8e839560 302 /**
AnnaBridge 163:e59c8e839560 303 * @}
AnnaBridge 163:e59c8e839560 304 */
AnnaBridge 163:e59c8e839560 305
AnnaBridge 163:e59c8e839560 306 /** @defgroup UART_Parity UART Parity
AnnaBridge 163:e59c8e839560 307 * @{
AnnaBridge 163:e59c8e839560 308 */
AnnaBridge 163:e59c8e839560 309 #define UART_PARITY_NONE (0x00000000U) /*!< No parity */
AnnaBridge 163:e59c8e839560 310 #define UART_PARITY_EVEN ((uint32_t)USART_CR1_PCE) /*!< Even parity */
AnnaBridge 163:e59c8e839560 311 #define UART_PARITY_ODD ((uint32_t)(USART_CR1_PCE | USART_CR1_PS)) /*!< Odd parity */
AnnaBridge 163:e59c8e839560 312 /**
AnnaBridge 163:e59c8e839560 313 * @}
AnnaBridge 163:e59c8e839560 314 */
AnnaBridge 163:e59c8e839560 315
AnnaBridge 163:e59c8e839560 316 /** @defgroup UART_Hardware_Flow_Control UART Hardware Flow Control
AnnaBridge 163:e59c8e839560 317 * @{
AnnaBridge 163:e59c8e839560 318 */
AnnaBridge 163:e59c8e839560 319 #define UART_HWCONTROL_NONE (0x00000000U) /*!< No hardware control */
AnnaBridge 163:e59c8e839560 320 #define UART_HWCONTROL_RTS ((uint32_t)USART_CR3_RTSE) /*!< Request To Send */
AnnaBridge 163:e59c8e839560 321 #define UART_HWCONTROL_CTS ((uint32_t)USART_CR3_CTSE) /*!< Clear To Send */
AnnaBridge 163:e59c8e839560 322 #define UART_HWCONTROL_RTS_CTS ((uint32_t)(USART_CR3_RTSE | USART_CR3_CTSE)) /*!< Request and Clear To Send */
AnnaBridge 163:e59c8e839560 323 /**
AnnaBridge 163:e59c8e839560 324 * @}
AnnaBridge 163:e59c8e839560 325 */
AnnaBridge 163:e59c8e839560 326
AnnaBridge 163:e59c8e839560 327 /** @defgroup UART_Mode UART Transfer Mode
AnnaBridge 163:e59c8e839560 328 * @{
AnnaBridge 163:e59c8e839560 329 */
AnnaBridge 163:e59c8e839560 330 #define UART_MODE_RX ((uint32_t)USART_CR1_RE) /*!< RX mode */
AnnaBridge 163:e59c8e839560 331 #define UART_MODE_TX ((uint32_t)USART_CR1_TE) /*!< TX mode */
AnnaBridge 163:e59c8e839560 332 #define UART_MODE_TX_RX ((uint32_t)(USART_CR1_TE |USART_CR1_RE)) /*!< RX and TX mode */
AnnaBridge 163:e59c8e839560 333 /**
AnnaBridge 163:e59c8e839560 334 * @}
AnnaBridge 163:e59c8e839560 335 */
AnnaBridge 163:e59c8e839560 336
AnnaBridge 163:e59c8e839560 337 /** @defgroup UART_State UART State
AnnaBridge 163:e59c8e839560 338 * @{
AnnaBridge 163:e59c8e839560 339 */
AnnaBridge 163:e59c8e839560 340 #define UART_STATE_DISABLE (0x00000000U) /*!< UART disabled */
AnnaBridge 163:e59c8e839560 341 #define UART_STATE_ENABLE ((uint32_t)USART_CR1_UE) /*!< UART enabled */
AnnaBridge 163:e59c8e839560 342 /**
AnnaBridge 163:e59c8e839560 343 * @}
AnnaBridge 163:e59c8e839560 344 */
AnnaBridge 163:e59c8e839560 345
AnnaBridge 163:e59c8e839560 346 /** @defgroup UART_Over_Sampling UART Over Sampling
AnnaBridge 163:e59c8e839560 347 * @{
AnnaBridge 163:e59c8e839560 348 */
AnnaBridge 163:e59c8e839560 349 #define UART_OVERSAMPLING_16 (0x00000000U) /*!< Oversampling by 16U */
AnnaBridge 163:e59c8e839560 350 #define UART_OVERSAMPLING_8 ((uint32_t)USART_CR1_OVER8) /*!< Oversampling by 8 */
AnnaBridge 163:e59c8e839560 351 /**
AnnaBridge 163:e59c8e839560 352 * @}
AnnaBridge 163:e59c8e839560 353 */
AnnaBridge 163:e59c8e839560 354
AnnaBridge 163:e59c8e839560 355 /** @defgroup UART_OneBit_Sampling UART One Bit Sampling Method
AnnaBridge 163:e59c8e839560 356 * @{
AnnaBridge 163:e59c8e839560 357 */
AnnaBridge 163:e59c8e839560 358 #define UART_ONE_BIT_SAMPLE_DISABLE (0x00000000U) /*!< One-bit sampling disable */
AnnaBridge 163:e59c8e839560 359 #define UART_ONE_BIT_SAMPLE_ENABLE ((uint32_t)USART_CR3_ONEBIT) /*!< One-bit sampling enable */
AnnaBridge 163:e59c8e839560 360 /**
AnnaBridge 163:e59c8e839560 361 * @}
AnnaBridge 163:e59c8e839560 362 */
AnnaBridge 163:e59c8e839560 363
AnnaBridge 163:e59c8e839560 364 /** @defgroup UART_AutoBaud_Rate_Mode UART Advanced Feature AutoBaud Rate Mode
AnnaBridge 163:e59c8e839560 365 * @{
AnnaBridge 163:e59c8e839560 366 */
AnnaBridge 163:e59c8e839560 367 #define UART_ADVFEATURE_AUTOBAUDRATE_ONSTARTBIT (0x00000000U) /*!< Auto Baud rate detection on start bit */
AnnaBridge 163:e59c8e839560 368 #define UART_ADVFEATURE_AUTOBAUDRATE_ONFALLINGEDGE ((uint32_t)USART_CR2_ABRMODE_0) /*!< Auto Baud rate detection on falling edge */
AnnaBridge 163:e59c8e839560 369 #define UART_ADVFEATURE_AUTOBAUDRATE_ON0X7FFRAME ((uint32_t)USART_CR2_ABRMODE_1) /*!< Auto Baud rate detection on 0x7F frame detection */
AnnaBridge 163:e59c8e839560 370 #define UART_ADVFEATURE_AUTOBAUDRATE_ON0X55FRAME ((uint32_t)USART_CR2_ABRMODE) /*!< Auto Baud rate detection on 0x55 frame detection */
AnnaBridge 163:e59c8e839560 371 /**
AnnaBridge 163:e59c8e839560 372 * @}
AnnaBridge 163:e59c8e839560 373 */
AnnaBridge 163:e59c8e839560 374
AnnaBridge 163:e59c8e839560 375 /** @defgroup UART_Receiver_TimeOut UART Receiver TimeOut
AnnaBridge 163:e59c8e839560 376 * @{
AnnaBridge 163:e59c8e839560 377 */
AnnaBridge 163:e59c8e839560 378 #define UART_RECEIVER_TIMEOUT_DISABLE (0x00000000U) /*!< UART receiver timeout disable */
AnnaBridge 163:e59c8e839560 379 #define UART_RECEIVER_TIMEOUT_ENABLE ((uint32_t)USART_CR2_RTOEN) /*!< UART receiver timeout enable */
AnnaBridge 163:e59c8e839560 380 /**
AnnaBridge 163:e59c8e839560 381 * @}
AnnaBridge 163:e59c8e839560 382 */
AnnaBridge 163:e59c8e839560 383
AnnaBridge 163:e59c8e839560 384 /** @defgroup UART_LIN UART Local Interconnection Network mode
AnnaBridge 163:e59c8e839560 385 * @{
AnnaBridge 163:e59c8e839560 386 */
AnnaBridge 163:e59c8e839560 387 #define UART_LIN_DISABLE (0x00000000U) /*!< Local Interconnect Network disable */
AnnaBridge 163:e59c8e839560 388 #define UART_LIN_ENABLE ((uint32_t)USART_CR2_LINEN) /*!< Local Interconnect Network enable */
AnnaBridge 163:e59c8e839560 389 /**
AnnaBridge 163:e59c8e839560 390 * @}
AnnaBridge 163:e59c8e839560 391 */
AnnaBridge 163:e59c8e839560 392
AnnaBridge 163:e59c8e839560 393 /** @defgroup UART_LIN_Break_Detection UART LIN Break Detection
AnnaBridge 163:e59c8e839560 394 * @{
AnnaBridge 163:e59c8e839560 395 */
AnnaBridge 163:e59c8e839560 396 #define UART_LINBREAKDETECTLENGTH_10B (0x00000000U) /*!< LIN 10-bit break detection length */
AnnaBridge 163:e59c8e839560 397 #define UART_LINBREAKDETECTLENGTH_11B ((uint32_t)USART_CR2_LBDL) /*!< LIN 11-bit break detection length */
AnnaBridge 163:e59c8e839560 398 /**
AnnaBridge 163:e59c8e839560 399 * @}
AnnaBridge 163:e59c8e839560 400 */
AnnaBridge 163:e59c8e839560 401
AnnaBridge 163:e59c8e839560 402 /** @defgroup UART_DMA_Tx UART DMA Tx
AnnaBridge 163:e59c8e839560 403 * @{
AnnaBridge 163:e59c8e839560 404 */
AnnaBridge 163:e59c8e839560 405 #define UART_DMA_TX_DISABLE (0x00000000U) /*!< UART DMA TX disabled */
AnnaBridge 163:e59c8e839560 406 #define UART_DMA_TX_ENABLE ((uint32_t)USART_CR3_DMAT) /*!< UART DMA TX enabled */
AnnaBridge 163:e59c8e839560 407 /**
AnnaBridge 163:e59c8e839560 408 * @}
AnnaBridge 163:e59c8e839560 409 */
AnnaBridge 163:e59c8e839560 410
AnnaBridge 163:e59c8e839560 411 /** @defgroup UART_DMA_Rx UART DMA Rx
AnnaBridge 163:e59c8e839560 412 * @{
AnnaBridge 163:e59c8e839560 413 */
AnnaBridge 163:e59c8e839560 414 #define UART_DMA_RX_DISABLE (0x00000000U) /*!< UART DMA RX disabled */
AnnaBridge 163:e59c8e839560 415 #define UART_DMA_RX_ENABLE ((uint32_t)USART_CR3_DMAR) /*!< UART DMA RX enabled */
AnnaBridge 163:e59c8e839560 416 /**
AnnaBridge 163:e59c8e839560 417 * @}
AnnaBridge 163:e59c8e839560 418 */
AnnaBridge 163:e59c8e839560 419
AnnaBridge 163:e59c8e839560 420 /** @defgroup UART_Half_Duplex_Selection UART Half Duplex Selection
AnnaBridge 163:e59c8e839560 421 * @{
AnnaBridge 163:e59c8e839560 422 */
AnnaBridge 163:e59c8e839560 423 #define UART_HALF_DUPLEX_DISABLE (0x00000000U) /*!< UART half-duplex disabled */
AnnaBridge 163:e59c8e839560 424 #define UART_HALF_DUPLEX_ENABLE ((uint32_t)USART_CR3_HDSEL) /*!< UART half-duplex enabled */
AnnaBridge 163:e59c8e839560 425 /**
AnnaBridge 163:e59c8e839560 426 * @}
AnnaBridge 163:e59c8e839560 427 */
AnnaBridge 163:e59c8e839560 428
AnnaBridge 163:e59c8e839560 429 /** @defgroup UART_WakeUp_Address_Length UART WakeUp Address Length
AnnaBridge 163:e59c8e839560 430 * @{
AnnaBridge 163:e59c8e839560 431 */
AnnaBridge 163:e59c8e839560 432 #define UART_ADDRESS_DETECT_4B (0x00000000U) /*!< 4-bit long wake-up address */
AnnaBridge 163:e59c8e839560 433 #define UART_ADDRESS_DETECT_7B ((uint32_t)USART_CR2_ADDM7) /*!< 7-bit long wake-up address */
AnnaBridge 163:e59c8e839560 434 /**
AnnaBridge 163:e59c8e839560 435 * @}
AnnaBridge 163:e59c8e839560 436 */
AnnaBridge 163:e59c8e839560 437
AnnaBridge 163:e59c8e839560 438 /** @defgroup UART_WakeUp_Methods UART WakeUp Methods
AnnaBridge 163:e59c8e839560 439 * @{
AnnaBridge 163:e59c8e839560 440 */
AnnaBridge 163:e59c8e839560 441 #define UART_WAKEUPMETHOD_IDLELINE (0x00000000U) /*!< UART wake-up on idle line */
AnnaBridge 163:e59c8e839560 442 #define UART_WAKEUPMETHOD_ADDRESSMARK ((uint32_t)USART_CR1_WAKE) /*!< UART wake-up on address mark */
AnnaBridge 163:e59c8e839560 443 /**
AnnaBridge 163:e59c8e839560 444 * @}
AnnaBridge 163:e59c8e839560 445 */
AnnaBridge 163:e59c8e839560 446
AnnaBridge 163:e59c8e839560 447 /** @defgroup UART_Flags UART Status Flags
AnnaBridge 163:e59c8e839560 448 * Elements values convention: 0xXXXX
AnnaBridge 163:e59c8e839560 449 * - 0xXXXX : Flag mask in the ISR register
AnnaBridge 163:e59c8e839560 450 * @{
AnnaBridge 163:e59c8e839560 451 */
AnnaBridge 163:e59c8e839560 452 #define UART_FLAG_REACK (0x00400000U) /*!< UART receive enable acknowledge flag */
AnnaBridge 163:e59c8e839560 453 #define UART_FLAG_TEACK (0x00200000U) /*!< UART transmit enable acknowledge flag */
AnnaBridge 163:e59c8e839560 454 #define UART_FLAG_WUF (0x00100000U) /*!< UART wake-up from stop mode flag */
AnnaBridge 163:e59c8e839560 455 #define UART_FLAG_RWU (0x00080000U) /*!< UART receiver wake-up from mute mode flag */
AnnaBridge 163:e59c8e839560 456 #define UART_FLAG_SBKF (0x00040000U) /*!< UART send break flag */
AnnaBridge 163:e59c8e839560 457 #define UART_FLAG_CMF (0x00020000U) /*!< UART character match flag */
AnnaBridge 163:e59c8e839560 458 #define UART_FLAG_BUSY (0x00010000U) /*!< UART busy flag */
AnnaBridge 163:e59c8e839560 459 #define UART_FLAG_ABRF (0x00008000U) /*!< UART auto Baud rate flag */
AnnaBridge 163:e59c8e839560 460 #define UART_FLAG_ABRE (0x00004000U) /*!< UART auto Baud rate error */
AnnaBridge 163:e59c8e839560 461 #define UART_FLAG_EOBF (0x00001000U) /*!< UART end of block flag */
AnnaBridge 163:e59c8e839560 462 #define UART_FLAG_RTOF (0x00000800U) /*!< UART receiver timeout flag */
AnnaBridge 163:e59c8e839560 463 #define UART_FLAG_CTS (0x00000400U) /*!< UART clear to send flag */
AnnaBridge 163:e59c8e839560 464 #define UART_FLAG_CTSIF (0x00000200U) /*!< UART clear to send interrupt flag */
AnnaBridge 163:e59c8e839560 465 #define UART_FLAG_LBDF (0x00000100U) /*!< UART LIN break detection flag */
AnnaBridge 163:e59c8e839560 466 #define UART_FLAG_TXE (0x00000080U) /*!< UART transmit data register empty */
AnnaBridge 163:e59c8e839560 467 #define UART_FLAG_TC (0x00000040U) /*!< UART transmission complete */
AnnaBridge 163:e59c8e839560 468 #define UART_FLAG_RXNE (0x00000020U) /*!< UART read data register not empty */
AnnaBridge 163:e59c8e839560 469 #define UART_FLAG_IDLE (0x00000010U) /*!< UART idle flag */
AnnaBridge 163:e59c8e839560 470 #define UART_FLAG_ORE (0x00000008U) /*!< UART overrun error */
AnnaBridge 163:e59c8e839560 471 #define UART_FLAG_NE (0x00000004U) /*!< UART noise error */
AnnaBridge 163:e59c8e839560 472 #define UART_FLAG_FE (0x00000002U) /*!< UART frame error */
AnnaBridge 163:e59c8e839560 473 #define UART_FLAG_PE (0x00000001U) /*!< UART parity error */
AnnaBridge 163:e59c8e839560 474 /**
AnnaBridge 163:e59c8e839560 475 * @}
AnnaBridge 163:e59c8e839560 476 */
AnnaBridge 163:e59c8e839560 477
AnnaBridge 163:e59c8e839560 478 /** @defgroup UART_Interrupt_definition UART Interrupts Definition
AnnaBridge 163:e59c8e839560 479 * Elements values convention: 000ZZZZZ0XXYYYYYb
AnnaBridge 163:e59c8e839560 480 * - YYYYY : Interrupt source position in the XX register (5bits)
AnnaBridge 163:e59c8e839560 481 * - XX : Interrupt source register (2bits)
AnnaBridge 163:e59c8e839560 482 * - 01: CR1 register
AnnaBridge 163:e59c8e839560 483 * - 10: CR2 register
AnnaBridge 163:e59c8e839560 484 * - 11: CR3 register
AnnaBridge 163:e59c8e839560 485 * - ZZZZZ : Flag position in the ISR register(5bits)
AnnaBridge 163:e59c8e839560 486 * @{
AnnaBridge 163:e59c8e839560 487 */
AnnaBridge 163:e59c8e839560 488 #define UART_IT_PE (0x0028U) /*!< UART parity error interruption */
AnnaBridge 163:e59c8e839560 489 #define UART_IT_TXE (0x0727U) /*!< UART transmit data register empty interruption */
AnnaBridge 163:e59c8e839560 490 #define UART_IT_TC (0x0626U) /*!< UART transmission complete interruption */
AnnaBridge 163:e59c8e839560 491 #define UART_IT_RXNE (0x0525U) /*!< UART read data register not empty interruption */
AnnaBridge 163:e59c8e839560 492 #define UART_IT_IDLE (0x0424U) /*!< UART idle interruption */
AnnaBridge 163:e59c8e839560 493 #define UART_IT_LBD (0x0846U) /*!< UART LIN break detection interruption */
AnnaBridge 163:e59c8e839560 494 #define UART_IT_CTS (0x096AU) /*!< UART CTS interruption */
AnnaBridge 163:e59c8e839560 495 #define UART_IT_CM (0x112EU) /*!< UART character match interruption */
AnnaBridge 163:e59c8e839560 496 #define UART_IT_WUF (0x1476U) /*!< UART wake-up from stop mode interruption */
AnnaBridge 163:e59c8e839560 497 #define UART_IT_ERR (0x0060U) /*!< UART error interruption */
AnnaBridge 163:e59c8e839560 498 #define UART_IT_ORE (0x0300U) /*!< UART overrun error interruption */
AnnaBridge 163:e59c8e839560 499 #define UART_IT_NE (0x0200U) /*!< UART noise error interruption */
AnnaBridge 163:e59c8e839560 500 #define UART_IT_FE (0x0100U) /*!< UART frame error interruption */
AnnaBridge 163:e59c8e839560 501 /**
AnnaBridge 163:e59c8e839560 502 * @}
AnnaBridge 163:e59c8e839560 503 */
AnnaBridge 163:e59c8e839560 504
AnnaBridge 163:e59c8e839560 505 /** @defgroup UART_IT_CLEAR_Flags UART Interruption Clear Flags
AnnaBridge 163:e59c8e839560 506 * @{
AnnaBridge 163:e59c8e839560 507 */
AnnaBridge 163:e59c8e839560 508 #define UART_CLEAR_PEF USART_ICR_PECF /*!< Parity Error Clear Flag */
AnnaBridge 163:e59c8e839560 509 #define UART_CLEAR_FEF USART_ICR_FECF /*!< Framing Error Clear Flag */
AnnaBridge 163:e59c8e839560 510 #define UART_CLEAR_NEF USART_ICR_NCF /*!< Noise detected Clear Flag */
AnnaBridge 163:e59c8e839560 511 #define UART_CLEAR_OREF USART_ICR_ORECF /*!< Overrun Error Clear Flag */
AnnaBridge 163:e59c8e839560 512 #define UART_CLEAR_IDLEF USART_ICR_IDLECF /*!< IDLE line detected Clear Flag */
AnnaBridge 163:e59c8e839560 513 #define UART_CLEAR_TCF USART_ICR_TCCF /*!< Transmission Complete Clear Flag */
AnnaBridge 163:e59c8e839560 514 #define UART_CLEAR_LBDF USART_ICR_LBDCF /*!< LIN Break Detection Clear Flag */
AnnaBridge 163:e59c8e839560 515 #define UART_CLEAR_CTSF USART_ICR_CTSCF /*!< CTS Interrupt Clear Flag */
AnnaBridge 163:e59c8e839560 516 #define UART_CLEAR_RTOF USART_ICR_RTOCF /*!< Receiver Time Out Clear Flag */
AnnaBridge 163:e59c8e839560 517 #define UART_CLEAR_EOBF USART_ICR_EOBCF /*!< End Of Block Clear Flag */
AnnaBridge 163:e59c8e839560 518 #define UART_CLEAR_CMF USART_ICR_CMCF /*!< Character Match Clear Flag */
AnnaBridge 163:e59c8e839560 519 #define UART_CLEAR_WUF USART_ICR_WUCF /*!< Wake Up from stop mode Clear Flag */
AnnaBridge 163:e59c8e839560 520 /**
AnnaBridge 163:e59c8e839560 521 * @}
AnnaBridge 163:e59c8e839560 522 */
AnnaBridge 163:e59c8e839560 523
AnnaBridge 163:e59c8e839560 524 /** @defgroup UART_Request_Parameters UART Request Parameters
AnnaBridge 163:e59c8e839560 525 * @{
AnnaBridge 163:e59c8e839560 526 */
AnnaBridge 163:e59c8e839560 527 #define UART_AUTOBAUD_REQUEST ((uint32_t)USART_RQR_ABRRQ) /*!< Auto-Baud Rate Request */
AnnaBridge 163:e59c8e839560 528 #define UART_SENDBREAK_REQUEST ((uint32_t)USART_RQR_SBKRQ) /*!< Send Break Request */
AnnaBridge 163:e59c8e839560 529 #define UART_MUTE_MODE_REQUEST ((uint32_t)USART_RQR_MMRQ) /*!< Mute Mode Request */
AnnaBridge 163:e59c8e839560 530 #define UART_RXDATA_FLUSH_REQUEST ((uint32_t)USART_RQR_RXFRQ) /*!< Receive Data flush Request */
AnnaBridge 163:e59c8e839560 531 #define UART_TXDATA_FLUSH_REQUEST ((uint32_t)USART_RQR_TXFRQ) /*!< Transmit data flush Request */
AnnaBridge 163:e59c8e839560 532 /**
AnnaBridge 163:e59c8e839560 533 * @}
AnnaBridge 163:e59c8e839560 534 */
AnnaBridge 163:e59c8e839560 535
AnnaBridge 163:e59c8e839560 536 /** @defgroup UART_Advanced_Features_Initialization_Type UART Advanced Feature Initialization Type
AnnaBridge 163:e59c8e839560 537 * @{
AnnaBridge 163:e59c8e839560 538 */
AnnaBridge 163:e59c8e839560 539 #define UART_ADVFEATURE_NO_INIT (0x00000000U) /*!< No advanced feature initialization */
AnnaBridge 163:e59c8e839560 540 #define UART_ADVFEATURE_TXINVERT_INIT (0x00000001U) /*!< TX pin active level inversion */
AnnaBridge 163:e59c8e839560 541 #define UART_ADVFEATURE_RXINVERT_INIT (0x00000002U) /*!< RX pin active level inversion */
AnnaBridge 163:e59c8e839560 542 #define UART_ADVFEATURE_DATAINVERT_INIT (0x00000004U) /*!< Binary data inversion */
AnnaBridge 163:e59c8e839560 543 #define UART_ADVFEATURE_SWAP_INIT (0x00000008U) /*!< TX/RX pins swap */
AnnaBridge 163:e59c8e839560 544 #define UART_ADVFEATURE_RXOVERRUNDISABLE_INIT (0x00000010U) /*!< RX overrun disable */
AnnaBridge 163:e59c8e839560 545 #define UART_ADVFEATURE_DMADISABLEONERROR_INIT (0x00000020U) /*!< DMA disable on Reception Error */
AnnaBridge 163:e59c8e839560 546 #define UART_ADVFEATURE_AUTOBAUDRATE_INIT (0x00000040U) /*!< Auto Baud rate detection initialization */
AnnaBridge 163:e59c8e839560 547 #define UART_ADVFEATURE_MSBFIRST_INIT (0x00000080U) /*!< Most significant bit sent/received first */
AnnaBridge 163:e59c8e839560 548 /**
AnnaBridge 163:e59c8e839560 549 * @}
AnnaBridge 163:e59c8e839560 550 */
AnnaBridge 163:e59c8e839560 551
AnnaBridge 163:e59c8e839560 552 /** @defgroup UART_Tx_Inv UART Advanced Feature TX Pin Active Level Inversion
AnnaBridge 163:e59c8e839560 553 * @{
AnnaBridge 163:e59c8e839560 554 */
AnnaBridge 163:e59c8e839560 555 #define UART_ADVFEATURE_TXINV_DISABLE (0x00000000U) /*!< TX pin active level inversion disable */
AnnaBridge 163:e59c8e839560 556 #define UART_ADVFEATURE_TXINV_ENABLE ((uint32_t)USART_CR2_TXINV) /*!< TX pin active level inversion enable */
AnnaBridge 163:e59c8e839560 557 /**
AnnaBridge 163:e59c8e839560 558 * @}
AnnaBridge 163:e59c8e839560 559 */
AnnaBridge 163:e59c8e839560 560
AnnaBridge 163:e59c8e839560 561 /** @defgroup UART_Rx_Inv UART Advanced Feature RX Pin Active Level Inversion
AnnaBridge 163:e59c8e839560 562 * @{
AnnaBridge 163:e59c8e839560 563 */
AnnaBridge 163:e59c8e839560 564 #define UART_ADVFEATURE_RXINV_DISABLE (0x00000000U) /*!< RX pin active level inversion disable */
AnnaBridge 163:e59c8e839560 565 #define UART_ADVFEATURE_RXINV_ENABLE ((uint32_t)USART_CR2_RXINV) /*!< RX pin active level inversion enable */
AnnaBridge 163:e59c8e839560 566 /**
AnnaBridge 163:e59c8e839560 567 * @}
AnnaBridge 163:e59c8e839560 568 */
AnnaBridge 163:e59c8e839560 569
AnnaBridge 163:e59c8e839560 570 /** @defgroup UART_Data_Inv UART Advanced Feature Binary Data Inversion
AnnaBridge 163:e59c8e839560 571 * @{
AnnaBridge 163:e59c8e839560 572 */
AnnaBridge 163:e59c8e839560 573 #define UART_ADVFEATURE_DATAINV_DISABLE (0x00000000U) /*!< Binary data inversion disable */
AnnaBridge 163:e59c8e839560 574 #define UART_ADVFEATURE_DATAINV_ENABLE ((uint32_t)USART_CR2_DATAINV) /*!< Binary data inversion enable */
AnnaBridge 163:e59c8e839560 575 /**
AnnaBridge 163:e59c8e839560 576 * @}
AnnaBridge 163:e59c8e839560 577 */
AnnaBridge 163:e59c8e839560 578
AnnaBridge 163:e59c8e839560 579 /** @defgroup UART_Rx_Tx_Swap UART Advanced Feature RX TX Pins Swap
AnnaBridge 163:e59c8e839560 580 * @{
AnnaBridge 163:e59c8e839560 581 */
AnnaBridge 163:e59c8e839560 582 #define UART_ADVFEATURE_SWAP_DISABLE (0x00000000U) /*!< TX/RX pins swap disable */
AnnaBridge 163:e59c8e839560 583 #define UART_ADVFEATURE_SWAP_ENABLE ((uint32_t)USART_CR2_SWAP) /*!< TX/RX pins swap enable */
AnnaBridge 163:e59c8e839560 584 /**
AnnaBridge 163:e59c8e839560 585 * @}
AnnaBridge 163:e59c8e839560 586 */
AnnaBridge 163:e59c8e839560 587
AnnaBridge 163:e59c8e839560 588 /** @defgroup UART_Overrun_Disable UART Advanced Feature Overrun Disable
AnnaBridge 163:e59c8e839560 589 * @{
AnnaBridge 163:e59c8e839560 590 */
AnnaBridge 163:e59c8e839560 591 #define UART_ADVFEATURE_OVERRUN_ENABLE (0x00000000U) /*!< RX overrun enable */
AnnaBridge 163:e59c8e839560 592 #define UART_ADVFEATURE_OVERRUN_DISABLE ((uint32_t)USART_CR3_OVRDIS) /*!< RX overrun disable */
AnnaBridge 163:e59c8e839560 593 /**
AnnaBridge 163:e59c8e839560 594 * @}
AnnaBridge 163:e59c8e839560 595 */
AnnaBridge 163:e59c8e839560 596
AnnaBridge 163:e59c8e839560 597 /** @defgroup UART_AutoBaudRate_Enable UART Advanced Feature Auto BaudRate Enable
AnnaBridge 163:e59c8e839560 598 * @{
AnnaBridge 163:e59c8e839560 599 */
AnnaBridge 163:e59c8e839560 600 #define UART_ADVFEATURE_AUTOBAUDRATE_DISABLE (0x00000000U) /*!< RX Auto Baud rate detection enable */
AnnaBridge 163:e59c8e839560 601 #define UART_ADVFEATURE_AUTOBAUDRATE_ENABLE ((uint32_t)USART_CR2_ABREN) /*!< RX Auto Baud rate detection disable */
AnnaBridge 163:e59c8e839560 602 /**
AnnaBridge 163:e59c8e839560 603 * @}
AnnaBridge 163:e59c8e839560 604 */
AnnaBridge 163:e59c8e839560 605
AnnaBridge 163:e59c8e839560 606 /** @defgroup UART_DMA_Disable_on_Rx_Error UART Advanced Feature DMA Disable On Rx Error
AnnaBridge 163:e59c8e839560 607 * @{
AnnaBridge 163:e59c8e839560 608 */
AnnaBridge 163:e59c8e839560 609 #define UART_ADVFEATURE_DMA_ENABLEONRXERROR (0x00000000U) /*!< DMA enable on Reception Error */
AnnaBridge 163:e59c8e839560 610 #define UART_ADVFEATURE_DMA_DISABLEONRXERROR ((uint32_t)USART_CR3_DDRE) /*!< DMA disable on Reception Error */
AnnaBridge 163:e59c8e839560 611 /**
AnnaBridge 163:e59c8e839560 612 * @}
AnnaBridge 163:e59c8e839560 613 */
AnnaBridge 163:e59c8e839560 614
AnnaBridge 163:e59c8e839560 615 /** @defgroup UART_MSB_First UART Advanced Feature MSB First
AnnaBridge 163:e59c8e839560 616 * @{
AnnaBridge 163:e59c8e839560 617 */
AnnaBridge 163:e59c8e839560 618 #define UART_ADVFEATURE_MSBFIRST_DISABLE (0x00000000U) /*!< Most significant bit sent/received first disable */
AnnaBridge 163:e59c8e839560 619 #define UART_ADVFEATURE_MSBFIRST_ENABLE ((uint32_t)USART_CR2_MSBFIRST) /*!< Most significant bit sent/received first enable */
AnnaBridge 163:e59c8e839560 620 /**
AnnaBridge 163:e59c8e839560 621 * @}
AnnaBridge 163:e59c8e839560 622 */
AnnaBridge 163:e59c8e839560 623
AnnaBridge 163:e59c8e839560 624 /** @defgroup UART_Stop_Mode_Enable UART Advanced Feature Stop Mode Enable
AnnaBridge 163:e59c8e839560 625 * @{
AnnaBridge 163:e59c8e839560 626 */
AnnaBridge 163:e59c8e839560 627 #define UART_ADVFEATURE_STOPMODE_DISABLE (0x00000000U) /*!< UART stop mode disable */
AnnaBridge 163:e59c8e839560 628 #define UART_ADVFEATURE_STOPMODE_ENABLE ((uint32_t)USART_CR1_UESM) /*!< UART stop mode enable */
AnnaBridge 163:e59c8e839560 629 /**
AnnaBridge 163:e59c8e839560 630 * @}
AnnaBridge 163:e59c8e839560 631 */
AnnaBridge 163:e59c8e839560 632
AnnaBridge 163:e59c8e839560 633 /** @defgroup UART_Mute_Mode UART Advanced Feature Mute Mode Enable
AnnaBridge 163:e59c8e839560 634 * @{
AnnaBridge 163:e59c8e839560 635 */
AnnaBridge 163:e59c8e839560 636 #define UART_ADVFEATURE_MUTEMODE_DISABLE (0x00000000U) /*!< UART mute mode disable */
AnnaBridge 163:e59c8e839560 637 #define UART_ADVFEATURE_MUTEMODE_ENABLE ((uint32_t)USART_CR1_MME) /*!< UART mute mode enable */
AnnaBridge 163:e59c8e839560 638 /**
AnnaBridge 163:e59c8e839560 639 * @}
AnnaBridge 163:e59c8e839560 640 */
AnnaBridge 163:e59c8e839560 641
AnnaBridge 163:e59c8e839560 642 /** @defgroup UART_CR2_ADDRESS_LSB_POS UART Address-matching LSB Position In CR2 Register
AnnaBridge 163:e59c8e839560 643 * @{
AnnaBridge 163:e59c8e839560 644 */
AnnaBridge 163:e59c8e839560 645 #define UART_CR2_ADDRESS_LSB_POS ( 24U) /*!< UART address-matching LSB position in CR2 register */
AnnaBridge 163:e59c8e839560 646 /**
AnnaBridge 163:e59c8e839560 647 * @}
AnnaBridge 163:e59c8e839560 648 */
AnnaBridge 163:e59c8e839560 649
AnnaBridge 163:e59c8e839560 650 /** @defgroup UART_WakeUp_from_Stop_Selection UART WakeUp From Stop Selection
AnnaBridge 163:e59c8e839560 651 * @{
AnnaBridge 163:e59c8e839560 652 */
AnnaBridge 163:e59c8e839560 653 #define UART_WAKEUP_ON_ADDRESS (0x00000000U) /*!< UART wake-up on address */
AnnaBridge 163:e59c8e839560 654 #define UART_WAKEUP_ON_STARTBIT ((uint32_t)USART_CR3_WUS_1) /*!< UART wake-up on start bit */
AnnaBridge 163:e59c8e839560 655 #define UART_WAKEUP_ON_READDATA_NONEMPTY ((uint32_t)USART_CR3_WUS) /*!< UART wake-up on receive data register not empty */
AnnaBridge 163:e59c8e839560 656 /**
AnnaBridge 163:e59c8e839560 657 * @}
AnnaBridge 163:e59c8e839560 658 */
AnnaBridge 163:e59c8e839560 659
AnnaBridge 163:e59c8e839560 660 /** @defgroup UART_DriverEnable_Polarity UART DriverEnable Polarity
AnnaBridge 163:e59c8e839560 661 * @{
AnnaBridge 163:e59c8e839560 662 */
AnnaBridge 163:e59c8e839560 663 #define UART_DE_POLARITY_HIGH (0x00000000U) /*!< Driver enable signal is active high */
AnnaBridge 163:e59c8e839560 664 #define UART_DE_POLARITY_LOW ((uint32_t)USART_CR3_DEP) /*!< Driver enable signal is active low */
AnnaBridge 163:e59c8e839560 665 /**
AnnaBridge 163:e59c8e839560 666 * @}
AnnaBridge 163:e59c8e839560 667 */
AnnaBridge 163:e59c8e839560 668
AnnaBridge 163:e59c8e839560 669 /** @defgroup UART_CR1_DEAT_ADDRESS_LSB_POS UART Driver Enable Assertion Time LSB Position In CR1 Register
AnnaBridge 163:e59c8e839560 670 * @{
AnnaBridge 163:e59c8e839560 671 */
AnnaBridge 163:e59c8e839560 672 #define UART_CR1_DEAT_ADDRESS_LSB_POS ( 21U) /*!< UART Driver Enable assertion time LSB position in CR1 register */
AnnaBridge 163:e59c8e839560 673 /**
AnnaBridge 163:e59c8e839560 674 * @}
AnnaBridge 163:e59c8e839560 675 */
AnnaBridge 163:e59c8e839560 676
AnnaBridge 163:e59c8e839560 677 /** @defgroup UART_CR1_DEDT_ADDRESS_LSB_POS UART Driver Enable DeAssertion Time LSB Position In CR1 Register
AnnaBridge 163:e59c8e839560 678 * @{
AnnaBridge 163:e59c8e839560 679 */
AnnaBridge 163:e59c8e839560 680 #define UART_CR1_DEDT_ADDRESS_LSB_POS ( 16U) /*!< UART Driver Enable de-assertion time LSB position in CR1 register */
AnnaBridge 163:e59c8e839560 681 /**
AnnaBridge 163:e59c8e839560 682 * @}
AnnaBridge 163:e59c8e839560 683 */
AnnaBridge 163:e59c8e839560 684
AnnaBridge 163:e59c8e839560 685 /** @defgroup UART_Interruption_Mask UART Interruptions Flag Mask
AnnaBridge 163:e59c8e839560 686 * @{
AnnaBridge 163:e59c8e839560 687 */
AnnaBridge 163:e59c8e839560 688 #define UART_IT_MASK (0x001FU) /*!< UART interruptions flags mask */
AnnaBridge 163:e59c8e839560 689 /**
AnnaBridge 163:e59c8e839560 690 * @}
AnnaBridge 163:e59c8e839560 691 */
AnnaBridge 163:e59c8e839560 692
AnnaBridge 163:e59c8e839560 693 /** @defgroup UART_TimeOut_Value UART polling-based communications time-out value
AnnaBridge 163:e59c8e839560 694 * @{
AnnaBridge 163:e59c8e839560 695 */
AnnaBridge 163:e59c8e839560 696 #define HAL_UART_TIMEOUT_VALUE 0x1FFFFFF /*!< UART polling-based communications time-out value */
AnnaBridge 163:e59c8e839560 697 /**
AnnaBridge 163:e59c8e839560 698 * @}
AnnaBridge 163:e59c8e839560 699 */
AnnaBridge 163:e59c8e839560 700
AnnaBridge 163:e59c8e839560 701 /**
AnnaBridge 163:e59c8e839560 702 * @}
AnnaBridge 163:e59c8e839560 703 */
AnnaBridge 163:e59c8e839560 704
AnnaBridge 163:e59c8e839560 705 /* Exported macros -----------------------------------------------------------*/
AnnaBridge 163:e59c8e839560 706 /** @defgroup UART_Exported_Macros UART Exported Macros
AnnaBridge 163:e59c8e839560 707 * @{
AnnaBridge 163:e59c8e839560 708 */
AnnaBridge 163:e59c8e839560 709
AnnaBridge 163:e59c8e839560 710 /** @brief Reset UART handle states.
AnnaBridge 168:b9e159c1930a 711 * @param __HANDLE__ UART handle.
AnnaBridge 163:e59c8e839560 712 * @retval None
AnnaBridge 163:e59c8e839560 713 */
AnnaBridge 163:e59c8e839560 714 #define __HAL_UART_RESET_HANDLE_STATE(__HANDLE__) do{ \
AnnaBridge 163:e59c8e839560 715 (__HANDLE__)->gState = HAL_UART_STATE_RESET; \
AnnaBridge 163:e59c8e839560 716 (__HANDLE__)->RxState = HAL_UART_STATE_RESET; \
AnnaBridge 163:e59c8e839560 717 } while(0U)
AnnaBridge 163:e59c8e839560 718 /** @brief Flush the UART Data registers.
AnnaBridge 168:b9e159c1930a 719 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 720 * @retval None
AnnaBridge 163:e59c8e839560 721 */
AnnaBridge 163:e59c8e839560 722 #define __HAL_UART_FLUSH_DRREGISTER(__HANDLE__) \
AnnaBridge 163:e59c8e839560 723 do{ \
AnnaBridge 163:e59c8e839560 724 SET_BIT((__HANDLE__)->Instance->RQR, UART_RXDATA_FLUSH_REQUEST); \
AnnaBridge 163:e59c8e839560 725 SET_BIT((__HANDLE__)->Instance->RQR, UART_TXDATA_FLUSH_REQUEST); \
AnnaBridge 163:e59c8e839560 726 } while(0U)
AnnaBridge 163:e59c8e839560 727
AnnaBridge 163:e59c8e839560 728 /** @brief Clear the specified UART pending flag.
AnnaBridge 168:b9e159c1930a 729 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 168:b9e159c1930a 730 * @param __FLAG__ specifies the flag to check.
AnnaBridge 163:e59c8e839560 731 * This parameter can be any combination of the following values:
AnnaBridge 163:e59c8e839560 732 * @arg @ref UART_CLEAR_PEF Parity Error Clear Flag
AnnaBridge 163:e59c8e839560 733 * @arg @ref UART_CLEAR_FEF Framing Error Clear Flag
AnnaBridge 163:e59c8e839560 734 * @arg @ref UART_CLEAR_NEF Noise detected Clear Flag
AnnaBridge 163:e59c8e839560 735 * @arg @ref UART_CLEAR_OREF Overrun Error Clear Flag
AnnaBridge 163:e59c8e839560 736 * @arg @ref UART_CLEAR_IDLEF IDLE line detected Clear Flag
AnnaBridge 163:e59c8e839560 737 * @arg @ref UART_CLEAR_TCF Transmission Complete Clear Flag
AnnaBridge 163:e59c8e839560 738 * @arg @ref UART_CLEAR_LBDF LIN Break Detection Clear Flag (not available on all devices)
AnnaBridge 163:e59c8e839560 739 * @arg @ref UART_CLEAR_CTSF CTS Interrupt Clear Flag
AnnaBridge 163:e59c8e839560 740 * @arg @ref UART_CLEAR_RTOF Receiver Time Out Clear Flag
AnnaBridge 163:e59c8e839560 741 * @arg @ref UART_CLEAR_EOBF End Of Block Clear Flag (not available on all devices)
AnnaBridge 163:e59c8e839560 742 * @arg @ref UART_CLEAR_CMF Character Match Clear Flag
AnnaBridge 163:e59c8e839560 743 * @arg @ref UART_CLEAR_WUF Wake Up from stop mode Clear Flag (not available on all devices)
AnnaBridge 163:e59c8e839560 744 * @retval None
AnnaBridge 163:e59c8e839560 745 */
AnnaBridge 163:e59c8e839560 746 #define __HAL_UART_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = (__FLAG__))
AnnaBridge 163:e59c8e839560 747
AnnaBridge 163:e59c8e839560 748 /** @brief Clear the UART PE pending flag.
AnnaBridge 168:b9e159c1930a 749 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 750 * @retval None
AnnaBridge 163:e59c8e839560 751 */
AnnaBridge 163:e59c8e839560 752 #define __HAL_UART_CLEAR_PEFLAG(__HANDLE__) __HAL_UART_CLEAR_FLAG((__HANDLE__), UART_CLEAR_PEF)
AnnaBridge 163:e59c8e839560 753
AnnaBridge 163:e59c8e839560 754 /** @brief Clear the UART FE pending flag.
AnnaBridge 168:b9e159c1930a 755 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 756 * @retval None
AnnaBridge 163:e59c8e839560 757 */
AnnaBridge 163:e59c8e839560 758 #define __HAL_UART_CLEAR_FEFLAG(__HANDLE__) __HAL_UART_CLEAR_FLAG((__HANDLE__), UART_CLEAR_FEF)
AnnaBridge 163:e59c8e839560 759
AnnaBridge 163:e59c8e839560 760 /** @brief Clear the UART NE pending flag.
AnnaBridge 168:b9e159c1930a 761 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 762 * @retval None
AnnaBridge 163:e59c8e839560 763 */
AnnaBridge 163:e59c8e839560 764 #define __HAL_UART_CLEAR_NEFLAG(__HANDLE__) __HAL_UART_CLEAR_FLAG((__HANDLE__), UART_CLEAR_NEF)
AnnaBridge 163:e59c8e839560 765
AnnaBridge 163:e59c8e839560 766 /** @brief Clear the UART ORE pending flag.
AnnaBridge 168:b9e159c1930a 767 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 768 * @retval None
AnnaBridge 163:e59c8e839560 769 */
AnnaBridge 163:e59c8e839560 770 #define __HAL_UART_CLEAR_OREFLAG(__HANDLE__) __HAL_UART_CLEAR_FLAG((__HANDLE__), UART_CLEAR_OREF)
AnnaBridge 163:e59c8e839560 771
AnnaBridge 163:e59c8e839560 772 /** @brief Clear the UART IDLE pending flag.
AnnaBridge 168:b9e159c1930a 773 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 774 * @retval None
AnnaBridge 163:e59c8e839560 775 */
AnnaBridge 163:e59c8e839560 776 #define __HAL_UART_CLEAR_IDLEFLAG(__HANDLE__) __HAL_UART_CLEAR_FLAG((__HANDLE__), UART_CLEAR_IDLEF)
AnnaBridge 163:e59c8e839560 777
AnnaBridge 163:e59c8e839560 778 /** @brief Check whether the specified UART flag is set or not.
AnnaBridge 168:b9e159c1930a 779 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 168:b9e159c1930a 780 * @param __FLAG__ specifies the flag to check.
AnnaBridge 163:e59c8e839560 781 * This parameter can be one of the following values:
AnnaBridge 163:e59c8e839560 782 * @arg @ref UART_FLAG_REACK Receive enable acknowledge flag
AnnaBridge 163:e59c8e839560 783 * @arg @ref UART_FLAG_TEACK Transmit enable acknowledge flag
AnnaBridge 163:e59c8e839560 784 * @arg @ref UART_FLAG_WUF Wake up from stop mode flag
AnnaBridge 163:e59c8e839560 785 * @arg @ref UART_FLAG_RWU Receiver wake up flag
AnnaBridge 163:e59c8e839560 786 * @arg @ref UART_FLAG_SBKF Send Break flag
AnnaBridge 163:e59c8e839560 787 * @arg @ref UART_FLAG_CMF Character match flag
AnnaBridge 163:e59c8e839560 788 * @arg @ref UART_FLAG_BUSY Busy flag
AnnaBridge 163:e59c8e839560 789 * @arg @ref UART_FLAG_ABRF Auto Baud rate detection flag
AnnaBridge 163:e59c8e839560 790 * @arg @ref UART_FLAG_ABRE Auto Baud rate detection error flag
AnnaBridge 163:e59c8e839560 791 * @arg @ref UART_FLAG_EOBF End of block flag
AnnaBridge 163:e59c8e839560 792 * @arg @ref UART_FLAG_RTOF Receiver timeout flag
AnnaBridge 163:e59c8e839560 793 * @arg @ref UART_FLAG_CTS CTS Change flag (not available for UART4 and UART5)
AnnaBridge 163:e59c8e839560 794 * @arg @ref UART_FLAG_LBDF LIN Break detection flag
AnnaBridge 163:e59c8e839560 795 * @arg @ref UART_FLAG_TXE Transmit data register empty flag
AnnaBridge 163:e59c8e839560 796 * @arg @ref UART_FLAG_TC Transmission Complete flag
AnnaBridge 163:e59c8e839560 797 * @arg @ref UART_FLAG_RXNE Receive data register not empty flag
AnnaBridge 163:e59c8e839560 798 * @arg @ref UART_FLAG_IDLE Idle Line detection flag
AnnaBridge 163:e59c8e839560 799 * @arg @ref UART_FLAG_ORE Overrun Error flag
AnnaBridge 163:e59c8e839560 800 * @arg @ref UART_FLAG_NE Noise Error flag
AnnaBridge 163:e59c8e839560 801 * @arg @ref UART_FLAG_FE Framing Error flag
AnnaBridge 163:e59c8e839560 802 * @arg @ref UART_FLAG_PE Parity Error flag
AnnaBridge 163:e59c8e839560 803 * @retval The new state of __FLAG__ (TRUE or FALSE).
AnnaBridge 163:e59c8e839560 804 */
AnnaBridge 163:e59c8e839560 805 #define __HAL_UART_GET_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->ISR & (__FLAG__)) == (__FLAG__))
AnnaBridge 163:e59c8e839560 806
AnnaBridge 163:e59c8e839560 807 /** @brief Enable the specified UART interrupt.
AnnaBridge 168:b9e159c1930a 808 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 168:b9e159c1930a 809 * @param __INTERRUPT__ specifies the UART interrupt source to enable.
AnnaBridge 163:e59c8e839560 810 * This parameter can be one of the following values:
AnnaBridge 163:e59c8e839560 811 * @arg @ref UART_IT_WUF Wakeup from stop mode interrupt
AnnaBridge 163:e59c8e839560 812 * @arg @ref UART_IT_CM Character match interrupt
AnnaBridge 163:e59c8e839560 813 * @arg @ref UART_IT_CTS CTS change interrupt
AnnaBridge 163:e59c8e839560 814 * @arg @ref UART_IT_LBD LIN Break detection interrupt
AnnaBridge 163:e59c8e839560 815 * @arg @ref UART_IT_TXE Transmit Data Register empty interrupt
AnnaBridge 163:e59c8e839560 816 * @arg @ref UART_IT_TC Transmission complete interrupt
AnnaBridge 163:e59c8e839560 817 * @arg @ref UART_IT_RXNE Receive Data register not empty interrupt
AnnaBridge 163:e59c8e839560 818 * @arg @ref UART_IT_IDLE Idle line detection interrupt
AnnaBridge 163:e59c8e839560 819 * @arg @ref UART_IT_PE Parity Error interrupt
AnnaBridge 163:e59c8e839560 820 * @arg @ref UART_IT_ERR Error interrupt (Frame error, noise error, overrun error)
AnnaBridge 163:e59c8e839560 821 * @retval None
AnnaBridge 163:e59c8e839560 822 */
AnnaBridge 163:e59c8e839560 823 #define __HAL_UART_ENABLE_IT(__HANDLE__, __INTERRUPT__) (((((uint8_t)(__INTERRUPT__)) >> 5U) == 1U)? ((__HANDLE__)->Instance->CR1 |= (1U << ((__INTERRUPT__) & UART_IT_MASK))): \
AnnaBridge 163:e59c8e839560 824 ((((uint8_t)(__INTERRUPT__)) >> 5U) == 2U)? ((__HANDLE__)->Instance->CR2 |= (1U << ((__INTERRUPT__) & UART_IT_MASK))): \
AnnaBridge 163:e59c8e839560 825 ((__HANDLE__)->Instance->CR3 |= (1U << ((__INTERRUPT__) & UART_IT_MASK))))
AnnaBridge 163:e59c8e839560 826
AnnaBridge 163:e59c8e839560 827
AnnaBridge 163:e59c8e839560 828 /** @brief Disable the specified UART interrupt.
AnnaBridge 168:b9e159c1930a 829 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 168:b9e159c1930a 830 * @param __INTERRUPT__ specifies the UART interrupt source to disable.
AnnaBridge 163:e59c8e839560 831 * This parameter can be one of the following values:
AnnaBridge 163:e59c8e839560 832 * @arg @ref UART_IT_WUF Wakeup from stop mode interrupt
AnnaBridge 163:e59c8e839560 833 * @arg @ref UART_IT_CM Character match interrupt
AnnaBridge 163:e59c8e839560 834 * @arg @ref UART_IT_CTS CTS change interrupt
AnnaBridge 163:e59c8e839560 835 * @arg @ref UART_IT_LBD LIN Break detection interrupt
AnnaBridge 163:e59c8e839560 836 * @arg @ref UART_IT_TXE Transmit Data Register empty interrupt
AnnaBridge 163:e59c8e839560 837 * @arg @ref UART_IT_TC Transmission complete interrupt
AnnaBridge 163:e59c8e839560 838 * @arg @ref UART_IT_RXNE Receive Data register not empty interrupt
AnnaBridge 163:e59c8e839560 839 * @arg @ref UART_IT_IDLE Idle line detection interrupt
AnnaBridge 163:e59c8e839560 840 * @arg @ref UART_IT_PE Parity Error interrupt
AnnaBridge 163:e59c8e839560 841 * @arg @ref UART_IT_ERR Error interrupt (Frame error, noise error, overrun error)
AnnaBridge 163:e59c8e839560 842 * @retval None
AnnaBridge 163:e59c8e839560 843 */
AnnaBridge 163:e59c8e839560 844 #define __HAL_UART_DISABLE_IT(__HANDLE__, __INTERRUPT__) (((((uint8_t)(__INTERRUPT__)) >> 5U) == 1U)? ((__HANDLE__)->Instance->CR1 &= ~ (1U << ((__INTERRUPT__) & UART_IT_MASK))): \
AnnaBridge 163:e59c8e839560 845 ((((uint8_t)(__INTERRUPT__)) >> 5U) == 2U)? ((__HANDLE__)->Instance->CR2 &= ~ (1U << ((__INTERRUPT__) & UART_IT_MASK))): \
AnnaBridge 163:e59c8e839560 846 ((__HANDLE__)->Instance->CR3 &= ~ (1U << ((__INTERRUPT__) & UART_IT_MASK))))
AnnaBridge 163:e59c8e839560 847
AnnaBridge 163:e59c8e839560 848 /** @brief Check whether the specified UART interrupt has occurred or not.
AnnaBridge 168:b9e159c1930a 849 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 168:b9e159c1930a 850 * @param __IT__ specifies the UART interrupt to check.
AnnaBridge 163:e59c8e839560 851 * This parameter can be one of the following values:
AnnaBridge 163:e59c8e839560 852 * @arg @ref UART_IT_WUF Wakeup from stop mode interrupt
AnnaBridge 163:e59c8e839560 853 * @arg @ref UART_IT_CM Character match interrupt
AnnaBridge 163:e59c8e839560 854 * @arg @ref UART_IT_CTS CTS change interrupt (not available for UART4 and UART5)
AnnaBridge 163:e59c8e839560 855 * @arg @ref UART_IT_LBD LIN Break detection interrupt
AnnaBridge 163:e59c8e839560 856 * @arg @ref UART_IT_TXE Transmit Data Register empty interrupt
AnnaBridge 163:e59c8e839560 857 * @arg @ref UART_IT_TC Transmission complete interrupt
AnnaBridge 163:e59c8e839560 858 * @arg @ref UART_IT_RXNE Receive Data register not empty interrupt
AnnaBridge 163:e59c8e839560 859 * @arg @ref UART_IT_IDLE Idle line detection interrupt
AnnaBridge 163:e59c8e839560 860 * @arg @ref UART_IT_ORE Overrun Error interrupt
AnnaBridge 163:e59c8e839560 861 * @arg @ref UART_IT_NE Noise Error interrupt
AnnaBridge 163:e59c8e839560 862 * @arg @ref UART_IT_FE Framing Error interrupt
AnnaBridge 163:e59c8e839560 863 * @arg @ref UART_IT_PE Parity Error interrupt
AnnaBridge 163:e59c8e839560 864 * @retval The new state of __IT__ (TRUE or FALSE).
AnnaBridge 163:e59c8e839560 865 */
AnnaBridge 163:e59c8e839560 866 #define __HAL_UART_GET_IT(__HANDLE__, __IT__) ((__HANDLE__)->Instance->ISR & (1U << ((__IT__)>> 0x08U)))
AnnaBridge 163:e59c8e839560 867
AnnaBridge 163:e59c8e839560 868 /** @brief Check whether the specified UART interrupt source is enabled or not.
AnnaBridge 168:b9e159c1930a 869 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 168:b9e159c1930a 870 * @param __IT__ specifies the UART interrupt source to check.
AnnaBridge 163:e59c8e839560 871 * This parameter can be one of the following values:
AnnaBridge 163:e59c8e839560 872 * @arg @ref UART_IT_WUF Wakeup from stop mode interrupt
AnnaBridge 163:e59c8e839560 873 * @arg @ref UART_IT_CM Character match interrupt
AnnaBridge 163:e59c8e839560 874 * @arg @ref UART_IT_CTS CTS change interrupt (not available for UART4 and UART5)
AnnaBridge 163:e59c8e839560 875 * @arg @ref UART_IT_LBD LIN Break detection interrupt
AnnaBridge 163:e59c8e839560 876 * @arg @ref UART_IT_TXE Transmit Data Register empty interrupt
AnnaBridge 163:e59c8e839560 877 * @arg @ref UART_IT_TC Transmission complete interrupt
AnnaBridge 163:e59c8e839560 878 * @arg @ref UART_IT_RXNE Receive Data register not empty interrupt
AnnaBridge 163:e59c8e839560 879 * @arg @ref UART_IT_IDLE Idle line detection interrupt
AnnaBridge 163:e59c8e839560 880 * @arg @ref UART_IT_ERR Error interrupt (Frame error, noise error, overrun error)
AnnaBridge 163:e59c8e839560 881 * @arg @ref UART_IT_PE Parity Error interrupt
AnnaBridge 163:e59c8e839560 882 * @retval The new state of __IT__ (TRUE or FALSE).
AnnaBridge 163:e59c8e839560 883 */
AnnaBridge 163:e59c8e839560 884 #define __HAL_UART_GET_IT_SOURCE(__HANDLE__, __IT__) ((((((uint8_t)(__IT__)) >> 5U) == 1U)? (__HANDLE__)->Instance->CR1:(((((uint8_t)(__IT__)) >> 5U) == 2U)? \
AnnaBridge 163:e59c8e839560 885 (__HANDLE__)->Instance->CR2 : (__HANDLE__)->Instance->CR3)) & (1U << (((uint16_t)(__IT__)) & UART_IT_MASK)))
AnnaBridge 163:e59c8e839560 886
AnnaBridge 163:e59c8e839560 887 /** @brief Clear the specified UART ISR flag, in setting the proper ICR register flag.
AnnaBridge 168:b9e159c1930a 888 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 168:b9e159c1930a 889 * @param __IT_CLEAR__ specifies the interrupt clear register flag that needs to be set
AnnaBridge 163:e59c8e839560 890 * to clear the corresponding interrupt
AnnaBridge 163:e59c8e839560 891 * This parameter can be one of the following values:
AnnaBridge 163:e59c8e839560 892 * @arg @ref UART_CLEAR_PEF Parity Error Clear Flag
AnnaBridge 163:e59c8e839560 893 * @arg @ref UART_CLEAR_FEF Framing Error Clear Flag
AnnaBridge 163:e59c8e839560 894 * @arg @ref UART_CLEAR_NEF Noise detected Clear Flag
AnnaBridge 163:e59c8e839560 895 * @arg @ref UART_CLEAR_OREF Overrun Error Clear Flag
AnnaBridge 163:e59c8e839560 896 * @arg @ref UART_CLEAR_IDLEF IDLE line detected Clear Flag
AnnaBridge 163:e59c8e839560 897 * @arg @ref UART_CLEAR_TCF Transmission Complete Clear Flag
AnnaBridge 163:e59c8e839560 898 * @arg @ref UART_CLEAR_LBDF LIN Break Detection Clear Flag
AnnaBridge 163:e59c8e839560 899 * @arg @ref UART_CLEAR_CTSF CTS Interrupt Clear Flag
AnnaBridge 163:e59c8e839560 900 * @arg @ref UART_CLEAR_RTOF Receiver Time Out Clear Flag
AnnaBridge 163:e59c8e839560 901 * @arg @ref UART_CLEAR_EOBF End Of Block Clear Flag
AnnaBridge 163:e59c8e839560 902 * @arg @ref UART_CLEAR_CMF Character Match Clear Flag
AnnaBridge 163:e59c8e839560 903 * @arg @ref UART_CLEAR_WUF Wake Up from stop mode Clear Flag
AnnaBridge 163:e59c8e839560 904 * @retval None
AnnaBridge 163:e59c8e839560 905 */
AnnaBridge 163:e59c8e839560 906 #define __HAL_UART_CLEAR_IT(__HANDLE__, __IT_CLEAR__) ((__HANDLE__)->Instance->ICR = (uint32_t)(__IT_CLEAR__))
AnnaBridge 163:e59c8e839560 907
AnnaBridge 163:e59c8e839560 908 /** @brief Set a specific UART request flag.
AnnaBridge 168:b9e159c1930a 909 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 168:b9e159c1930a 910 * @param __REQ__ specifies the request flag to set
AnnaBridge 163:e59c8e839560 911 * This parameter can be one of the following values:
AnnaBridge 163:e59c8e839560 912 * @arg @ref UART_AUTOBAUD_REQUEST Auto-Baud Rate Request
AnnaBridge 163:e59c8e839560 913 * @arg @ref UART_SENDBREAK_REQUEST Send Break Request
AnnaBridge 163:e59c8e839560 914 * @arg @ref UART_MUTE_MODE_REQUEST Mute Mode Request
AnnaBridge 163:e59c8e839560 915 * @arg @ref UART_RXDATA_FLUSH_REQUEST Receive Data flush Request
AnnaBridge 163:e59c8e839560 916 * @arg @ref UART_TXDATA_FLUSH_REQUEST Transmit data flush Request
AnnaBridge 163:e59c8e839560 917 * @retval None
AnnaBridge 163:e59c8e839560 918 */
AnnaBridge 163:e59c8e839560 919 #define __HAL_UART_SEND_REQ(__HANDLE__, __REQ__) ((__HANDLE__)->Instance->RQR |= (uint32_t)(__REQ__))
AnnaBridge 163:e59c8e839560 920
AnnaBridge 163:e59c8e839560 921 /** @brief Enable the UART one bit sample method.
AnnaBridge 168:b9e159c1930a 922 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 923 * @retval None
AnnaBridge 163:e59c8e839560 924 */
AnnaBridge 163:e59c8e839560 925 #define __HAL_UART_ONE_BIT_SAMPLE_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR3|= USART_CR3_ONEBIT)
AnnaBridge 163:e59c8e839560 926
AnnaBridge 163:e59c8e839560 927 /** @brief Disable the UART one bit sample method.
AnnaBridge 168:b9e159c1930a 928 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 929 * @retval None
AnnaBridge 163:e59c8e839560 930 */
AnnaBridge 163:e59c8e839560 931 #define __HAL_UART_ONE_BIT_SAMPLE_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR3 &= (uint32_t)~((uint32_t)USART_CR3_ONEBIT))
AnnaBridge 163:e59c8e839560 932
AnnaBridge 163:e59c8e839560 933 /** @brief Enable UART.
AnnaBridge 168:b9e159c1930a 934 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 935 * @retval None
AnnaBridge 163:e59c8e839560 936 */
AnnaBridge 163:e59c8e839560 937 #define __HAL_UART_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1 |= USART_CR1_UE)
AnnaBridge 163:e59c8e839560 938
AnnaBridge 163:e59c8e839560 939 /** @brief Disable UART.
AnnaBridge 168:b9e159c1930a 940 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 941 * @retval None
AnnaBridge 163:e59c8e839560 942 */
AnnaBridge 163:e59c8e839560 943 #define __HAL_UART_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1 &= ~USART_CR1_UE)
AnnaBridge 163:e59c8e839560 944
AnnaBridge 163:e59c8e839560 945 /** @brief Enable CTS flow control.
AnnaBridge 163:e59c8e839560 946 * @note This macro allows to enable CTS hardware flow control for a given UART instance,
AnnaBridge 163:e59c8e839560 947 * without need to call HAL_UART_Init() function.
AnnaBridge 163:e59c8e839560 948 * As involving direct access to UART registers, usage of this macro should be fully endorsed by user.
AnnaBridge 163:e59c8e839560 949 * @note As macro is expected to be used for modifying CTS Hw flow control feature activation, without need
AnnaBridge 163:e59c8e839560 950 * for USART instance Deinit/Init, following conditions for macro call should be fulfilled :
AnnaBridge 163:e59c8e839560 951 * - UART instance should have already been initialised (through call of HAL_UART_Init() )
AnnaBridge 163:e59c8e839560 952 * - macro could only be called when corresponding UART instance is disabled (i.e. __HAL_UART_DISABLE(__HANDLE__))
AnnaBridge 163:e59c8e839560 953 * and should be followed by an Enable macro (i.e. __HAL_UART_ENABLE(__HANDLE__)).
AnnaBridge 168:b9e159c1930a 954 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 955 * @retval None
AnnaBridge 163:e59c8e839560 956 */
AnnaBridge 163:e59c8e839560 957 #define __HAL_UART_HWCONTROL_CTS_ENABLE(__HANDLE__) \
AnnaBridge 163:e59c8e839560 958 do{ \
AnnaBridge 163:e59c8e839560 959 SET_BIT((__HANDLE__)->Instance->CR3, USART_CR3_CTSE); \
AnnaBridge 163:e59c8e839560 960 (__HANDLE__)->Init.HwFlowCtl |= USART_CR3_CTSE; \
AnnaBridge 163:e59c8e839560 961 } while(0U)
AnnaBridge 163:e59c8e839560 962
AnnaBridge 163:e59c8e839560 963 /** @brief Disable CTS flow control.
AnnaBridge 163:e59c8e839560 964 * @note This macro allows to disable CTS hardware flow control for a given UART instance,
AnnaBridge 163:e59c8e839560 965 * without need to call HAL_UART_Init() function.
AnnaBridge 163:e59c8e839560 966 * As involving direct access to UART registers, usage of this macro should be fully endorsed by user.
AnnaBridge 163:e59c8e839560 967 * @note As macro is expected to be used for modifying CTS Hw flow control feature activation, without need
AnnaBridge 163:e59c8e839560 968 * for USART instance Deinit/Init, following conditions for macro call should be fulfilled :
AnnaBridge 163:e59c8e839560 969 * - UART instance should have already been initialised (through call of HAL_UART_Init() )
AnnaBridge 163:e59c8e839560 970 * - macro could only be called when corresponding UART instance is disabled (i.e. __HAL_UART_DISABLE(__HANDLE__))
AnnaBridge 163:e59c8e839560 971 * and should be followed by an Enable macro (i.e. __HAL_UART_ENABLE(__HANDLE__)).
AnnaBridge 168:b9e159c1930a 972 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 973 * @retval None
AnnaBridge 163:e59c8e839560 974 */
AnnaBridge 163:e59c8e839560 975 #define __HAL_UART_HWCONTROL_CTS_DISABLE(__HANDLE__) \
AnnaBridge 163:e59c8e839560 976 do{ \
AnnaBridge 163:e59c8e839560 977 CLEAR_BIT((__HANDLE__)->Instance->CR3, USART_CR3_CTSE); \
AnnaBridge 163:e59c8e839560 978 (__HANDLE__)->Init.HwFlowCtl &= ~(USART_CR3_CTSE); \
AnnaBridge 163:e59c8e839560 979 } while(0U)
AnnaBridge 163:e59c8e839560 980
AnnaBridge 163:e59c8e839560 981 /** @brief Enable RTS flow control.
AnnaBridge 163:e59c8e839560 982 * @note This macro allows to enable RTS hardware flow control for a given UART instance,
AnnaBridge 163:e59c8e839560 983 * without need to call HAL_UART_Init() function.
AnnaBridge 163:e59c8e839560 984 * As involving direct access to UART registers, usage of this macro should be fully endorsed by user.
AnnaBridge 163:e59c8e839560 985 * @note As macro is expected to be used for modifying RTS Hw flow control feature activation, without need
AnnaBridge 163:e59c8e839560 986 * for USART instance Deinit/Init, following conditions for macro call should be fulfilled :
AnnaBridge 163:e59c8e839560 987 * - UART instance should have already been initialised (through call of HAL_UART_Init() )
AnnaBridge 163:e59c8e839560 988 * - macro could only be called when corresponding UART instance is disabled (i.e. __HAL_UART_DISABLE(__HANDLE__))
AnnaBridge 163:e59c8e839560 989 * and should be followed by an Enable macro (i.e. __HAL_UART_ENABLE(__HANDLE__)).
AnnaBridge 168:b9e159c1930a 990 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 991 * @retval None
AnnaBridge 163:e59c8e839560 992 */
AnnaBridge 163:e59c8e839560 993 #define __HAL_UART_HWCONTROL_RTS_ENABLE(__HANDLE__) \
AnnaBridge 163:e59c8e839560 994 do{ \
AnnaBridge 163:e59c8e839560 995 SET_BIT((__HANDLE__)->Instance->CR3, USART_CR3_RTSE); \
AnnaBridge 163:e59c8e839560 996 (__HANDLE__)->Init.HwFlowCtl |= USART_CR3_RTSE; \
AnnaBridge 163:e59c8e839560 997 } while(0U)
AnnaBridge 163:e59c8e839560 998
AnnaBridge 163:e59c8e839560 999 /** @brief Disable RTS flow control.
AnnaBridge 163:e59c8e839560 1000 * @note This macro allows to disable RTS hardware flow control for a given UART instance,
AnnaBridge 163:e59c8e839560 1001 * without need to call HAL_UART_Init() function.
AnnaBridge 163:e59c8e839560 1002 * As involving direct access to UART registers, usage of this macro should be fully endorsed by user.
AnnaBridge 163:e59c8e839560 1003 * @note As macro is expected to be used for modifying RTS Hw flow control feature activation, without need
AnnaBridge 163:e59c8e839560 1004 * for USART instance Deinit/Init, following conditions for macro call should be fulfilled :
AnnaBridge 163:e59c8e839560 1005 * - UART instance should have already been initialised (through call of HAL_UART_Init() )
AnnaBridge 163:e59c8e839560 1006 * - macro could only be called when corresponding UART instance is disabled (i.e. __HAL_UART_DISABLE(__HANDLE__))
AnnaBridge 163:e59c8e839560 1007 * and should be followed by an Enable macro (i.e. __HAL_UART_ENABLE(__HANDLE__)).
AnnaBridge 168:b9e159c1930a 1008 * @param __HANDLE__ specifies the UART Handle.
AnnaBridge 163:e59c8e839560 1009 * @retval None
AnnaBridge 163:e59c8e839560 1010 */
AnnaBridge 163:e59c8e839560 1011 #define __HAL_UART_HWCONTROL_RTS_DISABLE(__HANDLE__) \
AnnaBridge 163:e59c8e839560 1012 do{ \
AnnaBridge 163:e59c8e839560 1013 CLEAR_BIT((__HANDLE__)->Instance->CR3, USART_CR3_RTSE);\
AnnaBridge 163:e59c8e839560 1014 (__HANDLE__)->Init.HwFlowCtl &= ~(USART_CR3_RTSE); \
AnnaBridge 163:e59c8e839560 1015 } while(0U)
AnnaBridge 163:e59c8e839560 1016
AnnaBridge 163:e59c8e839560 1017 /**
AnnaBridge 163:e59c8e839560 1018 * @}
AnnaBridge 163:e59c8e839560 1019 */
AnnaBridge 163:e59c8e839560 1020
AnnaBridge 163:e59c8e839560 1021 /* Private macros --------------------------------------------------------*/
AnnaBridge 163:e59c8e839560 1022 /** @defgroup UART_Private_Macros UART Private Macros
AnnaBridge 163:e59c8e839560 1023 * @{
AnnaBridge 163:e59c8e839560 1024 */
AnnaBridge 163:e59c8e839560 1025 /** @brief BRR division operation to set BRR register in 8-bit oversampling mode.
AnnaBridge 168:b9e159c1930a 1026 * @param __PCLK__ UART clock.
AnnaBridge 168:b9e159c1930a 1027 * @param __BAUD__ Baud rate set by the user.
AnnaBridge 163:e59c8e839560 1028 * @retval Division result
AnnaBridge 163:e59c8e839560 1029 */
AnnaBridge 163:e59c8e839560 1030 #define UART_DIV_SAMPLING8(__PCLK__, __BAUD__) ((((__PCLK__)*2U) + ((__BAUD__)/2U)) / (__BAUD__))
AnnaBridge 163:e59c8e839560 1031
AnnaBridge 163:e59c8e839560 1032 /** @brief BRR division operation to set BRR register in 16-bit oversampling mode.
AnnaBridge 168:b9e159c1930a 1033 * @param __PCLK__ UART clock.
AnnaBridge 168:b9e159c1930a 1034 * @param __BAUD__ Baud rate set by the user.
AnnaBridge 163:e59c8e839560 1035 * @retval Division result
AnnaBridge 163:e59c8e839560 1036 */
AnnaBridge 163:e59c8e839560 1037 #define UART_DIV_SAMPLING16(__PCLK__, __BAUD__) (((__PCLK__) + ((__BAUD__)/2U)) / (__BAUD__))
AnnaBridge 163:e59c8e839560 1038
AnnaBridge 163:e59c8e839560 1039 /** @brief Check UART Baud rate.
AnnaBridge 168:b9e159c1930a 1040 * @param __BAUDRATE__ Baudrate specified by the user.
AnnaBridge 163:e59c8e839560 1041 * The maximum Baud Rate is derived from the maximum clock on F3 (i.e. 72 MHz)
AnnaBridge 163:e59c8e839560 1042 * divided by the smallest oversampling used on the USART (i.e. 8)
AnnaBridge 163:e59c8e839560 1043 * @retval SET (__BAUDRATE__ is valid) or RESET (__BAUDRATE__ is invalid)
AnnaBridge 163:e59c8e839560 1044 */
AnnaBridge 163:e59c8e839560 1045 #define IS_UART_BAUDRATE(__BAUDRATE__) ((__BAUDRATE__) < 9000001U)
AnnaBridge 163:e59c8e839560 1046
AnnaBridge 163:e59c8e839560 1047 /** @brief Check UART assertion time.
AnnaBridge 168:b9e159c1930a 1048 * @param __TIME__ 5-bit value assertion time.
AnnaBridge 163:e59c8e839560 1049 * @retval Test result (TRUE or FALSE).
AnnaBridge 163:e59c8e839560 1050 */
AnnaBridge 163:e59c8e839560 1051 #define IS_UART_ASSERTIONTIME(__TIME__) ((__TIME__) <= 0x1FU)
AnnaBridge 163:e59c8e839560 1052
AnnaBridge 163:e59c8e839560 1053 /** @brief Check UART deassertion time.
AnnaBridge 168:b9e159c1930a 1054 * @param __TIME__ 5-bit value deassertion time.
AnnaBridge 163:e59c8e839560 1055 * @retval Test result (TRUE or FALSE).
AnnaBridge 163:e59c8e839560 1056 */
AnnaBridge 163:e59c8e839560 1057 #define IS_UART_DEASSERTIONTIME(__TIME__) ((__TIME__) <= 0x1FU)
AnnaBridge 163:e59c8e839560 1058
AnnaBridge 163:e59c8e839560 1059 /**
AnnaBridge 163:e59c8e839560 1060 * @brief Ensure that UART frame number of stop bits is valid.
AnnaBridge 168:b9e159c1930a 1061 * @param __STOPBITS__ UART frame number of stop bits.
AnnaBridge 163:e59c8e839560 1062 * @retval SET (__STOPBITS__ is valid) or RESET (__STOPBITS__ is invalid)
AnnaBridge 163:e59c8e839560 1063 */
AnnaBridge 163:e59c8e839560 1064 #define IS_UART_STOPBITS(__STOPBITS__) (((__STOPBITS__) == UART_STOPBITS_0_5) || \
AnnaBridge 163:e59c8e839560 1065 ((__STOPBITS__) == UART_STOPBITS_1) || \
AnnaBridge 163:e59c8e839560 1066 ((__STOPBITS__) == UART_STOPBITS_1_5) || \
AnnaBridge 163:e59c8e839560 1067 ((__STOPBITS__) == UART_STOPBITS_2))
AnnaBridge 163:e59c8e839560 1068
AnnaBridge 163:e59c8e839560 1069 /**
AnnaBridge 163:e59c8e839560 1070 * @brief Ensure that UART frame parity is valid.
AnnaBridge 168:b9e159c1930a 1071 * @param __PARITY__ UART frame parity.
AnnaBridge 163:e59c8e839560 1072 * @retval SET (__PARITY__ is valid) or RESET (__PARITY__ is invalid)
AnnaBridge 163:e59c8e839560 1073 */
AnnaBridge 163:e59c8e839560 1074 #define IS_UART_PARITY(__PARITY__) (((__PARITY__) == UART_PARITY_NONE) || \
AnnaBridge 163:e59c8e839560 1075 ((__PARITY__) == UART_PARITY_EVEN) || \
AnnaBridge 163:e59c8e839560 1076 ((__PARITY__) == UART_PARITY_ODD))
AnnaBridge 163:e59c8e839560 1077
AnnaBridge 163:e59c8e839560 1078 /**
AnnaBridge 163:e59c8e839560 1079 * @brief Ensure that UART hardware flow control is valid.
AnnaBridge 168:b9e159c1930a 1080 * @param __CONTROL__ UART hardware flow control.
AnnaBridge 163:e59c8e839560 1081 * @retval SET (__CONTROL__ is valid) or RESET (__CONTROL__ is invalid)
AnnaBridge 163:e59c8e839560 1082 */
AnnaBridge 163:e59c8e839560 1083 #define IS_UART_HARDWARE_FLOW_CONTROL(__CONTROL__)\
AnnaBridge 163:e59c8e839560 1084 (((__CONTROL__) == UART_HWCONTROL_NONE) || \
AnnaBridge 163:e59c8e839560 1085 ((__CONTROL__) == UART_HWCONTROL_RTS) || \
AnnaBridge 163:e59c8e839560 1086 ((__CONTROL__) == UART_HWCONTROL_CTS) || \
AnnaBridge 163:e59c8e839560 1087 ((__CONTROL__) == UART_HWCONTROL_RTS_CTS))
AnnaBridge 163:e59c8e839560 1088
AnnaBridge 163:e59c8e839560 1089 /**
AnnaBridge 163:e59c8e839560 1090 * @brief Ensure that UART communication mode is valid.
AnnaBridge 168:b9e159c1930a 1091 * @param __MODE__ UART communication mode.
AnnaBridge 163:e59c8e839560 1092 * @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid)
AnnaBridge 163:e59c8e839560 1093 */
AnnaBridge 163:e59c8e839560 1094 #define IS_UART_MODE(__MODE__) ((((__MODE__) & (~((uint32_t)(UART_MODE_TX_RX)))) == 0x00U) && ((__MODE__) != 0x00U))
AnnaBridge 163:e59c8e839560 1095
AnnaBridge 163:e59c8e839560 1096 /**
AnnaBridge 163:e59c8e839560 1097 * @brief Ensure that UART state is valid.
AnnaBridge 168:b9e159c1930a 1098 * @param __STATE__ UART state.
AnnaBridge 163:e59c8e839560 1099 * @retval SET (__STATE__ is valid) or RESET (__STATE__ is invalid)
AnnaBridge 163:e59c8e839560 1100 */
AnnaBridge 163:e59c8e839560 1101 #define IS_UART_STATE(__STATE__) (((__STATE__) == UART_STATE_DISABLE) || \
AnnaBridge 163:e59c8e839560 1102 ((__STATE__) == UART_STATE_ENABLE))
AnnaBridge 163:e59c8e839560 1103
AnnaBridge 163:e59c8e839560 1104 /**
AnnaBridge 163:e59c8e839560 1105 * @brief Ensure that UART oversampling is valid.
AnnaBridge 168:b9e159c1930a 1106 * @param __SAMPLING__ UART oversampling.
AnnaBridge 163:e59c8e839560 1107 * @retval SET (__SAMPLING__ is valid) or RESET (__SAMPLING__ is invalid)
AnnaBridge 163:e59c8e839560 1108 */
AnnaBridge 163:e59c8e839560 1109 #define IS_UART_OVERSAMPLING(__SAMPLING__) (((__SAMPLING__) == UART_OVERSAMPLING_16) || \
AnnaBridge 163:e59c8e839560 1110 ((__SAMPLING__) == UART_OVERSAMPLING_8))
AnnaBridge 163:e59c8e839560 1111
AnnaBridge 163:e59c8e839560 1112 /**
AnnaBridge 163:e59c8e839560 1113 * @brief Ensure that UART frame sampling is valid.
AnnaBridge 168:b9e159c1930a 1114 * @param __ONEBIT__ UART frame sampling.
AnnaBridge 163:e59c8e839560 1115 * @retval SET (__ONEBIT__ is valid) or RESET (__ONEBIT__ is invalid)
AnnaBridge 163:e59c8e839560 1116 */
AnnaBridge 163:e59c8e839560 1117 #define IS_UART_ONE_BIT_SAMPLE(__ONEBIT__) (((__ONEBIT__) == UART_ONE_BIT_SAMPLE_DISABLE) || \
AnnaBridge 163:e59c8e839560 1118 ((__ONEBIT__) == UART_ONE_BIT_SAMPLE_ENABLE))
AnnaBridge 163:e59c8e839560 1119
AnnaBridge 163:e59c8e839560 1120 /**
AnnaBridge 163:e59c8e839560 1121 * @brief Ensure that Address Length detection parameter is valid.
AnnaBridge 168:b9e159c1930a 1122 * @param __ADDRESS__ UART Adress length value.
AnnaBridge 163:e59c8e839560 1123 * @retval SET (__ADDRESS__ is valid) or RESET (__ADDRESS__ is invalid)
AnnaBridge 163:e59c8e839560 1124 */
AnnaBridge 163:e59c8e839560 1125 #define IS_UART_ADDRESSLENGTH_DETECT(__ADDRESS__) (((__ADDRESS__) == UART_ADDRESS_DETECT_4B) || \
AnnaBridge 163:e59c8e839560 1126 ((__ADDRESS__) == UART_ADDRESS_DETECT_7B))
AnnaBridge 163:e59c8e839560 1127
AnnaBridge 163:e59c8e839560 1128 /**
AnnaBridge 163:e59c8e839560 1129 * @brief Ensure that UART auto Baud rate detection mode is valid.
AnnaBridge 168:b9e159c1930a 1130 * @param __MODE__ UART auto Baud rate detection mode.
AnnaBridge 163:e59c8e839560 1131 * @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid)
AnnaBridge 163:e59c8e839560 1132 */
AnnaBridge 163:e59c8e839560 1133 #define IS_UART_ADVFEATURE_AUTOBAUDRATEMODE(__MODE__) (((__MODE__) == UART_ADVFEATURE_AUTOBAUDRATE_ONSTARTBIT) || \
AnnaBridge 163:e59c8e839560 1134 ((__MODE__) == UART_ADVFEATURE_AUTOBAUDRATE_ONFALLINGEDGE) || \
AnnaBridge 163:e59c8e839560 1135 ((__MODE__) == UART_ADVFEATURE_AUTOBAUDRATE_ON0X7FFRAME) || \
AnnaBridge 163:e59c8e839560 1136 ((__MODE__) == UART_ADVFEATURE_AUTOBAUDRATE_ON0X55FRAME))
AnnaBridge 163:e59c8e839560 1137
AnnaBridge 163:e59c8e839560 1138 /**
AnnaBridge 163:e59c8e839560 1139 * @brief Ensure that UART receiver timeout setting is valid.
AnnaBridge 168:b9e159c1930a 1140 * @param __TIMEOUT__ UART receiver timeout setting.
AnnaBridge 163:e59c8e839560 1141 * @retval SET (__TIMEOUT__ is valid) or RESET (__TIMEOUT__ is invalid)
AnnaBridge 163:e59c8e839560 1142 */
AnnaBridge 163:e59c8e839560 1143 #define IS_UART_RECEIVER_TIMEOUT(__TIMEOUT__) (((__TIMEOUT__) == UART_RECEIVER_TIMEOUT_DISABLE) || \
AnnaBridge 163:e59c8e839560 1144 ((__TIMEOUT__) == UART_RECEIVER_TIMEOUT_ENABLE))
AnnaBridge 163:e59c8e839560 1145
AnnaBridge 163:e59c8e839560 1146 /**
AnnaBridge 163:e59c8e839560 1147 * @brief Ensure that UART LIN state is valid.
AnnaBridge 168:b9e159c1930a 1148 * @param __LIN__ UART LIN state.
AnnaBridge 163:e59c8e839560 1149 * @retval SET (__LIN__ is valid) or RESET (__LIN__ is invalid)
AnnaBridge 163:e59c8e839560 1150 */
AnnaBridge 163:e59c8e839560 1151 #define IS_UART_LIN(__LIN__) (((__LIN__) == UART_LIN_DISABLE) || \
AnnaBridge 163:e59c8e839560 1152 ((__LIN__) == UART_LIN_ENABLE))
AnnaBridge 163:e59c8e839560 1153
AnnaBridge 163:e59c8e839560 1154 /**
AnnaBridge 163:e59c8e839560 1155 * @brief Ensure that UART LIN break detection length is valid.
AnnaBridge 168:b9e159c1930a 1156 * @param __LENGTH__ UART LIN break detection length.
AnnaBridge 163:e59c8e839560 1157 * @retval SET (__LENGTH__ is valid) or RESET (__LENGTH__ is invalid)
AnnaBridge 163:e59c8e839560 1158 */
AnnaBridge 163:e59c8e839560 1159 #define IS_UART_LIN_BREAK_DETECT_LENGTH(__LENGTH__) (((__LENGTH__) == UART_LINBREAKDETECTLENGTH_10B) || \
AnnaBridge 163:e59c8e839560 1160 ((__LENGTH__) == UART_LINBREAKDETECTLENGTH_11B))
AnnaBridge 163:e59c8e839560 1161
AnnaBridge 163:e59c8e839560 1162 /**
AnnaBridge 163:e59c8e839560 1163 * @brief Ensure that UART DMA TX state is valid.
AnnaBridge 168:b9e159c1930a 1164 * @param __DMATX__ UART DMA TX state.
AnnaBridge 163:e59c8e839560 1165 * @retval SET (__DMATX__ is valid) or RESET (__DMATX__ is invalid)
AnnaBridge 163:e59c8e839560 1166 */
AnnaBridge 163:e59c8e839560 1167 #define IS_UART_DMA_TX(__DMATX__) (((__DMATX__) == UART_DMA_TX_DISABLE) || \
AnnaBridge 163:e59c8e839560 1168 ((__DMATX__) == UART_DMA_TX_ENABLE))
AnnaBridge 163:e59c8e839560 1169
AnnaBridge 163:e59c8e839560 1170 /**
AnnaBridge 163:e59c8e839560 1171 * @brief Ensure that UART DMA RX state is valid.
AnnaBridge 168:b9e159c1930a 1172 * @param __DMARX__ UART DMA RX state.
AnnaBridge 163:e59c8e839560 1173 * @retval SET (__DMARX__ is valid) or RESET (__DMARX__ is invalid)
AnnaBridge 163:e59c8e839560 1174 */
AnnaBridge 163:e59c8e839560 1175 #define IS_UART_DMA_RX(__DMARX__) (((__DMARX__) == UART_DMA_RX_DISABLE) || \
AnnaBridge 163:e59c8e839560 1176 ((__DMARX__) == UART_DMA_RX_ENABLE))
AnnaBridge 163:e59c8e839560 1177
AnnaBridge 163:e59c8e839560 1178 /**
AnnaBridge 163:e59c8e839560 1179 * @brief Ensure that UART half-duplex state is valid.
AnnaBridge 168:b9e159c1930a 1180 * @param __HDSEL__ UART half-duplex state.
AnnaBridge 163:e59c8e839560 1181 * @retval SET (__HDSEL__ is valid) or RESET (__HDSEL__ is invalid)
AnnaBridge 163:e59c8e839560 1182 */
AnnaBridge 163:e59c8e839560 1183 #define IS_UART_HALF_DUPLEX(__HDSEL__) (((__HDSEL__) == UART_HALF_DUPLEX_DISABLE) || \
AnnaBridge 163:e59c8e839560 1184 ((__HDSEL__) == UART_HALF_DUPLEX_ENABLE))
AnnaBridge 163:e59c8e839560 1185
AnnaBridge 163:e59c8e839560 1186 /**
AnnaBridge 163:e59c8e839560 1187 * @brief Ensure that UART wake-up method is valid.
AnnaBridge 168:b9e159c1930a 1188 * @param __WAKEUP__ UART wake-up method .
AnnaBridge 163:e59c8e839560 1189 * @retval SET (__WAKEUP__ is valid) or RESET (__WAKEUP__ is invalid)
AnnaBridge 163:e59c8e839560 1190 */
AnnaBridge 163:e59c8e839560 1191 #define IS_UART_WAKEUPMETHOD(__WAKEUP__) (((__WAKEUP__) == UART_WAKEUPMETHOD_IDLELINE) || \
AnnaBridge 163:e59c8e839560 1192 ((__WAKEUP__) == UART_WAKEUPMETHOD_ADDRESSMARK))
AnnaBridge 163:e59c8e839560 1193
AnnaBridge 163:e59c8e839560 1194 /**
AnnaBridge 163:e59c8e839560 1195 * @brief Ensure that UART advanced features initialization is valid.
AnnaBridge 168:b9e159c1930a 1196 * @param __INIT__ UART advanced features initialization.
AnnaBridge 163:e59c8e839560 1197 * @retval SET (__INIT__ is valid) or RESET (__INIT__ is invalid)
AnnaBridge 163:e59c8e839560 1198 */
AnnaBridge 163:e59c8e839560 1199 #define IS_UART_ADVFEATURE_INIT(__INIT__) ((__INIT__) <= (UART_ADVFEATURE_NO_INIT | \
AnnaBridge 163:e59c8e839560 1200 UART_ADVFEATURE_TXINVERT_INIT | \
AnnaBridge 163:e59c8e839560 1201 UART_ADVFEATURE_RXINVERT_INIT | \
AnnaBridge 163:e59c8e839560 1202 UART_ADVFEATURE_DATAINVERT_INIT | \
AnnaBridge 163:e59c8e839560 1203 UART_ADVFEATURE_SWAP_INIT | \
AnnaBridge 163:e59c8e839560 1204 UART_ADVFEATURE_RXOVERRUNDISABLE_INIT | \
AnnaBridge 163:e59c8e839560 1205 UART_ADVFEATURE_DMADISABLEONERROR_INIT | \
AnnaBridge 163:e59c8e839560 1206 UART_ADVFEATURE_AUTOBAUDRATE_INIT | \
AnnaBridge 163:e59c8e839560 1207 UART_ADVFEATURE_MSBFIRST_INIT))
AnnaBridge 163:e59c8e839560 1208
AnnaBridge 163:e59c8e839560 1209 /**
AnnaBridge 163:e59c8e839560 1210 * @brief Ensure that UART frame TX inversion setting is valid.
AnnaBridge 168:b9e159c1930a 1211 * @param __TXINV__ UART frame TX inversion setting.
AnnaBridge 163:e59c8e839560 1212 * @retval SET (__TXINV__ is valid) or RESET (__TXINV__ is invalid)
AnnaBridge 163:e59c8e839560 1213 */
AnnaBridge 163:e59c8e839560 1214 #define IS_UART_ADVFEATURE_TXINV(__TXINV__) (((__TXINV__) == UART_ADVFEATURE_TXINV_DISABLE) || \
AnnaBridge 163:e59c8e839560 1215 ((__TXINV__) == UART_ADVFEATURE_TXINV_ENABLE))
AnnaBridge 163:e59c8e839560 1216
AnnaBridge 163:e59c8e839560 1217 /**
AnnaBridge 163:e59c8e839560 1218 * @brief Ensure that UART frame RX inversion setting is valid.
AnnaBridge 168:b9e159c1930a 1219 * @param __RXINV__ UART frame RX inversion setting.
AnnaBridge 163:e59c8e839560 1220 * @retval SET (__RXINV__ is valid) or RESET (__RXINV__ is invalid)
AnnaBridge 163:e59c8e839560 1221 */
AnnaBridge 163:e59c8e839560 1222 #define IS_UART_ADVFEATURE_RXINV(__RXINV__) (((__RXINV__) == UART_ADVFEATURE_RXINV_DISABLE) || \
AnnaBridge 163:e59c8e839560 1223 ((__RXINV__) == UART_ADVFEATURE_RXINV_ENABLE))
AnnaBridge 163:e59c8e839560 1224
AnnaBridge 163:e59c8e839560 1225 /**
AnnaBridge 163:e59c8e839560 1226 * @brief Ensure that UART frame data inversion setting is valid.
AnnaBridge 168:b9e159c1930a 1227 * @param __DATAINV__ UART frame data inversion setting.
AnnaBridge 163:e59c8e839560 1228 * @retval SET (__DATAINV__ is valid) or RESET (__DATAINV__ is invalid)
AnnaBridge 163:e59c8e839560 1229 */
AnnaBridge 163:e59c8e839560 1230 #define IS_UART_ADVFEATURE_DATAINV(__DATAINV__) (((__DATAINV__) == UART_ADVFEATURE_DATAINV_DISABLE) || \
AnnaBridge 163:e59c8e839560 1231 ((__DATAINV__) == UART_ADVFEATURE_DATAINV_ENABLE))
AnnaBridge 163:e59c8e839560 1232
AnnaBridge 163:e59c8e839560 1233 /**
AnnaBridge 163:e59c8e839560 1234 * @brief Ensure that UART frame RX/TX pins swap setting is valid.
AnnaBridge 168:b9e159c1930a 1235 * @param __SWAP__ UART frame RX/TX pins swap setting.
AnnaBridge 163:e59c8e839560 1236 * @retval SET (__SWAP__ is valid) or RESET (__SWAP__ is invalid)
AnnaBridge 163:e59c8e839560 1237 */
AnnaBridge 163:e59c8e839560 1238 #define IS_UART_ADVFEATURE_SWAP(__SWAP__) (((__SWAP__) == UART_ADVFEATURE_SWAP_DISABLE) || \
AnnaBridge 163:e59c8e839560 1239 ((__SWAP__) == UART_ADVFEATURE_SWAP_ENABLE))
AnnaBridge 163:e59c8e839560 1240
AnnaBridge 163:e59c8e839560 1241 /**
AnnaBridge 163:e59c8e839560 1242 * @brief Ensure that UART frame overrun setting is valid.
AnnaBridge 168:b9e159c1930a 1243 * @param __OVERRUN__ UART frame overrun setting.
AnnaBridge 163:e59c8e839560 1244 * @retval SET (__OVERRUN__ is valid) or RESET (__OVERRUN__ is invalid)
AnnaBridge 163:e59c8e839560 1245 */
AnnaBridge 163:e59c8e839560 1246 #define IS_UART_OVERRUN(__OVERRUN__) (((__OVERRUN__) == UART_ADVFEATURE_OVERRUN_ENABLE) || \
AnnaBridge 163:e59c8e839560 1247 ((__OVERRUN__) == UART_ADVFEATURE_OVERRUN_DISABLE))
AnnaBridge 163:e59c8e839560 1248
AnnaBridge 163:e59c8e839560 1249 /**
AnnaBridge 163:e59c8e839560 1250 * @brief Ensure that UART auto Baud rate state is valid.
AnnaBridge 168:b9e159c1930a 1251 * @param __AUTOBAUDRATE__ UART auto Baud rate state.
AnnaBridge 163:e59c8e839560 1252 * @retval SET (__AUTOBAUDRATE__ is valid) or RESET (__AUTOBAUDRATE__ is invalid)
AnnaBridge 163:e59c8e839560 1253 */
AnnaBridge 163:e59c8e839560 1254 #define IS_UART_ADVFEATURE_AUTOBAUDRATE(__AUTOBAUDRATE__) (((__AUTOBAUDRATE__) == UART_ADVFEATURE_AUTOBAUDRATE_DISABLE) || \
AnnaBridge 163:e59c8e839560 1255 ((__AUTOBAUDRATE__) == UART_ADVFEATURE_AUTOBAUDRATE_ENABLE))
AnnaBridge 163:e59c8e839560 1256
AnnaBridge 163:e59c8e839560 1257 /**
AnnaBridge 163:e59c8e839560 1258 * @brief Ensure that UART DMA enabling or disabling on error setting is valid.
AnnaBridge 168:b9e159c1930a 1259 * @param __DMA__ UART DMA enabling or disabling on error setting.
AnnaBridge 163:e59c8e839560 1260 * @retval SET (__DMA__ is valid) or RESET (__DMA__ is invalid)
AnnaBridge 163:e59c8e839560 1261 */
AnnaBridge 163:e59c8e839560 1262 #define IS_UART_ADVFEATURE_DMAONRXERROR(__DMA__) (((__DMA__) == UART_ADVFEATURE_DMA_ENABLEONRXERROR) || \
AnnaBridge 163:e59c8e839560 1263 ((__DMA__) == UART_ADVFEATURE_DMA_DISABLEONRXERROR))
AnnaBridge 163:e59c8e839560 1264
AnnaBridge 163:e59c8e839560 1265 /**
AnnaBridge 163:e59c8e839560 1266 * @brief Ensure that UART frame MSB first setting is valid.
AnnaBridge 168:b9e159c1930a 1267 * @param __MSBFIRST__ UART frame MSB first setting.
AnnaBridge 163:e59c8e839560 1268 * @retval SET (__MSBFIRST__ is valid) or RESET (__MSBFIRST__ is invalid)
AnnaBridge 163:e59c8e839560 1269 */
AnnaBridge 163:e59c8e839560 1270 #define IS_UART_ADVFEATURE_MSBFIRST(__MSBFIRST__) (((__MSBFIRST__) == UART_ADVFEATURE_MSBFIRST_DISABLE) || \
AnnaBridge 163:e59c8e839560 1271 ((__MSBFIRST__) == UART_ADVFEATURE_MSBFIRST_ENABLE))
AnnaBridge 163:e59c8e839560 1272
AnnaBridge 163:e59c8e839560 1273 /**
AnnaBridge 163:e59c8e839560 1274 * @brief Ensure that UART stop mode state is valid.
AnnaBridge 168:b9e159c1930a 1275 * @param __STOPMODE__ UART stop mode state.
AnnaBridge 163:e59c8e839560 1276 * @retval SET (__STOPMODE__ is valid) or RESET (__STOPMODE__ is invalid)
AnnaBridge 163:e59c8e839560 1277 */
AnnaBridge 163:e59c8e839560 1278 #define IS_UART_ADVFEATURE_STOPMODE(__STOPMODE__) (((__STOPMODE__) == UART_ADVFEATURE_STOPMODE_DISABLE) || \
AnnaBridge 163:e59c8e839560 1279 ((__STOPMODE__) == UART_ADVFEATURE_STOPMODE_ENABLE))
AnnaBridge 163:e59c8e839560 1280
AnnaBridge 163:e59c8e839560 1281 /**
AnnaBridge 163:e59c8e839560 1282 * @brief Ensure that UART mute mode state is valid.
AnnaBridge 168:b9e159c1930a 1283 * @param __MUTE__ UART mute mode state.
AnnaBridge 163:e59c8e839560 1284 * @retval SET (__MUTE__ is valid) or RESET (__MUTE__ is invalid)
AnnaBridge 163:e59c8e839560 1285 */
AnnaBridge 163:e59c8e839560 1286 #define IS_UART_MUTE_MODE(__MUTE__) (((__MUTE__) == UART_ADVFEATURE_MUTEMODE_DISABLE) || \
AnnaBridge 163:e59c8e839560 1287 ((__MUTE__) == UART_ADVFEATURE_MUTEMODE_ENABLE))
AnnaBridge 163:e59c8e839560 1288
AnnaBridge 163:e59c8e839560 1289 /**
AnnaBridge 163:e59c8e839560 1290 * @brief Ensure that UART wake-up selection is valid.
AnnaBridge 168:b9e159c1930a 1291 * @param __WAKE__ UART wake-up selection.
AnnaBridge 163:e59c8e839560 1292 * @retval SET (__WAKE__ is valid) or RESET (__WAKE__ is invalid)
AnnaBridge 163:e59c8e839560 1293 */
AnnaBridge 163:e59c8e839560 1294 #define IS_UART_WAKEUP_SELECTION(__WAKE__) (((__WAKE__) == UART_WAKEUP_ON_ADDRESS) || \
AnnaBridge 163:e59c8e839560 1295 ((__WAKE__) == UART_WAKEUP_ON_STARTBIT) || \
AnnaBridge 163:e59c8e839560 1296 ((__WAKE__) == UART_WAKEUP_ON_READDATA_NONEMPTY))
AnnaBridge 163:e59c8e839560 1297
AnnaBridge 163:e59c8e839560 1298 /**
AnnaBridge 163:e59c8e839560 1299 * @brief Ensure that UART driver enable polarity is valid.
AnnaBridge 168:b9e159c1930a 1300 * @param __POLARITY__ UART driver enable polarity.
AnnaBridge 163:e59c8e839560 1301 * @retval SET (__POLARITY__ is valid) or RESET (__POLARITY__ is invalid)
AnnaBridge 163:e59c8e839560 1302 */
AnnaBridge 163:e59c8e839560 1303 #define IS_UART_DE_POLARITY(__POLARITY__) (((__POLARITY__) == UART_DE_POLARITY_HIGH) || \
AnnaBridge 163:e59c8e839560 1304 ((__POLARITY__) == UART_DE_POLARITY_LOW))
AnnaBridge 163:e59c8e839560 1305
AnnaBridge 163:e59c8e839560 1306 /**
AnnaBridge 163:e59c8e839560 1307 * @brief Ensure that UART request parameter is valid.
AnnaBridge 168:b9e159c1930a 1308 * @param __PARAM__ UART request parameter.
AnnaBridge 163:e59c8e839560 1309 * @retval SET (__PARAM__ is valid) or RESET (__PARAM__ is invalid)
AnnaBridge 163:e59c8e839560 1310 */
AnnaBridge 163:e59c8e839560 1311 #define IS_UART_REQUEST_PARAMETER(__PARAM__) (((__PARAM__) == UART_AUTOBAUD_REQUEST) || \
AnnaBridge 163:e59c8e839560 1312 ((__PARAM__) == UART_SENDBREAK_REQUEST) || \
AnnaBridge 163:e59c8e839560 1313 ((__PARAM__) == UART_MUTE_MODE_REQUEST) || \
AnnaBridge 163:e59c8e839560 1314 ((__PARAM__) == UART_RXDATA_FLUSH_REQUEST) || \
AnnaBridge 163:e59c8e839560 1315 ((__PARAM__) == UART_TXDATA_FLUSH_REQUEST))
AnnaBridge 163:e59c8e839560 1316
AnnaBridge 163:e59c8e839560 1317 /**
AnnaBridge 163:e59c8e839560 1318 * @}
AnnaBridge 163:e59c8e839560 1319 */
AnnaBridge 163:e59c8e839560 1320
AnnaBridge 163:e59c8e839560 1321 /* Include UART HAL Extended module */
AnnaBridge 163:e59c8e839560 1322 #include "stm32f3xx_hal_uart_ex.h"
AnnaBridge 163:e59c8e839560 1323
AnnaBridge 163:e59c8e839560 1324 /* Exported functions --------------------------------------------------------*/
AnnaBridge 163:e59c8e839560 1325 /** @addtogroup UART_Exported_Functions UART Exported Functions
AnnaBridge 163:e59c8e839560 1326 * @{
AnnaBridge 163:e59c8e839560 1327 */
AnnaBridge 163:e59c8e839560 1328
AnnaBridge 163:e59c8e839560 1329 /** @addtogroup UART_Exported_Functions_Group1 Initialization and de-initialization functions
AnnaBridge 163:e59c8e839560 1330 * @{
AnnaBridge 163:e59c8e839560 1331 */
AnnaBridge 163:e59c8e839560 1332
AnnaBridge 163:e59c8e839560 1333 /* Initialization and de-initialization functions ****************************/
AnnaBridge 163:e59c8e839560 1334 HAL_StatusTypeDef HAL_UART_Init(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1335 HAL_StatusTypeDef HAL_HalfDuplex_Init(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1336 HAL_StatusTypeDef HAL_LIN_Init(UART_HandleTypeDef *huart, uint32_t BreakDetectLength);
AnnaBridge 163:e59c8e839560 1337 HAL_StatusTypeDef HAL_MultiProcessor_Init(UART_HandleTypeDef *huart, uint8_t Address, uint32_t WakeUpMethod);
AnnaBridge 163:e59c8e839560 1338 HAL_StatusTypeDef HAL_UART_DeInit (UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1339 void HAL_UART_MspInit(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1340 void HAL_UART_MspDeInit(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1341
AnnaBridge 163:e59c8e839560 1342 /**
AnnaBridge 163:e59c8e839560 1343 * @}
AnnaBridge 163:e59c8e839560 1344 */
AnnaBridge 163:e59c8e839560 1345
AnnaBridge 163:e59c8e839560 1346 /** @addtogroup UART_Exported_Functions_Group2 IO operation functions
AnnaBridge 163:e59c8e839560 1347 * @{
AnnaBridge 163:e59c8e839560 1348 */
AnnaBridge 163:e59c8e839560 1349
AnnaBridge 163:e59c8e839560 1350 /* IO operation functions *****************************************************/
AnnaBridge 163:e59c8e839560 1351 HAL_StatusTypeDef HAL_UART_Transmit(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout);
AnnaBridge 163:e59c8e839560 1352 HAL_StatusTypeDef HAL_UART_Receive(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout);
AnnaBridge 163:e59c8e839560 1353 HAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
AnnaBridge 163:e59c8e839560 1354 HAL_StatusTypeDef HAL_UART_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
AnnaBridge 163:e59c8e839560 1355 HAL_StatusTypeDef HAL_UART_Transmit_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
AnnaBridge 163:e59c8e839560 1356 HAL_StatusTypeDef HAL_UART_Receive_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
AnnaBridge 163:e59c8e839560 1357 HAL_StatusTypeDef HAL_UART_DMAPause(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1358 HAL_StatusTypeDef HAL_UART_DMAResume(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1359 HAL_StatusTypeDef HAL_UART_DMAStop(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1360 /* Transfer Abort functions */
AnnaBridge 163:e59c8e839560 1361 HAL_StatusTypeDef HAL_UART_Abort(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1362 HAL_StatusTypeDef HAL_UART_AbortTransmit(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1363 HAL_StatusTypeDef HAL_UART_AbortReceive(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1364 HAL_StatusTypeDef HAL_UART_Abort_IT(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1365 HAL_StatusTypeDef HAL_UART_AbortTransmit_IT(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1366 HAL_StatusTypeDef HAL_UART_AbortReceive_IT(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1367
AnnaBridge 163:e59c8e839560 1368 void HAL_UART_IRQHandler(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1369 void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1370 void HAL_UART_TxHalfCpltCallback(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1371 void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1372 void HAL_UART_RxHalfCpltCallback(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1373 void HAL_UART_ErrorCallback(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1374 void HAL_UART_AbortCpltCallback (UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1375 void HAL_UART_AbortTransmitCpltCallback (UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1376 void HAL_UART_AbortReceiveCpltCallback (UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1377
AnnaBridge 163:e59c8e839560 1378 /**
AnnaBridge 163:e59c8e839560 1379 * @}
AnnaBridge 163:e59c8e839560 1380 */
AnnaBridge 163:e59c8e839560 1381
AnnaBridge 163:e59c8e839560 1382 /** @addtogroup UART_Exported_Functions_Group3 Peripheral Control functions
AnnaBridge 163:e59c8e839560 1383 * @{
AnnaBridge 163:e59c8e839560 1384 */
AnnaBridge 163:e59c8e839560 1385
AnnaBridge 163:e59c8e839560 1386 /* Peripheral Control functions ************************************************/
AnnaBridge 163:e59c8e839560 1387 HAL_StatusTypeDef HAL_MultiProcessor_EnableMuteMode(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1388 HAL_StatusTypeDef HAL_MultiProcessor_DisableMuteMode(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1389 void HAL_MultiProcessor_EnterMuteMode(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1390 HAL_StatusTypeDef HAL_HalfDuplex_EnableTransmitter(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1391 HAL_StatusTypeDef HAL_HalfDuplex_EnableReceiver(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1392 HAL_StatusTypeDef HAL_LIN_SendBreak(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1393
AnnaBridge 163:e59c8e839560 1394 /**
AnnaBridge 163:e59c8e839560 1395 * @}
AnnaBridge 163:e59c8e839560 1396 */
AnnaBridge 163:e59c8e839560 1397
AnnaBridge 163:e59c8e839560 1398 /** @addtogroup UART_Exported_Functions_Group4 Peripheral State and Error functions
AnnaBridge 163:e59c8e839560 1399 * @{
AnnaBridge 163:e59c8e839560 1400 */
AnnaBridge 163:e59c8e839560 1401
AnnaBridge 163:e59c8e839560 1402 /* Peripheral State and Errors functions **************************************************/
AnnaBridge 163:e59c8e839560 1403 HAL_UART_StateTypeDef HAL_UART_GetState(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1404 uint32_t HAL_UART_GetError(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1405
AnnaBridge 163:e59c8e839560 1406 /**
AnnaBridge 163:e59c8e839560 1407 * @}
AnnaBridge 163:e59c8e839560 1408 */
AnnaBridge 163:e59c8e839560 1409
AnnaBridge 163:e59c8e839560 1410 /**
AnnaBridge 163:e59c8e839560 1411 * @}
AnnaBridge 163:e59c8e839560 1412 */
AnnaBridge 163:e59c8e839560 1413
AnnaBridge 163:e59c8e839560 1414 /* Private functions -----------------------------------------------------------*/
AnnaBridge 163:e59c8e839560 1415 /** @addtogroup UART_Private_Functions UART Private Functions
AnnaBridge 163:e59c8e839560 1416 * @{
AnnaBridge 163:e59c8e839560 1417 */
AnnaBridge 163:e59c8e839560 1418 HAL_StatusTypeDef UART_SetConfig(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1419 void UART_AdvFeatureConfig(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1420 HAL_StatusTypeDef UART_CheckIdleState(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1421 HAL_StatusTypeDef UART_WaitOnFlagUntilTimeout(UART_HandleTypeDef *huart, uint32_t Flag, FlagStatus Status, uint32_t Tickstart, uint32_t Timeout);
AnnaBridge 163:e59c8e839560 1422 HAL_StatusTypeDef UART_Transmit_IT(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1423 HAL_StatusTypeDef UART_EndTransmit_IT(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1424 HAL_StatusTypeDef UART_Receive_IT(UART_HandleTypeDef *huart);
AnnaBridge 163:e59c8e839560 1425 void UART_Wakeup_AddressConfig(UART_HandleTypeDef *huart, UART_WakeUpTypeDef WakeUpSelection);
AnnaBridge 163:e59c8e839560 1426
AnnaBridge 163:e59c8e839560 1427 /**
AnnaBridge 163:e59c8e839560 1428 * @}
AnnaBridge 163:e59c8e839560 1429 */
AnnaBridge 163:e59c8e839560 1430
AnnaBridge 163:e59c8e839560 1431 /**
AnnaBridge 163:e59c8e839560 1432 * @}
AnnaBridge 163:e59c8e839560 1433 */
AnnaBridge 163:e59c8e839560 1434
AnnaBridge 163:e59c8e839560 1435 /**
AnnaBridge 163:e59c8e839560 1436 * @}
AnnaBridge 163:e59c8e839560 1437 */
AnnaBridge 163:e59c8e839560 1438
AnnaBridge 163:e59c8e839560 1439 #ifdef __cplusplus
AnnaBridge 163:e59c8e839560 1440 }
AnnaBridge 163:e59c8e839560 1441 #endif
AnnaBridge 163:e59c8e839560 1442
AnnaBridge 163:e59c8e839560 1443 #endif /* __STM32F3xx_HAL_UART_H */
AnnaBridge 163:e59c8e839560 1444
AnnaBridge 163:e59c8e839560 1445 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
AnnaBridge 163:e59c8e839560 1446