li lei / mbed-stm32l0l1-src

Fork of mbed-stm32l0l1-src-1 by lzbp li

Committer:
floatlei
Date:
Tue Sep 27 09:40:53 2016 +0000
Revision:
639:b32fded6b0ae
Parent:
489:119543c9f674
sf

Who changed what in which revision?

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