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.

Committer:
AnnaBridge
Date:
Thu Nov 09 11:14:10 2017 +0000
Revision:
157:e7ca05fa8600
Parent:
156:ff21514d8981
Child:
160:5571c4ff569f
Release 155 of the mbed library.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 156:ff21514d8981 1 /**
AnnaBridge 156:ff21514d8981 2 ******************************************************************************
AnnaBridge 156:ff21514d8981 3 * @file stm32f0xx_hal_usart.h
AnnaBridge 156:ff21514d8981 4 * @author MCD Application Team
AnnaBridge 156:ff21514d8981 5 * @version V1.5.0
AnnaBridge 156:ff21514d8981 6 * @date 04-November-2016
AnnaBridge 156:ff21514d8981 7 * @brief Header file of USART HAL module.
AnnaBridge 156:ff21514d8981 8 ******************************************************************************
AnnaBridge 156:ff21514d8981 9 * @attention
AnnaBridge 156:ff21514d8981 10 *
AnnaBridge 156:ff21514d8981 11 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
AnnaBridge 156:ff21514d8981 12 *
AnnaBridge 156:ff21514d8981 13 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 156:ff21514d8981 14 * are permitted provided that the following conditions are met:
AnnaBridge 156:ff21514d8981 15 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 156:ff21514d8981 16 * this list of conditions and the following disclaimer.
AnnaBridge 156:ff21514d8981 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 156:ff21514d8981 18 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 156:ff21514d8981 19 * and/or other materials provided with the distribution.
AnnaBridge 156:ff21514d8981 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 156:ff21514d8981 21 * may be used to endorse or promote products derived from this software
AnnaBridge 156:ff21514d8981 22 * without specific prior written permission.
AnnaBridge 156:ff21514d8981 23 *
AnnaBridge 156:ff21514d8981 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 156:ff21514d8981 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 156:ff21514d8981 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 156:ff21514d8981 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 156:ff21514d8981 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 156:ff21514d8981 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 156:ff21514d8981 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 156:ff21514d8981 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 156:ff21514d8981 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 156:ff21514d8981 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 156:ff21514d8981 34 *
AnnaBridge 156:ff21514d8981 35 ******************************************************************************
AnnaBridge 156:ff21514d8981 36 */
AnnaBridge 156:ff21514d8981 37
AnnaBridge 156:ff21514d8981 38 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 156:ff21514d8981 39 #ifndef __STM32F0xx_HAL_USART_H
AnnaBridge 156:ff21514d8981 40 #define __STM32F0xx_HAL_USART_H
AnnaBridge 156:ff21514d8981 41
AnnaBridge 156:ff21514d8981 42 #ifdef __cplusplus
AnnaBridge 156:ff21514d8981 43 extern "C" {
AnnaBridge 156:ff21514d8981 44 #endif
AnnaBridge 156:ff21514d8981 45
AnnaBridge 156:ff21514d8981 46 /* Includes ------------------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 47 #include "stm32f0xx_hal_def.h"
AnnaBridge 156:ff21514d8981 48
AnnaBridge 156:ff21514d8981 49 /** @addtogroup STM32F0xx_HAL_Driver
AnnaBridge 156:ff21514d8981 50 * @{
AnnaBridge 156:ff21514d8981 51 */
AnnaBridge 156:ff21514d8981 52
AnnaBridge 156:ff21514d8981 53 /** @addtogroup USART
AnnaBridge 156:ff21514d8981 54 * @{
AnnaBridge 156:ff21514d8981 55 */
AnnaBridge 156:ff21514d8981 56
AnnaBridge 156:ff21514d8981 57 /* Exported types ------------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 58 /** @defgroup USART_Exported_Types USART Exported Types
AnnaBridge 156:ff21514d8981 59 * @{
AnnaBridge 156:ff21514d8981 60 */
AnnaBridge 156:ff21514d8981 61
AnnaBridge 156:ff21514d8981 62 /**
AnnaBridge 156:ff21514d8981 63 * @brief USART Init Structure definition
AnnaBridge 156:ff21514d8981 64 */
AnnaBridge 156:ff21514d8981 65 typedef struct
AnnaBridge 156:ff21514d8981 66 {
AnnaBridge 156:ff21514d8981 67 uint32_t BaudRate; /*!< This member configures the Usart communication baud rate.
AnnaBridge 156:ff21514d8981 68 The baud rate is computed using the following formula:
AnnaBridge 156:ff21514d8981 69 Baud Rate Register = ((PCLKx) / ((huart->Init.BaudRate))). */
AnnaBridge 156:ff21514d8981 70
AnnaBridge 156:ff21514d8981 71 uint32_t WordLength; /*!< Specifies the number of data bits transmitted or received in a frame.
AnnaBridge 156:ff21514d8981 72 This parameter can be a value of @ref USARTEx_Word_Length. */
AnnaBridge 156:ff21514d8981 73
AnnaBridge 156:ff21514d8981 74 uint32_t StopBits; /*!< Specifies the number of stop bits transmitted.
AnnaBridge 156:ff21514d8981 75 This parameter can be a value of @ref USART_Stop_Bits. */
AnnaBridge 156:ff21514d8981 76
AnnaBridge 156:ff21514d8981 77 uint32_t Parity; /*!< Specifies the parity mode.
AnnaBridge 156:ff21514d8981 78 This parameter can be a value of @ref USART_Parity
AnnaBridge 156:ff21514d8981 79 @note When parity is enabled, the computed parity is inserted
AnnaBridge 156:ff21514d8981 80 at the MSB position of the transmitted data (9th bit when
AnnaBridge 156:ff21514d8981 81 the word length is set to 9 data bits; 8th bit when the
AnnaBridge 156:ff21514d8981 82 word length is set to 8 data bits). */
AnnaBridge 156:ff21514d8981 83
AnnaBridge 156:ff21514d8981 84 uint32_t Mode; /*!< Specifies whether the Receive or Transmit mode is enabled or disabled.
AnnaBridge 156:ff21514d8981 85 This parameter can be a value of @ref USART_Mode. */
AnnaBridge 156:ff21514d8981 86
AnnaBridge 156:ff21514d8981 87 uint32_t CLKPolarity; /*!< Specifies the steady state of the serial clock.
AnnaBridge 156:ff21514d8981 88 This parameter can be a value of @ref USART_Clock_Polarity. */
AnnaBridge 156:ff21514d8981 89
AnnaBridge 156:ff21514d8981 90 uint32_t CLKPhase; /*!< Specifies the clock transition on which the bit capture is made.
AnnaBridge 156:ff21514d8981 91 This parameter can be a value of @ref USART_Clock_Phase. */
AnnaBridge 156:ff21514d8981 92
AnnaBridge 156:ff21514d8981 93 uint32_t CLKLastBit; /*!< Specifies whether the clock pulse corresponding to the last transmitted
AnnaBridge 156:ff21514d8981 94 data bit (MSB) has to be output on the SCLK pin in synchronous mode.
AnnaBridge 156:ff21514d8981 95 This parameter can be a value of @ref USART_Last_Bit. */
AnnaBridge 156:ff21514d8981 96 }USART_InitTypeDef;
AnnaBridge 156:ff21514d8981 97
AnnaBridge 156:ff21514d8981 98 /**
AnnaBridge 156:ff21514d8981 99 * @brief HAL USART State structures definition
AnnaBridge 156:ff21514d8981 100 */
AnnaBridge 156:ff21514d8981 101 typedef enum
AnnaBridge 156:ff21514d8981 102 {
AnnaBridge 156:ff21514d8981 103 HAL_USART_STATE_RESET = 0x00U, /*!< Peripheral is not initialized */
AnnaBridge 156:ff21514d8981 104 HAL_USART_STATE_READY = 0x01U, /*!< Peripheral Initialized and ready for use */
AnnaBridge 156:ff21514d8981 105 HAL_USART_STATE_BUSY = 0x02U, /*!< an internal process is ongoing */
AnnaBridge 156:ff21514d8981 106 HAL_USART_STATE_BUSY_TX = 0x12U, /*!< Data Transmission process is ongoing */
AnnaBridge 156:ff21514d8981 107 HAL_USART_STATE_BUSY_RX = 0x22U, /*!< Data Reception process is ongoing */
AnnaBridge 156:ff21514d8981 108 HAL_USART_STATE_BUSY_TX_RX = 0x32U, /*!< Data Transmission Reception process is ongoing */
AnnaBridge 156:ff21514d8981 109 HAL_USART_STATE_TIMEOUT = 0x03U, /*!< Timeout state */
AnnaBridge 156:ff21514d8981 110 HAL_USART_STATE_ERROR = 0x04U /*!< Error */
AnnaBridge 156:ff21514d8981 111 }HAL_USART_StateTypeDef;
AnnaBridge 156:ff21514d8981 112
AnnaBridge 156:ff21514d8981 113 /**
AnnaBridge 156:ff21514d8981 114 * @brief USART clock sources definitions
AnnaBridge 156:ff21514d8981 115 */
AnnaBridge 156:ff21514d8981 116 typedef enum
AnnaBridge 156:ff21514d8981 117 {
AnnaBridge 156:ff21514d8981 118 USART_CLOCKSOURCE_PCLK1 = 0x00U, /*!< PCLK1 clock source */
AnnaBridge 156:ff21514d8981 119 USART_CLOCKSOURCE_HSI = 0x02U, /*!< HSI clock source */
AnnaBridge 156:ff21514d8981 120 USART_CLOCKSOURCE_SYSCLK = 0x04U, /*!< SYSCLK clock source */
AnnaBridge 156:ff21514d8981 121 USART_CLOCKSOURCE_LSE = 0x08U, /*!< LSE clock source */
AnnaBridge 156:ff21514d8981 122 USART_CLOCKSOURCE_UNDEFINED = 0x10U /*!< Undefined clock source */
AnnaBridge 156:ff21514d8981 123 }USART_ClockSourceTypeDef;
AnnaBridge 156:ff21514d8981 124
AnnaBridge 156:ff21514d8981 125
AnnaBridge 156:ff21514d8981 126 /**
AnnaBridge 156:ff21514d8981 127 * @brief USART handle Structure definition
AnnaBridge 156:ff21514d8981 128 */
AnnaBridge 156:ff21514d8981 129 typedef struct
AnnaBridge 156:ff21514d8981 130 {
AnnaBridge 156:ff21514d8981 131 USART_TypeDef *Instance; /*!< USART registers base address */
AnnaBridge 156:ff21514d8981 132
AnnaBridge 156:ff21514d8981 133 USART_InitTypeDef Init; /*!< USART communication parameters */
AnnaBridge 156:ff21514d8981 134
AnnaBridge 156:ff21514d8981 135 uint8_t *pTxBuffPtr; /*!< Pointer to USART Tx transfer Buffer */
AnnaBridge 156:ff21514d8981 136
AnnaBridge 156:ff21514d8981 137 uint16_t TxXferSize; /*!< USART Tx Transfer size */
AnnaBridge 156:ff21514d8981 138
AnnaBridge 156:ff21514d8981 139 __IO uint16_t TxXferCount; /*!< USART Tx Transfer Counter */
AnnaBridge 156:ff21514d8981 140
AnnaBridge 156:ff21514d8981 141 uint8_t *pRxBuffPtr; /*!< Pointer to USART Rx transfer Buffer */
AnnaBridge 156:ff21514d8981 142
AnnaBridge 156:ff21514d8981 143 uint16_t RxXferSize; /*!< USART Rx Transfer size */
AnnaBridge 156:ff21514d8981 144
AnnaBridge 156:ff21514d8981 145 __IO uint16_t RxXferCount; /*!< USART Rx Transfer Counter */
AnnaBridge 156:ff21514d8981 146
AnnaBridge 156:ff21514d8981 147 uint16_t Mask; /*!< USART Rx RDR register mask */
AnnaBridge 156:ff21514d8981 148
AnnaBridge 156:ff21514d8981 149 DMA_HandleTypeDef *hdmatx; /*!< USART Tx DMA Handle parameters */
AnnaBridge 156:ff21514d8981 150
AnnaBridge 156:ff21514d8981 151 DMA_HandleTypeDef *hdmarx; /*!< USART Rx DMA Handle parameters */
AnnaBridge 156:ff21514d8981 152
AnnaBridge 156:ff21514d8981 153 HAL_LockTypeDef Lock; /*!< Locking object */
AnnaBridge 156:ff21514d8981 154
AnnaBridge 156:ff21514d8981 155 __IO HAL_USART_StateTypeDef State; /*!< USART communication state */
AnnaBridge 156:ff21514d8981 156
AnnaBridge 156:ff21514d8981 157 __IO uint32_t ErrorCode; /*!< USART Error code */
AnnaBridge 156:ff21514d8981 158
AnnaBridge 156:ff21514d8981 159 }USART_HandleTypeDef;
AnnaBridge 156:ff21514d8981 160
AnnaBridge 156:ff21514d8981 161 /**
AnnaBridge 156:ff21514d8981 162 * @}
AnnaBridge 156:ff21514d8981 163 */
AnnaBridge 156:ff21514d8981 164
AnnaBridge 156:ff21514d8981 165 /* Exported constants --------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 166 /** @defgroup USART_Exported_Constants USART Exported Constants
AnnaBridge 156:ff21514d8981 167 * @{
AnnaBridge 156:ff21514d8981 168 */
AnnaBridge 156:ff21514d8981 169
AnnaBridge 156:ff21514d8981 170 /** @defgroup USART_Error USART Error
AnnaBridge 156:ff21514d8981 171 * @{
AnnaBridge 156:ff21514d8981 172 */
AnnaBridge 156:ff21514d8981 173 #define HAL_USART_ERROR_NONE (0x00000000U) /*!< No error */
AnnaBridge 156:ff21514d8981 174 #define HAL_USART_ERROR_PE (0x00000001U) /*!< Parity error */
AnnaBridge 156:ff21514d8981 175 #define HAL_USART_ERROR_NE (0x00000002U) /*!< Noise error */
AnnaBridge 156:ff21514d8981 176 #define HAL_USART_ERROR_FE (0x00000004U) /*!< frame error */
AnnaBridge 156:ff21514d8981 177 #define HAL_USART_ERROR_ORE (0x00000008U) /*!< Overrun error */
AnnaBridge 156:ff21514d8981 178 #define HAL_USART_ERROR_DMA (0x00000010U) /*!< DMA transfer error */
AnnaBridge 156:ff21514d8981 179 /**
AnnaBridge 156:ff21514d8981 180 * @}
AnnaBridge 156:ff21514d8981 181 */
AnnaBridge 156:ff21514d8981 182
AnnaBridge 156:ff21514d8981 183 /** @defgroup USART_Stop_Bits USART Number of Stop Bits
AnnaBridge 156:ff21514d8981 184 * @{
AnnaBridge 156:ff21514d8981 185 */
AnnaBridge 156:ff21514d8981 186 #ifdef USART_SMARTCARD_SUPPORT
AnnaBridge 156:ff21514d8981 187 #define USART_STOPBITS_0_5 ((uint32_t)USART_CR2_STOP_0) /*!< USART frame with 0.5 stop bit */
AnnaBridge 156:ff21514d8981 188 #define USART_STOPBITS_1 (0x00000000U) /*!< USART frame with 1 stop bit */
AnnaBridge 156:ff21514d8981 189 #define USART_STOPBITS_1_5 ((uint32_t)(USART_CR2_STOP_0 | USART_CR2_STOP_1)) /*!< USART frame with 1.5 stop bits */
AnnaBridge 156:ff21514d8981 190 #define USART_STOPBITS_2 ((uint32_t)USART_CR2_STOP_1) /*!< USART frame with 2 stop bits */
AnnaBridge 156:ff21514d8981 191 #else
AnnaBridge 156:ff21514d8981 192 #define USART_STOPBITS_1 (0x00000000U) /*!< USART frame with 1 stop bit */
AnnaBridge 156:ff21514d8981 193 #define USART_STOPBITS_2 ((uint32_t)USART_CR2_STOP_1) /*!< USART frame with 2 stop bits */
AnnaBridge 156:ff21514d8981 194 #endif
AnnaBridge 156:ff21514d8981 195 /**
AnnaBridge 156:ff21514d8981 196 * @}
AnnaBridge 156:ff21514d8981 197 */
AnnaBridge 156:ff21514d8981 198
AnnaBridge 156:ff21514d8981 199 /** @defgroup USART_Parity USART Parity
AnnaBridge 156:ff21514d8981 200 * @{
AnnaBridge 156:ff21514d8981 201 */
AnnaBridge 156:ff21514d8981 202 #define USART_PARITY_NONE (0x00000000U) /*!< No parity */
AnnaBridge 156:ff21514d8981 203 #define USART_PARITY_EVEN ((uint32_t)USART_CR1_PCE) /*!< Even parity */
AnnaBridge 156:ff21514d8981 204 #define USART_PARITY_ODD ((uint32_t)(USART_CR1_PCE | USART_CR1_PS)) /*!< Odd parity */
AnnaBridge 156:ff21514d8981 205 /**
AnnaBridge 156:ff21514d8981 206 * @}
AnnaBridge 156:ff21514d8981 207 */
AnnaBridge 156:ff21514d8981 208
AnnaBridge 156:ff21514d8981 209 /** @defgroup USART_Mode USART Mode
AnnaBridge 156:ff21514d8981 210 * @{
AnnaBridge 156:ff21514d8981 211 */
AnnaBridge 156:ff21514d8981 212 #define USART_MODE_RX ((uint32_t)USART_CR1_RE) /*!< RX mode */
AnnaBridge 156:ff21514d8981 213 #define USART_MODE_TX ((uint32_t)USART_CR1_TE) /*!< TX mode */
AnnaBridge 156:ff21514d8981 214 #define USART_MODE_TX_RX ((uint32_t)(USART_CR1_TE |USART_CR1_RE)) /*!< RX and TX mode */
AnnaBridge 156:ff21514d8981 215 /**
AnnaBridge 156:ff21514d8981 216 * @}
AnnaBridge 156:ff21514d8981 217 */
AnnaBridge 156:ff21514d8981 218
AnnaBridge 156:ff21514d8981 219 /** @defgroup USART_Clock USART Clock
AnnaBridge 156:ff21514d8981 220 * @{
AnnaBridge 156:ff21514d8981 221 */
AnnaBridge 156:ff21514d8981 222 #define USART_CLOCK_DISABLE (0x00000000U) /*!< USART clock disable */
AnnaBridge 156:ff21514d8981 223 #define USART_CLOCK_ENABLE ((uint32_t)USART_CR2_CLKEN) /*!< USART clock enable */
AnnaBridge 156:ff21514d8981 224 /**
AnnaBridge 156:ff21514d8981 225 * @}
AnnaBridge 156:ff21514d8981 226 */
AnnaBridge 156:ff21514d8981 227
AnnaBridge 156:ff21514d8981 228 /** @defgroup USART_Clock_Polarity USART Clock Polarity
AnnaBridge 156:ff21514d8981 229 * @{
AnnaBridge 156:ff21514d8981 230 */
AnnaBridge 156:ff21514d8981 231 #define USART_POLARITY_LOW (0x00000000U) /*!< USART Clock signal is steady Low */
AnnaBridge 156:ff21514d8981 232 #define USART_POLARITY_HIGH ((uint32_t)USART_CR2_CPOL) /*!< USART Clock signal is steady High */
AnnaBridge 156:ff21514d8981 233 /**
AnnaBridge 156:ff21514d8981 234 * @}
AnnaBridge 156:ff21514d8981 235 */
AnnaBridge 156:ff21514d8981 236
AnnaBridge 156:ff21514d8981 237 /** @defgroup USART_Clock_Phase USART Clock Phase
AnnaBridge 156:ff21514d8981 238 * @{
AnnaBridge 156:ff21514d8981 239 */
AnnaBridge 156:ff21514d8981 240 #define USART_PHASE_1EDGE (0x00000000U) /*!< USART frame phase on first clock transition */
AnnaBridge 156:ff21514d8981 241 #define USART_PHASE_2EDGE ((uint32_t)USART_CR2_CPHA) /*!< USART frame phase on second clock transition */
AnnaBridge 156:ff21514d8981 242 /**
AnnaBridge 156:ff21514d8981 243 * @}
AnnaBridge 156:ff21514d8981 244 */
AnnaBridge 156:ff21514d8981 245
AnnaBridge 156:ff21514d8981 246 /** @defgroup USART_Last_Bit USART Last Bit
AnnaBridge 156:ff21514d8981 247 * @{
AnnaBridge 156:ff21514d8981 248 */
AnnaBridge 156:ff21514d8981 249 #define USART_LASTBIT_DISABLE (0x00000000U) /*!< USART frame last data bit clock pulse not output to SCLK pin */
AnnaBridge 156:ff21514d8981 250 #define USART_LASTBIT_ENABLE ((uint32_t)USART_CR2_LBCL) /*!< USART frame last data bit clock pulse output to SCLK pin */
AnnaBridge 156:ff21514d8981 251 /**
AnnaBridge 156:ff21514d8981 252 * @}
AnnaBridge 156:ff21514d8981 253 */
AnnaBridge 156:ff21514d8981 254
AnnaBridge 156:ff21514d8981 255 /** @defgroup USART_Interrupt_definition USART Interrupts Definition
AnnaBridge 156:ff21514d8981 256 * Elements values convention: 0000ZZZZ0XXYYYYYb
AnnaBridge 156:ff21514d8981 257 * - YYYYY : Interrupt source position in the XX register (5bits)
AnnaBridge 156:ff21514d8981 258 * - XX : Interrupt source register (2bits)
AnnaBridge 156:ff21514d8981 259 * - 01: CR1 register
AnnaBridge 156:ff21514d8981 260 * - 10: CR2 register
AnnaBridge 156:ff21514d8981 261 * - 11: CR3 register
AnnaBridge 156:ff21514d8981 262 * - ZZZZ : Flag position in the ISR register(4bits)
AnnaBridge 156:ff21514d8981 263 * @{
AnnaBridge 156:ff21514d8981 264 */
AnnaBridge 156:ff21514d8981 265
AnnaBridge 156:ff21514d8981 266 #define USART_IT_PE ((uint16_t)0x0028U) /*!< USART parity error interruption */
AnnaBridge 156:ff21514d8981 267 #define USART_IT_TXE ((uint16_t)0x0727U) /*!< USART transmit data register empty interruption */
AnnaBridge 156:ff21514d8981 268 #define USART_IT_TC ((uint16_t)0x0626U) /*!< USART transmission complete interruption */
AnnaBridge 156:ff21514d8981 269 #define USART_IT_RXNE ((uint16_t)0x0525U) /*!< USART read data register not empty interruption */
AnnaBridge 156:ff21514d8981 270 #define USART_IT_IDLE ((uint16_t)0x0424U) /*!< USART idle interruption */
AnnaBridge 156:ff21514d8981 271 #define USART_IT_ERR ((uint16_t)0x0060U) /*!< USART error interruption */
AnnaBridge 156:ff21514d8981 272 #define USART_IT_ORE ((uint16_t)0x0300U) /*!< USART overrun error interruption */
AnnaBridge 156:ff21514d8981 273 #define USART_IT_NE ((uint16_t)0x0200U) /*!< USART noise error interruption */
AnnaBridge 156:ff21514d8981 274 #define USART_IT_FE ((uint16_t)0x0100U) /*!< USART frame error interruption */
AnnaBridge 156:ff21514d8981 275 /**
AnnaBridge 156:ff21514d8981 276 * @}
AnnaBridge 156:ff21514d8981 277 */
AnnaBridge 156:ff21514d8981 278
AnnaBridge 156:ff21514d8981 279 /** @defgroup USART_IT_CLEAR_Flags USART Interruption Clear Flags
AnnaBridge 156:ff21514d8981 280 * @{
AnnaBridge 156:ff21514d8981 281 */
AnnaBridge 156:ff21514d8981 282 #define USART_CLEAR_PEF USART_ICR_PECF /*!< Parity Error Clear Flag */
AnnaBridge 156:ff21514d8981 283 #define USART_CLEAR_FEF USART_ICR_FECF /*!< Framing Error Clear Flag */
AnnaBridge 156:ff21514d8981 284 #define USART_CLEAR_NEF USART_ICR_NCF /*!< Noise detected Clear Flag */
AnnaBridge 156:ff21514d8981 285 #define USART_CLEAR_OREF USART_ICR_ORECF /*!< OverRun Error Clear Flag */
AnnaBridge 156:ff21514d8981 286 #define USART_CLEAR_IDLEF USART_ICR_IDLECF /*!< IDLE line detected Clear Flag */
AnnaBridge 156:ff21514d8981 287 #define USART_CLEAR_TCF USART_ICR_TCCF /*!< Transmission Complete Clear Flag */
AnnaBridge 156:ff21514d8981 288 #define USART_CLEAR_CTSF USART_ICR_CTSCF /*!< CTS Interrupt Clear Flag */
AnnaBridge 156:ff21514d8981 289 /**
AnnaBridge 156:ff21514d8981 290 * @}
AnnaBridge 156:ff21514d8981 291 */
AnnaBridge 156:ff21514d8981 292
AnnaBridge 156:ff21514d8981 293 /** @defgroup USART_Interruption_Mask USART Interruption Flags Mask
AnnaBridge 156:ff21514d8981 294 * @{
AnnaBridge 156:ff21514d8981 295 */
AnnaBridge 156:ff21514d8981 296 #define USART_IT_MASK ((uint16_t)0x001FU) /*!< USART interruptions flags mask */
AnnaBridge 156:ff21514d8981 297 /**
AnnaBridge 156:ff21514d8981 298 * @}
AnnaBridge 156:ff21514d8981 299 */
AnnaBridge 156:ff21514d8981 300
AnnaBridge 156:ff21514d8981 301 /**
AnnaBridge 156:ff21514d8981 302 * @}
AnnaBridge 156:ff21514d8981 303 */
AnnaBridge 156:ff21514d8981 304
AnnaBridge 156:ff21514d8981 305 /* Exported macros -----------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 306 /** @defgroup USART_Exported_Macros USART Exported Macros
AnnaBridge 156:ff21514d8981 307 * @{
AnnaBridge 156:ff21514d8981 308 */
AnnaBridge 156:ff21514d8981 309
AnnaBridge 156:ff21514d8981 310 /** @brief Reset USART handle state.
AnnaBridge 156:ff21514d8981 311 * @param __HANDLE__: USART handle.
AnnaBridge 156:ff21514d8981 312 * @retval None
AnnaBridge 156:ff21514d8981 313 */
AnnaBridge 156:ff21514d8981 314 #define __HAL_USART_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_USART_STATE_RESET)
AnnaBridge 156:ff21514d8981 315
AnnaBridge 156:ff21514d8981 316 /** @brief Check whether the specified USART flag is set or not.
AnnaBridge 156:ff21514d8981 317 * @param __HANDLE__: specifies the USART Handle
AnnaBridge 156:ff21514d8981 318 * @param __FLAG__: specifies the flag to check.
AnnaBridge 156:ff21514d8981 319 * This parameter can be one of the following values:
AnnaBridge 156:ff21514d8981 320 @if STM32F030x6
AnnaBridge 156:ff21514d8981 321 @elseif STM32F030x8
AnnaBridge 156:ff21514d8981 322 @elseif STM32F030xC
AnnaBridge 156:ff21514d8981 323 @elseif STM32F070x6
AnnaBridge 156:ff21514d8981 324 @elseif STM32F070xB
AnnaBridge 156:ff21514d8981 325 @else
AnnaBridge 156:ff21514d8981 326 * @arg @ref USART_FLAG_REACK Receive enable acknowledge flag
AnnaBridge 156:ff21514d8981 327 @endif
AnnaBridge 156:ff21514d8981 328 * @arg @ref USART_FLAG_TEACK Transmit enable acknowledge flag
AnnaBridge 156:ff21514d8981 329 * @arg @ref USART_FLAG_BUSY Busy flag
AnnaBridge 156:ff21514d8981 330 * @arg @ref USART_FLAG_CTS CTS Change flag
AnnaBridge 156:ff21514d8981 331 * @arg @ref USART_FLAG_TXE Transmit data register empty flag
AnnaBridge 156:ff21514d8981 332 * @arg @ref USART_FLAG_TC Transmission Complete flag
AnnaBridge 156:ff21514d8981 333 * @arg @ref USART_FLAG_RXNE Receive data register not empty flag
AnnaBridge 156:ff21514d8981 334 * @arg @ref USART_FLAG_IDLE Idle Line detection flag
AnnaBridge 156:ff21514d8981 335 * @arg @ref USART_FLAG_ORE OverRun Error flag
AnnaBridge 156:ff21514d8981 336 * @arg @ref USART_FLAG_NE Noise Error flag
AnnaBridge 156:ff21514d8981 337 * @arg @ref USART_FLAG_FE Framing Error flag
AnnaBridge 156:ff21514d8981 338 * @arg @ref USART_FLAG_PE Parity Error flag
AnnaBridge 156:ff21514d8981 339 * @retval The new state of __FLAG__ (TRUE or FALSE).
AnnaBridge 156:ff21514d8981 340 */
AnnaBridge 156:ff21514d8981 341 #define __HAL_USART_GET_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->ISR & (__FLAG__)) == (__FLAG__))
AnnaBridge 156:ff21514d8981 342
AnnaBridge 156:ff21514d8981 343 /** @brief Clear the specified USART pending flag.
AnnaBridge 156:ff21514d8981 344 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 345 * @param __FLAG__: specifies the flag to check.
AnnaBridge 156:ff21514d8981 346 * This parameter can be any combination of the following values:
AnnaBridge 156:ff21514d8981 347 * @arg @ref USART_CLEAR_PEF
AnnaBridge 156:ff21514d8981 348 * @arg @ref USART_CLEAR_FEF
AnnaBridge 156:ff21514d8981 349 * @arg @ref USART_CLEAR_NEF
AnnaBridge 156:ff21514d8981 350 * @arg @ref USART_CLEAR_OREF
AnnaBridge 156:ff21514d8981 351 * @arg @ref USART_CLEAR_IDLEF
AnnaBridge 156:ff21514d8981 352 * @arg @ref USART_CLEAR_TCF
AnnaBridge 156:ff21514d8981 353 * @arg @ref USART_CLEAR_CTSF
AnnaBridge 156:ff21514d8981 354 * @retval None
AnnaBridge 156:ff21514d8981 355 */
AnnaBridge 156:ff21514d8981 356 #define __HAL_USART_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = (__FLAG__))
AnnaBridge 156:ff21514d8981 357
AnnaBridge 156:ff21514d8981 358 /** @brief Clear the USART PE pending flag.
AnnaBridge 156:ff21514d8981 359 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 360 * @retval None
AnnaBridge 156:ff21514d8981 361 */
AnnaBridge 156:ff21514d8981 362 #define __HAL_USART_CLEAR_PEFLAG(__HANDLE__) __HAL_USART_CLEAR_FLAG((__HANDLE__), USART_CLEAR_PEF)
AnnaBridge 156:ff21514d8981 363
AnnaBridge 156:ff21514d8981 364 /** @brief Clear the USART FE pending flag.
AnnaBridge 156:ff21514d8981 365 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 366 * @retval None
AnnaBridge 156:ff21514d8981 367 */
AnnaBridge 156:ff21514d8981 368 #define __HAL_USART_CLEAR_FEFLAG(__HANDLE__) __HAL_USART_CLEAR_FLAG((__HANDLE__), USART_CLEAR_FEF)
AnnaBridge 156:ff21514d8981 369
AnnaBridge 156:ff21514d8981 370 /** @brief Clear the USART NE pending flag.
AnnaBridge 156:ff21514d8981 371 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 372 * @retval None
AnnaBridge 156:ff21514d8981 373 */
AnnaBridge 156:ff21514d8981 374 #define __HAL_USART_CLEAR_NEFLAG(__HANDLE__) __HAL_USART_CLEAR_FLAG((__HANDLE__), USART_CLEAR_NEF)
AnnaBridge 156:ff21514d8981 375
AnnaBridge 156:ff21514d8981 376 /** @brief Clear the USART ORE pending flag.
AnnaBridge 156:ff21514d8981 377 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 378 * @retval None
AnnaBridge 156:ff21514d8981 379 */
AnnaBridge 156:ff21514d8981 380 #define __HAL_USART_CLEAR_OREFLAG(__HANDLE__) __HAL_USART_CLEAR_FLAG((__HANDLE__), USART_CLEAR_OREF)
AnnaBridge 156:ff21514d8981 381
AnnaBridge 156:ff21514d8981 382 /** @brief Clear the USART IDLE pending flag.
AnnaBridge 156:ff21514d8981 383 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 384 * @retval None
AnnaBridge 156:ff21514d8981 385 */
AnnaBridge 156:ff21514d8981 386 #define __HAL_USART_CLEAR_IDLEFLAG(__HANDLE__) __HAL_USART_CLEAR_FLAG((__HANDLE__), USART_CLEAR_IDLEF)
AnnaBridge 156:ff21514d8981 387
AnnaBridge 156:ff21514d8981 388 /** @brief Enable the specified USART interrupt.
AnnaBridge 156:ff21514d8981 389 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 390 * @param __INTERRUPT__: specifies the USART interrupt source to enable.
AnnaBridge 156:ff21514d8981 391 * This parameter can be one of the following values:
AnnaBridge 156:ff21514d8981 392 * @arg @ref USART_IT_TXE Transmit Data Register empty interrupt
AnnaBridge 156:ff21514d8981 393 * @arg @ref USART_IT_TC Transmission complete interrupt
AnnaBridge 156:ff21514d8981 394 * @arg @ref USART_IT_RXNE Receive Data register not empty interrupt
AnnaBridge 156:ff21514d8981 395 * @arg @ref USART_IT_IDLE Idle line detection interrupt
AnnaBridge 156:ff21514d8981 396 * @arg @ref USART_IT_PE Parity Error interrupt
AnnaBridge 156:ff21514d8981 397 * @arg @ref USART_IT_ERR Error interrupt(Frame error, noise error, overrun error)
AnnaBridge 156:ff21514d8981 398 * @retval None
AnnaBridge 156:ff21514d8981 399 */
AnnaBridge 156:ff21514d8981 400 #define __HAL_USART_ENABLE_IT(__HANDLE__, __INTERRUPT__) (((((uint8_t)(__INTERRUPT__)) >> 5U) == 1U)? ((__HANDLE__)->Instance->CR1 |= (1U << ((__INTERRUPT__) & USART_IT_MASK))): \
AnnaBridge 156:ff21514d8981 401 ((((uint8_t)(__INTERRUPT__)) >> 5U) == 2U)? ((__HANDLE__)->Instance->CR2 |= (1U << ((__INTERRUPT__) & USART_IT_MASK))): \
AnnaBridge 156:ff21514d8981 402 ((__HANDLE__)->Instance->CR3 |= (1U << ((__INTERRUPT__) & USART_IT_MASK))))
AnnaBridge 156:ff21514d8981 403
AnnaBridge 156:ff21514d8981 404 /** @brief Disable the specified USART interrupt.
AnnaBridge 156:ff21514d8981 405 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 406 * @param __INTERRUPT__: specifies the USART interrupt source to disable.
AnnaBridge 156:ff21514d8981 407 * This parameter can be one of the following values:
AnnaBridge 156:ff21514d8981 408 * @arg @ref USART_IT_TXE Transmit Data Register empty interrupt
AnnaBridge 156:ff21514d8981 409 * @arg @ref USART_IT_TC Transmission complete interrupt
AnnaBridge 156:ff21514d8981 410 * @arg @ref USART_IT_RXNE Receive Data register not empty interrupt
AnnaBridge 156:ff21514d8981 411 * @arg @ref USART_IT_IDLE Idle line detection interrupt
AnnaBridge 156:ff21514d8981 412 * @arg @ref USART_IT_PE Parity Error interrupt
AnnaBridge 156:ff21514d8981 413 * @arg @ref USART_IT_ERR Error interrupt(Frame error, noise error, overrun error)
AnnaBridge 156:ff21514d8981 414 * @retval None
AnnaBridge 156:ff21514d8981 415 */
AnnaBridge 156:ff21514d8981 416 #define __HAL_USART_DISABLE_IT(__HANDLE__, __INTERRUPT__) (((((uint8_t)(__INTERRUPT__)) >> 5U) == 1U)? ((__HANDLE__)->Instance->CR1 &= ~ (1U << ((__INTERRUPT__) & USART_IT_MASK))): \
AnnaBridge 156:ff21514d8981 417 ((((uint8_t)(__INTERRUPT__)) >> 5U) == 2U)? ((__HANDLE__)->Instance->CR2 &= ~ (1U << ((__INTERRUPT__) & USART_IT_MASK))): \
AnnaBridge 156:ff21514d8981 418 ((__HANDLE__)->Instance->CR3 &= ~ (1U << ((__INTERRUPT__) & USART_IT_MASK))))
AnnaBridge 156:ff21514d8981 419
AnnaBridge 156:ff21514d8981 420
AnnaBridge 156:ff21514d8981 421 /** @brief Check whether the specified USART interrupt has occurred or not.
AnnaBridge 156:ff21514d8981 422 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 423 * @param __IT__: specifies the USART interrupt source to check.
AnnaBridge 156:ff21514d8981 424 * This parameter can be one of the following values:
AnnaBridge 156:ff21514d8981 425 * @arg @ref USART_IT_TXE Transmit Data Register empty interrupt
AnnaBridge 156:ff21514d8981 426 * @arg @ref USART_IT_TC Transmission complete interrupt
AnnaBridge 156:ff21514d8981 427 * @arg @ref USART_IT_RXNE Receive Data register not empty interrupt
AnnaBridge 156:ff21514d8981 428 * @arg @ref USART_IT_IDLE Idle line detection interrupt
AnnaBridge 156:ff21514d8981 429 * @arg @ref USART_IT_ORE OverRun Error interrupt
AnnaBridge 156:ff21514d8981 430 * @arg @ref USART_IT_NE Noise Error interrupt
AnnaBridge 156:ff21514d8981 431 * @arg @ref USART_IT_FE Framing Error interrupt
AnnaBridge 156:ff21514d8981 432 * @arg @ref USART_IT_PE Parity Error interrupt
AnnaBridge 156:ff21514d8981 433 * @retval The new state of __IT__ (TRUE or FALSE).
AnnaBridge 156:ff21514d8981 434 */
AnnaBridge 156:ff21514d8981 435 #define __HAL_USART_GET_IT(__HANDLE__, __IT__) ((__HANDLE__)->Instance->ISR & (1U << ((__IT__)>> 0x08U)))
AnnaBridge 156:ff21514d8981 436
AnnaBridge 156:ff21514d8981 437 /** @brief Check whether the specified USART interrupt source is enabled or not.
AnnaBridge 156:ff21514d8981 438 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 439 * @param __IT__: specifies the USART interrupt source to check.
AnnaBridge 156:ff21514d8981 440 * This parameter can be one of the following values:
AnnaBridge 156:ff21514d8981 441 * @arg @ref USART_IT_TXE Transmit Data Register empty interrupt
AnnaBridge 156:ff21514d8981 442 * @arg @ref USART_IT_TC Transmission complete interrupt
AnnaBridge 156:ff21514d8981 443 * @arg @ref USART_IT_RXNE Receive Data register not empty interrupt
AnnaBridge 156:ff21514d8981 444 * @arg @ref USART_IT_IDLE Idle line detection interrupt
AnnaBridge 156:ff21514d8981 445 * @arg @ref USART_IT_ORE OverRun Error interrupt
AnnaBridge 156:ff21514d8981 446 * @arg @ref USART_IT_NE Noise Error interrupt
AnnaBridge 156:ff21514d8981 447 * @arg @ref USART_IT_FE Framing Error interrupt
AnnaBridge 156:ff21514d8981 448 * @arg @ref USART_IT_PE Parity Error interrupt
AnnaBridge 156:ff21514d8981 449 * @retval The new state of __IT__ (TRUE or FALSE).
AnnaBridge 156:ff21514d8981 450 */
AnnaBridge 156:ff21514d8981 451 #define __HAL_USART_GET_IT_SOURCE(__HANDLE__, __IT__) ((((((uint8_t)(__IT__)) >> 5U) == 1U)? (__HANDLE__)->Instance->CR1:(((((uint8_t)(__IT__)) >> 5U) == 2U)? \
AnnaBridge 156:ff21514d8981 452 (__HANDLE__)->Instance->CR2 : (__HANDLE__)->Instance->CR3)) & (1U << \
AnnaBridge 156:ff21514d8981 453 (((uint16_t)(__IT__)) & USART_IT_MASK)))
AnnaBridge 156:ff21514d8981 454
AnnaBridge 156:ff21514d8981 455
AnnaBridge 156:ff21514d8981 456 /** @brief Clear the specified USART ISR flag, in setting the proper ICR register flag.
AnnaBridge 156:ff21514d8981 457 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 458 * @param __IT_CLEAR__: specifies the interrupt clear register flag that needs to be set
AnnaBridge 156:ff21514d8981 459 * to clear the corresponding interrupt.
AnnaBridge 156:ff21514d8981 460 * This parameter can be one of the following values:
AnnaBridge 156:ff21514d8981 461 * @arg @ref USART_CLEAR_PEF Parity Error Clear Flag
AnnaBridge 156:ff21514d8981 462 * @arg @ref USART_CLEAR_FEF Framing Error Clear Flag
AnnaBridge 156:ff21514d8981 463 * @arg @ref USART_CLEAR_NEF Noise detected Clear Flag
AnnaBridge 156:ff21514d8981 464 * @arg @ref USART_CLEAR_OREF OverRun Error Clear Flag
AnnaBridge 156:ff21514d8981 465 * @arg @ref USART_CLEAR_IDLEF IDLE line detected Clear Flag
AnnaBridge 156:ff21514d8981 466 * @arg @ref USART_CLEAR_TCF Transmission Complete Clear Flag
AnnaBridge 156:ff21514d8981 467 * @arg @ref USART_CLEAR_CTSF CTS Interrupt Clear Flag
AnnaBridge 156:ff21514d8981 468 * @retval None
AnnaBridge 156:ff21514d8981 469 */
AnnaBridge 156:ff21514d8981 470 #define __HAL_USART_CLEAR_IT(__HANDLE__, __IT_CLEAR__) ((__HANDLE__)->Instance->ICR = (uint32_t)(__IT_CLEAR__))
AnnaBridge 156:ff21514d8981 471
AnnaBridge 156:ff21514d8981 472 /** @brief Set a specific USART request flag.
AnnaBridge 156:ff21514d8981 473 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 474 * @param __REQ__: specifies the request flag to set.
AnnaBridge 156:ff21514d8981 475 * This parameter can be one of the following values:
AnnaBridge 156:ff21514d8981 476 * @arg @ref USART_RXDATA_FLUSH_REQUEST Receive Data flush Request
AnnaBridge 156:ff21514d8981 477 @if STM32F030x6
AnnaBridge 156:ff21514d8981 478 @elseif STM32F030x8
AnnaBridge 156:ff21514d8981 479 @elseif STM32F030xC
AnnaBridge 156:ff21514d8981 480 @elseif STM32F070x6
AnnaBridge 156:ff21514d8981 481 @elseif STM32F070xB
AnnaBridge 156:ff21514d8981 482 @else
AnnaBridge 156:ff21514d8981 483 * @arg @ref USART_TXDATA_FLUSH_REQUEST Transmit data flush Request
AnnaBridge 156:ff21514d8981 484 @endif
AnnaBridge 156:ff21514d8981 485 *
AnnaBridge 156:ff21514d8981 486 * @retval None
AnnaBridge 156:ff21514d8981 487 */
AnnaBridge 156:ff21514d8981 488 #define __HAL_USART_SEND_REQ(__HANDLE__, __REQ__) ((__HANDLE__)->Instance->RQR |= (__REQ__))
AnnaBridge 156:ff21514d8981 489
AnnaBridge 156:ff21514d8981 490 /** @brief Enable the USART one bit sample method.
AnnaBridge 156:ff21514d8981 491 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 492 * @retval None
AnnaBridge 156:ff21514d8981 493 */
AnnaBridge 156:ff21514d8981 494 #define __HAL_USART_ONE_BIT_SAMPLE_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR3|= USART_CR3_ONEBIT)
AnnaBridge 156:ff21514d8981 495
AnnaBridge 156:ff21514d8981 496 /** @brief Disable the USART one bit sample method.
AnnaBridge 156:ff21514d8981 497 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 498 * @retval None
AnnaBridge 156:ff21514d8981 499 */
AnnaBridge 156:ff21514d8981 500 #define __HAL_USART_ONE_BIT_SAMPLE_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR3 &= (uint32_t)~((uint32_t)USART_CR3_ONEBIT))
AnnaBridge 156:ff21514d8981 501
AnnaBridge 156:ff21514d8981 502 /** @brief Enable USART.
AnnaBridge 156:ff21514d8981 503 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 504 * @retval None
AnnaBridge 156:ff21514d8981 505 */
AnnaBridge 156:ff21514d8981 506 #define __HAL_USART_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1 |= USART_CR1_UE)
AnnaBridge 156:ff21514d8981 507
AnnaBridge 156:ff21514d8981 508 /** @brief Disable USART.
AnnaBridge 156:ff21514d8981 509 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 156:ff21514d8981 510 * @retval None
AnnaBridge 156:ff21514d8981 511 */
AnnaBridge 156:ff21514d8981 512 #define __HAL_USART_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1 &= ~USART_CR1_UE)
AnnaBridge 156:ff21514d8981 513
AnnaBridge 156:ff21514d8981 514 /**
AnnaBridge 156:ff21514d8981 515 * @}
AnnaBridge 156:ff21514d8981 516 */
AnnaBridge 156:ff21514d8981 517
AnnaBridge 156:ff21514d8981 518 /* Private macros --------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 519 /** @defgroup USART_Private_Macros USART Private Macros
AnnaBridge 156:ff21514d8981 520 * @{
AnnaBridge 156:ff21514d8981 521 */
AnnaBridge 156:ff21514d8981 522
AnnaBridge 156:ff21514d8981 523 /** @brief Check USART Baud rate.
AnnaBridge 156:ff21514d8981 524 * @param __BAUDRATE__: Baudrate specified by the user.
AnnaBridge 156:ff21514d8981 525 * The maximum Baud Rate is derived from the maximum clock on F0 (i.e. 48 MHz)
AnnaBridge 156:ff21514d8981 526 * divided by the smallest oversampling used on the USART (i.e. 8)
AnnaBridge 156:ff21514d8981 527 * @retval Test result (TRUE or FALSE).
AnnaBridge 156:ff21514d8981 528 */
AnnaBridge 156:ff21514d8981 529 #define IS_USART_BAUDRATE(__BAUDRATE__) ((__BAUDRATE__) < 6000001U)
AnnaBridge 156:ff21514d8981 530
AnnaBridge 156:ff21514d8981 531 /**
AnnaBridge 156:ff21514d8981 532 * @brief Ensure that USART frame number of stop bits is valid.
AnnaBridge 156:ff21514d8981 533 * @param __STOPBITS__: USART frame number of stop bits.
AnnaBridge 156:ff21514d8981 534 * @retval SET (__STOPBITS__ is valid) or RESET (__STOPBITS__ is invalid)
AnnaBridge 156:ff21514d8981 535 */
AnnaBridge 156:ff21514d8981 536 #ifdef USART_SMARTCARD_SUPPORT
AnnaBridge 156:ff21514d8981 537 #define IS_USART_STOPBITS(__STOPBITS__) (((__STOPBITS__) == USART_STOPBITS_0_5) || \
AnnaBridge 156:ff21514d8981 538 ((__STOPBITS__) == USART_STOPBITS_1) || \
AnnaBridge 156:ff21514d8981 539 ((__STOPBITS__) == USART_STOPBITS_1_5) || \
AnnaBridge 156:ff21514d8981 540 ((__STOPBITS__) == USART_STOPBITS_2))
AnnaBridge 156:ff21514d8981 541 #else
AnnaBridge 156:ff21514d8981 542 #define IS_USART_STOPBITS(__STOPBITS__) (((__STOPBITS__) == USART_STOPBITS_1) || \
AnnaBridge 156:ff21514d8981 543 ((__STOPBITS__) == USART_STOPBITS_2))
AnnaBridge 156:ff21514d8981 544 #endif
AnnaBridge 156:ff21514d8981 545
AnnaBridge 156:ff21514d8981 546 /**
AnnaBridge 156:ff21514d8981 547 * @brief Ensure that USART frame parity is valid.
AnnaBridge 156:ff21514d8981 548 * @param __PARITY__: USART frame parity.
AnnaBridge 156:ff21514d8981 549 * @retval SET (__PARITY__ is valid) or RESET (__PARITY__ is invalid)
AnnaBridge 156:ff21514d8981 550 */
AnnaBridge 156:ff21514d8981 551 #define IS_USART_PARITY(__PARITY__) (((__PARITY__) == USART_PARITY_NONE) || \
AnnaBridge 156:ff21514d8981 552 ((__PARITY__) == USART_PARITY_EVEN) || \
AnnaBridge 156:ff21514d8981 553 ((__PARITY__) == USART_PARITY_ODD))
AnnaBridge 156:ff21514d8981 554
AnnaBridge 156:ff21514d8981 555 /**
AnnaBridge 156:ff21514d8981 556 * @brief Ensure that USART communication mode is valid.
AnnaBridge 156:ff21514d8981 557 * @param __MODE__: USART communication mode.
AnnaBridge 156:ff21514d8981 558 * @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid)
AnnaBridge 156:ff21514d8981 559 */
AnnaBridge 156:ff21514d8981 560 #define IS_USART_MODE(__MODE__) ((((__MODE__) & 0xFFFFFFF3U) == 0x00U) && ((__MODE__) != 0x00U))
AnnaBridge 156:ff21514d8981 561
AnnaBridge 156:ff21514d8981 562 /**
AnnaBridge 156:ff21514d8981 563 * @brief Ensure that USART clock state is valid.
AnnaBridge 156:ff21514d8981 564 * @param __CLOCK__: USART clock state.
AnnaBridge 156:ff21514d8981 565 * @retval SET (__CLOCK__ is valid) or RESET (__CLOCK__ is invalid)
AnnaBridge 156:ff21514d8981 566 */
AnnaBridge 156:ff21514d8981 567 #define IS_USART_CLOCK(__CLOCK__) (((__CLOCK__) == USART_CLOCK_DISABLE) || \
AnnaBridge 156:ff21514d8981 568 ((__CLOCK__) == USART_CLOCK_ENABLE))
AnnaBridge 156:ff21514d8981 569
AnnaBridge 156:ff21514d8981 570 /**
AnnaBridge 156:ff21514d8981 571 * @brief Ensure that USART frame polarity is valid.
AnnaBridge 156:ff21514d8981 572 * @param __CPOL__: USART frame polarity.
AnnaBridge 156:ff21514d8981 573 * @retval SET (__CPOL__ is valid) or RESET (__CPOL__ is invalid)
AnnaBridge 156:ff21514d8981 574 */
AnnaBridge 156:ff21514d8981 575 #define IS_USART_POLARITY(__CPOL__) (((__CPOL__) == USART_POLARITY_LOW) || ((__CPOL__) == USART_POLARITY_HIGH))
AnnaBridge 156:ff21514d8981 576
AnnaBridge 156:ff21514d8981 577 /**
AnnaBridge 156:ff21514d8981 578 * @brief Ensure that USART frame phase is valid.
AnnaBridge 156:ff21514d8981 579 * @param __CPHA__: USART frame phase.
AnnaBridge 156:ff21514d8981 580 * @retval SET (__CPHA__ is valid) or RESET (__CPHA__ is invalid)
AnnaBridge 156:ff21514d8981 581 */
AnnaBridge 156:ff21514d8981 582 #define IS_USART_PHASE(__CPHA__) (((__CPHA__) == USART_PHASE_1EDGE) || ((__CPHA__) == USART_PHASE_2EDGE))
AnnaBridge 156:ff21514d8981 583
AnnaBridge 156:ff21514d8981 584 /**
AnnaBridge 156:ff21514d8981 585 * @brief Ensure that USART frame last bit clock pulse setting is valid.
AnnaBridge 156:ff21514d8981 586 * @param __LASTBIT__: USART frame last bit clock pulse setting.
AnnaBridge 156:ff21514d8981 587 * @retval SET (__LASTBIT__ is valid) or RESET (__LASTBIT__ is invalid)
AnnaBridge 156:ff21514d8981 588 */
AnnaBridge 156:ff21514d8981 589 #define IS_USART_LASTBIT(__LASTBIT__) (((__LASTBIT__) == USART_LASTBIT_DISABLE) || \
AnnaBridge 156:ff21514d8981 590 ((__LASTBIT__) == USART_LASTBIT_ENABLE))
AnnaBridge 156:ff21514d8981 591
AnnaBridge 156:ff21514d8981 592 /**
AnnaBridge 156:ff21514d8981 593 * @}
AnnaBridge 156:ff21514d8981 594 */
AnnaBridge 156:ff21514d8981 595
AnnaBridge 156:ff21514d8981 596 /* Include USART HAL Extended module */
AnnaBridge 156:ff21514d8981 597 #include "stm32f0xx_hal_usart_ex.h"
AnnaBridge 156:ff21514d8981 598
AnnaBridge 156:ff21514d8981 599 /* Exported functions --------------------------------------------------------*/
AnnaBridge 156:ff21514d8981 600 /** @addtogroup USART_Exported_Functions USART Exported Functions
AnnaBridge 156:ff21514d8981 601 * @{
AnnaBridge 156:ff21514d8981 602 */
AnnaBridge 156:ff21514d8981 603
AnnaBridge 156:ff21514d8981 604 /** @addtogroup USART_Exported_Functions_Group1 Initialization and de-initialization functions
AnnaBridge 156:ff21514d8981 605 * @{
AnnaBridge 156:ff21514d8981 606 */
AnnaBridge 156:ff21514d8981 607
AnnaBridge 156:ff21514d8981 608 /* Initialization and de-initialization functions ****************************/
AnnaBridge 156:ff21514d8981 609 HAL_StatusTypeDef HAL_USART_Init(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 610 HAL_StatusTypeDef HAL_USART_DeInit(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 611 void HAL_USART_MspInit(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 612 void HAL_USART_MspDeInit(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 613
AnnaBridge 156:ff21514d8981 614 /**
AnnaBridge 156:ff21514d8981 615 * @}
AnnaBridge 156:ff21514d8981 616 */
AnnaBridge 156:ff21514d8981 617
AnnaBridge 156:ff21514d8981 618 /** @addtogroup USART_Exported_Functions_Group2 IO operation functions
AnnaBridge 156:ff21514d8981 619 * @{
AnnaBridge 156:ff21514d8981 620 */
AnnaBridge 156:ff21514d8981 621
AnnaBridge 156:ff21514d8981 622 /* IO operation functions *****************************************************/
AnnaBridge 156:ff21514d8981 623 HAL_StatusTypeDef HAL_USART_Transmit(USART_HandleTypeDef *husart, uint8_t *pTxData, uint16_t Size, uint32_t Timeout);
AnnaBridge 156:ff21514d8981 624 HAL_StatusTypeDef HAL_USART_Receive(USART_HandleTypeDef *husart, uint8_t *pRxData, uint16_t Size, uint32_t Timeout);
AnnaBridge 156:ff21514d8981 625 HAL_StatusTypeDef HAL_USART_TransmitReceive(USART_HandleTypeDef *husart, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size, uint32_t Timeout);
AnnaBridge 156:ff21514d8981 626 HAL_StatusTypeDef HAL_USART_Transmit_IT(USART_HandleTypeDef *husart, uint8_t *pTxData, uint16_t Size);
AnnaBridge 156:ff21514d8981 627 HAL_StatusTypeDef HAL_USART_Receive_IT(USART_HandleTypeDef *husart, uint8_t *pRxData, uint16_t Size);
AnnaBridge 156:ff21514d8981 628 HAL_StatusTypeDef HAL_USART_TransmitReceive_IT(USART_HandleTypeDef *husart, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size);
AnnaBridge 156:ff21514d8981 629 HAL_StatusTypeDef HAL_USART_Transmit_DMA(USART_HandleTypeDef *husart, uint8_t *pTxData, uint16_t Size);
AnnaBridge 156:ff21514d8981 630 HAL_StatusTypeDef HAL_USART_Receive_DMA(USART_HandleTypeDef *husart, uint8_t *pRxData, uint16_t Size);
AnnaBridge 156:ff21514d8981 631 HAL_StatusTypeDef HAL_USART_TransmitReceive_DMA(USART_HandleTypeDef *husart, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size);
AnnaBridge 156:ff21514d8981 632 HAL_StatusTypeDef HAL_USART_DMAPause(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 633 HAL_StatusTypeDef HAL_USART_DMAResume(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 634 HAL_StatusTypeDef HAL_USART_DMAStop(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 635 /* Transfer Abort functions */
AnnaBridge 156:ff21514d8981 636 HAL_StatusTypeDef HAL_USART_Abort(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 637 HAL_StatusTypeDef HAL_USART_Abort_IT(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 638
AnnaBridge 156:ff21514d8981 639 void HAL_USART_IRQHandler(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 640 void HAL_USART_TxCpltCallback(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 641 void HAL_USART_RxCpltCallback(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 642 void HAL_USART_TxHalfCpltCallback(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 643 void HAL_USART_RxHalfCpltCallback(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 644 void HAL_USART_TxRxCpltCallback(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 645 void HAL_USART_ErrorCallback(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 646 void HAL_USART_AbortCpltCallback (USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 647
AnnaBridge 156:ff21514d8981 648 /**
AnnaBridge 156:ff21514d8981 649 * @}
AnnaBridge 156:ff21514d8981 650 */
AnnaBridge 156:ff21514d8981 651
AnnaBridge 156:ff21514d8981 652 /* Peripheral Control functions ***********************************************/
AnnaBridge 156:ff21514d8981 653
AnnaBridge 156:ff21514d8981 654 /** @addtogroup USART_Exported_Functions_Group3 Peripheral State and Error functions
AnnaBridge 156:ff21514d8981 655 * @{
AnnaBridge 156:ff21514d8981 656 */
AnnaBridge 156:ff21514d8981 657
AnnaBridge 156:ff21514d8981 658 /* Peripheral State and Error functions ***************************************/
AnnaBridge 156:ff21514d8981 659 HAL_USART_StateTypeDef HAL_USART_GetState(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 660 uint32_t HAL_USART_GetError(USART_HandleTypeDef *husart);
AnnaBridge 156:ff21514d8981 661
AnnaBridge 156:ff21514d8981 662 /**
AnnaBridge 156:ff21514d8981 663 * @}
AnnaBridge 156:ff21514d8981 664 */
AnnaBridge 156:ff21514d8981 665
AnnaBridge 156:ff21514d8981 666 /**
AnnaBridge 156:ff21514d8981 667 * @}
AnnaBridge 156:ff21514d8981 668 */
AnnaBridge 156:ff21514d8981 669
AnnaBridge 156:ff21514d8981 670 /**
AnnaBridge 156:ff21514d8981 671 * @}
AnnaBridge 156:ff21514d8981 672 */
AnnaBridge 156:ff21514d8981 673
AnnaBridge 156:ff21514d8981 674 /**
AnnaBridge 156:ff21514d8981 675 * @}
AnnaBridge 156:ff21514d8981 676 */
AnnaBridge 156:ff21514d8981 677
AnnaBridge 156:ff21514d8981 678 #ifdef __cplusplus
AnnaBridge 156:ff21514d8981 679 }
AnnaBridge 156:ff21514d8981 680 #endif
AnnaBridge 156:ff21514d8981 681
AnnaBridge 156:ff21514d8981 682 #endif /* __STM32F0xx_HAL_USART_H */
AnnaBridge 156:ff21514d8981 683
AnnaBridge 156:ff21514d8981 684 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
AnnaBridge 156:ff21514d8981 685