mbed official / mbed

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.

TARGET_NUCLEO_L011K4/TOOLCHAIN_ARM_MICRO/stm32l0xx_hal_uart_ex.h@171:3a7713b1edbc, 2018-11-08 (annotated)

Committer:
AnnaBridge
Date:
Thu Nov 08 11:45:42 2018 +0000
Revision:
171:3a7713b1edbc
Parent:
TARGET_NUCLEO_L011K4/TARGET_STM/TARGET_STM32L0/device/stm32l0xx_hal_uart_ex.h@167:84c0a372a020 
mbed library. Release version 164

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 157:e7ca05fa8600 1 /**
AnnaBridge 157:e7ca05fa8600 2 ******************************************************************************
AnnaBridge 157:e7ca05fa8600 3 * @file stm32l0xx_hal_uart_ex.h
AnnaBridge 157:e7ca05fa8600 4 * @author MCD Application Team
AnnaBridge 167:84c0a372a020 5 * @brief Header file of UART HAL Extended module.
AnnaBridge 157:e7ca05fa8600 6 ******************************************************************************
AnnaBridge 157:e7ca05fa8600 7 * @attention
AnnaBridge 157:e7ca05fa8600 8 *
AnnaBridge 157:e7ca05fa8600 9 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
AnnaBridge 157:e7ca05fa8600 10 *
AnnaBridge 157:e7ca05fa8600 11 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 157:e7ca05fa8600 12 * are permitted provided that the following conditions are met:
AnnaBridge 157:e7ca05fa8600 13 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 157:e7ca05fa8600 14 * this list of conditions and the following disclaimer.
AnnaBridge 157:e7ca05fa8600 15 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 157:e7ca05fa8600 16 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 157:e7ca05fa8600 17 * and/or other materials provided with the distribution.
AnnaBridge 157:e7ca05fa8600 18 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 157:e7ca05fa8600 19 * may be used to endorse or promote products derived from this software
AnnaBridge 157:e7ca05fa8600 20 * without specific prior written permission.
AnnaBridge 157:e7ca05fa8600 21 *
AnnaBridge 157:e7ca05fa8600 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 157:e7ca05fa8600 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 157:e7ca05fa8600 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 157:e7ca05fa8600 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 157:e7ca05fa8600 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 157:e7ca05fa8600 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 157:e7ca05fa8600 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 157:e7ca05fa8600 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 157:e7ca05fa8600 30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 157:e7ca05fa8600 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 157:e7ca05fa8600 32 *
AnnaBridge 167:84c0a372a020 33 ******************************************************************************
AnnaBridge 167:84c0a372a020 34 */
AnnaBridge 157:e7ca05fa8600 35
AnnaBridge 157:e7ca05fa8600 36 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 157:e7ca05fa8600 37 #ifndef __STM32L0xx_HAL_UART_EX_H
AnnaBridge 157:e7ca05fa8600 38 #define __STM32L0xx_HAL_UART_EX_H
AnnaBridge 157:e7ca05fa8600 39
AnnaBridge 157:e7ca05fa8600 40 #ifdef __cplusplus
AnnaBridge 157:e7ca05fa8600 41 extern "C" {
AnnaBridge 157:e7ca05fa8600 42 #endif
AnnaBridge 157:e7ca05fa8600 43
AnnaBridge 157:e7ca05fa8600 44 /* Includes ------------------------------------------------------------------*/
AnnaBridge 157:e7ca05fa8600 45 #include "stm32l0xx_hal_def.h"
AnnaBridge 157:e7ca05fa8600 46
AnnaBridge 157:e7ca05fa8600 47 /** @addtogroup STM32L0xx_HAL_Driver
AnnaBridge 157:e7ca05fa8600 48 * @{
AnnaBridge 157:e7ca05fa8600 49 */
AnnaBridge 157:e7ca05fa8600 50
AnnaBridge 167:84c0a372a020 51 /** @addtogroup UARTEx
AnnaBridge 157:e7ca05fa8600 52 * @{
AnnaBridge 157:e7ca05fa8600 53 */
AnnaBridge 157:e7ca05fa8600 54
AnnaBridge 157:e7ca05fa8600 55 /* Exported types ------------------------------------------------------------*/
AnnaBridge 167:84c0a372a020 56 /** @defgroup UARTEx_Exported_Types UARTEx Exported Types
AnnaBridge 157:e7ca05fa8600 57 * @{
AnnaBridge 157:e7ca05fa8600 58 */
AnnaBridge 157:e7ca05fa8600 59
AnnaBridge 167:84c0a372a020 60 /**
AnnaBridge 157:e7ca05fa8600 61 * @brief UART wake up from stop mode parameters
AnnaBridge 157:e7ca05fa8600 62 */
AnnaBridge 157:e7ca05fa8600 63 typedef struct
AnnaBridge 157:e7ca05fa8600 64 {
AnnaBridge 157:e7ca05fa8600 65 uint32_t WakeUpEvent; /*!< Specifies which event will activat the Wakeup from Stop mode flag (WUF).
AnnaBridge 157:e7ca05fa8600 66 This parameter can be a value of @ref UART_WakeUp_from_Stop_Selection.
AnnaBridge 157:e7ca05fa8600 67 If set to UART_WAKEUP_ON_ADDRESS, the two other fields below must
AnnaBridge 157:e7ca05fa8600 68 be filled up. */
AnnaBridge 167:84c0a372a020 69
AnnaBridge 157:e7ca05fa8600 70 uint16_t AddressLength; /*!< Specifies whether the address is 4 or 7-bit long.
AnnaBridge 167:84c0a372a020 71 This parameter can be a value of @ref UARTEx_WakeUp_Address_Length. */
AnnaBridge 157:e7ca05fa8600 72
AnnaBridge 167:84c0a372a020 73 uint8_t Address; /*!< UART/USART node address (7-bit long max). */
AnnaBridge 157:e7ca05fa8600 74 } UART_WakeUpTypeDef;
AnnaBridge 157:e7ca05fa8600 75
AnnaBridge 157:e7ca05fa8600 76 /**
AnnaBridge 157:e7ca05fa8600 77 * @}
AnnaBridge 157:e7ca05fa8600 78 */
AnnaBridge 157:e7ca05fa8600 79
AnnaBridge 157:e7ca05fa8600 80 /* Exported constants --------------------------------------------------------*/
AnnaBridge 167:84c0a372a020 81 /** @defgroup UARTEx_Exported_Constants UARTEx Exported Constants
AnnaBridge 157:e7ca05fa8600 82 * @{
AnnaBridge 157:e7ca05fa8600 83 */
AnnaBridge 167:84c0a372a020 84
AnnaBridge 167:84c0a372a020 85 /** @defgroup UARTEx_Word_Length UART Word Length
AnnaBridge 157:e7ca05fa8600 86 * @{
AnnaBridge 157:e7ca05fa8600 87 */
AnnaBridge 167:84c0a372a020 88 #define UART_WORDLENGTH_7B ((uint32_t)USART_CR1_M1) /*!< 7-bit long UART frame */
AnnaBridge 167:84c0a372a020 89 #define UART_WORDLENGTH_8B ((uint32_t)0x00000000U) /*!< 8-bit long UART frame */
AnnaBridge 167:84c0a372a020 90 #define UART_WORDLENGTH_9B ((uint32_t)USART_CR1_M0) /*!< 9-bit long UART frame */
AnnaBridge 167:84c0a372a020 91 /**
AnnaBridge 167:84c0a372a020 92 * @}
AnnaBridge 167:84c0a372a020 93 */
AnnaBridge 167:84c0a372a020 94
AnnaBridge 167:84c0a372a020 95 /** @defgroup UARTEx_WakeUp_Address_Length UART Extended WakeUp Address Length
AnnaBridge 167:84c0a372a020 96 * @{
AnnaBridge 167:84c0a372a020 97 */
AnnaBridge 167:84c0a372a020 98 #define UART_ADDRESS_DETECT_4B ((uint32_t)0x00000000U) /*!< 4-bit long wake-up address */
AnnaBridge 167:84c0a372a020 99 #define UART_ADDRESS_DETECT_7B ((uint32_t)USART_CR2_ADDM7) /*!< 7-bit long wake-up address */
AnnaBridge 167:84c0a372a020 100 /**
AnnaBridge 167:84c0a372a020 101 * @}
AnnaBridge 167:84c0a372a020 102 */
AnnaBridge 167:84c0a372a020 103
AnnaBridge 157:e7ca05fa8600 104 /**
AnnaBridge 157:e7ca05fa8600 105 * @}
AnnaBridge 157:e7ca05fa8600 106 */
AnnaBridge 157:e7ca05fa8600 107
AnnaBridge 167:84c0a372a020 108 /* Exported macros -----------------------------------------------------------*/
AnnaBridge 167:84c0a372a020 109 /* Exported functions --------------------------------------------------------*/
AnnaBridge 167:84c0a372a020 110 /** @addtogroup UARTEx_Exported_Functions
AnnaBridge 157:e7ca05fa8600 111 * @{
AnnaBridge 157:e7ca05fa8600 112 */
AnnaBridge 167:84c0a372a020 113
AnnaBridge 167:84c0a372a020 114 /** @addtogroup UARTEx_Exported_Functions_Group1
AnnaBridge 157:e7ca05fa8600 115 * @{
AnnaBridge 157:e7ca05fa8600 116 */
AnnaBridge 157:e7ca05fa8600 117
AnnaBridge 167:84c0a372a020 118 /* Initialization and de-initialization functions ****************************/
AnnaBridge 167:84c0a372a020 119 HAL_StatusTypeDef HAL_RS485Ex_Init(UART_HandleTypeDef *huart, uint32_t Polarity, uint32_t AssertionTime, uint32_t DeassertionTime);
AnnaBridge 167:84c0a372a020 120
AnnaBridge 157:e7ca05fa8600 121 /**
AnnaBridge 157:e7ca05fa8600 122 * @}
AnnaBridge 157:e7ca05fa8600 123 */
AnnaBridge 167:84c0a372a020 124
AnnaBridge 167:84c0a372a020 125 /* IO operation functions *****************************************************/
AnnaBridge 167:84c0a372a020 126
AnnaBridge 167:84c0a372a020 127 /** @addtogroup UARTEx_Exported_Functions_Group3
AnnaBridge 167:84c0a372a020 128 * @{
AnnaBridge 167:84c0a372a020 129 */
AnnaBridge 167:84c0a372a020 130
AnnaBridge 167:84c0a372a020 131 /* Peripheral Control functions **********************************************/
AnnaBridge 167:84c0a372a020 132 HAL_StatusTypeDef HAL_UARTEx_StopModeWakeUpSourceConfig(UART_HandleTypeDef *huart, UART_WakeUpTypeDef WakeUpSelection);
AnnaBridge 167:84c0a372a020 133 HAL_StatusTypeDef HAL_UARTEx_EnableStopMode(UART_HandleTypeDef *huart);
AnnaBridge 167:84c0a372a020 134 HAL_StatusTypeDef HAL_UARTEx_DisableStopMode(UART_HandleTypeDef *huart);
AnnaBridge 167:84c0a372a020 135 HAL_StatusTypeDef HAL_MultiProcessorEx_AddressLength_Set(UART_HandleTypeDef *huart, uint32_t AddressLength);
AnnaBridge 167:84c0a372a020 136 HAL_StatusTypeDef HAL_UARTEx_EnableClockStopMode(UART_HandleTypeDef *huart);
AnnaBridge 167:84c0a372a020 137 HAL_StatusTypeDef HAL_UARTEx_DisableClockStopMode(UART_HandleTypeDef *huart);
AnnaBridge 167:84c0a372a020 138 void HAL_UARTEx_WakeupCallback(UART_HandleTypeDef *huart);
AnnaBridge 167:84c0a372a020 139
AnnaBridge 157:e7ca05fa8600 140 /**
AnnaBridge 157:e7ca05fa8600 141 * @}
AnnaBridge 167:84c0a372a020 142 */
AnnaBridge 157:e7ca05fa8600 143
AnnaBridge 167:84c0a372a020 144 /**
AnnaBridge 167:84c0a372a020 145 * @}
AnnaBridge 167:84c0a372a020 146 */
AnnaBridge 167:84c0a372a020 147
AnnaBridge 167:84c0a372a020 148 /* Private macros ------------------------------------------------------------*/
AnnaBridge 167:84c0a372a020 149 /** @defgroup UARTEx_Private_Macros UARTEx Private Macros
AnnaBridge 157:e7ca05fa8600 150 * @{
AnnaBridge 157:e7ca05fa8600 151 */
AnnaBridge 167:84c0a372a020 152
AnnaBridge 167:84c0a372a020 153 /** @brief Report the UART clock source.
AnnaBridge 167:84c0a372a020 154 * @param __HANDLE__: specifies the UART Handle.
AnnaBridge 167:84c0a372a020 155 * @param __CLOCKSOURCE__: output variable.
AnnaBridge 157:e7ca05fa8600 156 * @retval UART clocking source, written in __CLOCKSOURCE__.
AnnaBridge 157:e7ca05fa8600 157 */
AnnaBridge 157:e7ca05fa8600 158 #if defined (STM32L031xx) || defined (STM32L041xx) || defined (STM32L011xx) || defined (STM32L021xx)
AnnaBridge 157:e7ca05fa8600 159 #define UART_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
AnnaBridge 157:e7ca05fa8600 160 do { \
AnnaBridge 157:e7ca05fa8600 161 if((__HANDLE__)->Instance == USART2) \
AnnaBridge 157:e7ca05fa8600 162 { \
AnnaBridge 157:e7ca05fa8600 163 switch(__HAL_RCC_GET_USART2_SOURCE()) \
AnnaBridge 157:e7ca05fa8600 164 { \
AnnaBridge 157:e7ca05fa8600 165 case RCC_USART2CLKSOURCE_PCLK1: \
AnnaBridge 157:e7ca05fa8600 166 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_PCLK1; \
AnnaBridge 157:e7ca05fa8600 167 break; \
AnnaBridge 157:e7ca05fa8600 168 case RCC_USART2CLKSOURCE_HSI: \
AnnaBridge 157:e7ca05fa8600 169 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_HSI; \
AnnaBridge 157:e7ca05fa8600 170 break; \
AnnaBridge 157:e7ca05fa8600 171 case RCC_USART2CLKSOURCE_SYSCLK: \
AnnaBridge 157:e7ca05fa8600 172 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 157:e7ca05fa8600 173 break; \
AnnaBridge 157:e7ca05fa8600 174 case RCC_USART2CLKSOURCE_LSE: \
AnnaBridge 157:e7ca05fa8600 175 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_LSE; \
AnnaBridge 157:e7ca05fa8600 176 break; \
AnnaBridge 157:e7ca05fa8600 177 default: \
AnnaBridge 167:84c0a372a020 178 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 157:e7ca05fa8600 179 break; \
AnnaBridge 157:e7ca05fa8600 180 } \
AnnaBridge 157:e7ca05fa8600 181 } \
AnnaBridge 157:e7ca05fa8600 182 else if((__HANDLE__)->Instance == LPUART1) \
AnnaBridge 157:e7ca05fa8600 183 { \
AnnaBridge 157:e7ca05fa8600 184 switch(__HAL_RCC_GET_LPUART1_SOURCE()) \
AnnaBridge 157:e7ca05fa8600 185 { \
AnnaBridge 157:e7ca05fa8600 186 case RCC_LPUART1CLKSOURCE_PCLK1: \
AnnaBridge 157:e7ca05fa8600 187 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_PCLK1; \
AnnaBridge 157:e7ca05fa8600 188 break; \
AnnaBridge 157:e7ca05fa8600 189 case RCC_LPUART1CLKSOURCE_HSI: \
AnnaBridge 157:e7ca05fa8600 190 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_HSI; \
AnnaBridge 157:e7ca05fa8600 191 break; \
AnnaBridge 157:e7ca05fa8600 192 case RCC_LPUART1CLKSOURCE_SYSCLK: \
AnnaBridge 157:e7ca05fa8600 193 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 157:e7ca05fa8600 194 break; \
AnnaBridge 157:e7ca05fa8600 195 case RCC_LPUART1CLKSOURCE_LSE: \
AnnaBridge 157:e7ca05fa8600 196 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_LSE; \
AnnaBridge 157:e7ca05fa8600 197 break; \
AnnaBridge 157:e7ca05fa8600 198 default: \
AnnaBridge 167:84c0a372a020 199 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 157:e7ca05fa8600 200 break; \
AnnaBridge 157:e7ca05fa8600 201 } \
AnnaBridge 157:e7ca05fa8600 202 } \
AnnaBridge 157:e7ca05fa8600 203 } while(0)
AnnaBridge 157:e7ca05fa8600 204
AnnaBridge 167:84c0a372a020 205 #elif defined (STM32L051xx) || defined (STM32L052xx) || defined (STM32L053xx) || defined (STM32L061xx) || defined (STM32L062xx) || defined (STM32L063xx)
AnnaBridge 157:e7ca05fa8600 206
AnnaBridge 157:e7ca05fa8600 207 #define UART_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
AnnaBridge 157:e7ca05fa8600 208 do { \
AnnaBridge 157:e7ca05fa8600 209 if((__HANDLE__)->Instance == USART1) \
AnnaBridge 157:e7ca05fa8600 210 { \
AnnaBridge 157:e7ca05fa8600 211 switch(__HAL_RCC_GET_USART1_SOURCE()) \
AnnaBridge 157:e7ca05fa8600 212 { \
AnnaBridge 157:e7ca05fa8600 213 case RCC_USART1CLKSOURCE_PCLK2: \
AnnaBridge 157:e7ca05fa8600 214 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_PCLK2; \
AnnaBridge 157:e7ca05fa8600 215 break; \
AnnaBridge 157:e7ca05fa8600 216 case RCC_USART1CLKSOURCE_HSI: \
AnnaBridge 157:e7ca05fa8600 217 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_HSI; \
AnnaBridge 157:e7ca05fa8600 218 break; \
AnnaBridge 157:e7ca05fa8600 219 case RCC_USART1CLKSOURCE_SYSCLK: \
AnnaBridge 157:e7ca05fa8600 220 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 157:e7ca05fa8600 221 break; \
AnnaBridge 157:e7ca05fa8600 222 case RCC_USART1CLKSOURCE_LSE: \
AnnaBridge 157:e7ca05fa8600 223 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_LSE; \
AnnaBridge 157:e7ca05fa8600 224 break; \
AnnaBridge 157:e7ca05fa8600 225 default: \
AnnaBridge 167:84c0a372a020 226 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 157:e7ca05fa8600 227 break; \
AnnaBridge 157:e7ca05fa8600 228 } \
AnnaBridge 157:e7ca05fa8600 229 } \
AnnaBridge 157:e7ca05fa8600 230 else if((__HANDLE__)->Instance == USART2) \
AnnaBridge 157:e7ca05fa8600 231 { \
AnnaBridge 157:e7ca05fa8600 232 switch(__HAL_RCC_GET_USART2_SOURCE()) \
AnnaBridge 157:e7ca05fa8600 233 { \
AnnaBridge 157:e7ca05fa8600 234 case RCC_USART2CLKSOURCE_PCLK1: \
AnnaBridge 157:e7ca05fa8600 235 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_PCLK1; \
AnnaBridge 157:e7ca05fa8600 236 break; \
AnnaBridge 157:e7ca05fa8600 237 case RCC_USART2CLKSOURCE_HSI: \
AnnaBridge 157:e7ca05fa8600 238 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_HSI; \
AnnaBridge 157:e7ca05fa8600 239 break; \
AnnaBridge 157:e7ca05fa8600 240 case RCC_USART2CLKSOURCE_SYSCLK: \
AnnaBridge 157:e7ca05fa8600 241 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 157:e7ca05fa8600 242 break; \
AnnaBridge 157:e7ca05fa8600 243 case RCC_USART2CLKSOURCE_LSE: \
AnnaBridge 157:e7ca05fa8600 244 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_LSE; \
AnnaBridge 157:e7ca05fa8600 245 break; \
AnnaBridge 157:e7ca05fa8600 246 default: \
AnnaBridge 167:84c0a372a020 247 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 157:e7ca05fa8600 248 break; \
AnnaBridge 157:e7ca05fa8600 249 } \
AnnaBridge 157:e7ca05fa8600 250 } \
AnnaBridge 157:e7ca05fa8600 251 else if((__HANDLE__)->Instance == LPUART1) \
AnnaBridge 157:e7ca05fa8600 252 { \
AnnaBridge 157:e7ca05fa8600 253 switch(__HAL_RCC_GET_LPUART1_SOURCE()) \
AnnaBridge 157:e7ca05fa8600 254 { \
AnnaBridge 157:e7ca05fa8600 255 case RCC_LPUART1CLKSOURCE_PCLK1: \
AnnaBridge 157:e7ca05fa8600 256 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_PCLK1; \
AnnaBridge 157:e7ca05fa8600 257 break; \
AnnaBridge 157:e7ca05fa8600 258 case RCC_LPUART1CLKSOURCE_HSI: \
AnnaBridge 157:e7ca05fa8600 259 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_HSI; \
AnnaBridge 157:e7ca05fa8600 260 break; \
AnnaBridge 157:e7ca05fa8600 261 case RCC_LPUART1CLKSOURCE_SYSCLK: \
AnnaBridge 157:e7ca05fa8600 262 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 157:e7ca05fa8600 263 break; \
AnnaBridge 157:e7ca05fa8600 264 case RCC_LPUART1CLKSOURCE_LSE: \
AnnaBridge 157:e7ca05fa8600 265 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_LSE; \
AnnaBridge 157:e7ca05fa8600 266 break; \
AnnaBridge 157:e7ca05fa8600 267 default: \
AnnaBridge 167:84c0a372a020 268 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 167:84c0a372a020 269 break; \
AnnaBridge 167:84c0a372a020 270 } \
AnnaBridge 167:84c0a372a020 271 } \
AnnaBridge 167:84c0a372a020 272 } while(0)
AnnaBridge 167:84c0a372a020 273
AnnaBridge 167:84c0a372a020 274 #else
AnnaBridge 167:84c0a372a020 275
AnnaBridge 167:84c0a372a020 276 #define UART_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
AnnaBridge 167:84c0a372a020 277 do { \
AnnaBridge 167:84c0a372a020 278 if((__HANDLE__)->Instance == USART1) \
AnnaBridge 167:84c0a372a020 279 { \
AnnaBridge 167:84c0a372a020 280 switch(__HAL_RCC_GET_USART1_SOURCE()) \
AnnaBridge 167:84c0a372a020 281 { \
AnnaBridge 167:84c0a372a020 282 case RCC_USART1CLKSOURCE_PCLK2: \
AnnaBridge 167:84c0a372a020 283 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_PCLK2; \
AnnaBridge 167:84c0a372a020 284 break; \
AnnaBridge 167:84c0a372a020 285 case RCC_USART1CLKSOURCE_HSI: \
AnnaBridge 167:84c0a372a020 286 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_HSI; \
AnnaBridge 167:84c0a372a020 287 break; \
AnnaBridge 167:84c0a372a020 288 case RCC_USART1CLKSOURCE_SYSCLK: \
AnnaBridge 167:84c0a372a020 289 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 167:84c0a372a020 290 break; \
AnnaBridge 167:84c0a372a020 291 case RCC_USART1CLKSOURCE_LSE: \
AnnaBridge 167:84c0a372a020 292 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_LSE; \
AnnaBridge 167:84c0a372a020 293 break; \
AnnaBridge 167:84c0a372a020 294 default: \
AnnaBridge 167:84c0a372a020 295 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 167:84c0a372a020 296 break; \
AnnaBridge 167:84c0a372a020 297 } \
AnnaBridge 167:84c0a372a020 298 } \
AnnaBridge 167:84c0a372a020 299 else if((__HANDLE__)->Instance == USART2) \
AnnaBridge 167:84c0a372a020 300 { \
AnnaBridge 167:84c0a372a020 301 switch(__HAL_RCC_GET_USART2_SOURCE()) \
AnnaBridge 167:84c0a372a020 302 { \
AnnaBridge 167:84c0a372a020 303 case RCC_USART2CLKSOURCE_PCLK1: \
AnnaBridge 167:84c0a372a020 304 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_PCLK1; \
AnnaBridge 167:84c0a372a020 305 break; \
AnnaBridge 167:84c0a372a020 306 case RCC_USART2CLKSOURCE_HSI: \
AnnaBridge 167:84c0a372a020 307 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_HSI; \
AnnaBridge 167:84c0a372a020 308 break; \
AnnaBridge 167:84c0a372a020 309 case RCC_USART2CLKSOURCE_SYSCLK: \
AnnaBridge 167:84c0a372a020 310 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 167:84c0a372a020 311 break; \
AnnaBridge 167:84c0a372a020 312 case RCC_USART2CLKSOURCE_LSE: \
AnnaBridge 167:84c0a372a020 313 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_LSE; \
AnnaBridge 167:84c0a372a020 314 break; \
AnnaBridge 167:84c0a372a020 315 default: \
AnnaBridge 167:84c0a372a020 316 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 167:84c0a372a020 317 break; \
AnnaBridge 167:84c0a372a020 318 } \
AnnaBridge 167:84c0a372a020 319 } \
AnnaBridge 167:84c0a372a020 320 else if((__HANDLE__)->Instance == USART4) \
AnnaBridge 167:84c0a372a020 321 { \
AnnaBridge 167:84c0a372a020 322 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_PCLK1; \
AnnaBridge 167:84c0a372a020 323 } \
AnnaBridge 167:84c0a372a020 324 else if((__HANDLE__)->Instance == USART5) \
AnnaBridge 167:84c0a372a020 325 { \
AnnaBridge 167:84c0a372a020 326 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_PCLK1; \
AnnaBridge 167:84c0a372a020 327 } \
AnnaBridge 167:84c0a372a020 328 else if((__HANDLE__)->Instance == LPUART1) \
AnnaBridge 167:84c0a372a020 329 { \
AnnaBridge 167:84c0a372a020 330 switch(__HAL_RCC_GET_LPUART1_SOURCE()) \
AnnaBridge 167:84c0a372a020 331 { \
AnnaBridge 167:84c0a372a020 332 case RCC_LPUART1CLKSOURCE_PCLK1: \
AnnaBridge 167:84c0a372a020 333 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_PCLK1; \
AnnaBridge 167:84c0a372a020 334 break; \
AnnaBridge 167:84c0a372a020 335 case RCC_LPUART1CLKSOURCE_HSI: \
AnnaBridge 167:84c0a372a020 336 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_HSI; \
AnnaBridge 167:84c0a372a020 337 break; \
AnnaBridge 167:84c0a372a020 338 case RCC_LPUART1CLKSOURCE_SYSCLK: \
AnnaBridge 167:84c0a372a020 339 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_SYSCLK; \
AnnaBridge 167:84c0a372a020 340 break; \
AnnaBridge 167:84c0a372a020 341 case RCC_LPUART1CLKSOURCE_LSE: \
AnnaBridge 167:84c0a372a020 342 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_LSE; \
AnnaBridge 167:84c0a372a020 343 break; \
AnnaBridge 167:84c0a372a020 344 default: \
AnnaBridge 167:84c0a372a020 345 (__CLOCKSOURCE__) = UART_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 157:e7ca05fa8600 346 break; \
AnnaBridge 157:e7ca05fa8600 347 } \
AnnaBridge 157:e7ca05fa8600 348 } \
AnnaBridge 157:e7ca05fa8600 349 } while(0)
AnnaBridge 157:e7ca05fa8600 350 #endif /* (STM32L031xx) || (STM32L041xx) || (STM32L011xx) || defined (STM32L021xx) */
AnnaBridge 157:e7ca05fa8600 351
AnnaBridge 167:84c0a372a020 352 /** @brief Report the UART mask to apply to retrieve the received data
AnnaBridge 157:e7ca05fa8600 353 * according to the word length and to the parity bits activation.
AnnaBridge 167:84c0a372a020 354 * @note If PCE = 1, the parity bit is not included in the data extracted
AnnaBridge 157:e7ca05fa8600 355 * by the reception API().
AnnaBridge 157:e7ca05fa8600 356 * This masking operation is not carried out in the case of
AnnaBridge 167:84c0a372a020 357 * DMA transfers.
AnnaBridge 167:84c0a372a020 358 * @param __HANDLE__: specifies the UART Handle.
AnnaBridge 167:84c0a372a020 359 * @retval None, the mask to apply to UART RDR register is stored in (__HANDLE__)->Mask field.
AnnaBridge 157:e7ca05fa8600 360 */
AnnaBridge 157:e7ca05fa8600 361 #define UART_MASK_COMPUTATION(__HANDLE__) \
AnnaBridge 157:e7ca05fa8600 362 do { \
AnnaBridge 157:e7ca05fa8600 363 if ((__HANDLE__)->Init.WordLength == UART_WORDLENGTH_9B) \
AnnaBridge 157:e7ca05fa8600 364 { \
AnnaBridge 157:e7ca05fa8600 365 if ((__HANDLE__)->Init.Parity == UART_PARITY_NONE) \
AnnaBridge 157:e7ca05fa8600 366 { \
AnnaBridge 157:e7ca05fa8600 367 (__HANDLE__)->Mask = 0x01FF ; \
AnnaBridge 157:e7ca05fa8600 368 } \
AnnaBridge 157:e7ca05fa8600 369 else \
AnnaBridge 157:e7ca05fa8600 370 { \
AnnaBridge 157:e7ca05fa8600 371 (__HANDLE__)->Mask = 0x00FF ; \
AnnaBridge 157:e7ca05fa8600 372 } \
AnnaBridge 157:e7ca05fa8600 373 } \
AnnaBridge 157:e7ca05fa8600 374 else if ((__HANDLE__)->Init.WordLength == UART_WORDLENGTH_8B) \
AnnaBridge 157:e7ca05fa8600 375 { \
AnnaBridge 157:e7ca05fa8600 376 if ((__HANDLE__)->Init.Parity == UART_PARITY_NONE) \
AnnaBridge 157:e7ca05fa8600 377 { \
AnnaBridge 157:e7ca05fa8600 378 (__HANDLE__)->Mask = 0x00FF ; \
AnnaBridge 157:e7ca05fa8600 379 } \
AnnaBridge 157:e7ca05fa8600 380 else \
AnnaBridge 157:e7ca05fa8600 381 { \
AnnaBridge 157:e7ca05fa8600 382 (__HANDLE__)->Mask = 0x007F ; \
AnnaBridge 157:e7ca05fa8600 383 } \
AnnaBridge 157:e7ca05fa8600 384 } \
AnnaBridge 157:e7ca05fa8600 385 else if ((__HANDLE__)->Init.WordLength == UART_WORDLENGTH_7B) \
AnnaBridge 157:e7ca05fa8600 386 { \
AnnaBridge 157:e7ca05fa8600 387 if ((__HANDLE__)->Init.Parity == UART_PARITY_NONE) \
AnnaBridge 157:e7ca05fa8600 388 { \
AnnaBridge 157:e7ca05fa8600 389 (__HANDLE__)->Mask = 0x007F ; \
AnnaBridge 157:e7ca05fa8600 390 } \
AnnaBridge 157:e7ca05fa8600 391 else \
AnnaBridge 157:e7ca05fa8600 392 { \
AnnaBridge 157:e7ca05fa8600 393 (__HANDLE__)->Mask = 0x003F ; \
AnnaBridge 157:e7ca05fa8600 394 } \
AnnaBridge 157:e7ca05fa8600 395 } \
AnnaBridge 157:e7ca05fa8600 396 } while(0)
AnnaBridge 157:e7ca05fa8600 397
AnnaBridge 167:84c0a372a020 398
AnnaBridge 167:84c0a372a020 399 /**
AnnaBridge 167:84c0a372a020 400 * @brief Ensure that UART frame length is valid.
AnnaBridge 167:84c0a372a020 401 * @param __LENGTH__: UART frame length.
AnnaBridge 167:84c0a372a020 402 * @retval SET (__LENGTH__ is valid) or RESET (__LENGTH__ is invalid)
AnnaBridge 167:84c0a372a020 403 */
AnnaBridge 167:84c0a372a020 404 #define IS_UART_WORD_LENGTH(__LENGTH__) (((__LENGTH__) == UART_WORDLENGTH_7B) || \
AnnaBridge 167:84c0a372a020 405 ((__LENGTH__) == UART_WORDLENGTH_8B) || \
AnnaBridge 167:84c0a372a020 406 ((__LENGTH__) == UART_WORDLENGTH_9B))
AnnaBridge 167:84c0a372a020 407
AnnaBridge 167:84c0a372a020 408 /**
AnnaBridge 167:84c0a372a020 409 * @brief Ensure that UART wake-up address length is valid.
AnnaBridge 167:84c0a372a020 410 * @param __ADDRESS__: UART wake-up address length.
AnnaBridge 167:84c0a372a020 411 * @retval SET (__ADDRESS__ is valid) or RESET (__ADDRESS__ is invalid)
AnnaBridge 167:84c0a372a020 412 */
AnnaBridge 167:84c0a372a020 413 #define IS_UART_ADDRESSLENGTH_DETECT(__ADDRESS__) (((__ADDRESS__) == UART_ADDRESS_DETECT_4B) || \
AnnaBridge 167:84c0a372a020 414 ((__ADDRESS__) == UART_ADDRESS_DETECT_7B))
AnnaBridge 167:84c0a372a020 415
AnnaBridge 157:e7ca05fa8600 416 /**
AnnaBridge 157:e7ca05fa8600 417 * @}
AnnaBridge 157:e7ca05fa8600 418 */
AnnaBridge 157:e7ca05fa8600 419
AnnaBridge 167:84c0a372a020 420 /* Private functions ---------------------------------------------------------*/
AnnaBridge 157:e7ca05fa8600 421
AnnaBridge 157:e7ca05fa8600 422 /**
AnnaBridge 157:e7ca05fa8600 423 * @}
AnnaBridge 157:e7ca05fa8600 424 */
AnnaBridge 157:e7ca05fa8600 425
AnnaBridge 157:e7ca05fa8600 426 /**
AnnaBridge 157:e7ca05fa8600 427 * @}
AnnaBridge 157:e7ca05fa8600 428 */
AnnaBridge 157:e7ca05fa8600 429
AnnaBridge 157:e7ca05fa8600 430 #ifdef __cplusplus
AnnaBridge 157:e7ca05fa8600 431 }
AnnaBridge 157:e7ca05fa8600 432 #endif
AnnaBridge 157:e7ca05fa8600 433
AnnaBridge 157:e7ca05fa8600 434 #endif /* __STM32L0xx_HAL_UART_EX_H */
AnnaBridge 157:e7ca05fa8600 435
AnnaBridge 157:e7ca05fa8600 436 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
AnnaBridge 157:e7ca05fa8600 437