mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

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

Last commit 20 Feb 2019 by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L0/stm32l0xx_hal_usart_ex.h@579:53297373a894, 2015-07-01 (annotated)

Committer:
mbed_official
Date:
Wed Jul 01 09:45:11 2015 +0100
Revision:
579:53297373a894
Parent:
489:119543c9f674 
Synchronized with git revision d5b4d2ab9c47edb4dc5776e7177b0c2263459081



Full URL: https://github.com/mbedmicro/mbed/commit/d5b4d2ab9c47edb4dc5776e7177b0c2263459081/



Initial version of drivers for SAMR21

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 376:cb4d9db17537 1 /**
mbed_official 376:cb4d9db17537 2 ******************************************************************************
mbed_official 376:cb4d9db17537 3 * @file stm32l0xx_hal_usart_ex.h
mbed_official 376:cb4d9db17537 4 * @author MCD Application Team
mbed_official 489:119543c9f674 5 * @version V1.2.0
mbed_official 489:119543c9f674 6 * @date 06-February-2015
mbed_official 376:cb4d9db17537 7 * @brief Header file of USART HAL Extension module.
mbed_official 376:cb4d9db17537 8 ******************************************************************************
mbed_official 376:cb4d9db17537 9 * @attention
mbed_official 376:cb4d9db17537 10 *
mbed_official 489:119543c9f674 11 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
mbed_official 376:cb4d9db17537 12 *
mbed_official 376:cb4d9db17537 13 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 376:cb4d9db17537 14 * are permitted provided that the following conditions are met:
mbed_official 376:cb4d9db17537 15 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 376:cb4d9db17537 16 * this list of conditions and the following disclaimer.
mbed_official 376:cb4d9db17537 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 376:cb4d9db17537 18 * this list of conditions and the following disclaimer in the documentation
mbed_official 376:cb4d9db17537 19 * and/or other materials provided with the distribution.
mbed_official 376:cb4d9db17537 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 376:cb4d9db17537 21 * may be used to endorse or promote products derived from this software
mbed_official 376:cb4d9db17537 22 * without specific prior written permission.
mbed_official 376:cb4d9db17537 23 *
mbed_official 376:cb4d9db17537 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 376:cb4d9db17537 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 376:cb4d9db17537 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 376:cb4d9db17537 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 376:cb4d9db17537 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 376:cb4d9db17537 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 376:cb4d9db17537 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 376:cb4d9db17537 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 376:cb4d9db17537 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 376:cb4d9db17537 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 376:cb4d9db17537 34 *
mbed_official 376:cb4d9db17537 35 ******************************************************************************
mbed_official 376:cb4d9db17537 36 */
mbed_official 376:cb4d9db17537 37
mbed_official 376:cb4d9db17537 38 /* Define to prevent recursive inclusion -------------------------------------*/
mbed_official 376:cb4d9db17537 39 #ifndef __STM32L0xx_HAL_USART_EX_H
mbed_official 376:cb4d9db17537 40 #define __STM32L0xx_HAL_USART_EX_H
mbed_official 376:cb4d9db17537 41
mbed_official 376:cb4d9db17537 42 #ifdef __cplusplus
mbed_official 376:cb4d9db17537 43 extern "C" {
mbed_official 376:cb4d9db17537 44 #endif
mbed_official 376:cb4d9db17537 45
mbed_official 376:cb4d9db17537 46 /* Includes ------------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 47 #include "stm32l0xx_hal_def.h"
mbed_official 376:cb4d9db17537 48
mbed_official 376:cb4d9db17537 49 /** @addtogroup STM32L0xx_HAL_Driver
mbed_official 376:cb4d9db17537 50 * @{
mbed_official 376:cb4d9db17537 51 */
mbed_official 489:119543c9f674 52 /** @defgroup USARTEx USARTEx Extended USART
mbed_official 376:cb4d9db17537 53 * @{
mbed_official 489:119543c9f674 54 */
mbed_official 376:cb4d9db17537 55
mbed_official 376:cb4d9db17537 56 /* Exported types ------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 57 /* Exported constants --------------------------------------------------------*/
mbed_official 489:119543c9f674 58 /** @defgroup USARTEx_Exported_Constants USARTEx Exported Constants
mbed_official 376:cb4d9db17537 59 * @{
mbed_official 376:cb4d9db17537 60 */
mbed_official 376:cb4d9db17537 61
mbed_official 489:119543c9f674 62 /** @defgroup USARTEx_Word_Length Word length definition
mbed_official 376:cb4d9db17537 63 * @{
mbed_official 376:cb4d9db17537 64 */
mbed_official 376:cb4d9db17537 65 #define USART_WORDLENGTH_7B ((uint32_t)USART_CR1_M_1)
mbed_official 376:cb4d9db17537 66 #define USART_WORDLENGTH_8B ((uint32_t)0x00000000)
mbed_official 376:cb4d9db17537 67 #define USART_WORDLENGTH_9B ((uint32_t)USART_CR1_M_0)
mbed_official 376:cb4d9db17537 68 #define IS_USART_WORD_LENGTH(LENGTH) (((LENGTH) == USART_WORDLENGTH_7B) || \
mbed_official 376:cb4d9db17537 69 ((LENGTH) == USART_WORDLENGTH_8B) || \
mbed_official 376:cb4d9db17537 70 ((LENGTH) == USART_WORDLENGTH_9B))
mbed_official 376:cb4d9db17537 71 /**
mbed_official 376:cb4d9db17537 72 * @}
mbed_official 376:cb4d9db17537 73 */
mbed_official 376:cb4d9db17537 74
mbed_official 376:cb4d9db17537 75 /**
mbed_official 376:cb4d9db17537 76 * @}
mbed_official 376:cb4d9db17537 77 */
mbed_official 376:cb4d9db17537 78 /* Exported macro ------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 79
mbed_official 489:119543c9f674 80 /** @defgroup USARTEx_Extended_Exported_Macros USARTEx Exported Macros
mbed_official 376:cb4d9db17537 81 * @{
mbed_official 376:cb4d9db17537 82 */
mbed_official 376:cb4d9db17537 83
mbed_official 376:cb4d9db17537 84 /** @brief Reports the USART clock source.
mbed_official 376:cb4d9db17537 85 * @param __HANDLE__: specifies the USART Handle
mbed_official 376:cb4d9db17537 86 * @param __CLOCKSOURCE__ : output variable
mbed_official 376:cb4d9db17537 87 * @retval the USART clocking source, written in __CLOCKSOURCE__.
mbed_official 376:cb4d9db17537 88 */
mbed_official 489:119543c9f674 89 #if defined (STM32L031xx) || defined (STM32L041xx)
mbed_official 489:119543c9f674 90 #define USART_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
mbed_official 489:119543c9f674 91 do { \
mbed_official 489:119543c9f674 92 if((__HANDLE__)->Instance == USART2) \
mbed_official 489:119543c9f674 93 { \
mbed_official 489:119543c9f674 94 switch(__HAL_RCC_GET_USART2_SOURCE()) \
mbed_official 489:119543c9f674 95 { \
mbed_official 489:119543c9f674 96 case RCC_USART2CLKSOURCE_PCLK1: \
mbed_official 489:119543c9f674 97 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK1; \
mbed_official 489:119543c9f674 98 break; \
mbed_official 489:119543c9f674 99 case RCC_USART2CLKSOURCE_HSI: \
mbed_official 489:119543c9f674 100 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
mbed_official 489:119543c9f674 101 break; \
mbed_official 489:119543c9f674 102 case RCC_USART2CLKSOURCE_SYSCLK: \
mbed_official 489:119543c9f674 103 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
mbed_official 489:119543c9f674 104 break; \
mbed_official 489:119543c9f674 105 case RCC_USART2CLKSOURCE_LSE: \
mbed_official 489:119543c9f674 106 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
mbed_official 489:119543c9f674 107 break; \
mbed_official 489:119543c9f674 108 default: \
mbed_official 489:119543c9f674 109 break; \
mbed_official 489:119543c9f674 110 } \
mbed_official 489:119543c9f674 111 } \
mbed_official 489:119543c9f674 112 } while(0)
mbed_official 489:119543c9f674 113
mbed_official 489:119543c9f674 114 #else /* (STM32L031xx) || defined (STM32L041xx) */
mbed_official 489:119543c9f674 115
mbed_official 489:119543c9f674 116 #define USART_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
mbed_official 376:cb4d9db17537 117 do { \
mbed_official 376:cb4d9db17537 118 if((__HANDLE__)->Instance == USART1) \
mbed_official 376:cb4d9db17537 119 { \
mbed_official 489:119543c9f674 120 switch(__HAL_RCC_GET_USART1_SOURCE()) \
mbed_official 376:cb4d9db17537 121 { \
mbed_official 376:cb4d9db17537 122 case RCC_USART1CLKSOURCE_PCLK2: \
mbed_official 376:cb4d9db17537 123 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK2; \
mbed_official 376:cb4d9db17537 124 break; \
mbed_official 376:cb4d9db17537 125 case RCC_USART1CLKSOURCE_HSI: \
mbed_official 376:cb4d9db17537 126 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
mbed_official 376:cb4d9db17537 127 break; \
mbed_official 376:cb4d9db17537 128 case RCC_USART1CLKSOURCE_SYSCLK: \
mbed_official 376:cb4d9db17537 129 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
mbed_official 376:cb4d9db17537 130 break; \
mbed_official 376:cb4d9db17537 131 case RCC_USART1CLKSOURCE_LSE: \
mbed_official 376:cb4d9db17537 132 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
mbed_official 376:cb4d9db17537 133 break; \
mbed_official 376:cb4d9db17537 134 default: \
mbed_official 376:cb4d9db17537 135 break; \
mbed_official 376:cb4d9db17537 136 } \
mbed_official 376:cb4d9db17537 137 } \
mbed_official 376:cb4d9db17537 138 else if((__HANDLE__)->Instance == USART2) \
mbed_official 376:cb4d9db17537 139 { \
mbed_official 376:cb4d9db17537 140 switch(__HAL_RCC_GET_USART2_SOURCE()) \
mbed_official 376:cb4d9db17537 141 { \
mbed_official 376:cb4d9db17537 142 case RCC_USART2CLKSOURCE_PCLK1: \
mbed_official 376:cb4d9db17537 143 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_PCLK1; \
mbed_official 376:cb4d9db17537 144 break; \
mbed_official 376:cb4d9db17537 145 case RCC_USART2CLKSOURCE_HSI: \
mbed_official 376:cb4d9db17537 146 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_HSI; \
mbed_official 376:cb4d9db17537 147 break; \
mbed_official 376:cb4d9db17537 148 case RCC_USART2CLKSOURCE_SYSCLK: \
mbed_official 376:cb4d9db17537 149 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_SYSCLK; \
mbed_official 376:cb4d9db17537 150 break; \
mbed_official 376:cb4d9db17537 151 case RCC_USART2CLKSOURCE_LSE: \
mbed_official 376:cb4d9db17537 152 (__CLOCKSOURCE__) = USART_CLOCKSOURCE_LSE; \
mbed_official 376:cb4d9db17537 153 break; \
mbed_official 376:cb4d9db17537 154 default: \
mbed_official 376:cb4d9db17537 155 break; \
mbed_official 376:cb4d9db17537 156 } \
mbed_official 376:cb4d9db17537 157 } \
mbed_official 376:cb4d9db17537 158 } while(0)
mbed_official 489:119543c9f674 159 #endif /* (STM32L031xx) || (STM32L041xx) */
mbed_official 376:cb4d9db17537 160
mbed_official 376:cb4d9db17537 161 /** @brief Reports the USART mask to apply to retrieve the received data
mbed_official 376:cb4d9db17537 162 * according to the word length and to the parity bits activation.
mbed_official 376:cb4d9db17537 163 * If PCE = 1, the parity bit is not included in the data extracted
mbed_official 376:cb4d9db17537 164 * by the reception API().
mbed_official 376:cb4d9db17537 165 * This masking operation is not carried out in the case of
mbed_official 376:cb4d9db17537 166 * DMA transfers.
mbed_official 376:cb4d9db17537 167 * @param __HANDLE__: specifies the USART Handle
mbed_official 376:cb4d9db17537 168 * @retval mask to apply to USART RDR register value.
mbed_official 376:cb4d9db17537 169 */
mbed_official 489:119543c9f674 170 #define USART_MASK_COMPUTATION(__HANDLE__) \
mbed_official 376:cb4d9db17537 171 do { \
mbed_official 376:cb4d9db17537 172 if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_9B) \
mbed_official 376:cb4d9db17537 173 { \
mbed_official 376:cb4d9db17537 174 if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \
mbed_official 376:cb4d9db17537 175 { \
mbed_official 376:cb4d9db17537 176 (__HANDLE__)->Mask = 0x01FF ; \
mbed_official 376:cb4d9db17537 177 } \
mbed_official 376:cb4d9db17537 178 else \
mbed_official 376:cb4d9db17537 179 { \
mbed_official 376:cb4d9db17537 180 (__HANDLE__)->Mask = 0x00FF ; \
mbed_official 376:cb4d9db17537 181 } \
mbed_official 376:cb4d9db17537 182 } \
mbed_official 376:cb4d9db17537 183 else if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_8B) \
mbed_official 376:cb4d9db17537 184 { \
mbed_official 376:cb4d9db17537 185 if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \
mbed_official 376:cb4d9db17537 186 { \
mbed_official 376:cb4d9db17537 187 (__HANDLE__)->Mask = 0x00FF ; \
mbed_official 376:cb4d9db17537 188 } \
mbed_official 376:cb4d9db17537 189 else \
mbed_official 376:cb4d9db17537 190 { \
mbed_official 376:cb4d9db17537 191 (__HANDLE__)->Mask = 0x007F ; \
mbed_official 376:cb4d9db17537 192 } \
mbed_official 376:cb4d9db17537 193 } \
mbed_official 376:cb4d9db17537 194 else if ((__HANDLE__)->Init.WordLength == USART_WORDLENGTH_7B) \
mbed_official 376:cb4d9db17537 195 { \
mbed_official 376:cb4d9db17537 196 if ((__HANDLE__)->Init.Parity == USART_PARITY_NONE) \
mbed_official 376:cb4d9db17537 197 { \
mbed_official 376:cb4d9db17537 198 (__HANDLE__)->Mask = 0x007F ; \
mbed_official 376:cb4d9db17537 199 } \
mbed_official 376:cb4d9db17537 200 else \
mbed_official 376:cb4d9db17537 201 { \
mbed_official 376:cb4d9db17537 202 (__HANDLE__)->Mask = 0x003F ; \
mbed_official 376:cb4d9db17537 203 } \
mbed_official 376:cb4d9db17537 204 } \
mbed_official 376:cb4d9db17537 205 } while(0)
mbed_official 376:cb4d9db17537 206
mbed_official 376:cb4d9db17537 207 /**
mbed_official 376:cb4d9db17537 208 * @}
mbed_official 376:cb4d9db17537 209 */
mbed_official 376:cb4d9db17537 210
mbed_official 376:cb4d9db17537 211 /* Exported functions --------------------------------------------------------*/
mbed_official 376:cb4d9db17537 212 /* Initialization/de-initialization methods **********************************/
mbed_official 376:cb4d9db17537 213 /* IO operation methods *******************************************************/
mbed_official 376:cb4d9db17537 214 /* Peripheral Control methods ************************************************/
mbed_official 376:cb4d9db17537 215 /* Peripheral State methods **************************************************/
mbed_official 376:cb4d9db17537 216
mbed_official 376:cb4d9db17537 217
mbed_official 376:cb4d9db17537 218 /**
mbed_official 376:cb4d9db17537 219 * @}
mbed_official 376:cb4d9db17537 220 */
mbed_official 376:cb4d9db17537 221
mbed_official 376:cb4d9db17537 222 /**
mbed_official 376:cb4d9db17537 223 * @}
mbed_official 376:cb4d9db17537 224 */
mbed_official 376:cb4d9db17537 225
mbed_official 376:cb4d9db17537 226 #ifdef __cplusplus
mbed_official 376:cb4d9db17537 227 }
mbed_official 376:cb4d9db17537 228 #endif
mbed_official 376:cb4d9db17537 229
mbed_official 376:cb4d9db17537 230 #endif /* __STM32L0xx_HAL_USART_EX_H */
mbed_official 376:cb4d9db17537 231
mbed_official 376:cb4d9db17537 232 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
mbed_official 489:119543c9f674 233