en 129 / mbed-dev

fix LPC812 PWM

Dependents:   IR_LED_Send

Fork of mbed-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L0/stm32l0xx_hal_usart.h@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
113:b3775bf36a83
Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

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