1 /** 2 ****************************************************************************** 3 * @file stm32u5xx_hal_smartcard.h 4 * @author MCD Application Team 5 * @brief Header file of SMARTCARD HAL module. 6 ****************************************************************************** 7 * @attention 8 * 9 * Copyright (c) 2021 STMicroelectronics. 10 * All rights reserved. 11 * 12 * This software is licensed under terms that can be found in the LICENSE file 13 * in the root directory of this software component. 14 * If no LICENSE file comes with this software, it is provided AS-IS. 15 * 16 ****************************************************************************** 17 */ 18 19 /* Define to prevent recursive inclusion -------------------------------------*/ 20 #ifndef STM32U5xx_HAL_SMARTCARD_H 21 #define STM32U5xx_HAL_SMARTCARD_H 22 23 #ifdef __cplusplus 24 extern "C" { 25 #endif 26 27 /* Includes ------------------------------------------------------------------*/ 28 #include "stm32u5xx_hal_def.h" 29 30 /** @addtogroup STM32U5xx_HAL_Driver 31 * @{ 32 */ 33 34 /** @addtogroup SMARTCARD 35 * @{ 36 */ 37 38 /* Exported types ------------------------------------------------------------*/ 39 /** @defgroup SMARTCARD_Exported_Types SMARTCARD Exported Types 40 * @{ 41 */ 42 43 /** 44 * @brief SMARTCARD Init Structure definition 45 */ 46 typedef struct 47 { 48 uint32_t BaudRate; /*!< Configures the SmartCard communication baud rate. 49 The baud rate register is computed using the following formula: 50 Baud Rate Register = ((usart_ker_ckpres) / ((hsmartcard->Init.BaudRate))) 51 where usart_ker_ckpres is the USART input clock divided by a prescaler */ 52 53 uint32_t WordLength; /*!< Specifies the number of data bits transmitted or received in a frame. 54 This parameter @ref SMARTCARD_Word_Length can only be 55 set to 9 (8 data + 1 parity bits). */ 56 57 uint32_t StopBits; /*!< Specifies the number of stop bits. 58 This parameter can be a value of @ref SMARTCARD_Stop_Bits. */ 59 60 uint16_t Parity; /*!< Specifies the parity mode. 61 This parameter can be a value of @ref SMARTCARD_Parity 62 @note The parity is enabled by default (PCE is forced to 1). 63 Since the WordLength is forced to 8 bits + parity, M is 64 forced to 1 and the parity bit is the 9th bit. */ 65 66 uint16_t Mode; /*!< Specifies whether the Receive or Transmit mode is enabled or disabled. 67 This parameter can be a value of @ref SMARTCARD_Mode */ 68 69 uint16_t CLKPolarity; /*!< Specifies the steady state of the serial clock. 70 This parameter can be a value of @ref SMARTCARD_Clock_Polarity */ 71 72 uint16_t CLKPhase; /*!< Specifies the clock transition on which the bit capture is made. 73 This parameter can be a value of @ref SMARTCARD_Clock_Phase */ 74 75 uint16_t CLKLastBit; /*!< Specifies whether the clock pulse corresponding to the last transmitted 76 data bit (MSB) has to be output on the SCLK pin in synchronous mode. 77 This parameter can be a value of @ref SMARTCARD_Last_Bit */ 78 79 uint16_t OneBitSampling; /*!< Specifies whether a single sample or three samples' majority vote 80 is selected. Selecting the single sample method increases 81 the receiver tolerance to clock deviations. This parameter can be a value 82 of @ref SMARTCARD_OneBit_Sampling. */ 83 84 uint8_t Prescaler; /*!< Specifies the SmartCard Prescaler. 85 This parameter can be any value from 0x01 to 0x1F. Prescaler value is 86 multiplied by 2 to give the division factor of the source clock frequency */ 87 88 uint8_t GuardTime; /*!< Specifies the SmartCard Guard Time applied after stop bits. */ 89 90 uint16_t NACKEnable; /*!< Specifies whether the SmartCard NACK transmission is enabled 91 in case of parity error. 92 This parameter can be a value of @ref SMARTCARD_NACK_Enable */ 93 94 uint32_t TimeOutEnable; /*!< Specifies whether the receiver timeout is enabled. 95 This parameter can be a value of @ref SMARTCARD_Timeout_Enable*/ 96 97 uint32_t TimeOutValue; /*!< Specifies the receiver time out value in number of baud blocks: 98 it is used to implement the Character Wait Time (CWT) and 99 Block Wait Time (BWT). It is coded over 24 bits. */ 100 101 uint8_t BlockLength; /*!< Specifies the SmartCard Block Length in T=1 Reception mode. 102 This parameter can be any value from 0x0 to 0xFF */ 103 104 uint8_t AutoRetryCount; /*!< Specifies the SmartCard auto-retry count (number of retries in 105 receive and transmit mode). When set to 0, retransmission is 106 disabled. Otherwise, its maximum value is 7 (before signalling 107 an error) */ 108 109 uint32_t ClockPrescaler; /*!< Specifies the prescaler value used to divide the USART clock source. 110 This parameter can be a value of @ref SMARTCARD_ClockPrescaler. */ 111 112 } SMARTCARD_InitTypeDef; 113 114 /** 115 * @brief SMARTCARD advanced features initialization structure definition 116 */ 117 typedef struct 118 { 119 uint32_t AdvFeatureInit; /*!< Specifies which advanced SMARTCARD features is initialized. Several 120 advanced features may be initialized at the same time. This parameter 121 can be a value of @ref SMARTCARDEx_Advanced_Features_Initialization_Type */ 122 123 uint32_t TxPinLevelInvert; /*!< Specifies whether the TX pin active level is inverted. 124 This parameter can be a value of @ref SMARTCARD_Tx_Inv */ 125 126 uint32_t RxPinLevelInvert; /*!< Specifies whether the RX pin active level is inverted. 127 This parameter can be a value of @ref SMARTCARD_Rx_Inv */ 128 129 uint32_t DataInvert; /*!< Specifies whether data are inverted (positive/direct logic 130 vs negative/inverted logic). 131 This parameter can be a value of @ref SMARTCARD_Data_Inv */ 132 133 uint32_t Swap; /*!< Specifies whether TX and RX pins are swapped. 134 This parameter can be a value of @ref SMARTCARD_Rx_Tx_Swap */ 135 136 uint32_t OverrunDisable; /*!< Specifies whether the reception overrun detection is disabled. 137 This parameter can be a value of @ref SMARTCARD_Overrun_Disable */ 138 139 uint32_t DMADisableonRxError; /*!< Specifies whether the DMA is disabled in case of reception error. 140 This parameter can be a value of @ref SMARTCARD_DMA_Disable_on_Rx_Error */ 141 142 uint32_t MSBFirst; /*!< Specifies whether MSB is sent first on UART line. 143 This parameter can be a value of @ref SMARTCARD_MSB_First */ 144 145 uint16_t TxCompletionIndication; /*!< Specifies which transmission completion indication is used: before (when 146 relevant flag is available) or once guard time period has elapsed. 147 This parameter can be a value 148 of @ref SMARTCARDEx_Transmission_Completion_Indication. */ 149 } SMARTCARD_AdvFeatureInitTypeDef; 150 151 /** 152 * @brief HAL SMARTCARD State definition 153 * @note HAL SMARTCARD State value is a combination of 2 different substates: 154 * gState and RxState (see @ref SMARTCARD_State_Definition). 155 * - gState contains SMARTCARD state information related to global Handle management 156 * and also information related to Tx operations. 157 * gState value coding follow below described bitmap : 158 * b7-b6 Error information 159 * 00 : No Error 160 * 01 : (Not Used) 161 * 10 : Timeout 162 * 11 : Error 163 * b5 Peripheral initialization status 164 * 0 : Reset (Peripheral not initialized) 165 * 1 : Init done (Peripheral initialized. HAL SMARTCARD Init function already called) 166 * b4-b3 (not used) 167 * xx : Should be set to 00 168 * b2 Intrinsic process state 169 * 0 : Ready 170 * 1 : Busy (Peripheral busy with some configuration or internal operations) 171 * b1 (not used) 172 * x : Should be set to 0 173 * b0 Tx state 174 * 0 : Ready (no Tx operation ongoing) 175 * 1 : Busy (Tx operation ongoing) 176 * - RxState contains information related to Rx operations. 177 * RxState value coding follow below described bitmap : 178 * b7-b6 (not used) 179 * xx : Should be set to 00 180 * b5 Peripheral initialization status 181 * 0 : Reset (Peripheral not initialized) 182 * 1 : Init done (Peripheral initialized) 183 * b4-b2 (not used) 184 * xxx : Should be set to 000 185 * b1 Rx state 186 * 0 : Ready (no Rx operation ongoing) 187 * 1 : Busy (Rx operation ongoing) 188 * b0 (not used) 189 * x : Should be set to 0. 190 */ 191 typedef uint32_t HAL_SMARTCARD_StateTypeDef; 192 193 /** 194 * @brief SMARTCARD handle Structure definition 195 */ 196 typedef struct __SMARTCARD_HandleTypeDef 197 { 198 USART_TypeDef *Instance; /*!< USART registers base address */ 199 200 SMARTCARD_InitTypeDef Init; /*!< SmartCard communication parameters */ 201 202 SMARTCARD_AdvFeatureInitTypeDef AdvancedInit; /*!< SmartCard advanced features initialization parameters */ 203 204 const uint8_t *pTxBuffPtr; /*!< Pointer to SmartCard Tx transfer Buffer */ 205 206 uint16_t TxXferSize; /*!< SmartCard Tx Transfer size */ 207 208 __IO uint16_t TxXferCount; /*!< SmartCard Tx Transfer Counter */ 209 210 uint8_t *pRxBuffPtr; /*!< Pointer to SmartCard Rx transfer Buffer */ 211 212 uint16_t RxXferSize; /*!< SmartCard Rx Transfer size */ 213 214 __IO uint16_t RxXferCount; /*!< SmartCard Rx Transfer Counter */ 215 216 uint16_t NbRxDataToProcess; /*!< Number of data to process during RX ISR execution */ 217 218 uint16_t NbTxDataToProcess; /*!< Number of data to process during TX ISR execution */ 219 220 uint32_t FifoMode; /*!< Specifies if the FIFO mode will be used. 221 This parameter can be a value of 222 @ref SMARTCARDEx_FIFO_mode. */ 223 224 void (*RxISR)(struct __SMARTCARD_HandleTypeDef *huart); /*!< Function pointer on Rx IRQ handler */ 225 226 void (*TxISR)(struct __SMARTCARD_HandleTypeDef *huart); /*!< Function pointer on Tx IRQ handler */ 227 228 #if defined(HAL_DMA_MODULE_ENABLED) 229 DMA_HandleTypeDef *hdmatx; /*!< SmartCard Tx DMA Handle parameters */ 230 231 DMA_HandleTypeDef *hdmarx; /*!< SmartCard Rx DMA Handle parameters */ 232 233 #endif /* HAL_DMA_MODULE_ENABLED */ 234 HAL_LockTypeDef Lock; /*!< Locking object */ 235 236 __IO HAL_SMARTCARD_StateTypeDef gState; /*!< SmartCard state information related to global 237 Handle management and also related to Tx operations. 238 This parameter can be a value 239 of @ref HAL_SMARTCARD_StateTypeDef */ 240 241 __IO HAL_SMARTCARD_StateTypeDef RxState; /*!< SmartCard state information related to Rx operations. 242 This parameter can be a value 243 of @ref HAL_SMARTCARD_StateTypeDef */ 244 245 __IO uint32_t ErrorCode; /*!< SmartCard Error code */ 246 247 #if (USE_HAL_SMARTCARD_REGISTER_CALLBACKS == 1) 248 void (* TxCpltCallback)(struct __SMARTCARD_HandleTypeDef *hsmartcard); /*!< SMARTCARD Tx Complete Callback */ 249 250 void (* RxCpltCallback)(struct __SMARTCARD_HandleTypeDef *hsmartcard); /*!< SMARTCARD Rx Complete Callback */ 251 252 void (* ErrorCallback)(struct __SMARTCARD_HandleTypeDef *hsmartcard); /*!< SMARTCARD Error Callback */ 253 254 void (* AbortCpltCallback)(struct __SMARTCARD_HandleTypeDef *hsmartcard); /*!< SMARTCARD Abort Complete Callback */ 255 256 void (* AbortTransmitCpltCallback)(struct __SMARTCARD_HandleTypeDef *hsmartcard); /*!< SMARTCARD Abort Transmit Complete Callback */ 257 258 void (* AbortReceiveCpltCallback)(struct __SMARTCARD_HandleTypeDef *hsmartcard); /*!< SMARTCARD Abort Receive Complete Callback */ 259 260 void (* RxFifoFullCallback)(struct __SMARTCARD_HandleTypeDef *hsmartcard); /*!< SMARTCARD Rx Fifo Full Callback */ 261 262 void (* TxFifoEmptyCallback)(struct __SMARTCARD_HandleTypeDef *hsmartcard); /*!< SMARTCARD Tx Fifo Empty Callback */ 263 264 void (* MspInitCallback)(struct __SMARTCARD_HandleTypeDef *hsmartcard); /*!< SMARTCARD Msp Init callback */ 265 266 void (* MspDeInitCallback)(struct __SMARTCARD_HandleTypeDef *hsmartcard); /*!< SMARTCARD Msp DeInit callback */ 267 #endif /* USE_HAL_SMARTCARD_REGISTER_CALLBACKS */ 268 269 } SMARTCARD_HandleTypeDef; 270 271 #if (USE_HAL_SMARTCARD_REGISTER_CALLBACKS == 1) 272 /** 273 * @brief HAL SMARTCARD Callback ID enumeration definition 274 */ 275 typedef enum 276 { 277 HAL_SMARTCARD_TX_COMPLETE_CB_ID = 0x00U, /*!< SMARTCARD Tx Complete Callback ID */ 278 HAL_SMARTCARD_RX_COMPLETE_CB_ID = 0x01U, /*!< SMARTCARD Rx Complete Callback ID */ 279 HAL_SMARTCARD_ERROR_CB_ID = 0x02U, /*!< SMARTCARD Error Callback ID */ 280 HAL_SMARTCARD_ABORT_COMPLETE_CB_ID = 0x03U, /*!< SMARTCARD Abort Complete Callback ID */ 281 HAL_SMARTCARD_ABORT_TRANSMIT_COMPLETE_CB_ID = 0x04U, /*!< SMARTCARD Abort Transmit Complete Callback ID */ 282 HAL_SMARTCARD_ABORT_RECEIVE_COMPLETE_CB_ID = 0x05U, /*!< SMARTCARD Abort Receive Complete Callback ID */ 283 HAL_SMARTCARD_RX_FIFO_FULL_CB_ID = 0x06U, /*!< SMARTCARD Rx Fifo Full Callback ID */ 284 HAL_SMARTCARD_TX_FIFO_EMPTY_CB_ID = 0x07U, /*!< SMARTCARD Tx Fifo Empty Callback ID */ 285 286 HAL_SMARTCARD_MSPINIT_CB_ID = 0x08U, /*!< SMARTCARD MspInit callback ID */ 287 HAL_SMARTCARD_MSPDEINIT_CB_ID = 0x09U /*!< SMARTCARD MspDeInit callback ID */ 288 289 } HAL_SMARTCARD_CallbackIDTypeDef; 290 291 /** 292 * @brief HAL SMARTCARD Callback pointer definition 293 */ 294 typedef void (*pSMARTCARD_CallbackTypeDef)(SMARTCARD_HandleTypeDef *hsmartcard); /*!< pointer to an SMARTCARD callback function */ 295 296 #endif /* USE_HAL_SMARTCARD_REGISTER_CALLBACKS */ 297 298 /** 299 * @brief SMARTCARD clock sources 300 */ 301 typedef enum 302 { 303 SMARTCARD_CLOCKSOURCE_PCLK1 = 0x00U, /*!< PCLK1 clock source */ 304 SMARTCARD_CLOCKSOURCE_PCLK2 = 0x01U, /*!< PCLK2 clock source */ 305 SMARTCARD_CLOCKSOURCE_HSI = 0x02U, /*!< HSI clock source */ 306 SMARTCARD_CLOCKSOURCE_SYSCLK = 0x04U, /*!< SYSCLK clock source */ 307 SMARTCARD_CLOCKSOURCE_LSE = 0x08U, /*!< LSE clock source */ 308 SMARTCARD_CLOCKSOURCE_UNDEFINED = 0x10U /*!< undefined clock source */ 309 } SMARTCARD_ClockSourceTypeDef; 310 311 /** 312 * @} 313 */ 314 315 /* Exported constants --------------------------------------------------------*/ 316 /** @defgroup SMARTCARD_Exported_Constants SMARTCARD Exported Constants 317 * @{ 318 */ 319 320 /** @defgroup SMARTCARD_State_Definition SMARTCARD State Code Definition 321 * @{ 322 */ 323 #define HAL_SMARTCARD_STATE_RESET 0x00000000U /*!< Peripheral is not initialized. Value 324 is allowed for gState and RxState */ 325 #define HAL_SMARTCARD_STATE_READY 0x00000020U /*!< Peripheral Initialized and ready for 326 use. Value is allowed for gState 327 and RxState */ 328 #define HAL_SMARTCARD_STATE_BUSY 0x00000024U /*!< an internal process is ongoing 329 Value is allowed for gState only */ 330 #define HAL_SMARTCARD_STATE_BUSY_TX 0x00000021U /*!< Data Transmission process is ongoing 331 Value is allowed for gState only */ 332 #define HAL_SMARTCARD_STATE_BUSY_RX 0x00000022U /*!< Data Reception process is ongoing 333 Value is allowed for RxState only */ 334 #define HAL_SMARTCARD_STATE_BUSY_TX_RX 0x00000023U /*!< Data Transmission and Reception 335 process is ongoing Not to be used for 336 neither gState nor RxState. 337 Value is result of combination (Or) 338 between gState and RxState values */ 339 #define HAL_SMARTCARD_STATE_TIMEOUT 0x000000A0U /*!< Timeout state 340 Value is allowed for gState only */ 341 #define HAL_SMARTCARD_STATE_ERROR 0x000000E0U /*!< Error 342 Value is allowed for gState only */ 343 /** 344 * @} 345 */ 346 347 /** @defgroup SMARTCARD_Error_Definition SMARTCARD Error Code Definition 348 * @{ 349 */ 350 #define HAL_SMARTCARD_ERROR_NONE (0x00000000U) /*!< No error */ 351 #define HAL_SMARTCARD_ERROR_PE (0x00000001U) /*!< Parity error */ 352 #define HAL_SMARTCARD_ERROR_NE (0x00000002U) /*!< Noise error */ 353 #define HAL_SMARTCARD_ERROR_FE (0x00000004U) /*!< frame error */ 354 #define HAL_SMARTCARD_ERROR_ORE (0x00000008U) /*!< Overrun error */ 355 #if defined(HAL_DMA_MODULE_ENABLED) 356 #define HAL_SMARTCARD_ERROR_DMA (0x00000010U) /*!< DMA transfer error */ 357 #endif /* HAL_DMA_MODULE_ENABLED */ 358 #define HAL_SMARTCARD_ERROR_RTO (0x00000020U) /*!< Receiver TimeOut error */ 359 #if (USE_HAL_SMARTCARD_REGISTER_CALLBACKS == 1) 360 #define HAL_SMARTCARD_ERROR_INVALID_CALLBACK (0x00000040U) /*!< Invalid Callback error */ 361 #endif /* USE_HAL_SMARTCARD_REGISTER_CALLBACKS */ 362 /** 363 * @} 364 */ 365 366 /** @defgroup SMARTCARD_Word_Length SMARTCARD Word Length 367 * @{ 368 */ 369 #define SMARTCARD_WORDLENGTH_9B USART_CR1_M0 /*!< SMARTCARD frame length */ 370 /** 371 * @} 372 */ 373 374 /** @defgroup SMARTCARD_Stop_Bits SMARTCARD Number of Stop Bits 375 * @{ 376 */ 377 #define SMARTCARD_STOPBITS_0_5 USART_CR2_STOP_0 /*!< SMARTCARD frame with 0.5 stop bit */ 378 #define SMARTCARD_STOPBITS_1_5 USART_CR2_STOP /*!< SMARTCARD frame with 1.5 stop bits */ 379 /** 380 * @} 381 */ 382 383 /** @defgroup SMARTCARD_Parity SMARTCARD Parity 384 * @{ 385 */ 386 #define SMARTCARD_PARITY_EVEN USART_CR1_PCE /*!< SMARTCARD frame even parity */ 387 #define SMARTCARD_PARITY_ODD (USART_CR1_PCE | USART_CR1_PS) /*!< SMARTCARD frame odd parity */ 388 /** 389 * @} 390 */ 391 392 /** @defgroup SMARTCARD_Mode SMARTCARD Transfer Mode 393 * @{ 394 */ 395 #define SMARTCARD_MODE_RX USART_CR1_RE /*!< SMARTCARD RX mode */ 396 #define SMARTCARD_MODE_TX USART_CR1_TE /*!< SMARTCARD TX mode */ 397 #define SMARTCARD_MODE_TX_RX (USART_CR1_TE |USART_CR1_RE) /*!< SMARTCARD RX and TX mode */ 398 /** 399 * @} 400 */ 401 402 /** @defgroup SMARTCARD_Clock_Polarity SMARTCARD Clock Polarity 403 * @{ 404 */ 405 #define SMARTCARD_POLARITY_LOW 0x00000000U /*!< SMARTCARD frame low polarity */ 406 #define SMARTCARD_POLARITY_HIGH USART_CR2_CPOL /*!< SMARTCARD frame high polarity */ 407 /** 408 * @} 409 */ 410 411 /** @defgroup SMARTCARD_Clock_Phase SMARTCARD Clock Phase 412 * @{ 413 */ 414 #define SMARTCARD_PHASE_1EDGE 0x00000000U /*!< SMARTCARD frame phase on first clock transition */ 415 #define SMARTCARD_PHASE_2EDGE USART_CR2_CPHA /*!< SMARTCARD frame phase on second clock transition */ 416 /** 417 * @} 418 */ 419 420 /** @defgroup SMARTCARD_Last_Bit SMARTCARD Last Bit 421 * @{ 422 */ 423 #define SMARTCARD_LASTBIT_DISABLE 0x00000000U /*!< SMARTCARD frame last data bit clock pulse not output to SCLK pin */ 424 #define SMARTCARD_LASTBIT_ENABLE USART_CR2_LBCL /*!< SMARTCARD frame last data bit clock pulse output to SCLK pin */ 425 /** 426 * @} 427 */ 428 429 /** @defgroup SMARTCARD_OneBit_Sampling SMARTCARD One Bit Sampling Method 430 * @{ 431 */ 432 #define SMARTCARD_ONE_BIT_SAMPLE_DISABLE 0x00000000U /*!< SMARTCARD frame one-bit sample disabled */ 433 #define SMARTCARD_ONE_BIT_SAMPLE_ENABLE USART_CR3_ONEBIT /*!< SMARTCARD frame one-bit sample enabled */ 434 /** 435 * @} 436 */ 437 438 /** @defgroup SMARTCARD_NACK_Enable SMARTCARD NACK Enable 439 * @{ 440 */ 441 #define SMARTCARD_NACK_DISABLE 0x00000000U /*!< SMARTCARD NACK transmission disabled */ 442 #define SMARTCARD_NACK_ENABLE USART_CR3_NACK /*!< SMARTCARD NACK transmission enabled */ 443 /** 444 * @} 445 */ 446 447 /** @defgroup SMARTCARD_Timeout_Enable SMARTCARD Timeout Enable 448 * @{ 449 */ 450 #define SMARTCARD_TIMEOUT_DISABLE 0x00000000U /*!< SMARTCARD receiver timeout disabled */ 451 #define SMARTCARD_TIMEOUT_ENABLE USART_CR2_RTOEN /*!< SMARTCARD receiver timeout enabled */ 452 /** 453 * @} 454 */ 455 456 /** @defgroup SMARTCARD_ClockPrescaler SMARTCARD Clock Prescaler 457 * @{ 458 */ 459 #define SMARTCARD_PRESCALER_DIV1 0x00000000U /*!< fclk_pres = fclk */ 460 #define SMARTCARD_PRESCALER_DIV2 0x00000001U /*!< fclk_pres = fclk/2 */ 461 #define SMARTCARD_PRESCALER_DIV4 0x00000002U /*!< fclk_pres = fclk/4 */ 462 #define SMARTCARD_PRESCALER_DIV6 0x00000003U /*!< fclk_pres = fclk/6 */ 463 #define SMARTCARD_PRESCALER_DIV8 0x00000004U /*!< fclk_pres = fclk/8 */ 464 #define SMARTCARD_PRESCALER_DIV10 0x00000005U /*!< fclk_pres = fclk/10 */ 465 #define SMARTCARD_PRESCALER_DIV12 0x00000006U /*!< fclk_pres = fclk/12 */ 466 #define SMARTCARD_PRESCALER_DIV16 0x00000007U /*!< fclk_pres = fclk/16 */ 467 #define SMARTCARD_PRESCALER_DIV32 0x00000008U /*!< fclk_pres = fclk/32 */ 468 #define SMARTCARD_PRESCALER_DIV64 0x00000009U /*!< fclk_pres = fclk/64 */ 469 #define SMARTCARD_PRESCALER_DIV128 0x0000000AU /*!< fclk_pres = fclk/128 */ 470 #define SMARTCARD_PRESCALER_DIV256 0x0000000BU /*!< fclk_pres = fclk/256 */ 471 /** 472 * @} 473 */ 474 475 /** @defgroup SMARTCARD_Tx_Inv SMARTCARD advanced feature TX pin active level inversion 476 * @{ 477 */ 478 #define SMARTCARD_ADVFEATURE_TXINV_DISABLE 0x00000000U /*!< TX pin active level inversion disable */ 479 #define SMARTCARD_ADVFEATURE_TXINV_ENABLE USART_CR2_TXINV /*!< TX pin active level inversion enable */ 480 /** 481 * @} 482 */ 483 484 /** @defgroup SMARTCARD_Rx_Inv SMARTCARD advanced feature RX pin active level inversion 485 * @{ 486 */ 487 #define SMARTCARD_ADVFEATURE_RXINV_DISABLE 0x00000000U /*!< RX pin active level inversion disable */ 488 #define SMARTCARD_ADVFEATURE_RXINV_ENABLE USART_CR2_RXINV /*!< RX pin active level inversion enable */ 489 /** 490 * @} 491 */ 492 493 /** @defgroup SMARTCARD_Data_Inv SMARTCARD advanced feature Binary Data inversion 494 * @{ 495 */ 496 #define SMARTCARD_ADVFEATURE_DATAINV_DISABLE 0x00000000U /*!< Binary data inversion disable */ 497 #define SMARTCARD_ADVFEATURE_DATAINV_ENABLE USART_CR2_DATAINV /*!< Binary data inversion enable */ 498 /** 499 * @} 500 */ 501 502 /** @defgroup SMARTCARD_Rx_Tx_Swap SMARTCARD advanced feature RX TX pins swap 503 * @{ 504 */ 505 #define SMARTCARD_ADVFEATURE_SWAP_DISABLE 0x00000000U /*!< TX/RX pins swap disable */ 506 #define SMARTCARD_ADVFEATURE_SWAP_ENABLE USART_CR2_SWAP /*!< TX/RX pins swap enable */ 507 /** 508 * @} 509 */ 510 511 /** @defgroup SMARTCARD_Overrun_Disable SMARTCARD advanced feature Overrun Disable 512 * @{ 513 */ 514 #define SMARTCARD_ADVFEATURE_OVERRUN_ENABLE 0x00000000U /*!< RX overrun enable */ 515 #define SMARTCARD_ADVFEATURE_OVERRUN_DISABLE USART_CR3_OVRDIS /*!< RX overrun disable */ 516 /** 517 * @} 518 */ 519 520 /** @defgroup SMARTCARD_DMA_Disable_on_Rx_Error SMARTCARD advanced feature DMA Disable on Rx Error 521 * @{ 522 */ 523 #define SMARTCARD_ADVFEATURE_DMA_ENABLEONRXERROR 0x00000000U /*!< DMA enable on Reception Error */ 524 #define SMARTCARD_ADVFEATURE_DMA_DISABLEONRXERROR USART_CR3_DDRE /*!< DMA disable on Reception Error */ 525 /** 526 * @} 527 */ 528 529 /** @defgroup SMARTCARD_MSB_First SMARTCARD advanced feature MSB first 530 * @{ 531 */ 532 #define SMARTCARD_ADVFEATURE_MSBFIRST_DISABLE 0x00000000U /*!< Most significant bit sent/received first disable */ 533 #define SMARTCARD_ADVFEATURE_MSBFIRST_ENABLE USART_CR2_MSBFIRST /*!< Most significant bit sent/received first enable */ 534 /** 535 * @} 536 */ 537 538 /** @defgroup SMARTCARD_Request_Parameters SMARTCARD Request Parameters 539 * @{ 540 */ 541 #define SMARTCARD_RXDATA_FLUSH_REQUEST USART_RQR_RXFRQ /*!< Receive data flush request */ 542 #define SMARTCARD_TXDATA_FLUSH_REQUEST USART_RQR_TXFRQ /*!< Transmit data flush request */ 543 /** 544 * @} 545 */ 546 547 /** @defgroup SMARTCARD_Interruption_Mask SMARTCARD interruptions flags mask 548 * @{ 549 */ 550 #define SMARTCARD_IT_MASK 0x001FU /*!< SMARTCARD interruptions flags mask */ 551 #define SMARTCARD_CR_MASK 0x00E0U /*!< SMARTCARD control register mask */ 552 #define SMARTCARD_CR_POS 5U /*!< SMARTCARD control register position */ 553 #define SMARTCARD_ISR_MASK 0x1F00U /*!< SMARTCARD ISR register mask */ 554 #define SMARTCARD_ISR_POS 8U /*!< SMARTCARD ISR register position */ 555 /** 556 * @} 557 */ 558 559 /** 560 * @} 561 */ 562 563 /* Exported macros -----------------------------------------------------------*/ 564 /** @defgroup SMARTCARD_Exported_Macros SMARTCARD Exported Macros 565 * @{ 566 */ 567 568 /** @brief Reset SMARTCARD handle states. 569 * @param __HANDLE__ SMARTCARD handle. 570 * @retval None 571 */ 572 #if USE_HAL_SMARTCARD_REGISTER_CALLBACKS == 1 573 #define __HAL_SMARTCARD_RESET_HANDLE_STATE(__HANDLE__) do{ \ 574 (__HANDLE__)->gState = HAL_SMARTCARD_STATE_RESET; \ 575 (__HANDLE__)->RxState = HAL_SMARTCARD_STATE_RESET; \ 576 (__HANDLE__)->MspInitCallback = NULL; \ 577 (__HANDLE__)->MspDeInitCallback = NULL; \ 578 } while(0U) 579 #else 580 #define __HAL_SMARTCARD_RESET_HANDLE_STATE(__HANDLE__) do{ \ 581 (__HANDLE__)->gState = HAL_SMARTCARD_STATE_RESET; \ 582 (__HANDLE__)->RxState = HAL_SMARTCARD_STATE_RESET; \ 583 } while(0U) 584 #endif /*USE_HAL_SMARTCARD_REGISTER_CALLBACKS */ 585 586 /** @brief Flush the Smartcard Data registers. 587 * @param __HANDLE__ specifies the SMARTCARD Handle. 588 * @retval None 589 */ 590 #define __HAL_SMARTCARD_FLUSH_DRREGISTER(__HANDLE__) \ 591 do{ \ 592 SET_BIT((__HANDLE__)->Instance->RQR, SMARTCARD_RXDATA_FLUSH_REQUEST); \ 593 SET_BIT((__HANDLE__)->Instance->RQR, SMARTCARD_TXDATA_FLUSH_REQUEST); \ 594 } while(0U) 595 596 /** @brief Clear the specified SMARTCARD pending flag. 597 * @param __HANDLE__ specifies the SMARTCARD Handle. 598 * @param __FLAG__ specifies the flag to check. 599 * This parameter can be any combination of the following values: 600 * @arg @ref SMARTCARD_CLEAR_PEF Parity error clear flag 601 * @arg @ref SMARTCARD_CLEAR_FEF Framing error clear flag 602 * @arg @ref SMARTCARD_CLEAR_NEF Noise detected clear flag 603 * @arg @ref SMARTCARD_CLEAR_OREF OverRun error clear flag 604 * @arg @ref SMARTCARD_CLEAR_IDLEF Idle line detected clear flag 605 * @arg @ref SMARTCARD_CLEAR_TCF Transmission complete clear flag 606 * @arg @ref SMARTCARD_CLEAR_TCBGTF Transmission complete before guard time clear flag 607 * @arg @ref SMARTCARD_CLEAR_RTOF Receiver timeout clear flag 608 * @arg @ref SMARTCARD_CLEAR_EOBF End of block clear flag 609 * @arg @ref SMARTCARD_CLEAR_TXFECF TXFIFO empty Clear flag 610 * @retval None 611 */ 612 #define __HAL_SMARTCARD_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = (__FLAG__)) 613 614 /** @brief Clear the SMARTCARD PE pending flag. 615 * @param __HANDLE__ specifies the SMARTCARD Handle. 616 * @retval None 617 */ 618 #define __HAL_SMARTCARD_CLEAR_PEFLAG(__HANDLE__) __HAL_SMARTCARD_CLEAR_FLAG((__HANDLE__), SMARTCARD_CLEAR_PEF) 619 620 /** @brief Clear the SMARTCARD FE pending flag. 621 * @param __HANDLE__ specifies the SMARTCARD Handle. 622 * @retval None 623 */ 624 #define __HAL_SMARTCARD_CLEAR_FEFLAG(__HANDLE__) __HAL_SMARTCARD_CLEAR_FLAG((__HANDLE__), SMARTCARD_CLEAR_FEF) 625 626 /** @brief Clear the SMARTCARD NE pending flag. 627 * @param __HANDLE__ specifies the SMARTCARD Handle. 628 * @retval None 629 */ 630 #define __HAL_SMARTCARD_CLEAR_NEFLAG(__HANDLE__) __HAL_SMARTCARD_CLEAR_FLAG((__HANDLE__), SMARTCARD_CLEAR_NEF) 631 632 /** @brief Clear the SMARTCARD ORE pending flag. 633 * @param __HANDLE__ specifies the SMARTCARD Handle. 634 * @retval None 635 */ 636 #define __HAL_SMARTCARD_CLEAR_OREFLAG(__HANDLE__) __HAL_SMARTCARD_CLEAR_FLAG((__HANDLE__), SMARTCARD_CLEAR_OREF) 637 638 /** @brief Clear the SMARTCARD IDLE pending flag. 639 * @param __HANDLE__ specifies the SMARTCARD Handle. 640 * @retval None 641 */ 642 #define __HAL_SMARTCARD_CLEAR_IDLEFLAG(__HANDLE__) __HAL_SMARTCARD_CLEAR_FLAG((__HANDLE__), SMARTCARD_CLEAR_IDLEF) 643 644 /** @brief Check whether the specified Smartcard flag is set or not. 645 * @param __HANDLE__ specifies the SMARTCARD Handle. 646 * @param __FLAG__ specifies the flag to check. 647 * This parameter can be one of the following values: 648 * @arg @ref SMARTCARD_FLAG_TCBGT Transmission complete before guard time flag (when flag available) 649 * @arg @ref SMARTCARD_FLAG_REACK Receive enable acknowledge flag 650 * @arg @ref SMARTCARD_FLAG_TEACK Transmit enable acknowledge flag 651 * @arg @ref SMARTCARD_FLAG_BUSY Busy flag 652 * @arg @ref SMARTCARD_FLAG_EOBF End of block flag 653 * @arg @ref SMARTCARD_FLAG_RTOF Receiver timeout flag 654 * @arg @ref SMARTCARD_FLAG_TXE Transmit data register empty flag 655 * @arg @ref SMARTCARD_FLAG_TC Transmission complete flag 656 * @arg @ref SMARTCARD_FLAG_RXNE Receive data register not empty flag 657 * @arg @ref SMARTCARD_FLAG_IDLE Idle line detection flag 658 * @arg @ref SMARTCARD_FLAG_ORE Overrun error flag 659 * @arg @ref SMARTCARD_FLAG_NE Noise error flag 660 * @arg @ref SMARTCARD_FLAG_FE Framing error flag 661 * @arg @ref SMARTCARD_FLAG_PE Parity error flag 662 * @arg @ref SMARTCARD_FLAG_TXFNF TXFIFO not full flag 663 * @arg @ref SMARTCARD_FLAG_RXFNE RXFIFO not empty flag 664 * @arg @ref SMARTCARD_FLAG_TXFE TXFIFO Empty flag 665 * @arg @ref SMARTCARD_FLAG_RXFF RXFIFO Full flag 666 * @arg @ref SMARTCARD_FLAG_RXFT SMARTCARD RXFIFO threshold flag 667 * @arg @ref SMARTCARD_FLAG_TXFT SMARTCARD TXFIFO threshold flag 668 * @retval The new state of __FLAG__ (TRUE or FALSE). 669 */ 670 #define __HAL_SMARTCARD_GET_FLAG(__HANDLE__, __FLAG__) (((__HANDLE__)->Instance->ISR & (__FLAG__)) == (__FLAG__)) 671 672 /** @brief Enable the specified SmartCard interrupt. 673 * @param __HANDLE__ specifies the SMARTCARD Handle. 674 * @param __INTERRUPT__ specifies the SMARTCARD interrupt to enable. 675 * This parameter can be one of the following values: 676 * @arg @ref SMARTCARD_IT_EOB End of block interrupt 677 * @arg @ref SMARTCARD_IT_RTO Receive timeout interrupt 678 * @arg @ref SMARTCARD_IT_TXE Transmit data register empty interrupt 679 * @arg @ref SMARTCARD_IT_TC Transmission complete interrupt 680 * @arg @ref SMARTCARD_IT_TCBGT Transmission complete before 681 * guard time interrupt (when interruption available) 682 * @arg @ref SMARTCARD_IT_RXNE Receive data register not empty interrupt 683 * @arg @ref SMARTCARD_IT_IDLE Idle line detection interrupt 684 * @arg @ref SMARTCARD_IT_PE Parity error interrupt 685 * @arg @ref SMARTCARD_IT_ERR Error interrupt(frame error, noise error, overrun error) 686 * @arg @ref SMARTCARD_IT_TXFNF TX FIFO not full interruption 687 * @arg @ref SMARTCARD_IT_RXFNE RXFIFO not empty interruption 688 * @arg @ref SMARTCARD_IT_RXFF RXFIFO full interruption 689 * @arg @ref SMARTCARD_IT_TXFE TXFIFO empty interruption 690 * @arg @ref SMARTCARD_IT_RXFT RXFIFO threshold reached interruption 691 * @arg @ref SMARTCARD_IT_TXFT TXFIFO threshold reached interruption 692 * @retval None 693 */ 694 #define __HAL_SMARTCARD_ENABLE_IT(__HANDLE__, __INTERRUPT__) (((((__INTERRUPT__) & SMARTCARD_CR_MASK) >>\ 695 SMARTCARD_CR_POS) == 1U)?\ 696 ((__HANDLE__)->Instance->CR1 |= (1UL <<\ 697 ((__INTERRUPT__) & SMARTCARD_IT_MASK))):\ 698 ((((__INTERRUPT__) & SMARTCARD_CR_MASK) >>\ 699 SMARTCARD_CR_POS) == 2U)?\ 700 ((__HANDLE__)->Instance->CR2 |= (1UL <<\ 701 ((__INTERRUPT__) & SMARTCARD_IT_MASK))): \ 702 ((__HANDLE__)->Instance->CR3 |= (1UL <<\ 703 ((__INTERRUPT__) & SMARTCARD_IT_MASK)))) 704 705 /** @brief Disable the specified SmartCard interrupt. 706 * @param __HANDLE__ specifies the SMARTCARD Handle. 707 * @param __INTERRUPT__ specifies the SMARTCARD interrupt to disable. 708 * This parameter can be one of the following values: 709 * @arg @ref SMARTCARD_IT_EOB End of block interrupt 710 * @arg @ref SMARTCARD_IT_RTO Receive timeout interrupt 711 * @arg @ref SMARTCARD_IT_TXE Transmit data register empty interrupt 712 * @arg @ref SMARTCARD_IT_TC Transmission complete interrupt 713 * @arg @ref SMARTCARD_IT_TCBGT Transmission complete before guard 714 * time interrupt (when interruption available) 715 * @arg @ref SMARTCARD_IT_RXNE Receive data register not empty interrupt 716 * @arg @ref SMARTCARD_IT_IDLE Idle line detection interrupt 717 * @arg @ref SMARTCARD_IT_PE Parity error interrupt 718 * @arg @ref SMARTCARD_IT_ERR Error interrupt(frame error, noise error, overrun error) 719 * @arg @ref SMARTCARD_IT_TXFNF TX FIFO not full interruption 720 * @arg @ref SMARTCARD_IT_RXFNE RXFIFO not empty interruption 721 * @arg @ref SMARTCARD_IT_RXFF RXFIFO full interruption 722 * @arg @ref SMARTCARD_IT_TXFE TXFIFO empty interruption 723 * @arg @ref SMARTCARD_IT_RXFT RXFIFO threshold reached interruption 724 * @arg @ref SMARTCARD_IT_TXFT TXFIFO threshold reached interruption 725 * @retval None 726 */ 727 #define __HAL_SMARTCARD_DISABLE_IT(__HANDLE__, __INTERRUPT__) (((((__INTERRUPT__) & SMARTCARD_CR_MASK) >>\ 728 SMARTCARD_CR_POS) == 1U)?\ 729 ((__HANDLE__)->Instance->CR1 &= ~ (1U <<\ 730 ((__INTERRUPT__) & SMARTCARD_IT_MASK))): \ 731 ((((__INTERRUPT__) & SMARTCARD_CR_MASK) >>\ 732 SMARTCARD_CR_POS) == 2U)?\ 733 ((__HANDLE__)->Instance->CR2 &= ~ (1U <<\ 734 ((__INTERRUPT__) & SMARTCARD_IT_MASK))): \ 735 ((__HANDLE__)->Instance->CR3 &= ~ (1U <<\ 736 ((__INTERRUPT__) & SMARTCARD_IT_MASK)))) 737 738 /** @brief Check whether the specified SmartCard interrupt has occurred or not. 739 * @param __HANDLE__ specifies the SMARTCARD Handle. 740 * @param __INTERRUPT__ specifies the SMARTCARD interrupt to check. 741 * This parameter can be one of the following values: 742 * @arg @ref SMARTCARD_IT_EOB End of block interrupt 743 * @arg @ref SMARTCARD_IT_RTO Receive timeout interrupt 744 * @arg @ref SMARTCARD_IT_TXE Transmit data register empty interrupt 745 * @arg @ref SMARTCARD_IT_TC Transmission complete interrupt 746 * @arg @ref SMARTCARD_IT_TCBGT Transmission complete before guard time 747 * interrupt (when interruption available) 748 * @arg @ref SMARTCARD_IT_RXNE Receive data register not empty interrupt 749 * @arg @ref SMARTCARD_IT_IDLE Idle line detection interrupt 750 * @arg @ref SMARTCARD_IT_PE Parity error interrupt 751 * @arg @ref SMARTCARD_IT_ERR Error interrupt(frame error, noise error, overrun error) 752 * @arg @ref SMARTCARD_IT_TXFNF TX FIFO not full interruption 753 * @arg @ref SMARTCARD_IT_RXFNE RXFIFO not empty interruption 754 * @arg @ref SMARTCARD_IT_RXFF RXFIFO full interruption 755 * @arg @ref SMARTCARD_IT_TXFE TXFIFO empty interruption 756 * @arg @ref SMARTCARD_IT_RXFT RXFIFO threshold reached interruption 757 * @arg @ref SMARTCARD_IT_TXFT TXFIFO threshold reached interruption 758 * @retval The new state of __INTERRUPT__ (SET or RESET). 759 */ 760 #define __HAL_SMARTCARD_GET_IT(__HANDLE__, __INTERRUPT__) (\ 761 (((__HANDLE__)->Instance->ISR & (0x01UL << (((__INTERRUPT__)\ 762 & SMARTCARD_ISR_MASK)>> SMARTCARD_ISR_POS)))!= 0U)\ 763 ? SET : RESET) 764 765 /** @brief Check whether the specified SmartCard interrupt source is enabled or not. 766 * @param __HANDLE__ specifies the SMARTCARD Handle. 767 * @param __INTERRUPT__ specifies the SMARTCARD interrupt source to check. 768 * This parameter can be one of the following values: 769 * @arg @ref SMARTCARD_IT_EOB End of block interrupt 770 * @arg @ref SMARTCARD_IT_RTO Receive timeout interrupt 771 * @arg @ref SMARTCARD_IT_TXE Transmit data register empty interrupt 772 * @arg @ref SMARTCARD_IT_TC Transmission complete interrupt 773 * @arg @ref SMARTCARD_IT_TCBGT Transmission complete before guard time 774 * interrupt (when interruption available) 775 * @arg @ref SMARTCARD_IT_RXNE Receive data register not empty interrupt 776 * @arg @ref SMARTCARD_IT_IDLE Idle line detection interrupt 777 * @arg @ref SMARTCARD_IT_PE Parity error interrupt 778 * @arg @ref SMARTCARD_IT_ERR Error interrupt(frame error, noise error, overrun error) 779 * @arg @ref SMARTCARD_IT_TXFNF TX FIFO not full interruption 780 * @arg @ref SMARTCARD_IT_RXFNE RXFIFO not empty interruption 781 * @arg @ref SMARTCARD_IT_RXFF RXFIFO full interruption 782 * @arg @ref SMARTCARD_IT_TXFE TXFIFO empty interruption 783 * @arg @ref SMARTCARD_IT_RXFT RXFIFO threshold reached interruption 784 * @arg @ref SMARTCARD_IT_TXFT TXFIFO threshold reached interruption 785 * @retval The new state of __INTERRUPT__ (SET or RESET). 786 */ 787 #define __HAL_SMARTCARD_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((((((__INTERRUPT__) & SMARTCARD_CR_MASK) >>\ 788 SMARTCARD_CR_POS) == 0x01U)?\ 789 (__HANDLE__)->Instance->CR1 : \ 790 (((((__INTERRUPT__) & SMARTCARD_CR_MASK) >>\ 791 SMARTCARD_CR_POS) == 0x02U)?\ 792 (__HANDLE__)->Instance->CR2 : \ 793 (__HANDLE__)->Instance->CR3)) &\ 794 (0x01UL << (((uint16_t)(__INTERRUPT__))\ 795 & SMARTCARD_IT_MASK))) != 0U)\ 796 ? SET : RESET) 797 798 /** @brief Clear the specified SMARTCARD ISR flag, in setting the proper ICR register flag. 799 * @param __HANDLE__ specifies the SMARTCARD Handle. 800 * @param __IT_CLEAR__ specifies the interrupt clear register flag that needs to be set 801 * to clear the corresponding interrupt. 802 * This parameter can be one of the following values: 803 * @arg @ref SMARTCARD_CLEAR_PEF Parity error clear flag 804 * @arg @ref SMARTCARD_CLEAR_FEF Framing error clear flag 805 * @arg @ref SMARTCARD_CLEAR_NEF Noise detected clear flag 806 * @arg @ref SMARTCARD_CLEAR_OREF OverRun error clear flag 807 * @arg @ref SMARTCARD_CLEAR_IDLEF Idle line detection clear flag 808 * @arg @ref SMARTCARD_CLEAR_TXFECF TXFIFO empty Clear Flag 809 * @arg @ref SMARTCARD_CLEAR_TCF Transmission complete clear flag 810 * @arg @ref SMARTCARD_CLEAR_TCBGTF Transmission complete before guard time clear flag (when flag available) 811 * @arg @ref SMARTCARD_CLEAR_RTOF Receiver timeout clear flag 812 * @arg @ref SMARTCARD_CLEAR_EOBF End of block clear flag 813 * @retval None 814 */ 815 #define __HAL_SMARTCARD_CLEAR_IT(__HANDLE__, __IT_CLEAR__) ((__HANDLE__)->Instance->ICR |= (uint32_t)(__IT_CLEAR__)) 816 817 /** @brief Set a specific SMARTCARD request flag. 818 * @param __HANDLE__ specifies the SMARTCARD Handle. 819 * @param __REQ__ specifies the request flag to set 820 * This parameter can be one of the following values: 821 * @arg @ref SMARTCARD_RXDATA_FLUSH_REQUEST Receive data flush Request 822 * @arg @ref SMARTCARD_TXDATA_FLUSH_REQUEST Transmit data flush Request 823 * @retval None 824 */ 825 #define __HAL_SMARTCARD_SEND_REQ(__HANDLE__, __REQ__) ((__HANDLE__)->Instance->RQR |= (uint16_t)(__REQ__)) 826 827 /** @brief Enable the SMARTCARD one bit sample method. 828 * @param __HANDLE__ specifies the SMARTCARD Handle. 829 * @retval None 830 */ 831 #define __HAL_SMARTCARD_ONE_BIT_SAMPLE_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR3|= USART_CR3_ONEBIT) 832 833 /** @brief Disable the SMARTCARD one bit sample method. 834 * @param __HANDLE__ specifies the SMARTCARD Handle. 835 * @retval None 836 */ 837 #define __HAL_SMARTCARD_ONE_BIT_SAMPLE_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR3\ 838 &= (uint32_t)~((uint32_t)USART_CR3_ONEBIT)) 839 840 /** @brief Enable the USART associated to the SMARTCARD Handle. 841 * @param __HANDLE__ specifies the SMARTCARD Handle. 842 * @retval None 843 */ 844 #define __HAL_SMARTCARD_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1 |= USART_CR1_UE) 845 846 /** @brief Disable the USART associated to the SMARTCARD Handle 847 * @param __HANDLE__ specifies the SMARTCARD Handle. 848 * @retval None 849 */ 850 #define __HAL_SMARTCARD_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR1 &= ~USART_CR1_UE) 851 852 /** 853 * @} 854 */ 855 856 /* Private macros -------------------------------------------------------------*/ 857 /** @defgroup SMARTCARD_Private_Macros SMARTCARD Private Macros 858 * @{ 859 */ 860 861 /** @brief Report the SMARTCARD clock source. 862 * @param __HANDLE__ specifies the SMARTCARD Handle. 863 * @param __CLOCKSOURCE__ output variable. 864 * @retval the SMARTCARD clocking source, written in __CLOCKSOURCE__. 865 */ 866 #if defined(USART6) 867 #define SMARTCARD_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \ 868 do { \ 869 if((__HANDLE__)->Instance == USART1) \ 870 { \ 871 switch(__HAL_RCC_GET_USART1_SOURCE()) \ 872 { \ 873 case RCC_USART1CLKSOURCE_PCLK2: \ 874 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK2; \ 875 break; \ 876 case RCC_USART1CLKSOURCE_HSI: \ 877 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \ 878 break; \ 879 case RCC_USART1CLKSOURCE_SYSCLK: \ 880 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \ 881 break; \ 882 case RCC_USART1CLKSOURCE_LSE: \ 883 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \ 884 break; \ 885 default: \ 886 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 887 break; \ 888 } \ 889 } \ 890 else if((__HANDLE__)->Instance == USART2) \ 891 { \ 892 switch(__HAL_RCC_GET_USART2_SOURCE()) \ 893 { \ 894 case RCC_USART2CLKSOURCE_PCLK1: \ 895 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \ 896 break; \ 897 case RCC_USART2CLKSOURCE_HSI: \ 898 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \ 899 break; \ 900 case RCC_USART2CLKSOURCE_SYSCLK: \ 901 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \ 902 break; \ 903 case RCC_USART2CLKSOURCE_LSE: \ 904 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \ 905 break; \ 906 default: \ 907 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 908 break; \ 909 } \ 910 } \ 911 else if((__HANDLE__)->Instance == USART3) \ 912 { \ 913 switch(__HAL_RCC_GET_USART3_SOURCE()) \ 914 { \ 915 case RCC_USART3CLKSOURCE_PCLK1: \ 916 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \ 917 break; \ 918 case RCC_USART3CLKSOURCE_HSI: \ 919 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \ 920 break; \ 921 case RCC_USART3CLKSOURCE_SYSCLK: \ 922 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \ 923 break; \ 924 case RCC_USART3CLKSOURCE_LSE: \ 925 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \ 926 break; \ 927 default: \ 928 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 929 break; \ 930 } \ 931 } \ 932 else if((__HANDLE__)->Instance == USART6) \ 933 { \ 934 switch(__HAL_RCC_GET_USART6_SOURCE()) \ 935 { \ 936 case RCC_USART6CLKSOURCE_PCLK1: \ 937 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \ 938 break; \ 939 case RCC_USART6CLKSOURCE_SYSCLK: \ 940 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \ 941 break; \ 942 case RCC_USART6CLKSOURCE_HSI: \ 943 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \ 944 break; \ 945 case RCC_USART6CLKSOURCE_LSE: \ 946 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \ 947 break; \ 948 default: \ 949 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 950 break; \ 951 } \ 952 } \ 953 else \ 954 { \ 955 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 956 } \ 957 } while(0U) 958 #elif defined(USART2) 959 #define SMARTCARD_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \ 960 do { \ 961 if((__HANDLE__)->Instance == USART1) \ 962 { \ 963 switch(__HAL_RCC_GET_USART1_SOURCE()) \ 964 { \ 965 case RCC_USART1CLKSOURCE_PCLK2: \ 966 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK2; \ 967 break; \ 968 case RCC_USART1CLKSOURCE_HSI: \ 969 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \ 970 break; \ 971 case RCC_USART1CLKSOURCE_SYSCLK: \ 972 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \ 973 break; \ 974 case RCC_USART1CLKSOURCE_LSE: \ 975 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \ 976 break; \ 977 default: \ 978 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 979 break; \ 980 } \ 981 } \ 982 else if((__HANDLE__)->Instance == USART2) \ 983 { \ 984 switch(__HAL_RCC_GET_USART2_SOURCE()) \ 985 { \ 986 case RCC_USART2CLKSOURCE_PCLK1: \ 987 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \ 988 break; \ 989 case RCC_USART2CLKSOURCE_HSI: \ 990 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \ 991 break; \ 992 case RCC_USART2CLKSOURCE_SYSCLK: \ 993 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \ 994 break; \ 995 case RCC_USART2CLKSOURCE_LSE: \ 996 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \ 997 break; \ 998 default: \ 999 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 1000 break; \ 1001 } \ 1002 } \ 1003 else if((__HANDLE__)->Instance == USART3) \ 1004 { \ 1005 switch(__HAL_RCC_GET_USART3_SOURCE()) \ 1006 { \ 1007 case RCC_USART3CLKSOURCE_PCLK1: \ 1008 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \ 1009 break; \ 1010 case RCC_USART3CLKSOURCE_HSI: \ 1011 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \ 1012 break; \ 1013 case RCC_USART3CLKSOURCE_SYSCLK: \ 1014 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \ 1015 break; \ 1016 case RCC_USART3CLKSOURCE_LSE: \ 1017 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \ 1018 break; \ 1019 default: \ 1020 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 1021 break; \ 1022 } \ 1023 } \ 1024 else \ 1025 { \ 1026 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 1027 } \ 1028 } while(0U) 1029 #else 1030 #define SMARTCARD_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \ 1031 do { \ 1032 if((__HANDLE__)->Instance == USART1) \ 1033 { \ 1034 switch(__HAL_RCC_GET_USART1_SOURCE()) \ 1035 { \ 1036 case RCC_USART1CLKSOURCE_PCLK2: \ 1037 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK2; \ 1038 break; \ 1039 case RCC_USART1CLKSOURCE_HSI: \ 1040 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \ 1041 break; \ 1042 case RCC_USART1CLKSOURCE_SYSCLK: \ 1043 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \ 1044 break; \ 1045 case RCC_USART1CLKSOURCE_LSE: \ 1046 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \ 1047 break; \ 1048 default: \ 1049 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 1050 break; \ 1051 } \ 1052 } \ 1053 else if((__HANDLE__)->Instance == USART3) \ 1054 { \ 1055 switch(__HAL_RCC_GET_USART3_SOURCE()) \ 1056 { \ 1057 case RCC_USART3CLKSOURCE_PCLK1: \ 1058 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \ 1059 break; \ 1060 case RCC_USART3CLKSOURCE_HSI: \ 1061 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \ 1062 break; \ 1063 case RCC_USART3CLKSOURCE_SYSCLK: \ 1064 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \ 1065 break; \ 1066 case RCC_USART3CLKSOURCE_LSE: \ 1067 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \ 1068 break; \ 1069 default: \ 1070 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 1071 break; \ 1072 } \ 1073 } \ 1074 else \ 1075 { \ 1076 (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \ 1077 } \ 1078 } while(0U) 1079 #endif /* USART6 */ 1080 1081 /** @brief Check the Baud rate range. 1082 * @note The maximum Baud Rate is derived from the maximum clock on U5 (160 MHz) 1083 * divided by the oversampling used on the SMARTCARD (i.e. 16). 1084 * @param __BAUDRATE__ Baud rate set by the configuration function. 1085 * @retval Test result (TRUE or FALSE) 1086 */ 1087 #define IS_SMARTCARD_BAUDRATE(__BAUDRATE__) ((__BAUDRATE__) < 10000000U) 1088 1089 /** @brief Check the block length range. 1090 * @note The maximum SMARTCARD block length is 0xFF. 1091 * @param __LENGTH__ block length. 1092 * @retval Test result (TRUE or FALSE) 1093 */ 1094 #define IS_SMARTCARD_BLOCKLENGTH(__LENGTH__) ((__LENGTH__) <= 0xFFU) 1095 1096 /** @brief Check the receiver timeout value. 1097 * @note The maximum SMARTCARD receiver timeout value is 0xFFFFFF. 1098 * @param __TIMEOUTVALUE__ receiver timeout value. 1099 * @retval Test result (TRUE or FALSE) 1100 */ 1101 #define IS_SMARTCARD_TIMEOUT_VALUE(__TIMEOUTVALUE__) ((__TIMEOUTVALUE__) <= 0xFFFFFFU) 1102 1103 /** @brief Check the SMARTCARD autoretry counter value. 1104 * @note The maximum number of retransmissions is 0x7. 1105 * @param __COUNT__ number of retransmissions. 1106 * @retval Test result (TRUE or FALSE) 1107 */ 1108 #define IS_SMARTCARD_AUTORETRY_COUNT(__COUNT__) ((__COUNT__) <= 0x7U) 1109 1110 /** @brief Ensure that SMARTCARD frame length is valid. 1111 * @param __LENGTH__ SMARTCARD frame length. 1112 * @retval SET (__LENGTH__ is valid) or RESET (__LENGTH__ is invalid) 1113 */ 1114 #define IS_SMARTCARD_WORD_LENGTH(__LENGTH__) ((__LENGTH__) == SMARTCARD_WORDLENGTH_9B) 1115 1116 /** @brief Ensure that SMARTCARD frame number of stop bits is valid. 1117 * @param __STOPBITS__ SMARTCARD frame number of stop bits. 1118 * @retval SET (__STOPBITS__ is valid) or RESET (__STOPBITS__ is invalid) 1119 */ 1120 #define IS_SMARTCARD_STOPBITS(__STOPBITS__) (((__STOPBITS__) == SMARTCARD_STOPBITS_0_5) ||\ 1121 ((__STOPBITS__) == SMARTCARD_STOPBITS_1_5)) 1122 1123 /** @brief Ensure that SMARTCARD frame parity is valid. 1124 * @param __PARITY__ SMARTCARD frame parity. 1125 * @retval SET (__PARITY__ is valid) or RESET (__PARITY__ is invalid) 1126 */ 1127 #define IS_SMARTCARD_PARITY(__PARITY__) (((__PARITY__) == SMARTCARD_PARITY_EVEN) || \ 1128 ((__PARITY__) == SMARTCARD_PARITY_ODD)) 1129 1130 /** @brief Ensure that SMARTCARD communication mode is valid. 1131 * @param __MODE__ SMARTCARD communication mode. 1132 * @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid) 1133 */ 1134 #define IS_SMARTCARD_MODE(__MODE__) ((((__MODE__) & 0xFFF3U) == 0x00U) && ((__MODE__) != 0x00U)) 1135 1136 /** @brief Ensure that SMARTCARD frame polarity is valid. 1137 * @param __CPOL__ SMARTCARD frame polarity. 1138 * @retval SET (__CPOL__ is valid) or RESET (__CPOL__ is invalid) 1139 */ 1140 #define IS_SMARTCARD_POLARITY(__CPOL__) (((__CPOL__) == SMARTCARD_POLARITY_LOW)\ 1141 || ((__CPOL__) == SMARTCARD_POLARITY_HIGH)) 1142 1143 /** @brief Ensure that SMARTCARD frame phase is valid. 1144 * @param __CPHA__ SMARTCARD frame phase. 1145 * @retval SET (__CPHA__ is valid) or RESET (__CPHA__ is invalid) 1146 */ 1147 #define IS_SMARTCARD_PHASE(__CPHA__) (((__CPHA__) == SMARTCARD_PHASE_1EDGE) || ((__CPHA__) == SMARTCARD_PHASE_2EDGE)) 1148 1149 /** @brief Ensure that SMARTCARD frame last bit clock pulse setting is valid. 1150 * @param __LASTBIT__ SMARTCARD frame last bit clock pulse setting. 1151 * @retval SET (__LASTBIT__ is valid) or RESET (__LASTBIT__ is invalid) 1152 */ 1153 #define IS_SMARTCARD_LASTBIT(__LASTBIT__) (((__LASTBIT__) == SMARTCARD_LASTBIT_DISABLE) || \ 1154 ((__LASTBIT__) == SMARTCARD_LASTBIT_ENABLE)) 1155 1156 /** @brief Ensure that SMARTCARD frame sampling is valid. 1157 * @param __ONEBIT__ SMARTCARD frame sampling. 1158 * @retval SET (__ONEBIT__ is valid) or RESET (__ONEBIT__ is invalid) 1159 */ 1160 #define IS_SMARTCARD_ONE_BIT_SAMPLE(__ONEBIT__) (((__ONEBIT__) == SMARTCARD_ONE_BIT_SAMPLE_DISABLE) || \ 1161 ((__ONEBIT__) == SMARTCARD_ONE_BIT_SAMPLE_ENABLE)) 1162 1163 /** @brief Ensure that SMARTCARD NACK transmission setting is valid. 1164 * @param __NACK__ SMARTCARD NACK transmission setting. 1165 * @retval SET (__NACK__ is valid) or RESET (__NACK__ is invalid) 1166 */ 1167 #define IS_SMARTCARD_NACK(__NACK__) (((__NACK__) == SMARTCARD_NACK_ENABLE) || \ 1168 ((__NACK__) == SMARTCARD_NACK_DISABLE)) 1169 1170 /** @brief Ensure that SMARTCARD receiver timeout setting is valid. 1171 * @param __TIMEOUT__ SMARTCARD receiver timeout setting. 1172 * @retval SET (__TIMEOUT__ is valid) or RESET (__TIMEOUT__ is invalid) 1173 */ 1174 #define IS_SMARTCARD_TIMEOUT(__TIMEOUT__) (((__TIMEOUT__) == SMARTCARD_TIMEOUT_DISABLE) || \ 1175 ((__TIMEOUT__) == SMARTCARD_TIMEOUT_ENABLE)) 1176 1177 /** @brief Ensure that SMARTCARD clock Prescaler is valid. 1178 * @param __CLOCKPRESCALER__ SMARTCARD clock Prescaler value. 1179 * @retval SET (__CLOCKPRESCALER__ is valid) or RESET (__CLOCKPRESCALER__ is invalid) 1180 */ 1181 #define IS_SMARTCARD_CLOCKPRESCALER(__CLOCKPRESCALER__) (((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV1) || \ 1182 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV2) || \ 1183 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV4) || \ 1184 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV6) || \ 1185 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV8) || \ 1186 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV10) || \ 1187 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV12) || \ 1188 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV16) || \ 1189 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV32) || \ 1190 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV64) || \ 1191 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV128) || \ 1192 ((__CLOCKPRESCALER__) == SMARTCARD_PRESCALER_DIV256)) 1193 1194 /** @brief Ensure that SMARTCARD advanced features initialization is valid. 1195 * @param __INIT__ SMARTCARD advanced features initialization. 1196 * @retval SET (__INIT__ is valid) or RESET (__INIT__ is invalid) 1197 */ 1198 #define IS_SMARTCARD_ADVFEATURE_INIT(__INIT__) ((__INIT__) <= (SMARTCARD_ADVFEATURE_NO_INIT | \ 1199 SMARTCARD_ADVFEATURE_TXINVERT_INIT | \ 1200 SMARTCARD_ADVFEATURE_RXINVERT_INIT | \ 1201 SMARTCARD_ADVFEATURE_DATAINVERT_INIT | \ 1202 SMARTCARD_ADVFEATURE_SWAP_INIT | \ 1203 SMARTCARD_ADVFEATURE_RXOVERRUNDISABLE_INIT | \ 1204 SMARTCARD_ADVFEATURE_DMADISABLEONERROR_INIT | \ 1205 SMARTCARD_ADVFEATURE_MSBFIRST_INIT)) 1206 1207 /** @brief Ensure that SMARTCARD frame TX inversion setting is valid. 1208 * @param __TXINV__ SMARTCARD frame TX inversion setting. 1209 * @retval SET (__TXINV__ is valid) or RESET (__TXINV__ is invalid) 1210 */ 1211 #define IS_SMARTCARD_ADVFEATURE_TXINV(__TXINV__) (((__TXINV__) == SMARTCARD_ADVFEATURE_TXINV_DISABLE) || \ 1212 ((__TXINV__) == SMARTCARD_ADVFEATURE_TXINV_ENABLE)) 1213 1214 /** @brief Ensure that SMARTCARD frame RX inversion setting is valid. 1215 * @param __RXINV__ SMARTCARD frame RX inversion setting. 1216 * @retval SET (__RXINV__ is valid) or RESET (__RXINV__ is invalid) 1217 */ 1218 #define IS_SMARTCARD_ADVFEATURE_RXINV(__RXINV__) (((__RXINV__) == SMARTCARD_ADVFEATURE_RXINV_DISABLE) || \ 1219 ((__RXINV__) == SMARTCARD_ADVFEATURE_RXINV_ENABLE)) 1220 1221 /** @brief Ensure that SMARTCARD frame data inversion setting is valid. 1222 * @param __DATAINV__ SMARTCARD frame data inversion setting. 1223 * @retval SET (__DATAINV__ is valid) or RESET (__DATAINV__ is invalid) 1224 */ 1225 #define IS_SMARTCARD_ADVFEATURE_DATAINV(__DATAINV__) (((__DATAINV__) == SMARTCARD_ADVFEATURE_DATAINV_DISABLE) || \ 1226 ((__DATAINV__) == SMARTCARD_ADVFEATURE_DATAINV_ENABLE)) 1227 1228 /** @brief Ensure that SMARTCARD frame RX/TX pins swap setting is valid. 1229 * @param __SWAP__ SMARTCARD frame RX/TX pins swap setting. 1230 * @retval SET (__SWAP__ is valid) or RESET (__SWAP__ is invalid) 1231 */ 1232 #define IS_SMARTCARD_ADVFEATURE_SWAP(__SWAP__) (((__SWAP__) == SMARTCARD_ADVFEATURE_SWAP_DISABLE) || \ 1233 ((__SWAP__) == SMARTCARD_ADVFEATURE_SWAP_ENABLE)) 1234 1235 /** @brief Ensure that SMARTCARD frame overrun setting is valid. 1236 * @param __OVERRUN__ SMARTCARD frame overrun setting. 1237 * @retval SET (__OVERRUN__ is valid) or RESET (__OVERRUN__ is invalid) 1238 */ 1239 #define IS_SMARTCARD_OVERRUN(__OVERRUN__) (((__OVERRUN__) == SMARTCARD_ADVFEATURE_OVERRUN_ENABLE) || \ 1240 ((__OVERRUN__) == SMARTCARD_ADVFEATURE_OVERRUN_DISABLE)) 1241 1242 /** @brief Ensure that SMARTCARD DMA enabling or disabling on error setting is valid. 1243 * @param __DMA__ SMARTCARD DMA enabling or disabling on error setting. 1244 * @retval SET (__DMA__ is valid) or RESET (__DMA__ is invalid) 1245 */ 1246 #define IS_SMARTCARD_ADVFEATURE_DMAONRXERROR(__DMA__) (((__DMA__) == SMARTCARD_ADVFEATURE_DMA_ENABLEONRXERROR) || \ 1247 ((__DMA__) == SMARTCARD_ADVFEATURE_DMA_DISABLEONRXERROR)) 1248 1249 /** @brief Ensure that SMARTCARD frame MSB first setting is valid. 1250 * @param __MSBFIRST__ SMARTCARD frame MSB first setting. 1251 * @retval SET (__MSBFIRST__ is valid) or RESET (__MSBFIRST__ is invalid) 1252 */ 1253 #define IS_SMARTCARD_ADVFEATURE_MSBFIRST(__MSBFIRST__) (((__MSBFIRST__) == SMARTCARD_ADVFEATURE_MSBFIRST_DISABLE) || \ 1254 ((__MSBFIRST__) == SMARTCARD_ADVFEATURE_MSBFIRST_ENABLE)) 1255 1256 /** @brief Ensure that SMARTCARD request parameter is valid. 1257 * @param __PARAM__ SMARTCARD request parameter. 1258 * @retval SET (__PARAM__ is valid) or RESET (__PARAM__ is invalid) 1259 */ 1260 #define IS_SMARTCARD_REQUEST_PARAMETER(__PARAM__) (((__PARAM__) == SMARTCARD_RXDATA_FLUSH_REQUEST) || \ 1261 ((__PARAM__) == SMARTCARD_TXDATA_FLUSH_REQUEST)) 1262 1263 /** 1264 * @} 1265 */ 1266 1267 /* Include SMARTCARD HAL Extended module */ 1268 #include "stm32u5xx_hal_smartcard_ex.h" 1269 1270 /* Exported functions --------------------------------------------------------*/ 1271 /** @addtogroup SMARTCARD_Exported_Functions 1272 * @{ 1273 */ 1274 1275 /* Initialization and de-initialization functions ****************************/ 1276 /** @addtogroup SMARTCARD_Exported_Functions_Group1 1277 * @{ 1278 */ 1279 1280 HAL_StatusTypeDef HAL_SMARTCARD_Init(SMARTCARD_HandleTypeDef *hsmartcard); 1281 HAL_StatusTypeDef HAL_SMARTCARD_DeInit(SMARTCARD_HandleTypeDef *hsmartcard); 1282 void HAL_SMARTCARD_MspInit(SMARTCARD_HandleTypeDef *hsmartcard); 1283 void HAL_SMARTCARD_MspDeInit(SMARTCARD_HandleTypeDef *hsmartcard); 1284 1285 #if (USE_HAL_SMARTCARD_REGISTER_CALLBACKS == 1) 1286 /* Callbacks Register/UnRegister functions ***********************************/ 1287 HAL_StatusTypeDef HAL_SMARTCARD_RegisterCallback(SMARTCARD_HandleTypeDef *hsmartcard, 1288 HAL_SMARTCARD_CallbackIDTypeDef CallbackID, 1289 pSMARTCARD_CallbackTypeDef pCallback); 1290 HAL_StatusTypeDef HAL_SMARTCARD_UnRegisterCallback(SMARTCARD_HandleTypeDef *hsmartcard, 1291 HAL_SMARTCARD_CallbackIDTypeDef CallbackID); 1292 #endif /* USE_HAL_SMARTCARD_REGISTER_CALLBACKS */ 1293 1294 /** 1295 * @} 1296 */ 1297 1298 /* IO operation functions *****************************************************/ 1299 /** @addtogroup SMARTCARD_Exported_Functions_Group2 1300 * @{ 1301 */ 1302 1303 HAL_StatusTypeDef HAL_SMARTCARD_Transmit(SMARTCARD_HandleTypeDef *hsmartcard, const uint8_t *pData, uint16_t Size, 1304 uint32_t Timeout); 1305 HAL_StatusTypeDef HAL_SMARTCARD_Receive(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t *pData, uint16_t Size, 1306 uint32_t Timeout); 1307 HAL_StatusTypeDef HAL_SMARTCARD_Transmit_IT(SMARTCARD_HandleTypeDef *hsmartcard, const uint8_t *pData, uint16_t Size); 1308 HAL_StatusTypeDef HAL_SMARTCARD_Receive_IT(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t *pData, uint16_t Size); 1309 #if defined(HAL_DMA_MODULE_ENABLED) 1310 HAL_StatusTypeDef HAL_SMARTCARD_Transmit_DMA(SMARTCARD_HandleTypeDef *hsmartcard, const uint8_t *pData, uint16_t Size); 1311 HAL_StatusTypeDef HAL_SMARTCARD_Receive_DMA(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t *pData, uint16_t Size); 1312 #endif /* HAL_DMA_MODULE_ENABLED */ 1313 /* Transfer Abort functions */ 1314 HAL_StatusTypeDef HAL_SMARTCARD_Abort(SMARTCARD_HandleTypeDef *hsmartcard); 1315 HAL_StatusTypeDef HAL_SMARTCARD_AbortTransmit(SMARTCARD_HandleTypeDef *hsmartcard); 1316 HAL_StatusTypeDef HAL_SMARTCARD_AbortReceive(SMARTCARD_HandleTypeDef *hsmartcard); 1317 HAL_StatusTypeDef HAL_SMARTCARD_Abort_IT(SMARTCARD_HandleTypeDef *hsmartcard); 1318 HAL_StatusTypeDef HAL_SMARTCARD_AbortTransmit_IT(SMARTCARD_HandleTypeDef *hsmartcard); 1319 HAL_StatusTypeDef HAL_SMARTCARD_AbortReceive_IT(SMARTCARD_HandleTypeDef *hsmartcard); 1320 1321 void HAL_SMARTCARD_IRQHandler(SMARTCARD_HandleTypeDef *hsmartcard); 1322 void HAL_SMARTCARD_TxCpltCallback(SMARTCARD_HandleTypeDef *hsmartcard); 1323 void HAL_SMARTCARD_RxCpltCallback(SMARTCARD_HandleTypeDef *hsmartcard); 1324 void HAL_SMARTCARD_ErrorCallback(SMARTCARD_HandleTypeDef *hsmartcard); 1325 void HAL_SMARTCARD_AbortCpltCallback(SMARTCARD_HandleTypeDef *hsmartcard); 1326 void HAL_SMARTCARD_AbortTransmitCpltCallback(SMARTCARD_HandleTypeDef *hsmartcard); 1327 void HAL_SMARTCARD_AbortReceiveCpltCallback(SMARTCARD_HandleTypeDef *hsmartcard); 1328 1329 /** 1330 * @} 1331 */ 1332 1333 /* Peripheral State and Error functions ***************************************/ 1334 /** @addtogroup SMARTCARD_Exported_Functions_Group4 1335 * @{ 1336 */ 1337 1338 HAL_SMARTCARD_StateTypeDef HAL_SMARTCARD_GetState(const SMARTCARD_HandleTypeDef *hsmartcard); 1339 uint32_t HAL_SMARTCARD_GetError(const SMARTCARD_HandleTypeDef *hsmartcard); 1340 1341 /** 1342 * @} 1343 */ 1344 1345 /** 1346 * @} 1347 */ 1348 1349 /** 1350 * @} 1351 */ 1352 1353 /** 1354 * @} 1355 */ 1356 1357 #ifdef __cplusplus 1358 } 1359 #endif 1360 1361 #endif /* STM32U5xx_HAL_SMARTCARD_H */ 1362
