stm32l4xx_hal_smartcard.h 69 KB

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