mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

cmsis/BUILD/mbed/TARGET_DISCO_L072CZ_LRWAN1/TOOLCHAIN_IAR/stm32l0xx_hal_uart_ex.h@189:f392fc9709a3, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 22:31:08 2019 +0000
Revision:
189:f392fc9709a3
mbed library release version 165

Who changed what in which revision?

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