stm32g0xx_hal_smartcard_ex.h 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492
  1. /**
  2. ******************************************************************************
  3. * @file stm32g0xx_hal_smartcard_ex.h
  4. * @author MCD Application Team
  5. * @brief Header file of SMARTCARD HAL Extended module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * Copyright (c) 2018 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 STM32G0xx_HAL_SMARTCARD_EX_H
  20. #define STM32G0xx_HAL_SMARTCARD_EX_H
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. /* Includes ------------------------------------------------------------------*/
  25. #include "stm32g0xx_hal_def.h"
  26. /** @addtogroup STM32G0xx_HAL_Driver
  27. * @{
  28. */
  29. /** @addtogroup SMARTCARDEx
  30. * @{
  31. */
  32. /* Exported types ------------------------------------------------------------*/
  33. /* Exported constants --------------------------------------------------------*/
  34. /** @addtogroup SMARTCARDEx_Exported_Constants SMARTCARD Extended Exported Constants
  35. * @{
  36. */
  37. /** @defgroup SMARTCARDEx_Transmission_Completion_Indication SMARTCARD Transmission Completion Indication
  38. * @{
  39. */
  40. #define SMARTCARD_TCBGT SMARTCARD_IT_TCBGT /*!< SMARTCARD transmission complete before guard time */
  41. #define SMARTCARD_TC SMARTCARD_IT_TC /*!< SMARTCARD transmission complete (flag raised when guard time has elapsed) */
  42. /**
  43. * @}
  44. */
  45. /** @defgroup SMARTCARDEx_Advanced_Features_Initialization_Type SMARTCARD advanced feature initialization type
  46. * @{
  47. */
  48. #define SMARTCARD_ADVFEATURE_NO_INIT 0x00000000U /*!< No advanced feature initialization */
  49. #define SMARTCARD_ADVFEATURE_TXINVERT_INIT 0x00000001U /*!< TX pin active level inversion */
  50. #define SMARTCARD_ADVFEATURE_RXINVERT_INIT 0x00000002U /*!< RX pin active level inversion */
  51. #define SMARTCARD_ADVFEATURE_DATAINVERT_INIT 0x00000004U /*!< Binary data inversion */
  52. #define SMARTCARD_ADVFEATURE_SWAP_INIT 0x00000008U /*!< TX/RX pins swap */
  53. #define SMARTCARD_ADVFEATURE_RXOVERRUNDISABLE_INIT 0x00000010U /*!< RX overrun disable */
  54. #define SMARTCARD_ADVFEATURE_DMADISABLEONERROR_INIT 0x00000020U /*!< DMA disable on Reception Error */
  55. #define SMARTCARD_ADVFEATURE_MSBFIRST_INIT 0x00000080U /*!< Most significant bit sent/received first */
  56. #define SMARTCARD_ADVFEATURE_TXCOMPLETION 0x00000100U /*!< TX completion indication before of after guard time */
  57. /**
  58. * @}
  59. */
  60. /** @defgroup SMARTCARDEx_FIFO_mode SMARTCARD FIFO mode
  61. * @brief SMARTCARD FIFO mode
  62. * @{
  63. */
  64. #define SMARTCARD_FIFOMODE_DISABLE 0x00000000U /*!< FIFO mode disable */
  65. #define SMARTCARD_FIFOMODE_ENABLE USART_CR1_FIFOEN /*!< FIFO mode enable */
  66. /**
  67. * @}
  68. */
  69. /** @defgroup SMARTCARDEx_TXFIFO_threshold_level SMARTCARD TXFIFO threshold level
  70. * @brief SMARTCARD TXFIFO level
  71. * @{
  72. */
  73. #define SMARTCARD_TXFIFO_THRESHOLD_1_8 0x00000000U /*!< TXFIFO reaches 1/8 of its depth */
  74. #define SMARTCARD_TXFIFO_THRESHOLD_1_4 USART_CR3_TXFTCFG_0 /*!< TXFIFO reaches 1/4 of its depth */
  75. #define SMARTCARD_TXFIFO_THRESHOLD_1_2 USART_CR3_TXFTCFG_1 /*!< TXFIFO reaches 1/2 of its depth */
  76. #define SMARTCARD_TXFIFO_THRESHOLD_3_4 (USART_CR3_TXFTCFG_0|USART_CR3_TXFTCFG_1) /*!< TXFIFO reaches 3/4 of its depth */
  77. #define SMARTCARD_TXFIFO_THRESHOLD_7_8 USART_CR3_TXFTCFG_2 /*!< TXFIFO reaches 7/8 of its depth */
  78. #define SMARTCARD_TXFIFO_THRESHOLD_8_8 (USART_CR3_TXFTCFG_2|USART_CR3_TXFTCFG_0) /*!< TXFIFO becomes empty */
  79. /**
  80. * @}
  81. */
  82. /** @defgroup SMARTCARDEx_RXFIFO_threshold_level SMARTCARD RXFIFO threshold level
  83. * @brief SMARTCARD RXFIFO level
  84. * @{
  85. */
  86. #define SMARTCARD_RXFIFO_THRESHOLD_1_8 0x00000000U /*!< RXFIFO FIFO reaches 1/8 of its depth */
  87. #define SMARTCARD_RXFIFO_THRESHOLD_1_4 USART_CR3_RXFTCFG_0 /*!< RXFIFO FIFO reaches 1/4 of its depth */
  88. #define SMARTCARD_RXFIFO_THRESHOLD_1_2 USART_CR3_RXFTCFG_1 /*!< RXFIFO FIFO reaches 1/2 of its depth */
  89. #define SMARTCARD_RXFIFO_THRESHOLD_3_4 (USART_CR3_RXFTCFG_0|USART_CR3_RXFTCFG_1) /*!< RXFIFO FIFO reaches 3/4 of its depth */
  90. #define SMARTCARD_RXFIFO_THRESHOLD_7_8 USART_CR3_RXFTCFG_2 /*!< RXFIFO FIFO reaches 7/8 of its depth */
  91. #define SMARTCARD_RXFIFO_THRESHOLD_8_8 (USART_CR3_RXFTCFG_2|USART_CR3_RXFTCFG_0) /*!< RXFIFO FIFO becomes full */
  92. /**
  93. * @}
  94. */
  95. /** @defgroup SMARTCARDEx_Flags SMARTCARD Flags
  96. * Elements values convention: 0xXXXX
  97. * - 0xXXXX : Flag mask in the ISR register
  98. * @{
  99. */
  100. #define SMARTCARD_FLAG_TCBGT USART_ISR_TCBGT /*!< SMARTCARD transmission complete before guard time completion */
  101. #define SMARTCARD_FLAG_REACK USART_ISR_REACK /*!< SMARTCARD receive enable acknowledge flag */
  102. #define SMARTCARD_FLAG_TEACK USART_ISR_TEACK /*!< SMARTCARD transmit enable acknowledge flag */
  103. #define SMARTCARD_FLAG_BUSY USART_ISR_BUSY /*!< SMARTCARD busy flag */
  104. #define SMARTCARD_FLAG_EOBF USART_ISR_EOBF /*!< SMARTCARD end of block flag */
  105. #define SMARTCARD_FLAG_RTOF USART_ISR_RTOF /*!< SMARTCARD receiver timeout flag */
  106. #define SMARTCARD_FLAG_TXE USART_ISR_TXE_TXFNF /*!< SMARTCARD transmit data register empty */
  107. #define SMARTCARD_FLAG_TXFNF USART_ISR_TXE_TXFNF /*!< SMARTCARD TXFIFO not full */
  108. #define SMARTCARD_FLAG_TC USART_ISR_TC /*!< SMARTCARD transmission complete */
  109. #define SMARTCARD_FLAG_RXNE USART_ISR_RXNE_RXFNE /*!< SMARTCARD read data register not empty */
  110. #define SMARTCARD_FLAG_RXFNE USART_ISR_RXNE_RXFNE /*!< SMARTCARD RXFIFO not empty */
  111. #define SMARTCARD_FLAG_IDLE USART_ISR_IDLE /*!< SMARTCARD idle line detection */
  112. #define SMARTCARD_FLAG_ORE USART_ISR_ORE /*!< SMARTCARD overrun error */
  113. #define SMARTCARD_FLAG_NE USART_ISR_NE /*!< SMARTCARD noise error */
  114. #define SMARTCARD_FLAG_FE USART_ISR_FE /*!< SMARTCARD frame error */
  115. #define SMARTCARD_FLAG_PE USART_ISR_PE /*!< SMARTCARD parity error */
  116. #define SMARTCARD_FLAG_TXFE USART_ISR_TXFE /*!< SMARTCARD TXFIFO Empty flag */
  117. #define SMARTCARD_FLAG_RXFF USART_ISR_RXFF /*!< SMARTCARD RXFIFO Full flag */
  118. #define SMARTCARD_FLAG_RXFT USART_ISR_RXFT /*!< SMARTCARD RXFIFO threshold flag */
  119. #define SMARTCARD_FLAG_TXFT USART_ISR_TXFT /*!< SMARTCARD TXFIFO threshold flag */
  120. /**
  121. * @}
  122. */
  123. /** @defgroup SMARTCARDEx_Interrupt_definition SMARTCARD Interrupts Definition
  124. * Elements values convention: 000ZZZZZ0XXYYYYYb
  125. * - YYYYY : Interrupt source position in the XX register (5 bits)
  126. * - XX : Interrupt source register (2 bits)
  127. * - 01: CR1 register
  128. * - 10: CR2 register
  129. * - 11: CR3 register
  130. * - ZZZZZ : Flag position in the ISR register(5 bits)
  131. * @{
  132. */
  133. #define SMARTCARD_IT_PE 0x0028U /*!< SMARTCARD parity error interruption */
  134. #define SMARTCARD_IT_TXE 0x0727U /*!< SMARTCARD transmit data register empty interruption */
  135. #define SMARTCARD_IT_TXFNF 0x0727U /*!< SMARTCARD TX FIFO not full interruption */
  136. #define SMARTCARD_IT_TC 0x0626U /*!< SMARTCARD transmission complete interruption */
  137. #define SMARTCARD_IT_RXNE 0x0525U /*!< SMARTCARD read data register not empty interruption */
  138. #define SMARTCARD_IT_RXFNE 0x0525U /*!< SMARTCARD RXFIFO not empty interruption */
  139. #define SMARTCARD_IT_IDLE 0x0424U /*!< SMARTCARD idle line detection interruption */
  140. #define SMARTCARD_IT_ERR 0x0060U /*!< SMARTCARD error interruption */
  141. #define SMARTCARD_IT_ORE 0x0300U /*!< SMARTCARD overrun error interruption */
  142. #define SMARTCARD_IT_NE 0x0200U /*!< SMARTCARD noise error interruption */
  143. #define SMARTCARD_IT_FE 0x0100U /*!< SMARTCARD frame error interruption */
  144. #define SMARTCARD_IT_EOB 0x0C3BU /*!< SMARTCARD end of block interruption */
  145. #define SMARTCARD_IT_RTO 0x0B3AU /*!< SMARTCARD receiver timeout interruption */
  146. #define SMARTCARD_IT_TCBGT 0x1978U /*!< SMARTCARD transmission complete before guard time completion interruption */
  147. #define SMARTCARD_IT_RXFF 0x183FU /*!< SMARTCARD RXFIFO full interruption */
  148. #define SMARTCARD_IT_TXFE 0x173EU /*!< SMARTCARD TXFIFO empty interruption */
  149. #define SMARTCARD_IT_RXFT 0x1A7CU /*!< SMARTCARD RXFIFO threshold reached interruption */
  150. #define SMARTCARD_IT_TXFT 0x1B77U /*!< SMARTCARD TXFIFO threshold reached interruption */
  151. /**
  152. * @}
  153. */
  154. /** @defgroup SMARTCARDEx_IT_CLEAR_Flags SMARTCARD Interruption Clear Flags
  155. * @{
  156. */
  157. #define SMARTCARD_CLEAR_PEF USART_ICR_PECF /*!< SMARTCARD parity error clear flag */
  158. #define SMARTCARD_CLEAR_FEF USART_ICR_FECF /*!< SMARTCARD framing error clear flag */
  159. #define SMARTCARD_CLEAR_NEF USART_ICR_NECF /*!< SMARTCARD noise error detected clear flag */
  160. #define SMARTCARD_CLEAR_OREF USART_ICR_ORECF /*!< SMARTCARD overrun error clear flag */
  161. #define SMARTCARD_CLEAR_IDLEF USART_ICR_IDLECF /*!< SMARTCARD idle line detected clear flag */
  162. #define SMARTCARD_CLEAR_TXFECF USART_ICR_TXFECF /*!< TXFIFO empty Clear Flag */
  163. #define SMARTCARD_CLEAR_TCF USART_ICR_TCCF /*!< SMARTCARD transmission complete clear flag */
  164. #define SMARTCARD_CLEAR_TCBGTF USART_ICR_TCBGTCF /*!< SMARTCARD transmission complete before guard time completion clear flag */
  165. #define SMARTCARD_CLEAR_RTOF USART_ICR_RTOCF /*!< SMARTCARD receiver time out clear flag */
  166. #define SMARTCARD_CLEAR_EOBF USART_ICR_EOBCF /*!< SMARTCARD end of block clear flag */
  167. /**
  168. * @}
  169. */
  170. /**
  171. * @}
  172. */
  173. /* Exported macros -----------------------------------------------------------*/
  174. /* Private macros ------------------------------------------------------------*/
  175. /** @defgroup SMARTCARDEx_Private_Macros SMARTCARD Extended Private Macros
  176. * @{
  177. */
  178. /** @brief Report the SMARTCARD clock source.
  179. * @param __HANDLE__ specifies the SMARTCARD Handle.
  180. * @param __CLOCKSOURCE__ output variable.
  181. * @retval the SMARTCARD clocking source, written in __CLOCKSOURCE__.
  182. */
  183. #if defined(STM32G0C1xx) || defined(STM32G0B1xx) || defined(STM32G0B0xx)
  184. #define SMARTCARD_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
  185. do { \
  186. if((__HANDLE__)->Instance == USART1) \
  187. { \
  188. switch(__HAL_RCC_GET_USART1_SOURCE()) \
  189. { \
  190. case RCC_USART1CLKSOURCE_PCLK1: \
  191. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
  192. break; \
  193. case RCC_USART1CLKSOURCE_HSI: \
  194. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
  195. break; \
  196. case RCC_USART1CLKSOURCE_SYSCLK: \
  197. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
  198. break; \
  199. case RCC_USART1CLKSOURCE_LSE: \
  200. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
  201. break; \
  202. default: \
  203. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
  204. break; \
  205. } \
  206. } \
  207. else if((__HANDLE__)->Instance == USART2) \
  208. { \
  209. switch(__HAL_RCC_GET_USART2_SOURCE()) \
  210. { \
  211. case RCC_USART2CLKSOURCE_PCLK1: \
  212. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
  213. break; \
  214. case RCC_USART2CLKSOURCE_HSI: \
  215. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
  216. break; \
  217. case RCC_USART2CLKSOURCE_SYSCLK: \
  218. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
  219. break; \
  220. case RCC_USART2CLKSOURCE_LSE: \
  221. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
  222. break; \
  223. default: \
  224. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
  225. break; \
  226. } \
  227. } \
  228. else if((__HANDLE__)->Instance == USART3) \
  229. { \
  230. switch(__HAL_RCC_GET_USART3_SOURCE()) \
  231. { \
  232. case RCC_USART3CLKSOURCE_PCLK1: \
  233. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
  234. break; \
  235. case RCC_USART3CLKSOURCE_HSI: \
  236. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
  237. break; \
  238. case RCC_USART3CLKSOURCE_SYSCLK: \
  239. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
  240. break; \
  241. case RCC_USART3CLKSOURCE_LSE: \
  242. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
  243. break; \
  244. default: \
  245. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
  246. break; \
  247. } \
  248. } \
  249. else \
  250. { \
  251. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
  252. } \
  253. } while(0U)
  254. #elif defined(STM32G081xx) || defined(STM32G071xx) || defined(STM32G070xx)
  255. #define SMARTCARD_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
  256. do { \
  257. if((__HANDLE__)->Instance == USART1) \
  258. { \
  259. switch(__HAL_RCC_GET_USART1_SOURCE()) \
  260. { \
  261. case RCC_USART1CLKSOURCE_PCLK1: \
  262. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
  263. break; \
  264. case RCC_USART1CLKSOURCE_HSI: \
  265. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
  266. break; \
  267. case RCC_USART1CLKSOURCE_SYSCLK: \
  268. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
  269. break; \
  270. case RCC_USART1CLKSOURCE_LSE: \
  271. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
  272. break; \
  273. default: \
  274. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
  275. break; \
  276. } \
  277. } \
  278. else if((__HANDLE__)->Instance == USART2) \
  279. { \
  280. switch(__HAL_RCC_GET_USART2_SOURCE()) \
  281. { \
  282. case RCC_USART2CLKSOURCE_PCLK1: \
  283. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
  284. break; \
  285. case RCC_USART2CLKSOURCE_HSI: \
  286. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
  287. break; \
  288. case RCC_USART2CLKSOURCE_SYSCLK: \
  289. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
  290. break; \
  291. case RCC_USART2CLKSOURCE_LSE: \
  292. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
  293. break; \
  294. default: \
  295. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
  296. break; \
  297. } \
  298. } \
  299. else \
  300. { \
  301. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
  302. } \
  303. } while(0U)
  304. #else
  305. #define SMARTCARD_GETCLOCKSOURCE(__HANDLE__,__CLOCKSOURCE__) \
  306. do { \
  307. if((__HANDLE__)->Instance == USART1) \
  308. { \
  309. switch(__HAL_RCC_GET_USART1_SOURCE()) \
  310. { \
  311. case RCC_USART1CLKSOURCE_PCLK1: \
  312. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_PCLK1; \
  313. break; \
  314. case RCC_USART1CLKSOURCE_HSI: \
  315. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_HSI; \
  316. break; \
  317. case RCC_USART1CLKSOURCE_SYSCLK: \
  318. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_SYSCLK; \
  319. break; \
  320. case RCC_USART1CLKSOURCE_LSE: \
  321. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_LSE; \
  322. break; \
  323. default: \
  324. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
  325. break; \
  326. } \
  327. } \
  328. else \
  329. { \
  330. (__CLOCKSOURCE__) = SMARTCARD_CLOCKSOURCE_UNDEFINED; \
  331. } \
  332. } while(0U)
  333. #endif /* STM32G0C1xx || STM32G0B1xx || STM32G0B0xx */
  334. /** @brief Set the Transmission Completion flag
  335. * @param __HANDLE__ specifies the SMARTCARD Handle.
  336. * @note If TCBGT (Transmission Complete Before Guard Time) flag is not available or if
  337. * AdvancedInit.TxCompletionIndication is not already filled, the latter is forced
  338. * to SMARTCARD_TC (transmission completion indication when guard time has elapsed).
  339. * @retval None
  340. */
  341. #define SMARTCARD_TRANSMISSION_COMPLETION_SETTING(__HANDLE__) \
  342. do { \
  343. if (HAL_IS_BIT_CLR((__HANDLE__)->AdvancedInit.AdvFeatureInit, SMARTCARD_ADVFEATURE_TXCOMPLETION)) \
  344. { \
  345. (__HANDLE__)->AdvancedInit.TxCompletionIndication = SMARTCARD_TC; \
  346. } \
  347. else \
  348. { \
  349. assert_param(IS_SMARTCARD_TRANSMISSION_COMPLETION((__HANDLE__)->AdvancedInit.TxCompletionIndication)); \
  350. } \
  351. } while(0U)
  352. /** @brief Return the transmission completion flag.
  353. * @param __HANDLE__ specifies the SMARTCARD Handle.
  354. * @note Based on AdvancedInit.TxCompletionIndication setting, return TC or TCBGT flag.
  355. * When TCBGT flag (Transmission Complete Before Guard Time) is not available, TC flag is
  356. * reported.
  357. * @retval Transmission completion flag
  358. */
  359. #define SMARTCARD_TRANSMISSION_COMPLETION_FLAG(__HANDLE__) \
  360. (((__HANDLE__)->AdvancedInit.TxCompletionIndication == SMARTCARD_TC) ? (SMARTCARD_FLAG_TC) : (SMARTCARD_FLAG_TCBGT))
  361. /** @brief Ensure that SMARTCARD frame transmission completion used flag is valid.
  362. * @param __TXCOMPLETE__ SMARTCARD frame transmission completion used flag.
  363. * @retval SET (__TXCOMPLETE__ is valid) or RESET (__TXCOMPLETE__ is invalid)
  364. */
  365. #define IS_SMARTCARD_TRANSMISSION_COMPLETION(__TXCOMPLETE__) (((__TXCOMPLETE__) == SMARTCARD_TCBGT) || \
  366. ((__TXCOMPLETE__) == SMARTCARD_TC))
  367. /** @brief Ensure that SMARTCARD FIFO mode is valid.
  368. * @param __STATE__ SMARTCARD FIFO mode.
  369. * @retval SET (__STATE__ is valid) or RESET (__STATE__ is invalid)
  370. */
  371. #define IS_SMARTCARD_FIFOMODE_STATE(__STATE__) (((__STATE__) == SMARTCARD_FIFOMODE_DISABLE ) || \
  372. ((__STATE__) == SMARTCARD_FIFOMODE_ENABLE))
  373. /** @brief Ensure that SMARTCARD TXFIFO threshold level is valid.
  374. * @param __THRESHOLD__ SMARTCARD TXFIFO threshold level.
  375. * @retval SET (__THRESHOLD__ is valid) or RESET (__THRESHOLD__ is invalid)
  376. */
  377. #define IS_SMARTCARD_TXFIFO_THRESHOLD(__THRESHOLD__) (((__THRESHOLD__) == SMARTCARD_TXFIFO_THRESHOLD_1_8) || \
  378. ((__THRESHOLD__) == SMARTCARD_TXFIFO_THRESHOLD_1_4) || \
  379. ((__THRESHOLD__) == SMARTCARD_TXFIFO_THRESHOLD_1_2) || \
  380. ((__THRESHOLD__) == SMARTCARD_TXFIFO_THRESHOLD_3_4) || \
  381. ((__THRESHOLD__) == SMARTCARD_TXFIFO_THRESHOLD_7_8) || \
  382. ((__THRESHOLD__) == SMARTCARD_TXFIFO_THRESHOLD_8_8))
  383. /** @brief Ensure that SMARTCARD RXFIFO threshold level is valid.
  384. * @param __THRESHOLD__ SMARTCARD RXFIFO threshold level.
  385. * @retval SET (__THRESHOLD__ is valid) or RESET (__THRESHOLD__ is invalid)
  386. */
  387. #define IS_SMARTCARD_RXFIFO_THRESHOLD(__THRESHOLD__) (((__THRESHOLD__) == SMARTCARD_RXFIFO_THRESHOLD_1_8) || \
  388. ((__THRESHOLD__) == SMARTCARD_RXFIFO_THRESHOLD_1_4) || \
  389. ((__THRESHOLD__) == SMARTCARD_RXFIFO_THRESHOLD_1_2) || \
  390. ((__THRESHOLD__) == SMARTCARD_RXFIFO_THRESHOLD_3_4) || \
  391. ((__THRESHOLD__) == SMARTCARD_RXFIFO_THRESHOLD_7_8) || \
  392. ((__THRESHOLD__) == SMARTCARD_RXFIFO_THRESHOLD_8_8))
  393. /**
  394. * @}
  395. */
  396. /* Exported functions --------------------------------------------------------*/
  397. /** @addtogroup SMARTCARDEx_Exported_Functions
  398. * @{
  399. */
  400. /* Initialization and de-initialization functions ****************************/
  401. /* IO operation methods *******************************************************/
  402. /** @addtogroup SMARTCARDEx_Exported_Functions_Group1
  403. * @{
  404. */
  405. /* Peripheral Control functions ***********************************************/
  406. void HAL_SMARTCARDEx_BlockLength_Config(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t BlockLength);
  407. void HAL_SMARTCARDEx_TimeOut_Config(SMARTCARD_HandleTypeDef *hsmartcard, uint32_t TimeOutValue);
  408. HAL_StatusTypeDef HAL_SMARTCARDEx_EnableReceiverTimeOut(SMARTCARD_HandleTypeDef *hsmartcard);
  409. HAL_StatusTypeDef HAL_SMARTCARDEx_DisableReceiverTimeOut(SMARTCARD_HandleTypeDef *hsmartcard);
  410. /**
  411. * @}
  412. */
  413. /* Exported functions --------------------------------------------------------*/
  414. /** @addtogroup SMARTCARDEx_Exported_Functions_Group2
  415. * @{
  416. */
  417. /* IO operation functions *****************************************************/
  418. void HAL_SMARTCARDEx_RxFifoFullCallback(SMARTCARD_HandleTypeDef *hsmartcard);
  419. void HAL_SMARTCARDEx_TxFifoEmptyCallback(SMARTCARD_HandleTypeDef *hsmartcard);
  420. /**
  421. * @}
  422. */
  423. /** @addtogroup SMARTCARDEx_Exported_Functions_Group3
  424. * @{
  425. */
  426. /* Peripheral Control functions ***********************************************/
  427. HAL_StatusTypeDef HAL_SMARTCARDEx_EnableFifoMode(SMARTCARD_HandleTypeDef *hsmartcard);
  428. HAL_StatusTypeDef HAL_SMARTCARDEx_DisableFifoMode(SMARTCARD_HandleTypeDef *hsmartcard);
  429. HAL_StatusTypeDef HAL_SMARTCARDEx_SetTxFifoThreshold(SMARTCARD_HandleTypeDef *hsmartcard, uint32_t Threshold);
  430. HAL_StatusTypeDef HAL_SMARTCARDEx_SetRxFifoThreshold(SMARTCARD_HandleTypeDef *hsmartcard, uint32_t Threshold);
  431. /**
  432. * @}
  433. */
  434. /**
  435. * @}
  436. */
  437. /* Private functions ---------------------------------------------------------*/
  438. /**
  439. * @}
  440. */
  441. /**
  442. * @}
  443. */
  444. #ifdef __cplusplus
  445. }
  446. #endif
  447. #endif /* STM32G0xx_HAL_SMARTCARD_EX_H */