mbed - The official Mbed 2 C/C++ SDK provides the softwa…

Users » mbed_official » Code » mbed

mbed official / mbed

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

Dependents: hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

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

TARGET_DISCO_L072CZ_LRWAN1/TARGET_STM/TARGET_STM32L0/device/stm32l0xx_hal_uart.h@143:86740a56073b, 2017-05-26 (annotated)

Committer:: AnnaBridge
Date:: Fri May 26 12:30:20 2017 +0100
Revision:: 143:86740a56073b
Child:: 167:84c0a372a020

Release 143 of the mbed library.

Who changed what in which revision?

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