en 129 / mbed-dev

fix LPC812 PWM

Dependents:   IR_LED_Send

Fork of mbed-dev by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32L0/stm32l0xx_hal_usart_ex.h@0:9b334a45a8ff, 2015-10-01 (annotated)

Committer:
bogdanm
Date:
Thu Oct 01 15:25:22 2015 +0300
Revision:
0:9b334a45a8ff
Child:
113:b3775bf36a83
Initial commit on mbed-dev



Replaces mbed-src (now inactive)

Who changed what in which revision?

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