mbed official / mbed

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

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_NUCLEO_L4R5ZI_P/TOOLCHAIN_IAR/stm32l4xx_hal_smartcard_ex.h@172:65be27845400, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 20:53:29 2019 +0000
Revision:
172:65be27845400
mbed library release version 165

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 172:65be27845400 1 /**
AnnaBridge 172:65be27845400 2 ******************************************************************************
AnnaBridge 172:65be27845400 3 * @file stm32l4xx_hal_smartcard_ex.h
AnnaBridge 172:65be27845400 4 * @author MCD Application Team
AnnaBridge 172:65be27845400 5 * @brief Header file of SMARTCARD HAL Extended module.
AnnaBridge 172:65be27845400 6 ******************************************************************************
AnnaBridge 172:65be27845400 7 * @attention
AnnaBridge 172:65be27845400 8 *
AnnaBridge 172:65be27845400 9 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
AnnaBridge 172:65be27845400 10 *
AnnaBridge 172:65be27845400 11 * Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 172:65be27845400 12 * are permitted provided that the following conditions are met:
AnnaBridge 172:65be27845400 13 * 1. Redistributions of source code must retain the above copyright notice,
AnnaBridge 172:65be27845400 14 * this list of conditions and the following disclaimer.
AnnaBridge 172:65be27845400 15 * 2. Redistributions in binary form must reproduce the above copyright notice,
AnnaBridge 172:65be27845400 16 * this list of conditions and the following disclaimer in the documentation
AnnaBridge 172:65be27845400 17 * and/or other materials provided with the distribution.
AnnaBridge 172:65be27845400 18 * 3. Neither the name of STMicroelectronics nor the names of its contributors
AnnaBridge 172:65be27845400 19 * may be used to endorse or promote products derived from this software
AnnaBridge 172:65be27845400 20 * without specific prior written permission.
AnnaBridge 172:65be27845400 21 *
AnnaBridge 172:65be27845400 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AnnaBridge 172:65be27845400 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
AnnaBridge 172:65be27845400 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 172:65be27845400 25 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
AnnaBridge 172:65be27845400 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
AnnaBridge 172:65be27845400 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
AnnaBridge 172:65be27845400 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
AnnaBridge 172:65be27845400 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
AnnaBridge 172:65be27845400 30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
AnnaBridge 172:65be27845400 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 172:65be27845400 32 *
AnnaBridge 172:65be27845400 33 ******************************************************************************
AnnaBridge 172:65be27845400 34 */
AnnaBridge 172:65be27845400 35
AnnaBridge 172:65be27845400 36 /* Define to prevent recursive inclusion -------------------------------------*/
AnnaBridge 172:65be27845400 37 #ifndef __STM32L4xx_HAL_SMARTCARD_EX_H
AnnaBridge 172:65be27845400 38 #define __STM32L4xx_HAL_SMARTCARD_EX_H
AnnaBridge 172:65be27845400 39
AnnaBridge 172:65be27845400 40 #ifdef __cplusplus
AnnaBridge 172:65be27845400 41 extern "C" {
AnnaBridge 172:65be27845400 42 #endif
AnnaBridge 172:65be27845400 43
AnnaBridge 172:65be27845400 44 /* Includes ------------------------------------------------------------------*/
AnnaBridge 172:65be27845400 45 #include "stm32l4xx_hal_def.h"
AnnaBridge 172:65be27845400 46
AnnaBridge 172:65be27845400 47 /** @addtogroup STM32L4xx_HAL_Driver
AnnaBridge 172:65be27845400 48 * @{
AnnaBridge 172:65be27845400 49 */
AnnaBridge 172:65be27845400 50
AnnaBridge 172:65be27845400 51 /** @addtogroup SMARTCARDEx
AnnaBridge 172:65be27845400 52 * @{
AnnaBridge 172:65be27845400 53 */
AnnaBridge 172:65be27845400 54
AnnaBridge 172:65be27845400 55 /* Exported types ------------------------------------------------------------*/
AnnaBridge 172:65be27845400 56 /* Exported constants --------------------------------------------------------*/
AnnaBridge 172:65be27845400 57
AnnaBridge 172:65be27845400 58 /** @addtogroup SMARTCARDEx_Exported_Constants SMARTCARD Extended Exported Constants
AnnaBridge 172:65be27845400 59 * @{
AnnaBridge 172:65be27845400 60 */
AnnaBridge 172:65be27845400 61
AnnaBridge 172:65be27845400 62 /** @defgroup SMARTCARDEx_Transmission_Completion_Indication SMARTCARD Transmission Completion Indication
AnnaBridge 172:65be27845400 63 * @{
AnnaBridge 172:65be27845400 64 */
AnnaBridge 172:65be27845400 65 #if defined(USART_TCBGT_SUPPORT)
AnnaBridge 172:65be27845400 66 #define SMARTCARD_TCBGT SMARTCARD_IT_TCBGT /*!< SMARTCARD transmission complete before guard time */
AnnaBridge 172:65be27845400 67 #endif /* USART_TCBGT_SUPPORT */
AnnaBridge 172:65be27845400 68 #define SMARTCARD_TC SMARTCARD_IT_TC /*!< SMARTCARD transmission complete (flag raised when guard time has elapsed) */
AnnaBridge 172:65be27845400 69 /**
AnnaBridge 172:65be27845400 70 * @}
AnnaBridge 172:65be27845400 71 */
AnnaBridge 172:65be27845400 72
AnnaBridge 172:65be27845400 73 /** @defgroup SMARTCARDEx_Advanced_Features_Initialization_Type SMARTCARD advanced feature initialization type
AnnaBridge 172:65be27845400 74 * @{
AnnaBridge 172:65be27845400 75 */
AnnaBridge 172:65be27845400 76 #define SMARTCARD_ADVFEATURE_NO_INIT 0x00000000U /*!< No advanced feature initialization */
AnnaBridge 172:65be27845400 77 #define SMARTCARD_ADVFEATURE_TXINVERT_INIT 0x00000001U /*!< TX pin active level inversion */
AnnaBridge 172:65be27845400 78 #define SMARTCARD_ADVFEATURE_RXINVERT_INIT 0x00000002U /*!< RX pin active level inversion */
AnnaBridge 172:65be27845400 79 #define SMARTCARD_ADVFEATURE_DATAINVERT_INIT 0x00000004U /*!< Binary data inversion */
AnnaBridge 172:65be27845400 80 #define SMARTCARD_ADVFEATURE_SWAP_INIT 0x00000008U /*!< TX/RX pins swap */
AnnaBridge 172:65be27845400 81 #define SMARTCARD_ADVFEATURE_RXOVERRUNDISABLE_INIT 0x00000010U /*!< RX overrun disable */
AnnaBridge 172:65be27845400 82 #define SMARTCARD_ADVFEATURE_DMADISABLEONERROR_INIT 0x00000020U /*!< DMA disable on Reception Error */
AnnaBridge 172:65be27845400 83 #define SMARTCARD_ADVFEATURE_MSBFIRST_INIT 0x00000080U /*!< Most significant bit sent/received first */
AnnaBridge 172:65be27845400 84 #if defined(USART_TCBGT_SUPPORT)
AnnaBridge 172:65be27845400 85 #define SMARTCARD_ADVFEATURE_TXCOMPLETION 0x00000100U /*!< TX completion indication before of after guard time */
AnnaBridge 172:65be27845400 86 #endif /* USART_TCBGT_SUPPORT */
AnnaBridge 172:65be27845400 87 /**
AnnaBridge 172:65be27845400 88 * @}
AnnaBridge 172:65be27845400 89 */
AnnaBridge 172:65be27845400 90
AnnaBridge 172:65be27845400 91 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 92 /** @defgroup SMARTCARDEx_TXFIFO_threshold_level SMARTCARDEx TXFIFO threshold level
AnnaBridge 172:65be27845400 93 * @brief SMARTCARD TXFIFO level
AnnaBridge 172:65be27845400 94 * @{
AnnaBridge 172:65be27845400 95 */
AnnaBridge 172:65be27845400 96 #define SMARTCARD_TXFIFO_THRESHOLD_1_8 0x00000000U /*!< TXFIFO reaches 1/8 of its depth */
AnnaBridge 172:65be27845400 97 #define SMARTCARD_TXFIFO_THRESHOLD_1_4 USART_CR3_TXFTCFG_0 /*!< TXFIFO reaches 1/4 of its depth */
AnnaBridge 172:65be27845400 98 #define SMARTCARD_TXFIFO_THRESHOLD_1_2 USART_CR3_TXFTCFG_1 /*!< TXFIFO reaches 1/2 of its depth */
AnnaBridge 172:65be27845400 99 #define SMARTCARD_TXFIFO_THRESHOLD_3_4 (USART_CR3_TXFTCFG_0|USART_CR3_TXFTCFG_1) /*!< TXFIFO reaches 3/4 of its depth */
AnnaBridge 172:65be27845400 100 #define SMARTCARD_TXFIFO_THRESHOLD_7_8 USART_CR3_TXFTCFG_2 /*!< TXFIFO reaches 7/8 of its depth */
AnnaBridge 172:65be27845400 101 #define SMARTCARD_TXFIFO_THRESHOLD_8_8 (USART_CR3_TXFTCFG_2|USART_CR3_TXFTCFG_0) /*!< TXFIFO becomes empty */
AnnaBridge 172:65be27845400 102 /**
AnnaBridge 172:65be27845400 103 * @}
AnnaBridge 172:65be27845400 104 */
AnnaBridge 172:65be27845400 105
AnnaBridge 172:65be27845400 106 /** @defgroup SMARTCARDEx_RXFIFO_threshold_level SMARTCARDEx RXFIFO threshold level
AnnaBridge 172:65be27845400 107 * @brief SMARTCARD RXFIFO level
AnnaBridge 172:65be27845400 108 * @{
AnnaBridge 172:65be27845400 109 */
AnnaBridge 172:65be27845400 110 #define SMARTCARD_RXFIFO_THRESHOLD_1_8 0x00000000U /*!< RXFIFO FIFO reaches 1/8 of its depth */
AnnaBridge 172:65be27845400 111 #define SMARTCARD_RXFIFO_THRESHOLD_1_4 USART_CR3_RXFTCFG_0 /*!< RXFIFO FIFO reaches 1/4 of its depth */
AnnaBridge 172:65be27845400 112 #define SMARTCARD_RXFIFO_THRESHOLD_1_2 USART_CR3_RXFTCFG_1 /*!< RXFIFO FIFO reaches 1/2 of its depth */
AnnaBridge 172:65be27845400 113 #define SMARTCARD_RXFIFO_THRESHOLD_3_4 (USART_CR3_RXFTCFG_0|USART_CR3_RXFTCFG_1) /*!< RXFIFO FIFO reaches 3/4 of its depth */
AnnaBridge 172:65be27845400 114 #define SMARTCARD_RXFIFO_THRESHOLD_7_8 USART_CR3_RXFTCFG_2 /*!< RXFIFO FIFO reaches 7/8 of its depth */
AnnaBridge 172:65be27845400 115 #define SMARTCARD_RXFIFO_THRESHOLD_8_8 (USART_CR3_RXFTCFG_2|USART_CR3_RXFTCFG_0) /*!< RXFIFO FIFO becomes full */
AnnaBridge 172:65be27845400 116 /**
AnnaBridge 172:65be27845400 117 * @}
AnnaBridge 172:65be27845400 118 */
AnnaBridge 172:65be27845400 119 #endif
AnnaBridge 172:65be27845400 120
AnnaBridge 172:65be27845400 121 /** @defgroup SMARTCARDEx_Flags SMARTCARD Flags
AnnaBridge 172:65be27845400 122 * Elements values convention: 0xXXXX
AnnaBridge 172:65be27845400 123 * - 0xXXXX : Flag mask in the ISR register
AnnaBridge 172:65be27845400 124 * @{
AnnaBridge 172:65be27845400 125 */
AnnaBridge 172:65be27845400 126 #if defined(USART_TCBGT_SUPPORT)
AnnaBridge 172:65be27845400 127 #define SMARTCARD_FLAG_TCBGT USART_ISR_TCBGT /*!< SMARTCARD transmission complete before guard time completion */
AnnaBridge 172:65be27845400 128 #endif /* USART_TCBGT_SUPPORT */
AnnaBridge 172:65be27845400 129 #define SMARTCARD_FLAG_REACK USART_ISR_REACK /*!< SMARTCARD receive enable acknowledge flag */
AnnaBridge 172:65be27845400 130 #define SMARTCARD_FLAG_TEACK USART_ISR_TEACK /*!< SMARTCARD transmit enable acknowledge flag */
AnnaBridge 172:65be27845400 131 #define SMARTCARD_FLAG_BUSY USART_ISR_BUSY /*!< SMARTCARD busy flag */
AnnaBridge 172:65be27845400 132 #define SMARTCARD_FLAG_EOBF USART_ISR_EOBF /*!< SMARTCARD end of block flag */
AnnaBridge 172:65be27845400 133 #define SMARTCARD_FLAG_RTOF USART_ISR_RTOF /*!< SMARTCARD receiver timeout flag */
AnnaBridge 172:65be27845400 134 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 135 #define SMARTCARD_FLAG_TXE USART_ISR_TXE_TXFNF /*!< SMARTCARD transmit data register empty */
AnnaBridge 172:65be27845400 136 #define SMARTCARD_FLAG_TXFNF USART_ISR_TXE_TXFNF /*!< SMARTCARD TXFIFO not full */
AnnaBridge 172:65be27845400 137 #else
AnnaBridge 172:65be27845400 138 #define SMARTCARD_FLAG_TXE USART_ISR_TXE /*!< SMARTCARD transmit data register empty */
AnnaBridge 172:65be27845400 139 #endif
AnnaBridge 172:65be27845400 140 #define SMARTCARD_FLAG_TC USART_ISR_TC /*!< SMARTCARD transmission complete */
AnnaBridge 172:65be27845400 141 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 142 #define SMARTCARD_FLAG_RXNE USART_ISR_RXNE_RXFNE /*!< SMARTCARD read data register not empty */
AnnaBridge 172:65be27845400 143 #define SMARTCARD_FLAG_RXFNE USART_ISR_RXNE_RXFNE /*!< SMARTCARD RXFIFO not empty */
AnnaBridge 172:65be27845400 144 #else
AnnaBridge 172:65be27845400 145 #define SMARTCARD_FLAG_RXNE USART_ISR_RXNE /*!< SMARTCARD read data register not empty */
AnnaBridge 172:65be27845400 146 #endif
AnnaBridge 172:65be27845400 147 #define SMARTCARD_FLAG_IDLE USART_ISR_IDLE /*!< SMARTCARD idle line detection */
AnnaBridge 172:65be27845400 148 #define SMARTCARD_FLAG_ORE USART_ISR_ORE /*!< SMARTCARD overrun error */
AnnaBridge 172:65be27845400 149 #define SMARTCARD_FLAG_NE USART_ISR_NE /*!< SMARTCARD noise error */
AnnaBridge 172:65be27845400 150 #define SMARTCARD_FLAG_FE USART_ISR_FE /*!< SMARTCARD frame error */
AnnaBridge 172:65be27845400 151 #define SMARTCARD_FLAG_PE USART_ISR_PE /*!< SMARTCARD parity error */
AnnaBridge 172:65be27845400 152 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 153 #define SMARTCARD_FLAG_TXFE USART_ISR_TXFE /*!< SMARTCARD TXFIFO Empty flag */
AnnaBridge 172:65be27845400 154 #define SMARTCARD_FLAG_RXFF USART_ISR_RXFF /*!< SMARTCARD RXFIFO Full flag */
AnnaBridge 172:65be27845400 155 #define SMARTCARD_FLAG_RXFT USART_ISR_RXFT /*!< SMARTCARD RXFIFO threshold flag */
AnnaBridge 172:65be27845400 156 #define SMARTCARD_FLAG_TXFT USART_ISR_TXFT /*!< SMARTCARD TXFIFO threshold flag */
AnnaBridge 172:65be27845400 157 #endif
AnnaBridge 172:65be27845400 158 /**
AnnaBridge 172:65be27845400 159 * @}
AnnaBridge 172:65be27845400 160 */
AnnaBridge 172:65be27845400 161
AnnaBridge 172:65be27845400 162 /** @defgroup SMARTCARDEx_Interrupt_definition SMARTCARD Interrupts Definition
AnnaBridge 172:65be27845400 163 * Elements values convention: 000ZZZZZ0XXYYYYYb
AnnaBridge 172:65be27845400 164 * - YYYYY : Interrupt source position in the XX register (5 bits)
AnnaBridge 172:65be27845400 165 * - XX : Interrupt source register (2 bits)
AnnaBridge 172:65be27845400 166 * - 01: CR1 register
AnnaBridge 172:65be27845400 167 * - 10: CR2 register
AnnaBridge 172:65be27845400 168 * - 11: CR3 register
AnnaBridge 172:65be27845400 169 * - ZZZZZ : Flag position in the ISR register(5 bits)
AnnaBridge 172:65be27845400 170 * @{
AnnaBridge 172:65be27845400 171 */
AnnaBridge 172:65be27845400 172 #define SMARTCARD_IT_PE 0x0028U /*!< SMARTCARD parity error interruption */
AnnaBridge 172:65be27845400 173 #define SMARTCARD_IT_TXE 0x0727U /*!< SMARTCARD transmit data register empty interruption */
AnnaBridge 172:65be27845400 174 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 175 #define SMARTCARD_IT_TXFNF 0x0727U /*!< SMARTCARD TX FIFO not full interruption */
AnnaBridge 172:65be27845400 176 #endif
AnnaBridge 172:65be27845400 177 #define SMARTCARD_IT_TC 0x0626U /*!< SMARTCARD transmission complete interruption */
AnnaBridge 172:65be27845400 178 #define SMARTCARD_IT_RXNE 0x0525U /*!< SMARTCARD read data register not empty interruption */
AnnaBridge 172:65be27845400 179 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 180 #define SMARTCARD_IT_RXFNE 0x0525U /*!< SMARTCARD RXFIFO not empty interruption */
AnnaBridge 172:65be27845400 181 #endif
AnnaBridge 172:65be27845400 182 #define SMARTCARD_IT_IDLE 0x0424U /*!< SMARTCARD idle line detection interruption */
AnnaBridge 172:65be27845400 183
AnnaBridge 172:65be27845400 184 #define SMARTCARD_IT_ERR 0x0060U /*!< SMARTCARD error interruption */
AnnaBridge 172:65be27845400 185 #define SMARTCARD_IT_ORE 0x0300U /*!< SMARTCARD overrun error interruption */
AnnaBridge 172:65be27845400 186 #define SMARTCARD_IT_NE 0x0200U /*!< SMARTCARD noise error interruption */
AnnaBridge 172:65be27845400 187 #define SMARTCARD_IT_FE 0x0100U /*!< SMARTCARD frame error interruption */
AnnaBridge 172:65be27845400 188
AnnaBridge 172:65be27845400 189 #define SMARTCARD_IT_EOB 0x0C3BU /*!< SMARTCARD end of block interruption */
AnnaBridge 172:65be27845400 190 #define SMARTCARD_IT_RTO 0x0B3AU /*!< SMARTCARD receiver timeout interruption */
AnnaBridge 172:65be27845400 191 #if defined(USART_TCBGT_SUPPORT)
AnnaBridge 172:65be27845400 192 #define SMARTCARD_IT_TCBGT 0x1978U /*!< SMARTCARD transmission complete before guard time completion interruption */
AnnaBridge 172:65be27845400 193 #endif
AnnaBridge 172:65be27845400 194
AnnaBridge 172:65be27845400 195 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 196 #define SMARTCARD_IT_RXFF 0x183FU /*!< SMARTCARD RXFIFO full interruption */
AnnaBridge 172:65be27845400 197 #define SMARTCARD_IT_TXFE 0x173EU /*!< SMARTCARD TXFIFO empty interruption */
AnnaBridge 172:65be27845400 198 #define SMARTCARD_IT_RXFT 0x1A7CU /*!< SMARTCARD RXFIFO threshold reached interruption */
AnnaBridge 172:65be27845400 199 #define SMARTCARD_IT_TXFT 0x1B77U /*!< SMARTCARD TXFIFO threshold reached interruption */
AnnaBridge 172:65be27845400 200 #endif
AnnaBridge 172:65be27845400 201 /**
AnnaBridge 172:65be27845400 202 * @}
AnnaBridge 172:65be27845400 203 */
AnnaBridge 172:65be27845400 204
AnnaBridge 172:65be27845400 205 /** @defgroup SMARTCARDEx_IT_CLEAR_Flags SMARTCARD Interruption Clear Flags
AnnaBridge 172:65be27845400 206 * @{
AnnaBridge 172:65be27845400 207 */
AnnaBridge 172:65be27845400 208 #define SMARTCARD_CLEAR_PEF USART_ICR_PECF /*!< SMARTCARD parity error clear flag */
AnnaBridge 172:65be27845400 209 #define SMARTCARD_CLEAR_FEF USART_ICR_FECF /*!< SMARTCARD framing error clear flag */
AnnaBridge 172:65be27845400 210 #define SMARTCARD_CLEAR_NEF USART_ICR_NECF /*!< SMARTCARD noise detected clear flag */
AnnaBridge 172:65be27845400 211 #define SMARTCARD_CLEAR_OREF USART_ICR_ORECF /*!< SMARTCARD overrun error clear flag */
AnnaBridge 172:65be27845400 212 #define SMARTCARD_CLEAR_IDLEF USART_ICR_IDLECF /*!< SMARTCARD idle line detected clear flag */
AnnaBridge 172:65be27845400 213 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 214 #define SMARTCARD_CLEAR_TXFECF USART_ICR_TXFECF /*!< TXFIFO empty Clear Flag */
AnnaBridge 172:65be27845400 215 #endif
AnnaBridge 172:65be27845400 216 #define SMARTCARD_CLEAR_TCF USART_ICR_TCCF /*!< SMARTCARD transmission complete clear flag */
AnnaBridge 172:65be27845400 217 #if defined(USART_TCBGT_SUPPORT)
AnnaBridge 172:65be27845400 218 #define SMARTCARD_CLEAR_TCBGTF USART_ICR_TCBGTCF /*!< SMARTCARD transmission complete before guard time completion clear flag */
AnnaBridge 172:65be27845400 219 #endif
AnnaBridge 172:65be27845400 220 #define SMARTCARD_CLEAR_RTOF USART_ICR_RTOCF /*!< SMARTCARD receiver time out clear flag */
AnnaBridge 172:65be27845400 221 #define SMARTCARD_CLEAR_EOBF USART_ICR_EOBCF /*!< SMARTCARD end of block clear flag */
AnnaBridge 172:65be27845400 222 /**
AnnaBridge 172:65be27845400 223 * @}
AnnaBridge 172:65be27845400 224 */
AnnaBridge 172:65be27845400 225
AnnaBridge 172:65be27845400 226 /**
AnnaBridge 172:65be27845400 227 * @}
AnnaBridge 172:65be27845400 228 */
AnnaBridge 172:65be27845400 229
AnnaBridge 172:65be27845400 230 /* Exported macros -----------------------------------------------------------*/
AnnaBridge 172:65be27845400 231
AnnaBridge 172:65be27845400 232 /* Private constants ---------------------------------------------------------*/
AnnaBridge 172:65be27845400 233 /** @defgroup SMARTCARDEx_Private_Constants SMARTCARDEx Private Constants
AnnaBridge 172:65be27845400 234 * @{
AnnaBridge 172:65be27845400 235 */
AnnaBridge 172:65be27845400 236 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 237 /** @defgroup SMARTCARDEx_FIFO_mode SMARTCARDEx FIFO mode
AnnaBridge 172:65be27845400 238 * @{
AnnaBridge 172:65be27845400 239 */
AnnaBridge 172:65be27845400 240 #define SMARTCARD_FIFOMODE_DISABLE 0x00000000U /*!< FIFO mode disable */
AnnaBridge 172:65be27845400 241 #define SMARTCARD_FIFOMODE_ENABLE USART_CR1_FIFOEN /*!< FIFO mode enable */
AnnaBridge 172:65be27845400 242 /**
AnnaBridge 172:65be27845400 243 * @}
AnnaBridge 172:65be27845400 244 */
AnnaBridge 172:65be27845400 245 #endif
AnnaBridge 172:65be27845400 246 /**
AnnaBridge 172:65be27845400 247 * @}
AnnaBridge 172:65be27845400 248 */
AnnaBridge 172:65be27845400 249
AnnaBridge 172:65be27845400 250 /* Private macros ------------------------------------------------------------*/
AnnaBridge 172:65be27845400 251 /** @defgroup SMARTCARDEx_Private_Macros SMARTCARD Extended Private Macros
AnnaBridge 172:65be27845400 252 * @{
AnnaBridge 172:65be27845400 253 */
AnnaBridge 172:65be27845400 254
AnnaBridge 172:65be27845400 255 /** @brief Report the SMARTCARD clock source.
AnnaBridge 172:65be27845400 256 * @param __HANDLE__: specifies the SMARTCARD Handle.
AnnaBridge 172:65be27845400 257 * @param __CLOCKSOURCE__: output variable.
AnnaBridge 172:65be27845400 258 * @retval the SMARTCARD clocking source, written in __CLOCKSOURCE__.
AnnaBridge 172:65be27845400 259 */
AnnaBridge 172:65be27845400 260 #if defined (STM32L432xx) || defined (STM32L442xx)
AnnaBridge 172:65be27845400 261 #define SMARTCARD_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
AnnaBridge 172:65be27845400 262 do { \
AnnaBridge 172:65be27845400 263 if((__HANDLE__)->Instance == USART1) \
AnnaBridge 172:65be27845400 264 { \
AnnaBridge 172:65be27845400 265 switch(__HAL_RCC_GET_USART1_SOURCE()) \
AnnaBridge 172:65be27845400 266 { \
AnnaBridge 172:65be27845400 267 case RCC_USART1CLKSOURCE_PCLK2: \
AnnaBridge 172:65be27845400 268 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK2; \
AnnaBridge 172:65be27845400 269 break; \
AnnaBridge 172:65be27845400 270 case RCC_USART1CLKSOURCE_HSI: \
AnnaBridge 172:65be27845400 271 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
AnnaBridge 172:65be27845400 272 break; \
AnnaBridge 172:65be27845400 273 case RCC_USART1CLKSOURCE_SYSCLK: \
AnnaBridge 172:65be27845400 274 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
AnnaBridge 172:65be27845400 275 break; \
AnnaBridge 172:65be27845400 276 case RCC_USART1CLKSOURCE_LSE: \
AnnaBridge 172:65be27845400 277 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
AnnaBridge 172:65be27845400 278 break; \
AnnaBridge 172:65be27845400 279 default: \
AnnaBridge 172:65be27845400 280 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 172:65be27845400 281 break; \
AnnaBridge 172:65be27845400 282 } \
AnnaBridge 172:65be27845400 283 } \
AnnaBridge 172:65be27845400 284 else if((__HANDLE__)->Instance == USART2) \
AnnaBridge 172:65be27845400 285 { \
AnnaBridge 172:65be27845400 286 switch(__HAL_RCC_GET_USART2_SOURCE()) \
AnnaBridge 172:65be27845400 287 { \
AnnaBridge 172:65be27845400 288 case RCC_USART2CLKSOURCE_PCLK1: \
AnnaBridge 172:65be27845400 289 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
AnnaBridge 172:65be27845400 290 break; \
AnnaBridge 172:65be27845400 291 case RCC_USART2CLKSOURCE_HSI: \
AnnaBridge 172:65be27845400 292 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
AnnaBridge 172:65be27845400 293 break; \
AnnaBridge 172:65be27845400 294 case RCC_USART2CLKSOURCE_SYSCLK: \
AnnaBridge 172:65be27845400 295 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
AnnaBridge 172:65be27845400 296 break; \
AnnaBridge 172:65be27845400 297 case RCC_USART2CLKSOURCE_LSE: \
AnnaBridge 172:65be27845400 298 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
AnnaBridge 172:65be27845400 299 break; \
AnnaBridge 172:65be27845400 300 default: \
AnnaBridge 172:65be27845400 301 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 172:65be27845400 302 break; \
AnnaBridge 172:65be27845400 303 } \
AnnaBridge 172:65be27845400 304 } \
AnnaBridge 172:65be27845400 305 } while(0)
AnnaBridge 172:65be27845400 306 #else
AnnaBridge 172:65be27845400 307 #define SMARTCARD_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
AnnaBridge 172:65be27845400 308 do { \
AnnaBridge 172:65be27845400 309 if((__HANDLE__)->Instance == USART1) \
AnnaBridge 172:65be27845400 310 { \
AnnaBridge 172:65be27845400 311 switch(__HAL_RCC_GET_USART1_SOURCE()) \
AnnaBridge 172:65be27845400 312 { \
AnnaBridge 172:65be27845400 313 case RCC_USART1CLKSOURCE_PCLK2: \
AnnaBridge 172:65be27845400 314 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK2; \
AnnaBridge 172:65be27845400 315 break; \
AnnaBridge 172:65be27845400 316 case RCC_USART1CLKSOURCE_HSI: \
AnnaBridge 172:65be27845400 317 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
AnnaBridge 172:65be27845400 318 break; \
AnnaBridge 172:65be27845400 319 case RCC_USART1CLKSOURCE_SYSCLK: \
AnnaBridge 172:65be27845400 320 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
AnnaBridge 172:65be27845400 321 break; \
AnnaBridge 172:65be27845400 322 case RCC_USART1CLKSOURCE_LSE: \
AnnaBridge 172:65be27845400 323 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
AnnaBridge 172:65be27845400 324 break; \
AnnaBridge 172:65be27845400 325 default: \
AnnaBridge 172:65be27845400 326 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 172:65be27845400 327 break; \
AnnaBridge 172:65be27845400 328 } \
AnnaBridge 172:65be27845400 329 } \
AnnaBridge 172:65be27845400 330 else if((__HANDLE__)->Instance == USART2) \
AnnaBridge 172:65be27845400 331 { \
AnnaBridge 172:65be27845400 332 switch(__HAL_RCC_GET_USART2_SOURCE()) \
AnnaBridge 172:65be27845400 333 { \
AnnaBridge 172:65be27845400 334 case RCC_USART2CLKSOURCE_PCLK1: \
AnnaBridge 172:65be27845400 335 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
AnnaBridge 172:65be27845400 336 break; \
AnnaBridge 172:65be27845400 337 case RCC_USART2CLKSOURCE_HSI: \
AnnaBridge 172:65be27845400 338 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
AnnaBridge 172:65be27845400 339 break; \
AnnaBridge 172:65be27845400 340 case RCC_USART2CLKSOURCE_SYSCLK: \
AnnaBridge 172:65be27845400 341 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
AnnaBridge 172:65be27845400 342 break; \
AnnaBridge 172:65be27845400 343 case RCC_USART2CLKSOURCE_LSE: \
AnnaBridge 172:65be27845400 344 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
AnnaBridge 172:65be27845400 345 break; \
AnnaBridge 172:65be27845400 346 default: \
AnnaBridge 172:65be27845400 347 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 172:65be27845400 348 break; \
AnnaBridge 172:65be27845400 349 } \
AnnaBridge 172:65be27845400 350 } \
AnnaBridge 172:65be27845400 351 else if((__HANDLE__)->Instance == USART3) \
AnnaBridge 172:65be27845400 352 { \
AnnaBridge 172:65be27845400 353 switch(__HAL_RCC_GET_USART3_SOURCE()) \
AnnaBridge 172:65be27845400 354 { \
AnnaBridge 172:65be27845400 355 case RCC_USART3CLKSOURCE_PCLK1: \
AnnaBridge 172:65be27845400 356 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
AnnaBridge 172:65be27845400 357 break; \
AnnaBridge 172:65be27845400 358 case RCC_USART3CLKSOURCE_HSI: \
AnnaBridge 172:65be27845400 359 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
AnnaBridge 172:65be27845400 360 break; \
AnnaBridge 172:65be27845400 361 case RCC_USART3CLKSOURCE_SYSCLK: \
AnnaBridge 172:65be27845400 362 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
AnnaBridge 172:65be27845400 363 break; \
AnnaBridge 172:65be27845400 364 case RCC_USART3CLKSOURCE_LSE: \
AnnaBridge 172:65be27845400 365 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
AnnaBridge 172:65be27845400 366 break; \
AnnaBridge 172:65be27845400 367 default: \
AnnaBridge 172:65be27845400 368 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
AnnaBridge 172:65be27845400 369 break; \
AnnaBridge 172:65be27845400 370 } \
AnnaBridge 172:65be27845400 371 } \
AnnaBridge 172:65be27845400 372 } while(0)
AnnaBridge 172:65be27845400 373 #endif /* STM32L432xx || STM32L442xx */
AnnaBridge 172:65be27845400 374
AnnaBridge 172:65be27845400 375 /** @brief Set the Transmission Completion flag
AnnaBridge 172:65be27845400 376 * @param __HANDLE__ specifies the SMARTCARD Handle.
AnnaBridge 172:65be27845400 377 * @note If TCBGT (Transmission Complete Before Guard Time) flag is not available or if
AnnaBridge 172:65be27845400 378 * AdvancedInit.TxCompletionIndication is not already filled, the latter is forced
AnnaBridge 172:65be27845400 379 * to SMARTCARD_TC (transmission completion indication when guard time has elapsed).
AnnaBridge 172:65be27845400 380 * @retval None
AnnaBridge 172:65be27845400 381 */
AnnaBridge 172:65be27845400 382 #if defined(USART_TCBGT_SUPPORT)
AnnaBridge 172:65be27845400 383 #define SMARTCARD_TRANSMISSION_COMPLETION_SETTING(__HANDLE__) \
AnnaBridge 172:65be27845400 384 do { \
AnnaBridge 172:65be27845400 385 if (HAL_IS_BIT_CLR((__HANDLE__)->AdvancedInit.AdvFeatureInit, SMARTCARD_ADVFEATURE_TXCOMPLETION)) \
AnnaBridge 172:65be27845400 386 { \
AnnaBridge 172:65be27845400 387 (__HANDLE__)->AdvancedInit.TxCompletionIndication = SMARTCARD_TC; \
AnnaBridge 172:65be27845400 388 } \
AnnaBridge 172:65be27845400 389 else \
AnnaBridge 172:65be27845400 390 { \
AnnaBridge 172:65be27845400 391 assert_param(IS_SMARTCARD_TRANSMISSION_COMPLETION((__HANDLE__)->AdvancedInit.TxCompletionIndication)); \
AnnaBridge 172:65be27845400 392 } \
AnnaBridge 172:65be27845400 393 } while(0)
AnnaBridge 172:65be27845400 394 #else
AnnaBridge 172:65be27845400 395 #define SMARTCARD_TRANSMISSION_COMPLETION_SETTING(__HANDLE__) \
AnnaBridge 172:65be27845400 396 do { \
AnnaBridge 172:65be27845400 397 (__HANDLE__)->AdvancedInit.TxCompletionIndication = SMARTCARD_TC; \
AnnaBridge 172:65be27845400 398 } while(0)
AnnaBridge 172:65be27845400 399 #endif
AnnaBridge 172:65be27845400 400
AnnaBridge 172:65be27845400 401 /** @brief Return the transmission completion flag.
AnnaBridge 172:65be27845400 402 * @param __HANDLE__ specifies the SMARTCARD Handle.
AnnaBridge 172:65be27845400 403 * @note Based on AdvancedInit.TxCompletionIndication setting, return TC or TCBGT flag.
AnnaBridge 172:65be27845400 404 * When TCBGT flag (Transmission Complete Before Guard Time) is not available, TC flag is
AnnaBridge 172:65be27845400 405 * reported.
AnnaBridge 172:65be27845400 406 * @retval Transmission completion flag
AnnaBridge 172:65be27845400 407 */
AnnaBridge 172:65be27845400 408 #if defined(USART_TCBGT_SUPPORT)
AnnaBridge 172:65be27845400 409 #define SMARTCARD_TRANSMISSION_COMPLETION_FLAG(__HANDLE__) \
AnnaBridge 172:65be27845400 410 (((__HANDLE__)->AdvancedInit.TxCompletionIndication == SMARTCARD_TC) ? (SMARTCARD_FLAG_TC) : (SMARTCARD_FLAG_TCBGT))
AnnaBridge 172:65be27845400 411 #else
AnnaBridge 172:65be27845400 412 #define SMARTCARD_TRANSMISSION_COMPLETION_FLAG(__HANDLE__) (SMARTCARD_FLAG_TC)
AnnaBridge 172:65be27845400 413 #endif
AnnaBridge 172:65be27845400 414
AnnaBridge 172:65be27845400 415
AnnaBridge 172:65be27845400 416 /**
AnnaBridge 172:65be27845400 417 * @brief Ensure that SMARTCARD frame transmission completion used flag is valid.
AnnaBridge 172:65be27845400 418 * @param __TXCOMPLETE__ SMARTCARD frame transmission completion used flag.
AnnaBridge 172:65be27845400 419 * @retval SET (__TXCOMPLETE__ is valid) or RESET (__TXCOMPLETE__ is invalid)
AnnaBridge 172:65be27845400 420 */
AnnaBridge 172:65be27845400 421 #if defined(USART_TCBGT_SUPPORT)
AnnaBridge 172:65be27845400 422 #define IS_SMARTCARD_TRANSMISSION_COMPLETION(__TXCOMPLETE__) (((__TXCOMPLETE__) == SMARTCARD_TCBGT) ||\
AnnaBridge 172:65be27845400 423 ((__TXCOMPLETE__) == SMARTCARD_TC))
AnnaBridge 172:65be27845400 424 #else
AnnaBridge 172:65be27845400 425 #define IS_SMARTCARD_TRANSMISSION_COMPLETION(__TXCOMPLETE__) ((__TXCOMPLETE__) == SMARTCARD_TC)
AnnaBridge 172:65be27845400 426 #endif
AnnaBridge 172:65be27845400 427
AnnaBridge 172:65be27845400 428 /**
AnnaBridge 172:65be27845400 429 * @}
AnnaBridge 172:65be27845400 430 */
AnnaBridge 172:65be27845400 431
AnnaBridge 172:65be27845400 432 /* Exported functions --------------------------------------------------------*/
AnnaBridge 172:65be27845400 433 /** @addtogroup SMARTCARDEx_Exported_Functions
AnnaBridge 172:65be27845400 434 * @{
AnnaBridge 172:65be27845400 435 */
AnnaBridge 172:65be27845400 436
AnnaBridge 172:65be27845400 437 /* Initialization and de-initialization functions ****************************/
AnnaBridge 172:65be27845400 438 /** @addtogroup SMARTCARDEx_Exported_Functions_Group2
AnnaBridge 172:65be27845400 439 * @{
AnnaBridge 172:65be27845400 440 */
AnnaBridge 172:65be27845400 441
AnnaBridge 172:65be27845400 442 /* IO operation functions *****************************************************/
AnnaBridge 172:65be27845400 443 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 444 void HAL_SMARTCARDEx_RxFifoFullCallback(SMARTCARD_HandleTypeDef *hsmartcard);
AnnaBridge 172:65be27845400 445 void HAL_SMARTCARDEx_TxFifoEmptyCallback(SMARTCARD_HandleTypeDef *hsmartcard);
AnnaBridge 172:65be27845400 446 #endif
AnnaBridge 172:65be27845400 447
AnnaBridge 172:65be27845400 448 /**
AnnaBridge 172:65be27845400 449 * @}
AnnaBridge 172:65be27845400 450 */
AnnaBridge 172:65be27845400 451
AnnaBridge 172:65be27845400 452
AnnaBridge 172:65be27845400 453 /** @addtogroup SMARTCARDEx_Exported_Functions_Group3
AnnaBridge 172:65be27845400 454 * @{
AnnaBridge 172:65be27845400 455 */
AnnaBridge 172:65be27845400 456
AnnaBridge 172:65be27845400 457 /* Peripheral Control functions ***********************************************/
AnnaBridge 172:65be27845400 458 void HAL_SMARTCARDEx_BlockLength_Config(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t BlockLength);
AnnaBridge 172:65be27845400 459 void HAL_SMARTCARDEx_TimeOut_Config(SMARTCARD_HandleTypeDef *hsmartcard, uint32_t TimeOutValue);
AnnaBridge 172:65be27845400 460 HAL_StatusTypeDef HAL_SMARTCARDEx_EnableReceiverTimeOut(SMARTCARD_HandleTypeDef *hsmartcard);
AnnaBridge 172:65be27845400 461 HAL_StatusTypeDef HAL_SMARTCARDEx_DisableReceiverTimeOut(SMARTCARD_HandleTypeDef *hsmartcard);
AnnaBridge 172:65be27845400 462
AnnaBridge 172:65be27845400 463 #if defined(USART_CR1_FIFOEN)
AnnaBridge 172:65be27845400 464 HAL_StatusTypeDef HAL_SMARTCARDEx_EnableFifoMode(SMARTCARD_HandleTypeDef *hsmartcard);
AnnaBridge 172:65be27845400 465 HAL_StatusTypeDef HAL_SMARTCARDEx_DisableFifoMode(SMARTCARD_HandleTypeDef *hsmartcard);
AnnaBridge 172:65be27845400 466 HAL_StatusTypeDef HAL_SMARTCARDEx_SetTxFifoThreshold(SMARTCARD_HandleTypeDef *hsmartcard, uint32_t Threshold);
AnnaBridge 172:65be27845400 467 HAL_StatusTypeDef HAL_SMARTCARDEx_SetRxFifoThreshold(SMARTCARD_HandleTypeDef *hsmartcard, uint32_t Threshold);
AnnaBridge 172:65be27845400 468 #endif
AnnaBridge 172:65be27845400 469
AnnaBridge 172:65be27845400 470 /**
AnnaBridge 172:65be27845400 471 * @}
AnnaBridge 172:65be27845400 472 */
AnnaBridge 172:65be27845400 473
AnnaBridge 172:65be27845400 474 /**
AnnaBridge 172:65be27845400 475 * @}
AnnaBridge 172:65be27845400 476 */
AnnaBridge 172:65be27845400 477
AnnaBridge 172:65be27845400 478
AnnaBridge 172:65be27845400 479 /* Private functions ---------------------------------------------------------*/
AnnaBridge 172:65be27845400 480
AnnaBridge 172:65be27845400 481 /**
AnnaBridge 172:65be27845400 482 * @}
AnnaBridge 172:65be27845400 483 */
AnnaBridge 172:65be27845400 484
AnnaBridge 172:65be27845400 485 /**
AnnaBridge 172:65be27845400 486 * @}
AnnaBridge 172:65be27845400 487 */
AnnaBridge 172:65be27845400 488
AnnaBridge 172:65be27845400 489 #ifdef __cplusplus
AnnaBridge 172:65be27845400 490 }
AnnaBridge 172:65be27845400 491 #endif
AnnaBridge 172:65be27845400 492
AnnaBridge 172:65be27845400 493 #endif /* __STM32L4xx_HAL_SMARTCARD_EX_H */
AnnaBridge 172:65be27845400 494
AnnaBridge 172:65be27845400 495 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/