cc y / mbed

Fork of mbed by mbed official

Committer:
kaoshen
Date:
Tue Jan 17 23:27:32 2017 +0000
Revision:
135:fce8a9387ed1
Parent:
130:d75b3fe1f5cb
333 ADS1115 ADC1

Who changed what in which revision?

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