Egor Rumjantsev / mbed

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

Fork of mbed by mbed official

TARGET_NUCLEO_F334R8/stm32f3xx_hal_smartcard_ex.h@92:4fc01daae5a5, 2014-11-27 (annotated)

Committer:
bogdanm
Date:
Thu Nov 27 13:33:22 2014 +0000
Revision:
92:4fc01daae5a5
Parent:
86:04dd9b1680ae 
Release 92 of the mbed libray



Main changes:



- nRF51822: fixed pin assignment issues

- ST targets moving to the STM32Cube driver

- LPC1439: fixed serial interrupt issue

- first Cortex-A platform supported in mbed (RZ_A1H)

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 86:04dd9b1680ae 1 /**
bogdanm 86:04dd9b1680ae 2 ******************************************************************************
bogdanm 86:04dd9b1680ae 3 * @file stm32f3xx_hal_smartcard_ex.h
bogdanm 86:04dd9b1680ae 4 * @author MCD Application Team
bogdanm 92:4fc01daae5a5 5 * @version V1.1.0
bogdanm 92:4fc01daae5a5 6 * @date 12-Sept-2014
bogdanm 86:04dd9b1680ae 7 * @brief Header file of SMARTCARD HAL module.
bogdanm 86:04dd9b1680ae 8 ******************************************************************************
bogdanm 86:04dd9b1680ae 9 * @attention
bogdanm 86:04dd9b1680ae 10 *
bogdanm 86:04dd9b1680ae 11 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
bogdanm 86:04dd9b1680ae 12 *
bogdanm 86:04dd9b1680ae 13 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 86:04dd9b1680ae 14 * are permitted provided that the following conditions are met:
bogdanm 86:04dd9b1680ae 15 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 86:04dd9b1680ae 16 * this list of conditions and the following disclaimer.
bogdanm 86:04dd9b1680ae 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 86:04dd9b1680ae 18 * this list of conditions and the following disclaimer in the documentation
bogdanm 86:04dd9b1680ae 19 * and/or other materials provided with the distribution.
bogdanm 86:04dd9b1680ae 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 86:04dd9b1680ae 21 * may be used to endorse or promote products derived from this software
bogdanm 86:04dd9b1680ae 22 * without specific prior written permission.
bogdanm 86:04dd9b1680ae 23 *
bogdanm 86:04dd9b1680ae 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 86:04dd9b1680ae 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 86:04dd9b1680ae 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 86:04dd9b1680ae 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 86:04dd9b1680ae 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 86:04dd9b1680ae 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 86:04dd9b1680ae 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 86:04dd9b1680ae 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 86:04dd9b1680ae 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 86:04dd9b1680ae 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 86:04dd9b1680ae 34 *
bogdanm 86:04dd9b1680ae 35 ******************************************************************************
bogdanm 86:04dd9b1680ae 36 */
bogdanm 86:04dd9b1680ae 37
bogdanm 86:04dd9b1680ae 38 /* Define to prevent recursive inclusion -------------------------------------*/
bogdanm 86:04dd9b1680ae 39 #ifndef __STM32F3xx_HAL_SMARTCARD_EX_H
bogdanm 86:04dd9b1680ae 40 #define __STM32F3xx_HAL_SMARTCARD_EX_H
bogdanm 86:04dd9b1680ae 41
bogdanm 86:04dd9b1680ae 42 #ifdef __cplusplus
bogdanm 86:04dd9b1680ae 43 extern "C" {
bogdanm 86:04dd9b1680ae 44 #endif
bogdanm 86:04dd9b1680ae 45
bogdanm 86:04dd9b1680ae 46 /* Includes ------------------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 47 #include "stm32f3xx_hal_def.h"
bogdanm 86:04dd9b1680ae 48
bogdanm 86:04dd9b1680ae 49 /** @addtogroup STM32F3xx_HAL_Driver
bogdanm 86:04dd9b1680ae 50 * @{
bogdanm 86:04dd9b1680ae 51 */
bogdanm 86:04dd9b1680ae 52
bogdanm 92:4fc01daae5a5 53 /** @addtogroup SMARTCARDEx SMARTCARD Extended HAL module driver
bogdanm 86:04dd9b1680ae 54 * @{
bogdanm 86:04dd9b1680ae 55 */
bogdanm 86:04dd9b1680ae 56
bogdanm 86:04dd9b1680ae 57 /* Exported types ------------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 58 /* Exported constants --------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 59 /* Exported macro ------------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 60
bogdanm 92:4fc01daae5a5 61 /** @defgroup SMARTCARDEx_Exported_Macros SMARTCARD Extended Exported Macros
bogdanm 86:04dd9b1680ae 62 * @{
bogdanm 86:04dd9b1680ae 63 */
bogdanm 86:04dd9b1680ae 64
bogdanm 86:04dd9b1680ae 65 /** @brief Reports the SMARTCARD clock source.
bogdanm 86:04dd9b1680ae 66 * @param __HANDLE__: specifies the SMARTCARD Handle
bogdanm 86:04dd9b1680ae 67 * @param __CLOCKSOURCE__ : output variable
bogdanm 86:04dd9b1680ae 68 * @retval the SMARTCARD clocking source, written in __CLOCKSOURCE__.
bogdanm 86:04dd9b1680ae 69 */
bogdanm 86:04dd9b1680ae 70 #if defined(STM32F334x8) || defined(STM32F303x8) || defined(STM32F328xx)
bogdanm 86:04dd9b1680ae 71 #define __HAL_SMARTCARD_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
bogdanm 86:04dd9b1680ae 72 do { \
bogdanm 86:04dd9b1680ae 73 if((__HANDLE__)->Instance == USART1) \
bogdanm 86:04dd9b1680ae 74 { \
bogdanm 86:04dd9b1680ae 75 switch(__HAL_RCC_GET_USART1_SOURCE()) \
bogdanm 86:04dd9b1680ae 76 { \
bogdanm 86:04dd9b1680ae 77 case RCC_USART1CLKSOURCE_PCLK1: \
bogdanm 86:04dd9b1680ae 78 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
bogdanm 86:04dd9b1680ae 79 break; \
bogdanm 86:04dd9b1680ae 80 case RCC_USART1CLKSOURCE_HSI: \
bogdanm 86:04dd9b1680ae 81 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
bogdanm 86:04dd9b1680ae 82 break; \
bogdanm 86:04dd9b1680ae 83 case RCC_USART1CLKSOURCE_SYSCLK: \
bogdanm 86:04dd9b1680ae 84 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
bogdanm 86:04dd9b1680ae 85 break; \
bogdanm 86:04dd9b1680ae 86 case RCC_USART1CLKSOURCE_LSE: \
bogdanm 86:04dd9b1680ae 87 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
bogdanm 86:04dd9b1680ae 88 break; \
bogdanm 86:04dd9b1680ae 89 } \
bogdanm 86:04dd9b1680ae 90 } \
bogdanm 86:04dd9b1680ae 91 else if((__HANDLE__)->Instance == USART2) \
bogdanm 86:04dd9b1680ae 92 { \
bogdanm 86:04dd9b1680ae 93 switch(__HAL_RCC_GET_USART2_SOURCE()) \
bogdanm 86:04dd9b1680ae 94 { \
bogdanm 86:04dd9b1680ae 95 case RCC_USART2CLKSOURCE_PCLK1: \
bogdanm 86:04dd9b1680ae 96 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
bogdanm 86:04dd9b1680ae 97 break; \
bogdanm 86:04dd9b1680ae 98 case RCC_USART2CLKSOURCE_HSI: \
bogdanm 86:04dd9b1680ae 99 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
bogdanm 86:04dd9b1680ae 100 break; \
bogdanm 86:04dd9b1680ae 101 case RCC_USART2CLKSOURCE_SYSCLK: \
bogdanm 86:04dd9b1680ae 102 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
bogdanm 86:04dd9b1680ae 103 break; \
bogdanm 86:04dd9b1680ae 104 case RCC_USART2CLKSOURCE_LSE: \
bogdanm 86:04dd9b1680ae 105 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
bogdanm 86:04dd9b1680ae 106 break; \
bogdanm 86:04dd9b1680ae 107 } \
bogdanm 86:04dd9b1680ae 108 } \
bogdanm 86:04dd9b1680ae 109 else if((__HANDLE__)->Instance == USART3) \
bogdanm 86:04dd9b1680ae 110 { \
bogdanm 86:04dd9b1680ae 111 switch(__HAL_RCC_GET_USART3_SOURCE()) \
bogdanm 86:04dd9b1680ae 112 { \
bogdanm 86:04dd9b1680ae 113 case RCC_USART3CLKSOURCE_PCLK1: \
bogdanm 86:04dd9b1680ae 114 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
bogdanm 86:04dd9b1680ae 115 break; \
bogdanm 86:04dd9b1680ae 116 case RCC_USART3CLKSOURCE_HSI: \
bogdanm 86:04dd9b1680ae 117 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
bogdanm 86:04dd9b1680ae 118 break; \
bogdanm 86:04dd9b1680ae 119 case RCC_USART3CLKSOURCE_SYSCLK: \
bogdanm 86:04dd9b1680ae 120 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
bogdanm 86:04dd9b1680ae 121 break; \
bogdanm 86:04dd9b1680ae 122 case RCC_USART3CLKSOURCE_LSE: \
bogdanm 86:04dd9b1680ae 123 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
bogdanm 86:04dd9b1680ae 124 break; \
bogdanm 86:04dd9b1680ae 125 } \
bogdanm 86:04dd9b1680ae 126 } \
bogdanm 86:04dd9b1680ae 127 } while(0)
bogdanm 86:04dd9b1680ae 128 #else
bogdanm 86:04dd9b1680ae 129 #define __HAL_SMARTCARD_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
bogdanm 86:04dd9b1680ae 130 do { \
bogdanm 86:04dd9b1680ae 131 if((__HANDLE__)->Instance == USART1) \
bogdanm 86:04dd9b1680ae 132 { \
bogdanm 86:04dd9b1680ae 133 switch(__HAL_RCC_GET_USART1_SOURCE()) \
bogdanm 86:04dd9b1680ae 134 { \
bogdanm 86:04dd9b1680ae 135 case RCC_USART1CLKSOURCE_PCLK2: \
bogdanm 86:04dd9b1680ae 136 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK2; \
bogdanm 86:04dd9b1680ae 137 break; \
bogdanm 86:04dd9b1680ae 138 case RCC_USART1CLKSOURCE_HSI: \
bogdanm 86:04dd9b1680ae 139 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
bogdanm 86:04dd9b1680ae 140 break; \
bogdanm 86:04dd9b1680ae 141 case RCC_USART1CLKSOURCE_SYSCLK: \
bogdanm 86:04dd9b1680ae 142 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
bogdanm 86:04dd9b1680ae 143 break; \
bogdanm 86:04dd9b1680ae 144 case RCC_USART1CLKSOURCE_LSE: \
bogdanm 86:04dd9b1680ae 145 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
bogdanm 86:04dd9b1680ae 146 break; \
bogdanm 86:04dd9b1680ae 147 } \
bogdanm 86:04dd9b1680ae 148 } \
bogdanm 86:04dd9b1680ae 149 else if((__HANDLE__)->Instance == USART2) \
bogdanm 86:04dd9b1680ae 150 { \
bogdanm 86:04dd9b1680ae 151 switch(__HAL_RCC_GET_USART2_SOURCE()) \
bogdanm 86:04dd9b1680ae 152 { \
bogdanm 86:04dd9b1680ae 153 case RCC_USART2CLKSOURCE_PCLK1: \
bogdanm 86:04dd9b1680ae 154 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
bogdanm 86:04dd9b1680ae 155 break; \
bogdanm 86:04dd9b1680ae 156 case RCC_USART2CLKSOURCE_HSI: \
bogdanm 86:04dd9b1680ae 157 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
bogdanm 86:04dd9b1680ae 158 break; \
bogdanm 86:04dd9b1680ae 159 case RCC_USART2CLKSOURCE_SYSCLK: \
bogdanm 86:04dd9b1680ae 160 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
bogdanm 86:04dd9b1680ae 161 break; \
bogdanm 86:04dd9b1680ae 162 case RCC_USART2CLKSOURCE_LSE: \
bogdanm 86:04dd9b1680ae 163 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
bogdanm 86:04dd9b1680ae 164 break; \
bogdanm 86:04dd9b1680ae 165 } \
bogdanm 86:04dd9b1680ae 166 } \
bogdanm 86:04dd9b1680ae 167 else if((__HANDLE__)->Instance == USART3) \
bogdanm 86:04dd9b1680ae 168 { \
bogdanm 86:04dd9b1680ae 169 switch(__HAL_RCC_GET_USART3_SOURCE()) \
bogdanm 86:04dd9b1680ae 170 { \
bogdanm 86:04dd9b1680ae 171 case RCC_USART3CLKSOURCE_PCLK1: \
bogdanm 86:04dd9b1680ae 172 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
bogdanm 86:04dd9b1680ae 173 break; \
bogdanm 86:04dd9b1680ae 174 case RCC_USART3CLKSOURCE_HSI: \
bogdanm 86:04dd9b1680ae 175 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
bogdanm 86:04dd9b1680ae 176 break; \
bogdanm 86:04dd9b1680ae 177 case RCC_USART3CLKSOURCE_SYSCLK: \
bogdanm 86:04dd9b1680ae 178 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
bogdanm 86:04dd9b1680ae 179 break; \
bogdanm 86:04dd9b1680ae 180 case RCC_USART3CLKSOURCE_LSE: \
bogdanm 86:04dd9b1680ae 181 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
bogdanm 86:04dd9b1680ae 182 break; \
bogdanm 86:04dd9b1680ae 183 } \
bogdanm 86:04dd9b1680ae 184 } \
bogdanm 86:04dd9b1680ae 185 } while(0)
bogdanm 86:04dd9b1680ae 186 #endif
bogdanm 86:04dd9b1680ae 187
bogdanm 86:04dd9b1680ae 188 /**
bogdanm 86:04dd9b1680ae 189 * @}
bogdanm 86:04dd9b1680ae 190 */
bogdanm 86:04dd9b1680ae 191
bogdanm 86:04dd9b1680ae 192
bogdanm 86:04dd9b1680ae 193 /* Exported functions --------------------------------------------------------*/
bogdanm 92:4fc01daae5a5 194 /** @addtogroup SMARTCARDEx_Exported_Functions SMARTCARD Extended Exported Functions
bogdanm 92:4fc01daae5a5 195 * @{
bogdanm 92:4fc01daae5a5 196 */
bogdanm 92:4fc01daae5a5 197
bogdanm 86:04dd9b1680ae 198 /* Initialization and de-initialization functions ****************************/
bogdanm 86:04dd9b1680ae 199 /* IO operation functions *****************************************************/
bogdanm 86:04dd9b1680ae 200 /* Peripheral Control functions ***********************************************/
bogdanm 92:4fc01daae5a5 201 /** @addtogroup SMARTCARDEx_Exported_Functions_Group1 Extended Peripheral Control functions
bogdanm 92:4fc01daae5a5 202 * @{
bogdanm 92:4fc01daae5a5 203 */
bogdanm 86:04dd9b1680ae 204 void HAL_SMARTCARDEx_BlockLength_Config(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t BlockLength);
bogdanm 86:04dd9b1680ae 205 void HAL_SMARTCARDEx_TimeOut_Config(SMARTCARD_HandleTypeDef *hsmartcard, uint32_t TimeOutValue);
bogdanm 86:04dd9b1680ae 206 HAL_StatusTypeDef HAL_SMARTCARDEx_EnableReceiverTimeOut(SMARTCARD_HandleTypeDef *hsmartcard);
bogdanm 86:04dd9b1680ae 207 HAL_StatusTypeDef HAL_SMARTCARDEx_DisableReceiverTimeOut(SMARTCARD_HandleTypeDef *hsmartcard);
bogdanm 86:04dd9b1680ae 208
bogdanm 86:04dd9b1680ae 209 /* Peripheral State and Error functions ***************************************/
bogdanm 86:04dd9b1680ae 210
bogdanm 86:04dd9b1680ae 211 /**
bogdanm 86:04dd9b1680ae 212 * @}
bogdanm 86:04dd9b1680ae 213 */
bogdanm 86:04dd9b1680ae 214
bogdanm 86:04dd9b1680ae 215 /**
bogdanm 86:04dd9b1680ae 216 * @}
bogdanm 92:4fc01daae5a5 217 */
bogdanm 92:4fc01daae5a5 218
bogdanm 92:4fc01daae5a5 219 /**
bogdanm 92:4fc01daae5a5 220 * @}
bogdanm 92:4fc01daae5a5 221 */
bogdanm 92:4fc01daae5a5 222
bogdanm 92:4fc01daae5a5 223 /**
bogdanm 92:4fc01daae5a5 224 * @}
bogdanm 86:04dd9b1680ae 225 */
bogdanm 86:04dd9b1680ae 226
bogdanm 86:04dd9b1680ae 227 #ifdef __cplusplus
bogdanm 86:04dd9b1680ae 228 }
bogdanm 86:04dd9b1680ae 229 #endif
bogdanm 86:04dd9b1680ae 230
bogdanm 86:04dd9b1680ae 231 #endif /* __STM32F3xx_HAL_SMARTCARD_EX_H */
bogdanm 86:04dd9b1680ae 232
bogdanm 86:04dd9b1680ae 233 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/