1 /**
2   ******************************************************************************
3   * @file    stm32f4xx_hal_uart.h
4   * @author  MCD Application Team
5   * @brief   Header file of UART HAL module.
6   ******************************************************************************
7   * @attention
8   *
9   * Copyright (c) 2016 STMicroelectronics.
10   * All rights reserved.
11   *
12   * This software is licensed under terms that can be found in the LICENSE file
13   * in the root directory of this software component.
14   * If no LICENSE file comes with this software, it is provided AS-IS.
15   *
16   ******************************************************************************
17   */
18 
19 /* Define to prevent recursive inclusion -------------------------------------*/
20 #ifndef __STM32F4xx_HAL_UART_H
21 #define __STM32F4xx_HAL_UART_H
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26 
27 /* Includes ------------------------------------------------------------------*/
28 #include "stm32f4xx_hal_def.h"
29 
30 /** @addtogroup STM32F4xx_HAL_Driver
31   * @{
32   */
33 
34 /** @addtogroup UART
35   * @{
36   */
37 
38 /* Exported types ------------------------------------------------------------*/
39 /** @defgroup UART_Exported_Types UART Exported Types
40   * @{
41   */
42 
43 /**
44   * @brief UART Init Structure definition
45   */
46 typedef struct
47 {
48   uint32_t BaudRate;                  /*!< This member configures the UART communication baud rate.
49                                            The baud rate is computed using the following formula:
50                                            - IntegerDivider = ((PCLKx) / (8 * (OVR8+1) * (huart->Init.BaudRate)))
51                                            - FractionalDivider = ((IntegerDivider - ((uint32_t) IntegerDivider)) * 8 * (OVR8+1)) + 0.5
52                                            Where OVR8 is the "oversampling by 8 mode" configuration bit in the CR1 register. */
53 
54   uint32_t WordLength;                /*!< Specifies the number of data bits transmitted or received in a frame.
55                                            This parameter can be a value of @ref UART_Word_Length */
56 
57   uint32_t StopBits;                  /*!< Specifies the number of stop bits transmitted.
58                                            This parameter can be a value of @ref UART_Stop_Bits */
59 
60   uint32_t Parity;                    /*!< Specifies the parity mode.
61                                            This parameter can be a value of @ref UART_Parity
62                                            @note When parity is enabled, the computed parity is inserted
63                                                  at the MSB position of the transmitted data (9th bit when
64                                                  the word length is set to 9 data bits; 8th bit when the
65                                                  word length is set to 8 data bits). */
66 
67   uint32_t Mode;                      /*!< Specifies whether the Receive or Transmit mode is enabled or disabled.
68                                            This parameter can be a value of @ref UART_Mode */
69 
70   uint32_t HwFlowCtl;                 /*!< Specifies whether the hardware flow control mode is enabled or disabled.
71                                            This parameter can be a value of @ref UART_Hardware_Flow_Control */
72 
73   uint32_t OverSampling;              /*!< Specifies whether the Over sampling 8 is enabled or disabled, to achieve higher speed (up to fPCLK/8).
74                                            This parameter can be a value of @ref UART_Over_Sampling */
75 } UART_InitTypeDef;
76 
77 /**
78   * @brief HAL UART State structures definition
79   * @note  HAL UART State value is a combination of 2 different substates: gState and RxState.
80   *        - gState contains UART state information related to global Handle management
81   *          and also information related to Tx operations.
82   *          gState value coding follow below described bitmap :
83   *          b7-b6  Error information
84   *             00 : No Error
85   *             01 : (Not Used)
86   *             10 : Timeout
87   *             11 : Error
88   *          b5     Peripheral initialization status
89   *             0  : Reset (Peripheral not initialized)
90   *             1  : Init done (Peripheral initialized. HAL UART Init function already called)
91   *          b4-b3  (not used)
92   *             xx : Should be set to 00
93   *          b2     Intrinsic process state
94   *             0  : Ready
95   *             1  : Busy (Peripheral busy with some configuration or internal operations)
96   *          b1     (not used)
97   *             x  : Should be set to 0
98   *          b0     Tx state
99   *             0  : Ready (no Tx operation ongoing)
100   *             1  : Busy (Tx operation ongoing)
101   *        - RxState contains information related to Rx operations.
102   *          RxState value coding follow below described bitmap :
103   *          b7-b6  (not used)
104   *             xx : Should be set to 00
105   *          b5     Peripheral initialization status
106   *             0  : Reset (Peripheral not initialized)
107   *             1  : Init done (Peripheral initialized)
108   *          b4-b2  (not used)
109   *            xxx : Should be set to 000
110   *          b1     Rx state
111   *             0  : Ready (no Rx operation ongoing)
112   *             1  : Busy (Rx operation ongoing)
113   *          b0     (not used)
114   *             x  : Should be set to 0.
115   */
116 typedef enum
117 {
118   HAL_UART_STATE_RESET             = 0x00U,    /*!< Peripheral is not yet Initialized
119                                                    Value is allowed for gState and RxState */
120   HAL_UART_STATE_READY             = 0x20U,    /*!< Peripheral Initialized and ready for use
121                                                    Value is allowed for gState and RxState */
122   HAL_UART_STATE_BUSY              = 0x24U,    /*!< an internal process is ongoing
123                                                    Value is allowed for gState only */
124   HAL_UART_STATE_BUSY_TX           = 0x21U,    /*!< Data Transmission process is ongoing
125                                                    Value is allowed for gState only */
126   HAL_UART_STATE_BUSY_RX           = 0x22U,    /*!< Data Reception process is ongoing
127                                                    Value is allowed for RxState only */
128   HAL_UART_STATE_BUSY_TX_RX        = 0x23U,    /*!< Data Transmission and Reception process is ongoing
129                                                    Not to be used for neither gState nor RxState.
130                                                    Value is result of combination (Or) between gState and RxState values */
131   HAL_UART_STATE_TIMEOUT           = 0xA0U,    /*!< Timeout state
132                                                    Value is allowed for gState only */
133   HAL_UART_STATE_ERROR             = 0xE0U     /*!< Error
134                                                    Value is allowed for gState only */
135 } HAL_UART_StateTypeDef;
136 
137 /**
138   * @brief HAL UART Reception type definition
139   * @note  HAL UART Reception type value aims to identify which type of Reception is ongoing.
140   *        It is expected to admit following values :
141   *           HAL_UART_RECEPTION_STANDARD         = 0x00U,
142   *           HAL_UART_RECEPTION_TOIDLE           = 0x01U,
143   */
144 typedef uint32_t HAL_UART_RxTypeTypeDef;
145 
146 /**
147   * @brief  UART handle Structure definition
148   */
149 typedef struct __UART_HandleTypeDef
150 {
151   USART_TypeDef                 *Instance;        /*!< UART registers base address        */
152 
153   UART_InitTypeDef              Init;             /*!< UART communication parameters      */
154 
155   const uint8_t                 *pTxBuffPtr;      /*!< Pointer to UART Tx transfer Buffer */
156 
157   uint16_t                      TxXferSize;       /*!< UART Tx Transfer size              */
158 
159   __IO uint16_t                 TxXferCount;      /*!< UART Tx Transfer Counter           */
160 
161   uint8_t                       *pRxBuffPtr;      /*!< Pointer to UART Rx transfer Buffer */
162 
163   uint16_t                      RxXferSize;       /*!< UART Rx Transfer size              */
164 
165   __IO uint16_t                 RxXferCount;      /*!< UART Rx Transfer Counter           */
166 
167   __IO HAL_UART_RxTypeTypeDef ReceptionType;      /*!< Type of ongoing reception          */
168 
169   DMA_HandleTypeDef             *hdmatx;          /*!< UART Tx DMA Handle parameters      */
170 
171   DMA_HandleTypeDef             *hdmarx;          /*!< UART Rx DMA Handle parameters      */
172 
173   HAL_LockTypeDef               Lock;             /*!< Locking object                     */
174 
175   __IO HAL_UART_StateTypeDef    gState;           /*!< UART state information related to global Handle management
176                                                        and also related to Tx operations.
177                                                        This parameter can be a value of @ref HAL_UART_StateTypeDef */
178 
179   __IO HAL_UART_StateTypeDef    RxState;          /*!< UART state information related to Rx operations.
180                                                        This parameter can be a value of @ref HAL_UART_StateTypeDef */
181 
182   __IO uint32_t                 ErrorCode;        /*!< UART Error code                    */
183 
184 #if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
185   void (* TxHalfCpltCallback)(struct __UART_HandleTypeDef *huart);        /*!< UART Tx Half Complete Callback        */
186   void (* TxCpltCallback)(struct __UART_HandleTypeDef *huart);            /*!< UART Tx Complete Callback             */
187   void (* RxHalfCpltCallback)(struct __UART_HandleTypeDef *huart);        /*!< UART Rx Half Complete Callback        */
188   void (* RxCpltCallback)(struct __UART_HandleTypeDef *huart);            /*!< UART Rx Complete Callback             */
189   void (* ErrorCallback)(struct __UART_HandleTypeDef *huart);             /*!< UART Error Callback                   */
190   void (* AbortCpltCallback)(struct __UART_HandleTypeDef *huart);         /*!< UART Abort Complete Callback          */
191   void (* AbortTransmitCpltCallback)(struct __UART_HandleTypeDef *huart); /*!< UART Abort Transmit Complete Callback */
192   void (* AbortReceiveCpltCallback)(struct __UART_HandleTypeDef *huart);  /*!< UART Abort Receive Complete Callback  */
193   void (* WakeupCallback)(struct __UART_HandleTypeDef *huart);            /*!< UART Wakeup Callback                  */
194   void (* RxEventCallback)(struct __UART_HandleTypeDef *huart, uint16_t Pos); /*!< UART Reception Event Callback     */
195 
196   void (* MspInitCallback)(struct __UART_HandleTypeDef *huart);           /*!< UART Msp Init callback                */
197   void (* MspDeInitCallback)(struct __UART_HandleTypeDef *huart);         /*!< UART Msp DeInit callback              */
198 #endif  /* USE_HAL_UART_REGISTER_CALLBACKS */
199 
200 } UART_HandleTypeDef;
201 
202 #if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
203 /**
204   * @brief  HAL UART Callback ID enumeration definition
205   */
206 typedef enum
207 {
208   HAL_UART_TX_HALFCOMPLETE_CB_ID         = 0x00U,    /*!< UART Tx Half Complete Callback ID        */
209   HAL_UART_TX_COMPLETE_CB_ID             = 0x01U,    /*!< UART Tx Complete Callback ID             */
210   HAL_UART_RX_HALFCOMPLETE_CB_ID         = 0x02U,    /*!< UART Rx Half Complete Callback ID        */
211   HAL_UART_RX_COMPLETE_CB_ID             = 0x03U,    /*!< UART Rx Complete Callback ID             */
212   HAL_UART_ERROR_CB_ID                   = 0x04U,    /*!< UART Error Callback ID                   */
213   HAL_UART_ABORT_COMPLETE_CB_ID          = 0x05U,    /*!< UART Abort Complete Callback ID          */
214   HAL_UART_ABORT_TRANSMIT_COMPLETE_CB_ID = 0x06U,    /*!< UART Abort Transmit Complete Callback ID */
215   HAL_UART_ABORT_RECEIVE_COMPLETE_CB_ID  = 0x07U,    /*!< UART Abort Receive Complete Callback ID  */
216   HAL_UART_WAKEUP_CB_ID                  = 0x08U,    /*!< UART Wakeup Callback ID                  */
217 
218   HAL_UART_MSPINIT_CB_ID                 = 0x0BU,    /*!< UART MspInit callback ID                 */
219   HAL_UART_MSPDEINIT_CB_ID               = 0x0CU     /*!< UART MspDeInit callback ID               */
220 
221 } HAL_UART_CallbackIDTypeDef;
222 
223 /**
224   * @brief  HAL UART Callback pointer definition
225   */
226 typedef  void (*pUART_CallbackTypeDef)(UART_HandleTypeDef *huart);  /*!< pointer to an UART callback function */
227 typedef  void (*pUART_RxEventCallbackTypeDef)(struct __UART_HandleTypeDef *huart, uint16_t Pos);   /*!< pointer to a UART Rx Event specific callback function */
228 
229 #endif /* USE_HAL_UART_REGISTER_CALLBACKS */
230 
231 /**
232   * @}
233   */
234 
235 /* Exported constants --------------------------------------------------------*/
236 /** @defgroup UART_Exported_Constants UART Exported Constants
237   * @{
238   */
239 
240 /** @defgroup UART_Error_Code UART Error Code
241   * @{
242   */
243 #define HAL_UART_ERROR_NONE              0x00000000U   /*!< No error            */
244 #define HAL_UART_ERROR_PE                0x00000001U   /*!< Parity error        */
245 #define HAL_UART_ERROR_NE                0x00000002U   /*!< Noise error         */
246 #define HAL_UART_ERROR_FE                0x00000004U   /*!< Frame error         */
247 #define HAL_UART_ERROR_ORE               0x00000008U   /*!< Overrun error       */
248 #define HAL_UART_ERROR_DMA               0x00000010U   /*!< DMA transfer error  */
249 #if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
250 #define  HAL_UART_ERROR_INVALID_CALLBACK 0x00000020U   /*!< Invalid Callback error  */
251 #endif /* USE_HAL_UART_REGISTER_CALLBACKS */
252 /**
253   * @}
254   */
255 
256 /** @defgroup UART_Word_Length UART Word Length
257   * @{
258   */
259 #define UART_WORDLENGTH_8B                  0x00000000U
260 #define UART_WORDLENGTH_9B                  ((uint32_t)USART_CR1_M)
261 /**
262   * @}
263   */
264 
265 /** @defgroup UART_Stop_Bits UART Number of Stop Bits
266   * @{
267   */
268 #define UART_STOPBITS_1                     0x00000000U
269 #define UART_STOPBITS_2                     ((uint32_t)USART_CR2_STOP_1)
270 /**
271   * @}
272   */
273 
274 /** @defgroup UART_Parity UART Parity
275   * @{
276   */
277 #define UART_PARITY_NONE                    0x00000000U
278 #define UART_PARITY_EVEN                    ((uint32_t)USART_CR1_PCE)
279 #define UART_PARITY_ODD                     ((uint32_t)(USART_CR1_PCE | USART_CR1_PS))
280 /**
281   * @}
282   */
283 
284 /** @defgroup UART_Hardware_Flow_Control UART Hardware Flow Control
285   * @{
286   */
287 #define UART_HWCONTROL_NONE                  0x00000000U
288 #define UART_HWCONTROL_RTS                   ((uint32_t)USART_CR3_RTSE)
289 #define UART_HWCONTROL_CTS                   ((uint32_t)USART_CR3_CTSE)
290 #define UART_HWCONTROL_RTS_CTS               ((uint32_t)(USART_CR3_RTSE | USART_CR3_CTSE))
291 /**
292   * @}
293   */
294 
295 /** @defgroup UART_Mode UART Transfer Mode
296   * @{
297   */
298 #define UART_MODE_RX                        ((uint32_t)USART_CR1_RE)
299 #define UART_MODE_TX                        ((uint32_t)USART_CR1_TE)
300 #define UART_MODE_TX_RX                     ((uint32_t)(USART_CR1_TE | USART_CR1_RE))
301 /**
302   * @}
303   */
304 
305 /** @defgroup UART_State UART State
306   * @{
307   */
308 #define UART_STATE_DISABLE                  0x00000000U
309 #define UART_STATE_ENABLE                   ((uint32_t)USART_CR1_UE)
310 /**
311   * @}
312   */
313 
314 /** @defgroup UART_Over_Sampling UART Over Sampling
315   * @{
316   */
317 #define UART_OVERSAMPLING_16                    0x00000000U
318 #define UART_OVERSAMPLING_8                     ((uint32_t)USART_CR1_OVER8)
319 /**
320   * @}
321   */
322 
323 /** @defgroup UART_LIN_Break_Detection_Length  UART LIN Break Detection Length
324   * @{
325   */
326 #define UART_LINBREAKDETECTLENGTH_10B      0x00000000U
327 #define UART_LINBREAKDETECTLENGTH_11B      ((uint32_t)USART_CR2_LBDL)
328 /**
329   * @}
330   */
331 
332 /** @defgroup UART_WakeUp_functions  UART Wakeup Functions
333   * @{
334   */
335 #define UART_WAKEUPMETHOD_IDLELINE                0x00000000U
336 #define UART_WAKEUPMETHOD_ADDRESSMARK             ((uint32_t)USART_CR1_WAKE)
337 /**
338   * @}
339   */
340 
341 /** @defgroup UART_Flags   UART FLags
342   *        Elements values convention: 0xXXXX
343   *           - 0xXXXX  : Flag mask in the SR register
344   * @{
345   */
346 #define UART_FLAG_CTS                       ((uint32_t)USART_SR_CTS)
347 #define UART_FLAG_LBD                       ((uint32_t)USART_SR_LBD)
348 #define UART_FLAG_TXE                       ((uint32_t)USART_SR_TXE)
349 #define UART_FLAG_TC                        ((uint32_t)USART_SR_TC)
350 #define UART_FLAG_RXNE                      ((uint32_t)USART_SR_RXNE)
351 #define UART_FLAG_IDLE                      ((uint32_t)USART_SR_IDLE)
352 #define UART_FLAG_ORE                       ((uint32_t)USART_SR_ORE)
353 #define UART_FLAG_NE                        ((uint32_t)USART_SR_NE)
354 #define UART_FLAG_FE                        ((uint32_t)USART_SR_FE)
355 #define UART_FLAG_PE                        ((uint32_t)USART_SR_PE)
356 /**
357   * @}
358   */
359 
360 /** @defgroup UART_Interrupt_definition  UART Interrupt Definitions
361   *        Elements values convention: 0xY000XXXX
362   *           - XXXX  : Interrupt mask (16 bits) in the Y register
363   *           - Y  : Interrupt source register (2bits)
364   *                   - 0001: CR1 register
365   *                   - 0010: CR2 register
366   *                   - 0011: CR3 register
367   * @{
368   */
369 
370 #define UART_IT_PE                       ((uint32_t)(UART_CR1_REG_INDEX << 28U | USART_CR1_PEIE))
371 #define UART_IT_TXE                      ((uint32_t)(UART_CR1_REG_INDEX << 28U | USART_CR1_TXEIE))
372 #define UART_IT_TC                       ((uint32_t)(UART_CR1_REG_INDEX << 28U | USART_CR1_TCIE))
373 #define UART_IT_RXNE                     ((uint32_t)(UART_CR1_REG_INDEX << 28U | USART_CR1_RXNEIE))
374 #define UART_IT_IDLE                     ((uint32_t)(UART_CR1_REG_INDEX << 28U | USART_CR1_IDLEIE))
375 
376 #define UART_IT_LBD                      ((uint32_t)(UART_CR2_REG_INDEX << 28U | USART_CR2_LBDIE))
377 
378 #define UART_IT_CTS                      ((uint32_t)(UART_CR3_REG_INDEX << 28U | USART_CR3_CTSIE))
379 #define UART_IT_ERR                      ((uint32_t)(UART_CR3_REG_INDEX << 28U | USART_CR3_EIE))
380 /**
381   * @}
382   */
383 
384 /** @defgroup UART_RECEPTION_TYPE_Values  UART Reception type values
385   * @{
386   */
387 #define HAL_UART_RECEPTION_STANDARD          (0x00000000U)             /*!< Standard reception                       */
388 #define HAL_UART_RECEPTION_TOIDLE            (0x00000001U)             /*!< Reception till completion or IDLE event  */
389 /**
390   * @}
391   */
392 
393 /**
394   * @}
395   */
396 
397 /* Exported macro ------------------------------------------------------------*/
398 /** @defgroup UART_Exported_Macros UART Exported Macros
399   * @{
400   */
401 
402 /** @brief Reset UART handle gstate & RxState
403   * @param  __HANDLE__ specifies the UART Handle.
404   *         UART Handle selects the USARTx or UARTy peripheral
405   *         (USART,UART availability and x,y values depending on device).
406   * @retval None
407   */
408 #if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
409 #define __HAL_UART_RESET_HANDLE_STATE(__HANDLE__)  do{                                                   \
410                                                        (__HANDLE__)->gState = HAL_UART_STATE_RESET;      \
411                                                        (__HANDLE__)->RxState = HAL_UART_STATE_RESET;     \
412                                                        (__HANDLE__)->MspInitCallback = NULL;             \
413                                                        (__HANDLE__)->MspDeInitCallback = NULL;           \
414                                                      } while(0U)
415 #else
416 #define __HAL_UART_RESET_HANDLE_STATE(__HANDLE__)  do{                                                   \
417                                                        (__HANDLE__)->gState = HAL_UART_STATE_RESET;      \
418                                                        (__HANDLE__)->RxState = HAL_UART_STATE_RESET;     \
419                                                      } while(0U)
420 #endif /*USE_HAL_UART_REGISTER_CALLBACKS */
421 
422 /** @brief  Flushes the UART DR register
423   * @param  __HANDLE__ specifies the UART Handle.
424   *         UART Handle selects the USARTx or UARTy peripheral
425   *         (USART,UART availability and x,y values depending on device).
426   */
427 #define __HAL_UART_FLUSH_DRREGISTER(__HANDLE__) ((__HANDLE__)->Instance->DR)
428 
429 /** @brief  Checks whether the specified UART flag is set or not.
430   * @param  __HANDLE__ specifies the UART Handle.
431   *         UART Handle selects the USARTx or UARTy peripheral
432   *         (USART,UART availability and x,y values depending on device).
433   * @param  __FLAG__ specifies the flag to check.
434   *        This parameter can be one of the following values:
435   *            @arg UART_FLAG_CTS:  CTS Change flag (not available for UART4 and UART5)
436   *            @arg UART_FLAG_LBD:  LIN Break detection flag
437   *            @arg UART_FLAG_TXE:  Transmit data register empty flag
438   *            @arg UART_FLAG_TC:   Transmission Complete flag
439   *            @arg UART_FLAG_RXNE: Receive data register not empty flag
440   *            @arg UART_FLAG_IDLE: Idle Line detection flag
441   *            @arg UART_FLAG_ORE:  Overrun Error flag
442   *            @arg UART_FLAG_NE:   Noise Error flag
443   *            @arg UART_FLAG_FE:   Framing Error flag
444   *            @arg UART_FLAG_PE:   Parity Error flag
445   * @retval The new state of __FLAG__ (TRUE or FALSE).
446   */
447 #define __HAL_UART_GET_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->SR & (__FLAG__)) == (__FLAG__))
448 
449 /** @brief  Clears the specified UART pending flag.
450   * @param  __HANDLE__ specifies the UART Handle.
451   *         UART Handle selects the USARTx or UARTy peripheral
452   *         (USART,UART availability and x,y values depending on device).
453   * @param  __FLAG__ specifies the flag to check.
454   *          This parameter can be any combination of the following values:
455   *            @arg UART_FLAG_CTS:  CTS Change flag (not available for UART4 and UART5).
456   *            @arg UART_FLAG_LBD:  LIN Break detection flag.
457   *            @arg UART_FLAG_TC:   Transmission Complete flag.
458   *            @arg UART_FLAG_RXNE: Receive data register not empty flag.
459   *
460   * @note   PE (Parity error), FE (Framing error), NE (Noise error), ORE (Overrun
461   *          error) and IDLE (Idle line detected) flags are cleared by software
462   *          sequence: a read operation to USART_SR register followed by a read
463   *          operation to USART_DR register.
464   * @note   RXNE flag can be also cleared by a read to the USART_DR register.
465   * @note   TC flag can be also cleared by software sequence: a read operation to
466   *          USART_SR register followed by a write operation to USART_DR register.
467   * @note   TXE flag is cleared only by a write to the USART_DR register.
468   *
469   * @retval None
470   */
471 #define __HAL_UART_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->SR = ~(__FLAG__))
472 
473 /** @brief  Clears the UART PE pending flag.
474   * @param  __HANDLE__ specifies the UART Handle.
475   *         UART Handle selects the USARTx or UARTy peripheral
476   *         (USART,UART availability and x,y values depending on device).
477   * @retval None
478   */
479 #define __HAL_UART_CLEAR_PEFLAG(__HANDLE__)     \
480   do{                                           \
481     __IO uint32_t tmpreg = 0x00U;               \
482     tmpreg = (__HANDLE__)->Instance->SR;        \
483     tmpreg = (__HANDLE__)->Instance->DR;        \
484     UNUSED(tmpreg);                             \
485   } while(0U)
486 
487 /** @brief  Clears the UART FE pending flag.
488   * @param  __HANDLE__ specifies the UART Handle.
489   *         UART Handle selects the USARTx or UARTy peripheral
490   *         (USART,UART availability and x,y values depending on device).
491   * @retval None
492   */
493 #define __HAL_UART_CLEAR_FEFLAG(__HANDLE__) __HAL_UART_CLEAR_PEFLAG(__HANDLE__)
494 
495 /** @brief  Clears the UART NE pending flag.
496   * @param  __HANDLE__ specifies the UART Handle.
497   *         UART Handle selects the USARTx or UARTy peripheral
498   *         (USART,UART availability and x,y values depending on device).
499   * @retval None
500   */
501 #define __HAL_UART_CLEAR_NEFLAG(__HANDLE__) __HAL_UART_CLEAR_PEFLAG(__HANDLE__)
502 
503 /** @brief  Clears the UART ORE pending flag.
504   * @param  __HANDLE__ specifies the UART Handle.
505   *         UART Handle selects the USARTx or UARTy peripheral
506   *         (USART,UART availability and x,y values depending on device).
507   * @retval None
508   */
509 #define __HAL_UART_CLEAR_OREFLAG(__HANDLE__) __HAL_UART_CLEAR_PEFLAG(__HANDLE__)
510 
511 /** @brief  Clears the UART IDLE pending flag.
512   * @param  __HANDLE__ specifies the UART Handle.
513   *         UART Handle selects the USARTx or UARTy peripheral
514   *         (USART,UART availability and x,y values depending on device).
515   * @retval None
516   */
517 #define __HAL_UART_CLEAR_IDLEFLAG(__HANDLE__) __HAL_UART_CLEAR_PEFLAG(__HANDLE__)
518 
519 /** @brief  Enable the specified UART interrupt.
520   * @param  __HANDLE__ specifies the UART Handle.
521   *         UART Handle selects the USARTx or UARTy peripheral
522   *         (USART,UART availability and x,y values depending on device).
523   * @param  __INTERRUPT__ specifies the UART interrupt source to enable.
524   *          This parameter can be one of the following values:
525   *            @arg UART_IT_CTS:  CTS change interrupt
526   *            @arg UART_IT_LBD:  LIN Break detection interrupt
527   *            @arg UART_IT_TXE:  Transmit Data Register empty interrupt
528   *            @arg UART_IT_TC:   Transmission complete interrupt
529   *            @arg UART_IT_RXNE: Receive Data register not empty interrupt
530   *            @arg UART_IT_IDLE: Idle line detection interrupt
531   *            @arg UART_IT_PE:   Parity Error interrupt
532   *            @arg UART_IT_ERR:  Error interrupt(Frame error, noise error, overrun error)
533   * @retval None
534   */
535 #define __HAL_UART_ENABLE_IT(__HANDLE__, __INTERRUPT__)   ((((__INTERRUPT__) >> 28U) == UART_CR1_REG_INDEX)? ((__HANDLE__)->Instance->CR1 |= ((__INTERRUPT__) & UART_IT_MASK)): \
536                                                            (((__INTERRUPT__) >> 28U) == UART_CR2_REG_INDEX)? ((__HANDLE__)->Instance->CR2 |= ((__INTERRUPT__) & UART_IT_MASK)): \
537                                                            ((__HANDLE__)->Instance->CR3 |= ((__INTERRUPT__) & UART_IT_MASK)))
538 
539 /** @brief  Disable the specified UART interrupt.
540   * @param  __HANDLE__ specifies the UART Handle.
541   *         UART Handle selects the USARTx or UARTy peripheral
542   *         (USART,UART availability and x,y values depending on device).
543   * @param  __INTERRUPT__ specifies the UART interrupt source to disable.
544   *          This parameter can be one of the following values:
545   *            @arg UART_IT_CTS:  CTS change interrupt
546   *            @arg UART_IT_LBD:  LIN Break detection interrupt
547   *            @arg UART_IT_TXE:  Transmit Data Register empty interrupt
548   *            @arg UART_IT_TC:   Transmission complete interrupt
549   *            @arg UART_IT_RXNE: Receive Data register not empty interrupt
550   *            @arg UART_IT_IDLE: Idle line detection interrupt
551   *            @arg UART_IT_PE:   Parity Error interrupt
552   *            @arg UART_IT_ERR:  Error interrupt(Frame error, noise error, overrun error)
553   * @retval None
554   */
555 #define __HAL_UART_DISABLE_IT(__HANDLE__, __INTERRUPT__)  ((((__INTERRUPT__) >> 28U) == UART_CR1_REG_INDEX)? ((__HANDLE__)->Instance->CR1 &= ~((__INTERRUPT__) & UART_IT_MASK)): \
556                                                            (((__INTERRUPT__) >> 28U) == UART_CR2_REG_INDEX)? ((__HANDLE__)->Instance->CR2 &= ~((__INTERRUPT__) & UART_IT_MASK)): \
557                                                            ((__HANDLE__)->Instance->CR3 &= ~ ((__INTERRUPT__) & UART_IT_MASK)))
558 
559 /** @brief  Checks whether the specified UART interrupt source is enabled or not.
560   * @param  __HANDLE__ specifies the UART Handle.
561   *         UART Handle selects the USARTx or UARTy peripheral
562   *         (USART,UART availability and x,y values depending on device).
563   * @param  __IT__ specifies the UART interrupt source to check.
564   *          This parameter can be one of the following values:
565   *            @arg UART_IT_CTS: CTS change interrupt (not available for UART4 and UART5)
566   *            @arg UART_IT_LBD: LIN Break detection interrupt
567   *            @arg UART_IT_TXE: Transmit Data Register empty interrupt
568   *            @arg UART_IT_TC:  Transmission complete interrupt
569   *            @arg UART_IT_RXNE: Receive Data register not empty interrupt
570   *            @arg UART_IT_IDLE: Idle line detection interrupt
571   *            @arg UART_IT_ERR: Error interrupt
572   * @retval The new state of __IT__ (TRUE or FALSE).
573   */
574 #define __HAL_UART_GET_IT_SOURCE(__HANDLE__, __IT__) (((((__IT__) >> 28U) == UART_CR1_REG_INDEX)? (__HANDLE__)->Instance->CR1:(((((uint32_t)(__IT__)) >> 28U) == UART_CR2_REG_INDEX)? \
575                                                        (__HANDLE__)->Instance->CR2 : (__HANDLE__)->Instance->CR3)) & (((uint32_t)(__IT__)) & UART_IT_MASK))
576 
577 /** @brief  Enable CTS flow control
578   * @note   This macro allows to enable CTS hardware flow control for a given UART instance,
579   *         without need to call HAL_UART_Init() function.
580   *         As involving direct access to UART registers, usage of this macro should be fully endorsed by user.
581   * @note   As macro is expected to be used for modifying CTS Hw flow control feature activation, without need
582   *         for USART instance Deinit/Init, following conditions for macro call should be fulfilled :
583   *           - UART instance should have already been initialised (through call of HAL_UART_Init() )
584   *           - macro could only be called when corresponding UART instance is disabled (i.e __HAL_UART_DISABLE(__HANDLE__))
585   *             and should be followed by an Enable macro (i.e __HAL_UART_ENABLE(__HANDLE__)).
586   * @param  __HANDLE__ specifies the UART Handle.
587   *         The Handle Instance can be any USARTx (supporting the HW Flow control feature).
588   *         It is used to select the USART peripheral (USART availability and x value depending on device).
589   * @retval None
590   */
591 #define __HAL_UART_HWCONTROL_CTS_ENABLE(__HANDLE__)        \
592   do{                                                      \
593     ATOMIC_SET_BIT((__HANDLE__)->Instance->CR3, USART_CR3_CTSE);  \
594     (__HANDLE__)->Init.HwFlowCtl |= USART_CR3_CTSE;        \
595   } while(0U)
596 
597 /** @brief  Disable CTS flow control
598   * @note   This macro allows to disable CTS hardware flow control for a given UART instance,
599   *         without need to call HAL_UART_Init() function.
600   *         As involving direct access to UART registers, usage of this macro should be fully endorsed by user.
601   * @note   As macro is expected to be used for modifying CTS Hw flow control feature activation, without need
602   *         for USART instance Deinit/Init, following conditions for macro call should be fulfilled :
603   *           - UART instance should have already been initialised (through call of HAL_UART_Init() )
604   *           - macro could only be called when corresponding UART instance is disabled (i.e __HAL_UART_DISABLE(__HANDLE__))
605   *             and should be followed by an Enable macro (i.e __HAL_UART_ENABLE(__HANDLE__)).
606   * @param  __HANDLE__ specifies the UART Handle.
607   *         The Handle Instance can be any USARTx (supporting the HW Flow control feature).
608   *         It is used to select the USART peripheral (USART availability and x value depending on device).
609   * @retval None
610   */
611 #define __HAL_UART_HWCONTROL_CTS_DISABLE(__HANDLE__)        \
612   do{                                                       \
613     ATOMIC_CLEAR_BIT((__HANDLE__)->Instance->CR3, USART_CR3_CTSE); \
614     (__HANDLE__)->Init.HwFlowCtl &= ~(USART_CR3_CTSE);      \
615   } while(0U)
616 
617 /** @brief  Enable RTS flow control
618   *         This macro allows to enable RTS hardware flow control for a given UART instance,
619   *         without need to call HAL_UART_Init() function.
620   *         As involving direct access to UART registers, usage of this macro should be fully endorsed by user.
621   * @note   As macro is expected to be used for modifying RTS Hw flow control feature activation, without need
622   *         for USART instance Deinit/Init, following conditions for macro call should be fulfilled :
623   *           - UART instance should have already been initialised (through call of HAL_UART_Init() )
624   *           - macro could only be called when corresponding UART instance is disabled (i.e __HAL_UART_DISABLE(__HANDLE__))
625   *             and should be followed by an Enable macro (i.e __HAL_UART_ENABLE(__HANDLE__)).
626   * @param  __HANDLE__ specifies the UART Handle.
627   *         The Handle Instance can be any USARTx (supporting the HW Flow control feature).
628   *         It is used to select the USART peripheral (USART availability and x value depending on device).
629   * @retval None
630   */
631 #define __HAL_UART_HWCONTROL_RTS_ENABLE(__HANDLE__)       \
632   do{                                                     \
633     ATOMIC_SET_BIT((__HANDLE__)->Instance->CR3, USART_CR3_RTSE); \
634     (__HANDLE__)->Init.HwFlowCtl |= USART_CR3_RTSE;       \
635   } while(0U)
636 
637 /** @brief  Disable RTS flow control
638   *         This macro allows to disable RTS hardware flow control for a given UART instance,
639   *         without need to call HAL_UART_Init() function.
640   *         As involving direct access to UART registers, usage of this macro should be fully endorsed by user.
641   * @note   As macro is expected to be used for modifying RTS Hw flow control feature activation, without need
642   *         for USART instance Deinit/Init, following conditions for macro call should be fulfilled :
643   *           - UART instance should have already been initialised (through call of HAL_UART_Init() )
644   *           - macro could only be called when corresponding UART instance is disabled (i.e __HAL_UART_DISABLE(__HANDLE__))
645   *             and should be followed by an Enable macro (i.e __HAL_UART_ENABLE(__HANDLE__)).
646   * @param  __HANDLE__ specifies the UART Handle.
647   *         The Handle Instance can be any USARTx (supporting the HW Flow control feature).
648   *         It is used to select the USART peripheral (USART availability and x value depending on device).
649   * @retval None
650   */
651 #define __HAL_UART_HWCONTROL_RTS_DISABLE(__HANDLE__)       \
652   do{                                                      \
653     ATOMIC_CLEAR_BIT((__HANDLE__)->Instance->CR3, USART_CR3_RTSE);\
654     (__HANDLE__)->Init.HwFlowCtl &= ~(USART_CR3_RTSE);     \
655   } while(0U)
656 
657 /** @brief  Macro to enable the UART's one bit sample method
658   * @param  __HANDLE__ specifies the UART Handle.
659   * @retval None
660   */
661 #define __HAL_UART_ONE_BIT_SAMPLE_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR3|= USART_CR3_ONEBIT)
662 
663 /** @brief  Macro to disable the UART's one bit sample method
664   * @param  __HANDLE__ specifies the UART Handle.
665   * @retval None
666   */
667 #define __HAL_UART_ONE_BIT_SAMPLE_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR3\
668                                                        &= (uint16_t)~((uint16_t)USART_CR3_ONEBIT))
669 
670 /** @brief  Enable UART
671   * @param  __HANDLE__ specifies the UART Handle.
672   * @retval None
673   */
674 #define __HAL_UART_ENABLE(__HANDLE__)               ((__HANDLE__)->Instance->CR1 |=  USART_CR1_UE)
675 
676 /** @brief  Disable UART
677   * @param  __HANDLE__ specifies the UART Handle.
678   * @retval None
679   */
680 #define __HAL_UART_DISABLE(__HANDLE__)              ((__HANDLE__)->Instance->CR1 &=  ~USART_CR1_UE)
681 /**
682   * @}
683   */
684 
685 /* Exported functions --------------------------------------------------------*/
686 /** @addtogroup UART_Exported_Functions
687   * @{
688   */
689 
690 /** @addtogroup UART_Exported_Functions_Group1 Initialization and de-initialization functions
691   * @{
692   */
693 
694 /* Initialization/de-initialization functions  **********************************/
695 HAL_StatusTypeDef HAL_UART_Init(UART_HandleTypeDef *huart);
696 HAL_StatusTypeDef HAL_HalfDuplex_Init(UART_HandleTypeDef *huart);
697 HAL_StatusTypeDef HAL_LIN_Init(UART_HandleTypeDef *huart, uint32_t BreakDetectLength);
698 HAL_StatusTypeDef HAL_MultiProcessor_Init(UART_HandleTypeDef *huart, uint8_t Address, uint32_t WakeUpMethod);
699 HAL_StatusTypeDef HAL_UART_DeInit(UART_HandleTypeDef *huart);
700 void HAL_UART_MspInit(UART_HandleTypeDef *huart);
701 void HAL_UART_MspDeInit(UART_HandleTypeDef *huart);
702 
703 /* Callbacks Register/UnRegister functions  ***********************************/
704 #if (USE_HAL_UART_REGISTER_CALLBACKS == 1)
705 HAL_StatusTypeDef HAL_UART_RegisterCallback(UART_HandleTypeDef *huart, HAL_UART_CallbackIDTypeDef CallbackID,
706                                             pUART_CallbackTypeDef pCallback);
707 HAL_StatusTypeDef HAL_UART_UnRegisterCallback(UART_HandleTypeDef *huart, HAL_UART_CallbackIDTypeDef CallbackID);
708 
709 HAL_StatusTypeDef HAL_UART_RegisterRxEventCallback(UART_HandleTypeDef *huart, pUART_RxEventCallbackTypeDef pCallback);
710 HAL_StatusTypeDef HAL_UART_UnRegisterRxEventCallback(UART_HandleTypeDef *huart);
711 #endif /* USE_HAL_UART_REGISTER_CALLBACKS */
712 
713 /**
714   * @}
715   */
716 
717 /** @addtogroup UART_Exported_Functions_Group2 IO operation functions
718   * @{
719   */
720 
721 /* IO operation functions *******************************************************/
722 HAL_StatusTypeDef HAL_UART_Transmit(UART_HandleTypeDef *huart, const uint8_t *pData, uint16_t Size, uint32_t Timeout);
723 HAL_StatusTypeDef HAL_UART_Receive(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout);
724 HAL_StatusTypeDef HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, const uint8_t *pData, uint16_t Size);
725 HAL_StatusTypeDef HAL_UART_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
726 HAL_StatusTypeDef HAL_UART_Transmit_DMA(UART_HandleTypeDef *huart, const uint8_t *pData, uint16_t Size);
727 HAL_StatusTypeDef HAL_UART_Receive_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
728 HAL_StatusTypeDef HAL_UART_DMAPause(UART_HandleTypeDef *huart);
729 HAL_StatusTypeDef HAL_UART_DMAResume(UART_HandleTypeDef *huart);
730 HAL_StatusTypeDef HAL_UART_DMAStop(UART_HandleTypeDef *huart);
731 
732 HAL_StatusTypeDef HAL_UARTEx_ReceiveToIdle(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint16_t *RxLen,
733                                            uint32_t Timeout);
734 HAL_StatusTypeDef HAL_UARTEx_ReceiveToIdle_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
735 HAL_StatusTypeDef HAL_UARTEx_ReceiveToIdle_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
736 
737 /* Transfer Abort functions */
738 HAL_StatusTypeDef HAL_UART_Abort(UART_HandleTypeDef *huart);
739 HAL_StatusTypeDef HAL_UART_AbortTransmit(UART_HandleTypeDef *huart);
740 HAL_StatusTypeDef HAL_UART_AbortReceive(UART_HandleTypeDef *huart);
741 HAL_StatusTypeDef HAL_UART_Abort_IT(UART_HandleTypeDef *huart);
742 HAL_StatusTypeDef HAL_UART_AbortTransmit_IT(UART_HandleTypeDef *huart);
743 HAL_StatusTypeDef HAL_UART_AbortReceive_IT(UART_HandleTypeDef *huart);
744 
745 void HAL_UART_IRQHandler(UART_HandleTypeDef *huart);
746 void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart);
747 void HAL_UART_TxHalfCpltCallback(UART_HandleTypeDef *huart);
748 void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart);
749 void HAL_UART_RxHalfCpltCallback(UART_HandleTypeDef *huart);
750 void HAL_UART_ErrorCallback(UART_HandleTypeDef *huart);
751 void HAL_UART_AbortCpltCallback(UART_HandleTypeDef *huart);
752 void HAL_UART_AbortTransmitCpltCallback(UART_HandleTypeDef *huart);
753 void HAL_UART_AbortReceiveCpltCallback(UART_HandleTypeDef *huart);
754 
755 void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size);
756 
757 /**
758   * @}
759   */
760 
761 /** @addtogroup UART_Exported_Functions_Group3
762   * @{
763   */
764 /* Peripheral Control functions  ************************************************/
765 HAL_StatusTypeDef HAL_LIN_SendBreak(UART_HandleTypeDef *huart);
766 HAL_StatusTypeDef HAL_MultiProcessor_EnterMuteMode(UART_HandleTypeDef *huart);
767 HAL_StatusTypeDef HAL_MultiProcessor_ExitMuteMode(UART_HandleTypeDef *huart);
768 HAL_StatusTypeDef HAL_HalfDuplex_EnableTransmitter(UART_HandleTypeDef *huart);
769 HAL_StatusTypeDef HAL_HalfDuplex_EnableReceiver(UART_HandleTypeDef *huart);
770 /**
771   * @}
772   */
773 
774 /** @addtogroup UART_Exported_Functions_Group4
775   * @{
776   */
777 /* Peripheral State functions  **************************************************/
778 HAL_UART_StateTypeDef HAL_UART_GetState(UART_HandleTypeDef *huart);
779 uint32_t              HAL_UART_GetError(UART_HandleTypeDef *huart);
780 /**
781   * @}
782   */
783 
784 /**
785   * @}
786   */
787 /* Private types -------------------------------------------------------------*/
788 /* Private variables ---------------------------------------------------------*/
789 /* Private constants ---------------------------------------------------------*/
790 /** @defgroup UART_Private_Constants UART Private Constants
791   * @{
792   */
793 /** @brief UART interruptions flag mask
794   *
795   */
796 #define UART_IT_MASK                     0x0000FFFFU
797 
798 #define UART_CR1_REG_INDEX               1U
799 #define UART_CR2_REG_INDEX               2U
800 #define UART_CR3_REG_INDEX               3U
801 /**
802   * @}
803   */
804 
805 /* Private macros ------------------------------------------------------------*/
806 /** @defgroup UART_Private_Macros UART Private Macros
807   * @{
808   */
809 #define IS_UART_WORD_LENGTH(LENGTH) (((LENGTH) == UART_WORDLENGTH_8B) || \
810                                      ((LENGTH) == UART_WORDLENGTH_9B))
811 #define IS_UART_LIN_WORD_LENGTH(LENGTH) (((LENGTH) == UART_WORDLENGTH_8B))
812 #define IS_UART_STOPBITS(STOPBITS) (((STOPBITS) == UART_STOPBITS_1) || \
813                                     ((STOPBITS) == UART_STOPBITS_2))
814 #define IS_UART_PARITY(PARITY) (((PARITY) == UART_PARITY_NONE) || \
815                                 ((PARITY) == UART_PARITY_EVEN) || \
816                                 ((PARITY) == UART_PARITY_ODD))
817 #define IS_UART_HARDWARE_FLOW_CONTROL(CONTROL)\
818                               (((CONTROL) == UART_HWCONTROL_NONE) || \
819                                ((CONTROL) == UART_HWCONTROL_RTS) || \
820                                ((CONTROL) == UART_HWCONTROL_CTS) || \
821                                ((CONTROL) == UART_HWCONTROL_RTS_CTS))
822 #define IS_UART_MODE(MODE) ((((MODE) & 0x0000FFF3U) == 0x00U) && ((MODE) != 0x00U))
823 #define IS_UART_STATE(STATE) (((STATE) == UART_STATE_DISABLE) || \
824                               ((STATE) == UART_STATE_ENABLE))
825 #define IS_UART_OVERSAMPLING(SAMPLING) (((SAMPLING) == UART_OVERSAMPLING_16) || \
826                                         ((SAMPLING) == UART_OVERSAMPLING_8))
827 #define IS_UART_LIN_OVERSAMPLING(SAMPLING) (((SAMPLING) == UART_OVERSAMPLING_16))
828 #define IS_UART_LIN_BREAK_DETECT_LENGTH(LENGTH) (((LENGTH) == UART_LINBREAKDETECTLENGTH_10B) || \
829                                                  ((LENGTH) == UART_LINBREAKDETECTLENGTH_11B))
830 #define IS_UART_WAKEUPMETHOD(WAKEUP) (((WAKEUP) == UART_WAKEUPMETHOD_IDLELINE) || \
831                                       ((WAKEUP) == UART_WAKEUPMETHOD_ADDRESSMARK))
832 #define IS_UART_BAUDRATE(BAUDRATE) ((BAUDRATE) <= 10500000U)
833 #define IS_UART_ADDRESS(ADDRESS) ((ADDRESS) <= 0x0FU)
834 
835 #define UART_DIV_SAMPLING16(_PCLK_, _BAUD_)            ((uint32_t)((((uint64_t)(_PCLK_))*25U)/(4U*((uint64_t)(_BAUD_)))))
836 #define UART_DIVMANT_SAMPLING16(_PCLK_, _BAUD_)        (UART_DIV_SAMPLING16((_PCLK_), (_BAUD_))/100U)
837 #define UART_DIVFRAQ_SAMPLING16(_PCLK_, _BAUD_)        ((((UART_DIV_SAMPLING16((_PCLK_), (_BAUD_)) - (UART_DIVMANT_SAMPLING16((_PCLK_), (_BAUD_)) * 100U)) * 16U)\
838                                                          + 50U) / 100U)
839 /* UART BRR = mantissa + overflow + fraction
840             = (UART DIVMANT << 4) + (UART DIVFRAQ & 0xF0) + (UART DIVFRAQ & 0x0FU) */
841 #define UART_BRR_SAMPLING16(_PCLK_, _BAUD_)            ((UART_DIVMANT_SAMPLING16((_PCLK_), (_BAUD_)) << 4U) + \
842                                                         (UART_DIVFRAQ_SAMPLING16((_PCLK_), (_BAUD_)) & 0xF0U) + \
843                                                         (UART_DIVFRAQ_SAMPLING16((_PCLK_), (_BAUD_)) & 0x0FU))
844 
845 #define UART_DIV_SAMPLING8(_PCLK_, _BAUD_)             ((uint32_t)((((uint64_t)(_PCLK_))*25U)/(2U*((uint64_t)(_BAUD_)))))
846 #define UART_DIVMANT_SAMPLING8(_PCLK_, _BAUD_)         (UART_DIV_SAMPLING8((_PCLK_), (_BAUD_))/100U)
847 #define UART_DIVFRAQ_SAMPLING8(_PCLK_, _BAUD_)         ((((UART_DIV_SAMPLING8((_PCLK_), (_BAUD_)) - (UART_DIVMANT_SAMPLING8((_PCLK_), (_BAUD_)) * 100U)) * 8U)\
848                                                          + 50U) / 100U)
849 /* UART BRR = mantissa + overflow + fraction
850             = (UART DIVMANT << 4) + ((UART DIVFRAQ & 0xF8) << 1) + (UART DIVFRAQ & 0x07U) */
851 #define UART_BRR_SAMPLING8(_PCLK_, _BAUD_)             ((UART_DIVMANT_SAMPLING8((_PCLK_), (_BAUD_)) << 4U) + \
852                                                         ((UART_DIVFRAQ_SAMPLING8((_PCLK_), (_BAUD_)) & 0xF8U) << 1U) + \
853                                                         (UART_DIVFRAQ_SAMPLING8((_PCLK_), (_BAUD_)) & 0x07U))
854 
855 /**
856   * @}
857   */
858 
859 /* Private functions ---------------------------------------------------------*/
860 /** @defgroup UART_Private_Functions UART Private Functions
861   * @{
862   */
863 
864 HAL_StatusTypeDef UART_Start_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
865 HAL_StatusTypeDef UART_Start_Receive_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size);
866 
867 /**
868   * @}
869   */
870 
871 /**
872   * @}
873   */
874 
875 /**
876   * @}
877   */
878 
879 #ifdef __cplusplus
880 }
881 #endif
882 
883 #endif /* __STM32F4xx_HAL_UART_H */
884 
885