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

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

Committer:
AnnaBridge
Date:
Thu Nov 08 11:45:42 2018 +0000
Revision:
171:3a7713b1edbc
Parent:
TARGET_DISCO_L475VG_IOT01A/TARGET_STM/TARGET_STM32L4/device/stm32l4xx_hal_usart_ex.h@161:aa5281ff4a02
mbed library. Release version 164

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 145:64910690c574 1 /**
AnnaBridge 145:64910690c574 2 ******************************************************************************
AnnaBridge 145:64910690c574 3 * @file stm32l4xx_hal_usart_ex.h
AnnaBridge 145:64910690c574 4 * @author MCD Application Team
AnnaBridge 145:64910690c574 5 * @brief Header file of USART HAL Extended module.
AnnaBridge 145:64910690c574 6 ******************************************************************************
AnnaBridge 145:64910690c574 7 * @attention
AnnaBridge 145:64910690c574 8 *
AnnaBridge 145:64910690c574 9 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
AnnaBridge 145:64910690c574 10 *
AnnaBridge 145:64910690c574 11 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 145:64910690c574 12 * are permitted provided that the following conditions are met:
AnnaBridge 145:64910690c574 13 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 145:64910690c574 14 * this list of conditions and the following disclaimer.
AnnaBridge 145:64910690c574 15 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 145:64910690c574 16 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 145:64910690c574 17 * and/or other materials provided with the distribution.
AnnaBridge 145:64910690c574 18 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 145:64910690c574 19 * may be used to endorse or promote products derived from this software
AnnaBridge 145:64910690c574 20 * without specific prior written permission.
AnnaBridge 145:64910690c574 21 *
AnnaBridge 145:64910690c574 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 145:64910690c574 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 145:64910690c574 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 145:64910690c574 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 145:64910690c574 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 145:64910690c574 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 145:64910690c574 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 145:64910690c574 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 145:64910690c574 30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 145:64910690c574 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 145:64910690c574 32 *
AnnaBridge 145:64910690c574 33 ******************************************************************************
AnnaBridge 145:64910690c574 34 */
AnnaBridge 145:64910690c574 35
AnnaBridge 145:64910690c574 36 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 145:64910690c574 37 #ifndef __STM32L4xx_HAL_USART_EX_H
AnnaBridge 145:64910690c574 38 #define __STM32L4xx_HAL_USART_EX_H
AnnaBridge 145:64910690c574 39
AnnaBridge 145:64910690c574 40 #ifdef __cplusplus
AnnaBridge 145:64910690c574 41 extern "C" {
AnnaBridge 145:64910690c574 42 #endif
AnnaBridge 145:64910690c574 43
AnnaBridge 145:64910690c574 44 /* Includes ------------------------------------------------------------------*/
AnnaBridge 145:64910690c574 45 #include "stm32l4xx_hal_def.h"
AnnaBridge 145:64910690c574 46
AnnaBridge 145:64910690c574 47 /** @addtogroup STM32L4xx_HAL_Driver
AnnaBridge 145:64910690c574 48 * @{
AnnaBridge 145:64910690c574 49 */
AnnaBridge 145:64910690c574 50
AnnaBridge 145:64910690c574 51 /** @addtogroup USARTEx
AnnaBridge 145:64910690c574 52 * @{
AnnaBridge 145:64910690c574 53 */
AnnaBridge 145:64910690c574 54
AnnaBridge 145:64910690c574 55 /* Exported types ------------------------------------------------------------*/
AnnaBridge 145:64910690c574 56 /* Exported constants --------------------------------------------------------*/
AnnaBridge 145:64910690c574 57 /** @defgroup USARTEx_Exported_Constants USARTEx Exported Constants
AnnaBridge 145:64910690c574 58 * @{
AnnaBridge 145:64910690c574 59 */
AnnaBridge 145:64910690c574 60
AnnaBridge 145:64910690c574 61 /** @defgroup USARTEx_Word_Length USARTEx Word Length
AnnaBridge 145:64910690c574 62 * @{
AnnaBridge 145:64910690c574 63 */
AnnaBridge 161:aa5281ff4a02 64 #define USART_WORDLENGTH_7B ((uint32_t)USART_CR1_M1) /*!< 7-bit long USART frame */
AnnaBridge 161:aa5281ff4a02 65 #define USART_WORDLENGTH_8B 0x00000000U /*!< 8-bit long USART frame */
AnnaBridge 161:aa5281ff4a02 66 #define USART_WORDLENGTH_9B ((uint32_t)USART_CR1_M0) /*!< 9-bit long USART frame */
AnnaBridge 161:aa5281ff4a02 67 /**
AnnaBridge 161:aa5281ff4a02 68 * @}
AnnaBridge 161:aa5281ff4a02 69 */
AnnaBridge 161:aa5281ff4a02 70
AnnaBridge 161:aa5281ff4a02 71 #if defined(USART_CR2_SLVEN)
AnnaBridge 161:aa5281ff4a02 72 /** @defgroup USARTEx_Slave_Select_management USARTEx Slave Select Management
AnnaBridge 161:aa5281ff4a02 73 * @{
AnnaBridge 161:aa5281ff4a02 74 */
AnnaBridge 161:aa5281ff4a02 75 #define USART_NSS_HARD 0x00000000U /*!< SPI slave selection depends on NSS input pin */
AnnaBridge 161:aa5281ff4a02 76 #define USART_NSS_SOFT USART_CR2_DIS_NSS /*!< SPI slave is always selected and NSS input pin is ignored */
AnnaBridge 145:64910690c574 77 /**
AnnaBridge 145:64910690c574 78 * @}
AnnaBridge 145:64910690c574 79 */
AnnaBridge 161:aa5281ff4a02 80 #endif
AnnaBridge 161:aa5281ff4a02 81
AnnaBridge 161:aa5281ff4a02 82 #if defined(USART_CR1_FIFOEN)
AnnaBridge 161:aa5281ff4a02 83 /** @defgroup USARTEx_TXFIFO_threshold_level USARTEx TXFIFO threshold level
AnnaBridge 161:aa5281ff4a02 84 * @brief USART TXFIFO level
AnnaBridge 161:aa5281ff4a02 85 * @{
AnnaBridge 161:aa5281ff4a02 86 */
AnnaBridge 161:aa5281ff4a02 87 #define USART_TXFIFO_THRESHOLD_1_8 0x00000000U /*!< TXFIFO reaches 1/8 of its depth */
AnnaBridge 161:aa5281ff4a02 88 #define USART_TXFIFO_THRESHOLD_1_4 USART_CR3_TXFTCFG_0 /*!< TXFIFO reaches 1/4 of its depth */
AnnaBridge 161:aa5281ff4a02 89 #define USART_TXFIFO_THRESHOLD_1_2 USART_CR3_TXFTCFG_1 /*!< TXFIFO reaches 1/2 of its depth */
AnnaBridge 161:aa5281ff4a02 90 #define USART_TXFIFO_THRESHOLD_3_4 (USART_CR3_TXFTCFG_0|USART_CR3_TXFTCFG_1) /*!< TXFIFO reaches 3/4 of its depth */
AnnaBridge 161:aa5281ff4a02 91 #define USART_TXFIFO_THRESHOLD_7_8 USART_CR3_TXFTCFG_2 /*!< TXFIFO reaches 7/8 of its depth */
AnnaBridge 161:aa5281ff4a02 92 #define USART_TXFIFO_THRESHOLD_8_8 (USART_CR3_TXFTCFG_2|USART_CR3_TXFTCFG_0) /*!< TXFIFO becomes empty */
AnnaBridge 161:aa5281ff4a02 93 /**
AnnaBridge 161:aa5281ff4a02 94 * @}
AnnaBridge 161:aa5281ff4a02 95 */
AnnaBridge 161:aa5281ff4a02 96
AnnaBridge 161:aa5281ff4a02 97 /** @defgroup USARTEx_RXFIFO_threshold_level USARTEx RXFIFO threshold level
AnnaBridge 161:aa5281ff4a02 98 * @brief USART RXFIFO level
AnnaBridge 161:aa5281ff4a02 99 * @{
AnnaBridge 161:aa5281ff4a02 100 */
AnnaBridge 161:aa5281ff4a02 101 #define USART_RXFIFO_THRESHOLD_1_8 0x00000000U /*!< RXFIFO FIFO reaches 1/8 of its depth */
AnnaBridge 161:aa5281ff4a02 102 #define USART_RXFIFO_THRESHOLD_1_4 USART_CR3_RXFTCFG_0 /*!< RXFIFO FIFO reaches 1/4 of its depth */
AnnaBridge 161:aa5281ff4a02 103 #define USART_RXFIFO_THRESHOLD_1_2 USART_CR3_RXFTCFG_1 /*!< RXFIFO FIFO reaches 1/2 of its depth */
AnnaBridge 161:aa5281ff4a02 104 #define USART_RXFIFO_THRESHOLD_3_4 (USART_CR3_RXFTCFG_0|USART_CR3_RXFTCFG_1) /*!< RXFIFO FIFO reaches 3/4 of its depth */
AnnaBridge 161:aa5281ff4a02 105 #define USART_RXFIFO_THRESHOLD_7_8 USART_CR3_RXFTCFG_2 /*!< RXFIFO FIFO reaches 7/8 of its depth */
AnnaBridge 161:aa5281ff4a02 106 #define USART_RXFIFO_THRESHOLD_8_8 (USART_CR3_RXFTCFG_2|USART_CR3_RXFTCFG_0) /*!< RXFIFO FIFO becomes full */
AnnaBridge 161:aa5281ff4a02 107 /**
AnnaBridge 161:aa5281ff4a02 108 * @}
AnnaBridge 161:aa5281ff4a02 109 */
AnnaBridge 161:aa5281ff4a02 110 #endif
AnnaBridge 145:64910690c574 111
AnnaBridge 145:64910690c574 112 /**
AnnaBridge 145:64910690c574 113 * @}
AnnaBridge 145:64910690c574 114 */
AnnaBridge 145:64910690c574 115
AnnaBridge 161:aa5281ff4a02 116 /* Private constants ---------------------------------------------------------*/
AnnaBridge 161:aa5281ff4a02 117 /** @defgroup USARTEx_Private_Constants USARTEx Private Constants
AnnaBridge 161:aa5281ff4a02 118 * @{
AnnaBridge 161:aa5281ff4a02 119 */
AnnaBridge 161:aa5281ff4a02 120 #if defined(USART_CR2_SLVEN)
AnnaBridge 161:aa5281ff4a02 121 /** @defgroup USARTEx_Slave_Mode USARTEx Synchronous Slave mode
AnnaBridge 161:aa5281ff4a02 122 * @{
AnnaBridge 161:aa5281ff4a02 123 */
AnnaBridge 161:aa5281ff4a02 124 #define USART_SLAVEMODE_DISABLE 0x00000000U /*!< USART SPI Slave Mode Enable */
AnnaBridge 161:aa5281ff4a02 125 #define USART_SLAVEMODE_ENABLE USART_CR2_SLVEN /*!< USART SPI Slave Mode Disable */
AnnaBridge 161:aa5281ff4a02 126 /**
AnnaBridge 161:aa5281ff4a02 127 * @}
AnnaBridge 161:aa5281ff4a02 128 */
AnnaBridge 161:aa5281ff4a02 129 #endif
AnnaBridge 161:aa5281ff4a02 130
AnnaBridge 161:aa5281ff4a02 131 #if defined(USART_CR1_FIFOEN)
AnnaBridge 161:aa5281ff4a02 132 /** @defgroup USARTEx_FIFO_mode USARTEx FIFO mode
AnnaBridge 161:aa5281ff4a02 133 * @{
AnnaBridge 161:aa5281ff4a02 134 */
AnnaBridge 161:aa5281ff4a02 135 #define USART_FIFOMODE_DISABLE 0x00000000U /*!< FIFO mode disable */
AnnaBridge 161:aa5281ff4a02 136 #define USART_FIFOMODE_ENABLE USART_CR1_FIFOEN /*!< FIFO mode enable */
AnnaBridge 161:aa5281ff4a02 137 /**
AnnaBridge 161:aa5281ff4a02 138 * @}
AnnaBridge 161:aa5281ff4a02 139 */
AnnaBridge 161:aa5281ff4a02 140 #endif
AnnaBridge 161:aa5281ff4a02 141 /**
AnnaBridge 161:aa5281ff4a02 142 * @}
AnnaBridge 161:aa5281ff4a02 143 */
AnnaBridge 145:64910690c574 144
AnnaBridge 145:64910690c574 145 /* Private macros ------------------------------------------------------------*/
AnnaBridge 145:64910690c574 146 /** @defgroup USARTEx_Private_Macros USARTEx Private Macros
AnnaBridge 145:64910690c574 147 * @{
AnnaBridge 145:64910690c574 148 */
AnnaBridge 145:64910690c574 149
AnnaBridge 145:64910690c574 150 /** @brief Report the USART clock source.
AnnaBridge 145:64910690c574 151 * @param __HANDLE__: specifies the USART Handle.
AnnaBridge 145:64910690c574 152 * @param __CLOCKSOURCE__: output variable.
AnnaBridge 145:64910690c574 153 * @retval the USART clocking source, written in __CLOCKSOURCE__.
AnnaBridge 145:64910690c574 154 */
AnnaBridge 145:64910690c574 155 #if defined (STM32L432xx) || defined (STM32L442xx)
AnnaBridge 145:64910690c574 156 #define USART_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
AnnaBridge 145:64910690c574 157 do { \
AnnaBridge 145:64910690c574 158 if((__HANDLE__)->Instance == USART1) \
AnnaBridge 145:64910690c574 159 { \
AnnaBridge 145:64910690c574 160 switch(__HAL_RCC_GET_USART1_SOURCE()) \
AnnaBridge 145:64910690c574 161 { \
AnnaBridge 145:64910690c574 162 case RCC_USART1CLKSOURCE_PCLK2: \
AnnaBridge 145:64910690c574 163 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK2; \
AnnaBridge 145:64910690c574 164 break; \
AnnaBridge 145:64910690c574 165 case RCC_USART1CLKSOURCE_HSI: \
AnnaBridge 145:64910690c574 166 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
AnnaBridge 145:64910690c574 167 break; \
AnnaBridge 145:64910690c574 168 case RCC_USART1CLKSOURCE_SYSCLK: \
AnnaBridge 145:64910690c574 169 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 145:64910690c574 170 break; \
AnnaBridge 145:64910690c574 171 case RCC_USART1CLKSOURCE_LSE: \
AnnaBridge 145:64910690c574 172 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
AnnaBridge 145:64910690c574 173 break; \
AnnaBridge 145:64910690c574 174 default: \
AnnaBridge 145:64910690c574 175 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 145:64910690c574 176 break; \
AnnaBridge 145:64910690c574 177 } \
AnnaBridge 145:64910690c574 178 } \
AnnaBridge 145:64910690c574 179 else if((__HANDLE__)->Instance == USART2) \
AnnaBridge 145:64910690c574 180 { \
AnnaBridge 145:64910690c574 181 switch(__HAL_RCC_GET_USART2_SOURCE()) \
AnnaBridge 145:64910690c574 182 { \
AnnaBridge 145:64910690c574 183 case RCC_USART2CLKSOURCE_PCLK1: \
AnnaBridge 145:64910690c574 184 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK1; \
AnnaBridge 145:64910690c574 185 break; \
AnnaBridge 145:64910690c574 186 case RCC_USART2CLKSOURCE_HSI: \
AnnaBridge 145:64910690c574 187 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
AnnaBridge 145:64910690c574 188 break; \
AnnaBridge 145:64910690c574 189 case RCC_USART2CLKSOURCE_SYSCLK: \
AnnaBridge 145:64910690c574 190 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 145:64910690c574 191 break; \
AnnaBridge 145:64910690c574 192 case RCC_USART2CLKSOURCE_LSE: \
AnnaBridge 145:64910690c574 193 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
AnnaBridge 145:64910690c574 194 break; \
AnnaBridge 145:64910690c574 195 default: \
AnnaBridge 145:64910690c574 196 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 145:64910690c574 197 break; \
AnnaBridge 145:64910690c574 198 } \
AnnaBridge 145:64910690c574 199 } \
AnnaBridge 145:64910690c574 200 } while(0)
AnnaBridge 145:64910690c574 201 #else
AnnaBridge 145:64910690c574 202 #define USART_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
AnnaBridge 145:64910690c574 203 do { \
AnnaBridge 145:64910690c574 204 if((__HANDLE__)->Instance == USART1) \
AnnaBridge 145:64910690c574 205 { \
AnnaBridge 145:64910690c574 206 switch(__HAL_RCC_GET_USART1_SOURCE()) \
AnnaBridge 145:64910690c574 207 { \
AnnaBridge 145:64910690c574 208 case RCC_USART1CLKSOURCE_PCLK2: \
AnnaBridge 145:64910690c574 209 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK2; \
AnnaBridge 145:64910690c574 210 break; \
AnnaBridge 145:64910690c574 211 case RCC_USART1CLKSOURCE_HSI: \
AnnaBridge 145:64910690c574 212 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
AnnaBridge 145:64910690c574 213 break; \
AnnaBridge 145:64910690c574 214 case RCC_USART1CLKSOURCE_SYSCLK: \
AnnaBridge 145:64910690c574 215 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 145:64910690c574 216 break; \
AnnaBridge 145:64910690c574 217 case RCC_USART1CLKSOURCE_LSE: \
AnnaBridge 145:64910690c574 218 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
AnnaBridge 145:64910690c574 219 break; \
AnnaBridge 145:64910690c574 220 default: \
AnnaBridge 145:64910690c574 221 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 145:64910690c574 222 break; \
AnnaBridge 145:64910690c574 223 } \
AnnaBridge 145:64910690c574 224 } \
AnnaBridge 145:64910690c574 225 else if((__HANDLE__)->Instance == USART2) \
AnnaBridge 145:64910690c574 226 { \
AnnaBridge 145:64910690c574 227 switch(__HAL_RCC_GET_USART2_SOURCE()) \
AnnaBridge 145:64910690c574 228 { \
AnnaBridge 145:64910690c574 229 case RCC_USART2CLKSOURCE_PCLK1: \
AnnaBridge 145:64910690c574 230 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK1; \
AnnaBridge 145:64910690c574 231 break; \
AnnaBridge 145:64910690c574 232 case RCC_USART2CLKSOURCE_HSI: \
AnnaBridge 145:64910690c574 233 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
AnnaBridge 145:64910690c574 234 break; \
AnnaBridge 145:64910690c574 235 case RCC_USART2CLKSOURCE_SYSCLK: \
AnnaBridge 145:64910690c574 236 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 145:64910690c574 237 break; \
AnnaBridge 145:64910690c574 238 case RCC_USART2CLKSOURCE_LSE: \
AnnaBridge 145:64910690c574 239 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
AnnaBridge 145:64910690c574 240 break; \
AnnaBridge 145:64910690c574 241 default: \
AnnaBridge 145:64910690c574 242 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 145:64910690c574 243 break; \
AnnaBridge 145:64910690c574 244 } \
AnnaBridge 145:64910690c574 245 } \
AnnaBridge 145:64910690c574 246 else if((__HANDLE__)->Instance == USART3) \
AnnaBridge 145:64910690c574 247 { \
AnnaBridge 145:64910690c574 248 switch(__HAL_RCC_GET_USART3_SOURCE()) \
AnnaBridge 145:64910690c574 249 { \
AnnaBridge 145:64910690c574 250 case RCC_USART3CLKSOURCE_PCLK1: \
AnnaBridge 145:64910690c574 251 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK1; \
AnnaBridge 145:64910690c574 252 break; \
AnnaBridge 145:64910690c574 253 case RCC_USART3CLKSOURCE_HSI: \
AnnaBridge 145:64910690c574 254 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
AnnaBridge 145:64910690c574 255 break; \
AnnaBridge 145:64910690c574 256 case RCC_USART3CLKSOURCE_SYSCLK: \
AnnaBridge 145:64910690c574 257 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 145:64910690c574 258 break; \
AnnaBridge 145:64910690c574 259 case RCC_USART3CLKSOURCE_LSE: \
AnnaBridge 145:64910690c574 260 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
AnnaBridge 145:64910690c574 261 break; \
AnnaBridge 145:64910690c574 262 default: \
AnnaBridge 145:64910690c574 263 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 145:64910690c574 264 break; \
AnnaBridge 145:64910690c574 265 } \
AnnaBridge 145:64910690c574 266 } \
AnnaBridge 145:64910690c574 267 } while(0)
AnnaBridge 145:64910690c574 268 #endif /* STM32L432xx || STM32L442xx */
AnnaBridge 145:64910690c574 269
AnnaBridge 145:64910690c574 270 /** @brief Compute the USART mask to apply to retrieve the received data
AnnaBridge 145:64910690c574 271 * according to the word length and to the parity bits activation.
AnnaBridge 145:64910690c574 272 * @note If PCE = 1, the parity bit is not included in the data extracted
AnnaBridge 145:64910690c574 273 * by the reception API().
AnnaBridge 145:64910690c574 274 * This masking operation is not carried out in the case of
AnnaBridge 145:64910690c574 275 * DMA transfers.
AnnaBridge 161:aa5281ff4a02 276 * @param __HANDLE__ specifies the USART Handle.
AnnaBridge 145:64910690c574 277 * @retval None, the mask to apply to USART RDR register is stored in (__HANDLE__)->Mask field.
AnnaBridge 145:64910690c574 278 */
AnnaBridge 145:64910690c574 279 #define USART_MASK_COMPUTATION(__HANDLE__) \
AnnaBridge 145:64910690c574 280 do { \
AnnaBridge 145:64910690c574 281 if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_9B) \
AnnaBridge 145:64910690c574 282 { \
AnnaBridge 145:64910690c574 283 if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \
AnnaBridge 145:64910690c574 284 { \
AnnaBridge 145:64910690c574 285 (__HANDLE__)->Mask = 0x01FF ; \
AnnaBridge 145:64910690c574 286 } \
AnnaBridge 145:64910690c574 287 else \
AnnaBridge 145:64910690c574 288 { \
AnnaBridge 145:64910690c574 289 (__HANDLE__)->Mask = 0x00FF ; \
AnnaBridge 145:64910690c574 290 } \
AnnaBridge 145:64910690c574 291 } \
AnnaBridge 145:64910690c574 292 else if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_8B) \
AnnaBridge 145:64910690c574 293 { \
AnnaBridge 145:64910690c574 294 if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \
AnnaBridge 145:64910690c574 295 { \
AnnaBridge 145:64910690c574 296 (__HANDLE__)->Mask = 0x00FF ; \
AnnaBridge 145:64910690c574 297 } \
AnnaBridge 145:64910690c574 298 else \
AnnaBridge 145:64910690c574 299 { \
AnnaBridge 145:64910690c574 300 (__HANDLE__)->Mask = 0x007F ; \
AnnaBridge 145:64910690c574 301 } \
AnnaBridge 145:64910690c574 302 } \
AnnaBridge 145:64910690c574 303 else if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_7B) \
AnnaBridge 145:64910690c574 304 { \
AnnaBridge 145:64910690c574 305 if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \
AnnaBridge 145:64910690c574 306 { \
AnnaBridge 145:64910690c574 307 (__HANDLE__)->Mask = 0x007F ; \
AnnaBridge 145:64910690c574 308 } \
AnnaBridge 145:64910690c574 309 else \
AnnaBridge 145:64910690c574 310 { \
AnnaBridge 145:64910690c574 311 (__HANDLE__)->Mask = 0x003F ; \
AnnaBridge 145:64910690c574 312 } \
AnnaBridge 145:64910690c574 313 } \
AnnaBridge 145:64910690c574 314 } while(0)
AnnaBridge 145:64910690c574 315
AnnaBridge 145:64910690c574 316
AnnaBridge 145:64910690c574 317 /**
AnnaBridge 145:64910690c574 318 * @brief Ensure that USART frame length is valid.
AnnaBridge 161:aa5281ff4a02 319 * @param __LENGTH__ USART frame length.
AnnaBridge 145:64910690c574 320 * @retval SET (__LENGTH__ is valid) or RESET (__LENGTH__ is invalid)
AnnaBridge 145:64910690c574 321 */
AnnaBridge 145:64910690c574 322 #define IS_USART_WORD_LENGTH(__LENGTH__) (((__LENGTH__) == USART_WORDLENGTH_7B) || \
AnnaBridge 145:64910690c574 323 ((__LENGTH__) == USART_WORDLENGTH_8B) || \
AnnaBridge 145:64910690c574 324 ((__LENGTH__) == USART_WORDLENGTH_9B))
AnnaBridge 161:aa5281ff4a02 325 #if defined(USART_CR2_SLVEN)
AnnaBridge 161:aa5281ff4a02 326 /**
AnnaBridge 161:aa5281ff4a02 327 * @brief Ensure that USART Negative Slave Select (NSS) pin management is valid.
AnnaBridge 161:aa5281ff4a02 328 * @param __NSS__ USART Negative Slave Select pin management.
AnnaBridge 161:aa5281ff4a02 329 * @retval SET (__NSS__ is valid) or RESET (__NSS__ is invalid)
AnnaBridge 161:aa5281ff4a02 330 */
AnnaBridge 161:aa5281ff4a02 331 #define IS_USART_NSS(__NSS__) (((__NSS__) == USART_NSS_HARD) || \
AnnaBridge 161:aa5281ff4a02 332 ((__NSS__) == USART_NSS_SOFT))
AnnaBridge 161:aa5281ff4a02 333 #endif
AnnaBridge 161:aa5281ff4a02 334
AnnaBridge 161:aa5281ff4a02 335 #if defined(USART_CR1_FIFOEN)
AnnaBridge 161:aa5281ff4a02 336 /**
AnnaBridge 161:aa5281ff4a02 337 * @brief Ensure that USART TXFIFO threshold level is valid.
AnnaBridge 161:aa5281ff4a02 338 * @param __THRESHOLD__ USART TXFIFO threshold level.
AnnaBridge 161:aa5281ff4a02 339 * @retval SET (__THRESHOLD__ is valid) or RESET (__THRESHOLD__ is invalid)
AnnaBridge 161:aa5281ff4a02 340 */
AnnaBridge 161:aa5281ff4a02 341 #define IS_USART_TXFIFO_THRESHOLD(__THRESHOLD__) (((__THRESHOLD__) == USART_TXFIFO_THRESHOLD_1_8) || \
AnnaBridge 161:aa5281ff4a02 342 ((__THRESHOLD__) == USART_TXFIFO_THRESHOLD_1_4) || \
AnnaBridge 161:aa5281ff4a02 343 ((__THRESHOLD__) == USART_TXFIFO_THRESHOLD_1_2) || \
AnnaBridge 161:aa5281ff4a02 344 ((__THRESHOLD__) == USART_TXFIFO_THRESHOLD_3_4) || \
AnnaBridge 161:aa5281ff4a02 345 ((__THRESHOLD__) == USART_TXFIFO_THRESHOLD_7_8) || \
AnnaBridge 161:aa5281ff4a02 346 ((__THRESHOLD__) == USART_TXFIFO_THRESHOLD_8_8))
AnnaBridge 161:aa5281ff4a02 347
AnnaBridge 161:aa5281ff4a02 348 /**
AnnaBridge 161:aa5281ff4a02 349 * @brief Ensure that USART RXFIFO threshold level is valid.
AnnaBridge 161:aa5281ff4a02 350 * @param __THRESHOLD__ USART RXFIFO threshold level.
AnnaBridge 161:aa5281ff4a02 351 * @retval SET (__THRESHOLD__ is valid) or RESET (__THRESHOLD__ is invalid)
AnnaBridge 161:aa5281ff4a02 352 */
AnnaBridge 161:aa5281ff4a02 353 #define IS_USART_RXFIFO_THRESHOLD(__THRESHOLD__) (((__THRESHOLD__) == USART_RXFIFO_THRESHOLD_1_8) || \
AnnaBridge 161:aa5281ff4a02 354 ((__THRESHOLD__) == USART_RXFIFO_THRESHOLD_1_4) || \
AnnaBridge 161:aa5281ff4a02 355 ((__THRESHOLD__) == USART_RXFIFO_THRESHOLD_1_2) || \
AnnaBridge 161:aa5281ff4a02 356 ((__THRESHOLD__) == USART_RXFIFO_THRESHOLD_3_4) || \
AnnaBridge 161:aa5281ff4a02 357 ((__THRESHOLD__) == USART_RXFIFO_THRESHOLD_7_8) || \
AnnaBridge 161:aa5281ff4a02 358 ((__THRESHOLD__) == USART_RXFIFO_THRESHOLD_8_8))
AnnaBridge 161:aa5281ff4a02 359 #endif
AnnaBridge 145:64910690c574 360
AnnaBridge 145:64910690c574 361 /**
AnnaBridge 145:64910690c574 362 * @}
AnnaBridge 145:64910690c574 363 */
AnnaBridge 145:64910690c574 364
AnnaBridge 145:64910690c574 365 /* Exported functions --------------------------------------------------------*/
AnnaBridge 161:aa5281ff4a02 366 /** @addtogroup USARTEx_Exported_Functions
AnnaBridge 161:aa5281ff4a02 367 * @{
AnnaBridge 161:aa5281ff4a02 368 */
AnnaBridge 161:aa5281ff4a02 369
AnnaBridge 161:aa5281ff4a02 370 /** @addtogroup USARTEx_Exported_Functions_Group2
AnnaBridge 161:aa5281ff4a02 371 * @{
AnnaBridge 161:aa5281ff4a02 372 */
AnnaBridge 161:aa5281ff4a02 373
AnnaBridge 161:aa5281ff4a02 374 /* IO operation functions *****************************************************/
AnnaBridge 161:aa5281ff4a02 375 #if defined(USART_CR1_FIFOEN)
AnnaBridge 161:aa5281ff4a02 376 void HAL_USARTEx_RxFifoFullCallback(USART_HandleTypeDef *husart);
AnnaBridge 161:aa5281ff4a02 377 void HAL_USARTEx_TxFifoEmptyCallback(USART_HandleTypeDef *husart);
AnnaBridge 161:aa5281ff4a02 378 #endif
AnnaBridge 161:aa5281ff4a02 379
AnnaBridge 161:aa5281ff4a02 380 /**
AnnaBridge 161:aa5281ff4a02 381 * @}
AnnaBridge 161:aa5281ff4a02 382 */
AnnaBridge 161:aa5281ff4a02 383
AnnaBridge 161:aa5281ff4a02 384 /** @addtogroup USARTEx_Exported_Functions_Group3
AnnaBridge 161:aa5281ff4a02 385 * @{
AnnaBridge 161:aa5281ff4a02 386 */
AnnaBridge 161:aa5281ff4a02 387
AnnaBridge 161:aa5281ff4a02 388 /* Peripheral Control functions ***********************************************/
AnnaBridge 161:aa5281ff4a02 389 #if defined(USART_CR2_SLVEN)
AnnaBridge 161:aa5281ff4a02 390 HAL_StatusTypeDef HAL_USARTEx_EnableSlaveMode(USART_HandleTypeDef *husart);
AnnaBridge 161:aa5281ff4a02 391 HAL_StatusTypeDef HAL_USARTEx_DisableSlaveMode(USART_HandleTypeDef *husart);
AnnaBridge 161:aa5281ff4a02 392 HAL_StatusTypeDef HAL_USARTEx_ConfigNSS(USART_HandleTypeDef *husart, uint32_t NSSConfig);
AnnaBridge 161:aa5281ff4a02 393 #endif
AnnaBridge 161:aa5281ff4a02 394
AnnaBridge 161:aa5281ff4a02 395 #if defined(USART_CR1_FIFOEN)
AnnaBridge 161:aa5281ff4a02 396 HAL_StatusTypeDef HAL_USARTEx_EnableFifoMode(USART_HandleTypeDef *husart);
AnnaBridge 161:aa5281ff4a02 397 HAL_StatusTypeDef HAL_USARTEx_DisableFifoMode(USART_HandleTypeDef *husart);
AnnaBridge 161:aa5281ff4a02 398 HAL_StatusTypeDef HAL_USARTEx_SetTxFifoThreshold(USART_HandleTypeDef *husart, uint32_t Threshold);
AnnaBridge 161:aa5281ff4a02 399 HAL_StatusTypeDef HAL_USARTEx_SetRxFifoThreshold(USART_HandleTypeDef *husart, uint32_t Threshold);
AnnaBridge 161:aa5281ff4a02 400 #endif
AnnaBridge 161:aa5281ff4a02 401
AnnaBridge 161:aa5281ff4a02 402 /**
AnnaBridge 161:aa5281ff4a02 403 * @}
AnnaBridge 161:aa5281ff4a02 404 */
AnnaBridge 161:aa5281ff4a02 405
AnnaBridge 161:aa5281ff4a02 406 /**
AnnaBridge 161:aa5281ff4a02 407 * @}
AnnaBridge 161:aa5281ff4a02 408 */
AnnaBridge 145:64910690c574 409
AnnaBridge 145:64910690c574 410 /**
AnnaBridge 145:64910690c574 411 * @}
AnnaBridge 145:64910690c574 412 */
AnnaBridge 145:64910690c574 413
AnnaBridge 145:64910690c574 414 /**
AnnaBridge 145:64910690c574 415 * @}
AnnaBridge 145:64910690c574 416 */
AnnaBridge 145:64910690c574 417
AnnaBridge 145:64910690c574 418 #ifdef __cplusplus
AnnaBridge 145:64910690c574 419 }
AnnaBridge 145:64910690c574 420 #endif
AnnaBridge 145:64910690c574 421
AnnaBridge 145:64910690c574 422 #endif /* __STM32L4xx_HAL_USART_EX_H */
AnnaBridge 145:64910690c574 423
AnnaBridge 145:64910690c574 424 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/