cc y / mbed

Fork of mbed by mbed official

Committer:
Kojto
Date:
Wed Apr 27 12:10:56 2016 -0500
Revision:
119:aae6fcc7d9bb
Parent:
96:487b796308b0
Release 119 of the mbed library

Changes:
- new targets - EFM32PG_STK3401, NUCLEO_L031K6
- ST - hwflwctl support for NUCLEO_L476RG
- Update STM32CUBE_L0 from v1.2 to v1.5
- STM32F7 - bugfix - The weak function HAL_Delay is overwritten to use us ticker API.
- Maxim - Fixing the send break for the MAXWSNENV and MAX32600MBED

Who changed what in which revision?

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