Ricardo Benitez / mbed

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed by mbed official

TARGET_NUCLEO_L073RZ/stm32l0xx_hal_usart_ex.h@116:c0f6e94411f5, 2016-03-15 (annotated)

Committer:
Kojto
Date:
Tue Mar 15 14:34:00 2016 +0000
Revision:
116:c0f6e94411f5
Release 116 of the mbed library



Changes:

- new targets - NUCLEO_L073RZ

- fixes to IOTSS BEID platform

- LPC824, LPC1549 and LPC11U68 - fix PWMOut SCT bugs

- STM32F7 - Cube driver

- STM32F4 - add RTC LSI macro, defined as 0

- STM32F3 - fix multiple ADC clock initialization

- retarget - binary mode fix for GCC

Who changed what in which revision?

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