mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

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

Committer:
mbed_official
Date:
Wed Jul 01 09:45:11 2015 +0100
Revision:
579:53297373a894
Parent:
489:119543c9f674
Synchronized with git revision d5b4d2ab9c47edb4dc5776e7177b0c2263459081

Full URL: https://github.com/mbedmicro/mbed/commit/d5b4d2ab9c47edb4dc5776e7177b0c2263459081/

Initial version of drivers for SAMR21

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