mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

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

targets/TARGET_STM/TARGET_STM32L0/device/stm32l0xx_hal_irda_ex.h@149:156823d33999, 2016-10-28 (annotated)

Committer:
<>
Date:
Fri Oct 28 11:17:30 2016 +0100
Revision:
149:156823d33999
Parent:
targets/cmsis/TARGET_STM/TARGET_STM32L0/stm32l0xx_hal_irda_ex.h@144:ef7eb2e8f9f7
Child:
151:5eaa88a5bcc7
This updates the lib to the mbed lib v128



NOTE: This release includes a restructuring of the file and directory locations and thus some

include paths in your code may need updating accordingly.

Who changed what in which revision?

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