You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

568 lines
26 KiB

  1. /**
  2. ******************************************************************************
  3. * @file stm32wbxx_hal_pka.h
  4. * @author MCD Application Team
  5. * @brief Header file of PKA HAL module.
  6. ******************************************************************************
  7. * @attention
  8. *
  9. * <h2><center>&copy; Copyright (c) 2019 STMicroelectronics.
  10. * All rights reserved.</center></h2>
  11. *
  12. * This software component is licensed by ST under BSD 3-Clause license,
  13. * the "License"; You may not use this file except in compliance with the
  14. * License. You may obtain a copy of the License at:
  15. * opensource.org/licenses/BSD-3-Clause
  16. *
  17. ******************************************************************************
  18. */
  19. /* Define to prevent recursive inclusion -------------------------------------*/
  20. #ifndef STM32WBxx_HAL_PKA_H
  21. #define STM32WBxx_HAL_PKA_H
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. /* Includes ------------------------------------------------------------------*/
  26. #include "stm32wbxx_hal_def.h"
  27. /** @addtogroup STM32WBxx_HAL_Driver
  28. * @{
  29. */
  30. #if defined(PKA) && defined(HAL_PKA_MODULE_ENABLED)
  31. /** @addtogroup PKA
  32. * @{
  33. */
  34. /* Exported types ------------------------------------------------------------*/
  35. /** @defgroup PKA_Exported_Types PKA Exported Types
  36. * @{
  37. */
  38. /** @defgroup HAL_state_structure_definition HAL state structure definition
  39. * @brief HAL State structures definition
  40. * @{
  41. */
  42. typedef enum
  43. {
  44. HAL_PKA_STATE_RESET = 0x00U, /*!< PKA not yet initialized or disabled */
  45. HAL_PKA_STATE_READY = 0x01U, /*!< PKA initialized and ready for use */
  46. HAL_PKA_STATE_BUSY = 0x02U, /*!< PKA internal processing is ongoing */
  47. HAL_PKA_STATE_ERROR = 0x03U, /*!< PKA error state */
  48. }
  49. HAL_PKA_StateTypeDef;
  50. /**
  51. * @}
  52. */
  53. #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
  54. /** @defgroup HAL_callback_id HAL callback ID enumeration
  55. * @{
  56. */
  57. typedef enum
  58. {
  59. HAL_PKA_OPERATION_COMPLETE_CB_ID = 0x00U, /*!< PKA End of operation callback ID */
  60. HAL_PKA_ERROR_CB_ID = 0x01U, /*!< PKA Error callback ID */
  61. HAL_PKA_MSPINIT_CB_ID = 0x02U, /*!< PKA Msp Init callback ID */
  62. HAL_PKA_MSPDEINIT_CB_ID = 0x03U /*!< PKA Msp DeInit callback ID */
  63. } HAL_PKA_CallbackIDTypeDef;
  64. /**
  65. * @}
  66. */
  67. #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
  68. /** @defgroup PKA_Error_Code_definition PKA Error Code definition
  69. * @brief PKA Error Code definition
  70. * @{
  71. */
  72. #define HAL_PKA_ERROR_NONE (0x00000000U)
  73. #define HAL_PKA_ERROR_ADDRERR (0x00000001U)
  74. #define HAL_PKA_ERROR_RAMERR (0x00000002U)
  75. #define HAL_PKA_ERROR_TIMEOUT (0x00000004U)
  76. #define HAL_PKA_ERROR_OPERATION (0x00000008U)
  77. #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
  78. #define HAL_PKA_ERROR_INVALID_CALLBACK (0x00000010U) /*!< Invalid Callback error */
  79. #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
  80. /**
  81. * @}
  82. */
  83. /** @defgroup PKA_handle_Structure_definition PKA handle Structure definition
  84. * @brief PKA handle Structure definition
  85. * @{
  86. */
  87. #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
  88. typedef struct __PKA_HandleTypeDef
  89. #else
  90. typedef struct
  91. #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
  92. {
  93. PKA_TypeDef *Instance; /*!< Register base address */
  94. __IO HAL_PKA_StateTypeDef State; /*!< PKA state */
  95. __IO uint32_t ErrorCode; /*!< PKA Error code */
  96. #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
  97. void (* OperationCpltCallback)(struct __PKA_HandleTypeDef *hpka); /*!< PKA End of operation callback */
  98. void (* ErrorCallback)(struct __PKA_HandleTypeDef *hpka); /*!< PKA Error callback */
  99. void (* MspInitCallback)(struct __PKA_HandleTypeDef *hpka); /*!< PKA Msp Init callback */
  100. void (* MspDeInitCallback)(struct __PKA_HandleTypeDef *hpka); /*!< PKA Msp DeInit callback */
  101. #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
  102. } PKA_HandleTypeDef;
  103. /**
  104. * @}
  105. */
  106. #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
  107. /** @defgroup PKA_Callback_definition PKA Callback pointer definition
  108. * @brief PKA Callback pointer definition
  109. * @{
  110. */
  111. typedef void (*pPKA_CallbackTypeDef)(PKA_HandleTypeDef *hpka); /*!< Pointer to a PKA callback function */
  112. /**
  113. * @}
  114. */
  115. #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
  116. /** @defgroup PKA_Operation PKA operation structure definition
  117. * @brief Input and output data definition
  118. * @{
  119. */
  120. typedef struct
  121. {
  122. uint32_t scalarMulSize; /*!< Number of element in scalarMul array */
  123. uint32_t modulusSize; /*!< Number of element in modulus, coefA, pointX and pointY arrays */
  124. uint32_t coefSign; /*!< Curve coefficient a sign */
  125. const uint8_t *coefA; /*!< Pointer to curve coefficient |a| (Array of modulusSize elements) */
  126. const uint8_t *modulus; /*!< Pointer to curve modulus value p (Array of modulusSize elements) */
  127. const uint8_t *pointX; /*!< Pointer to point P coordinate xP (Array of modulusSize elements) */
  128. const uint8_t *pointY; /*!< Pointer to point P coordinate yP (Array of modulusSize elements) */
  129. const uint8_t *scalarMul; /*!< Pointer to scalar multiplier k (Array of scalarMulSize elements) */
  130. const uint32_t *pMontgomeryParam; /*!< Pointer to Montgomery parameter (Array of modulusSize/4 elements) */
  131. } PKA_ECCMulFastModeInTypeDef;
  132. typedef struct
  133. {
  134. uint32_t scalarMulSize; /*!< Number of element in scalarMul array */
  135. uint32_t modulusSize; /*!< Number of element in modulus, coefA, pointX and pointY arrays */
  136. uint32_t coefSign; /*!< Curve coefficient a sign */
  137. const uint8_t *coefA; /*!< Pointer to curve coefficient |a| (Array of modulusSize elements) */
  138. const uint8_t *modulus; /*!< Pointer to curve modulus value p (Array of modulusSize elements) */
  139. const uint8_t *pointX; /*!< Pointer to point P coordinate xP (Array of modulusSize elements) */
  140. const uint8_t *pointY; /*!< Pointer to point P coordinate yP (Array of modulusSize elements) */
  141. const uint8_t *scalarMul; /*!< Pointer to scalar multiplier k (Array of scalarMulSize elements) */
  142. } PKA_ECCMulInTypeDef;
  143. typedef struct
  144. {
  145. uint32_t modulusSize; /*!< Number of element in coefA, coefB, modulus, pointX and pointY arrays */
  146. uint32_t coefSign; /*!< Curve coefficient a sign */
  147. const uint8_t *coefA; /*!< Pointer to curve coefficient |a| (Array of modulusSize elements) */
  148. const uint8_t *coefB; /*!< Pointer to curve coefficient b (Array of modulusSize elements) */
  149. const uint8_t *modulus; /*!< Pointer to curve modulus value p (Array of modulusSize elements) */
  150. const uint8_t *pointX; /*!< Pointer to point P coordinate xP (Array of modulusSize elements) */
  151. const uint8_t *pointY; /*!< Pointer to point P coordinate yP (Array of modulusSize elements) */
  152. } PKA_PointCheckInTypeDef;
  153. typedef struct
  154. {
  155. uint32_t size; /*!< Number of element in popA array */
  156. const uint8_t *pOpDp; /*!< Pointer to operand dP (Array of size/2 elements) */
  157. const uint8_t *pOpDq; /*!< Pointer to operand dQ (Array of size/2 elements) */
  158. const uint8_t *pOpQinv; /*!< Pointer to operand qinv (Array of size/2 elements) */
  159. const uint8_t *pPrimeP; /*!< Pointer to prime p (Array of size/2 elements) */
  160. const uint8_t *pPrimeQ; /*!< Pointer to prime Q (Array of size/2 elements) */
  161. const uint8_t *popA; /*!< Pointer to operand A (Array of size elements) */
  162. } PKA_RSACRTExpInTypeDef;
  163. typedef struct
  164. {
  165. uint32_t primeOrderSize; /*!< Number of element in primeOrder array */
  166. uint32_t modulusSize; /*!< Number of element in modulus array */
  167. uint32_t coefSign; /*!< Curve coefficient a sign */
  168. const uint8_t *coef; /*!< Pointer to curve coefficient |a| (Array of modulusSize elements) */
  169. const uint8_t *modulus; /*!< Pointer to curve modulus value p (Array of modulusSize elements) */
  170. const uint8_t *basePointX; /*!< Pointer to curve base point xG (Array of modulusSize elements) */
  171. const uint8_t *basePointY; /*!< Pointer to curve base point yG (Array of modulusSize elements) */
  172. const uint8_t *pPubKeyCurvePtX; /*!< Pointer to public-key curve point xQ (Array of modulusSize elements) */
  173. const uint8_t *pPubKeyCurvePtY; /*!< Pointer to public-key curve point yQ (Array of modulusSize elements) */
  174. const uint8_t *RSign; /*!< Pointer to signature part r (Array of primeOrderSize elements) */
  175. const uint8_t *SSign; /*!< Pointer to signature part s (Array of primeOrderSize elements) */
  176. const uint8_t *hash; /*!< Pointer to hash of the message e (Array of primeOrderSize elements) */
  177. const uint8_t *primeOrder; /*!< Pointer to order of the curve n (Array of primeOrderSize elements) */
  178. } PKA_ECDSAVerifInTypeDef;
  179. typedef struct
  180. {
  181. uint32_t primeOrderSize; /*!< Number of element in primeOrder array */
  182. uint32_t modulusSize; /*!< Number of element in modulus array */
  183. uint32_t coefSign; /*!< Curve coefficient a sign */
  184. const uint8_t *coef; /*!< Pointer to curve coefficient |a| (Array of modulusSize elements) */
  185. const uint8_t *modulus; /*!< Pointer to curve modulus value p (Array of modulusSize elements) */
  186. const uint8_t *integer; /*!< Pointer to random integer k (Array of primeOrderSize elements) */
  187. const uint8_t *basePointX; /*!< Pointer to curve base point xG (Array of modulusSize elements) */
  188. const uint8_t *basePointY; /*!< Pointer to curve base point yG (Array of modulusSize elements) */
  189. const uint8_t *hash; /*!< Pointer to hash of the message (Array of primeOrderSize elements) */
  190. const uint8_t *privateKey; /*!< Pointer to private key d (Array of primeOrderSize elements) */
  191. const uint8_t *primeOrder; /*!< Pointer to order of the curve n (Array of primeOrderSize elements) */
  192. } PKA_ECDSASignInTypeDef;
  193. typedef struct
  194. {
  195. uint8_t *RSign; /*!< Pointer to signature part r (Array of modulusSize elements) */
  196. uint8_t *SSign; /*!< Pointer to signature part s (Array of modulusSize elements) */
  197. } PKA_ECDSASignOutTypeDef;
  198. typedef struct
  199. {
  200. uint8_t *ptX; /*!< Pointer to point P coordinate xP (Array of modulusSize elements) */
  201. uint8_t *ptY; /*!< Pointer to point P coordinate yP (Array of modulusSize elements) */
  202. } PKA_ECDSASignOutExtParamTypeDef, PKA_ECCMulOutTypeDef;
  203. typedef struct
  204. {
  205. uint32_t expSize; /*!< Number of element in pExp array */
  206. uint32_t OpSize; /*!< Number of element in pOp1 and pMod arrays */
  207. const uint8_t *pExp; /*!< Pointer to Exponent (Array of expSize elements) */
  208. const uint8_t *pOp1; /*!< Pointer to Operand (Array of OpSize elements) */
  209. const uint8_t *pMod; /*!< Pointer to modulus (Array of OpSize elements) */
  210. } PKA_ModExpInTypeDef;
  211. typedef struct
  212. {
  213. uint32_t expSize; /*!< Number of element in pExp and pMontgomeryParam arrays */
  214. uint32_t OpSize; /*!< Number of element in pOp1 and pMod arrays */
  215. const uint8_t *pExp; /*!< Pointer to Exponent (Array of expSize elements) */
  216. const uint8_t *pOp1; /*!< Pointer to Operand (Array of OpSize elements) */
  217. const uint8_t *pMod; /*!< Pointer to modulus (Array of OpSize elements) */
  218. const uint32_t *pMontgomeryParam; /*!< Pointer to Montgomery parameter (Array of expSize/4 elements) */
  219. } PKA_ModExpFastModeInTypeDef;
  220. typedef struct
  221. {
  222. uint32_t size; /*!< Number of element in pOp1 array */
  223. const uint8_t *pOp1; /*!< Pointer to Operand (Array of size elements) */
  224. } PKA_MontgomeryParamInTypeDef;
  225. typedef struct
  226. {
  227. uint32_t size; /*!< Number of element in pOp1 and pOp2 arrays */
  228. const uint32_t *pOp1; /*!< Pointer to Operand 1 (Array of size elements) */
  229. const uint32_t *pOp2; /*!< Pointer to Operand 2 (Array of size elements) */
  230. } PKA_AddInTypeDef, PKA_SubInTypeDef, PKA_MulInTypeDef, PKA_CmpInTypeDef;
  231. typedef struct
  232. {
  233. uint32_t size; /*!< Number of element in pOp1 array */
  234. const uint32_t *pOp1; /*!< Pointer to Operand 1 (Array of size elements) */
  235. const uint8_t *pMod; /*!< Pointer to modulus value n (Array of size*4 elements) */
  236. } PKA_ModInvInTypeDef;
  237. typedef struct
  238. {
  239. uint32_t OpSize; /*!< Number of element in pOp1 array */
  240. uint32_t modSize; /*!< Number of element in pMod array */
  241. const uint32_t *pOp1; /*!< Pointer to Operand 1 (Array of OpSize elements) */
  242. const uint8_t *pMod; /*!< Pointer to modulus value n (Array of modSize elements) */
  243. } PKA_ModRedInTypeDef;
  244. typedef struct
  245. {
  246. uint32_t size; /*!< Number of element in pOp1 and pOp2 arrays */
  247. const uint32_t *pOp1; /*!< Pointer to Operand 1 (Array of size elements) */
  248. const uint32_t *pOp2; /*!< Pointer to Operand 2 (Array of size elements) */
  249. const uint8_t *pOp3; /*!< Pointer to Operand 3 (Array of size*4 elements) */
  250. } PKA_ModAddInTypeDef, PKA_ModSubInTypeDef, PKA_MontgomeryMulInTypeDef;
  251. /**
  252. * @}
  253. */
  254. /**
  255. * @}
  256. */
  257. /* Exported constants --------------------------------------------------------*/
  258. /** @defgroup PKA_Exported_Constants PKA Exported Constants
  259. * @{
  260. */
  261. /** @defgroup PKA_Mode PKA mode
  262. * @{
  263. */
  264. #define PKA_MODE_MONTGOMERY_PARAM (0x00000001U)
  265. #define PKA_MODE_MODULAR_EXP (0x00000000U)
  266. #define PKA_MODE_MODULAR_EXP_FAST_MODE (0x00000002U)
  267. #define PKA_MODE_ECC_MUL (0x00000020U)
  268. #define PKA_MODE_ECC_MUL_FAST_MODE (0x00000022U)
  269. #define PKA_MODE_ECDSA_SIGNATURE (0x00000024U)
  270. #define PKA_MODE_ECDSA_VERIFICATION (0x00000026U)
  271. #define PKA_MODE_POINT_CHECK (0x00000028U)
  272. #define PKA_MODE_RSA_CRT_EXP (0x00000007U)
  273. #define PKA_MODE_MODULAR_INV (0x00000008U)
  274. #define PKA_MODE_ARITHMETIC_ADD (0x00000009U)
  275. #define PKA_MODE_ARITHMETIC_SUB (0x0000000AU)
  276. #define PKA_MODE_ARITHMETIC_MUL (0x0000000BU)
  277. #define PKA_MODE_COMPARISON (0x0000000CU)
  278. #define PKA_MODE_MODULAR_RED (0x0000000DU)
  279. #define PKA_MODE_MODULAR_ADD (0x0000000EU)
  280. #define PKA_MODE_MODULAR_SUB (0x0000000FU)
  281. #define PKA_MODE_MONTGOMERY_MUL (0x00000010U)
  282. /**
  283. * @}
  284. */
  285. /** @defgroup PKA_Interrupt_configuration_definition PKA Interrupt configuration definition
  286. * @brief PKA Interrupt definition
  287. * @{
  288. */
  289. #define PKA_IT_PROCEND PKA_CR_PROCENDIE
  290. #define PKA_IT_ADDRERR PKA_CR_ADDRERRIE
  291. #define PKA_IT_RAMERR PKA_CR_RAMERRIE
  292. /**
  293. * @}
  294. */
  295. /** @defgroup PKA_Flag_definition PKA Flag definition
  296. * @{
  297. */
  298. #define PKA_FLAG_PROCEND PKA_SR_PROCENDF
  299. #define PKA_FLAG_ADDRERR PKA_SR_ADDRERRF
  300. #define PKA_FLAG_RAMERR PKA_SR_RAMERRF
  301. /**
  302. * @}
  303. */
  304. /**
  305. * @}
  306. */
  307. /* Exported macros -----------------------------------------------------------*/
  308. /** @defgroup PKA_Exported_Macros PKA Exported Macros
  309. * @{
  310. */
  311. /** @brief Reset PKA handle state.
  312. * @param __HANDLE__ specifies the PKA Handle
  313. * @retval None
  314. */
  315. #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
  316. #define __HAL_PKA_RESET_HANDLE_STATE(__HANDLE__) do{ \
  317. (__HANDLE__)->State = HAL_PKA_STATE_RESET; \
  318. (__HANDLE__)->MspInitCallback = NULL; \
  319. (__HANDLE__)->MspDeInitCallback = NULL; \
  320. } while(0)
  321. #else
  322. #define __HAL_PKA_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_PKA_STATE_RESET)
  323. #endif
  324. /** @brief Enable the specified PKA interrupt.
  325. * @param __HANDLE__ specifies the PKA Handle
  326. * @param __INTERRUPT__ specifies the interrupt source to enable.
  327. * This parameter can be one of the following values:
  328. * @arg @ref PKA_IT_PROCEND End Of Operation interrupt enable
  329. * @arg @ref PKA_IT_ADDRERR Address error interrupt enable
  330. * @arg @ref PKA_IT_RAMERR RAM error interrupt enable
  331. * @retval None
  332. */
  333. #define __HAL_PKA_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR |= (__INTERRUPT__))
  334. /** @brief Disable the specified PKA interrupt.
  335. * @param __HANDLE__ specifies the PKA Handle
  336. * @param __INTERRUPT__ specifies the interrupt source to disable.
  337. * This parameter can be one of the following values:
  338. * @arg @ref PKA_IT_PROCEND End Of Operation interrupt enable
  339. * @arg @ref PKA_IT_ADDRERR Address error interrupt enable
  340. * @arg @ref PKA_IT_RAMERR RAM error interrupt enable
  341. * @retval None
  342. */
  343. #define __HAL_PKA_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR &= (~(__INTERRUPT__)))
  344. /** @brief Check whether the specified PKA interrupt source is enabled or not.
  345. * @param __HANDLE__ specifies the PKA Handle
  346. * @param __INTERRUPT__ specifies the PKA interrupt source to check.
  347. * This parameter can be one of the following values:
  348. * @arg @ref PKA_IT_PROCEND End Of Operation interrupt enable
  349. * @arg @ref PKA_IT_ADDRERR Address error interrupt enable
  350. * @arg @ref PKA_IT_RAMERR RAM error interrupt enable
  351. * @retval The new state of __INTERRUPT__ (SET or RESET)
  352. */
  353. #define __HAL_PKA_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->CR & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
  354. /** @brief Check whether the specified PKA flag is set or not.
  355. * @param __HANDLE__ specifies the PKA Handle
  356. * @param __FLAG__ specifies the flag to check.
  357. * This parameter can be one of the following values:
  358. * @arg @ref PKA_FLAG_PROCEND End Of Operation
  359. * @arg @ref PKA_FLAG_ADDRERR Address error
  360. * @arg @ref PKA_FLAG_RAMERR RAM error
  361. * @retval The new state of __FLAG__ (SET or RESET)
  362. */
  363. #define __HAL_PKA_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->SR) & (__FLAG__)) == (__FLAG__)) ? SET : RESET)
  364. /** @brief Clear the PKA pending flags which are cleared by writing 1 in a specific bit.
  365. * @param __HANDLE__ specifies the PKA Handle
  366. * @param __FLAG__ specifies the flag to clear.
  367. * This parameter can be any combination of the following values:
  368. * @arg @ref PKA_FLAG_PROCEND End Of Operation
  369. * @arg @ref PKA_FLAG_ADDRERR Address error
  370. * @arg @ref PKA_FLAG_RAMERR RAM error
  371. * @retval None
  372. */
  373. #define __HAL_PKA_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->CLRFR = (__FLAG__))
  374. /** @brief Enable the specified PKA peripheral.
  375. * @param __HANDLE__ specifies the PKA Handle
  376. * @retval None
  377. */
  378. #define __HAL_PKA_ENABLE(__HANDLE__) (SET_BIT((__HANDLE__)->Instance->CR, PKA_CR_EN))
  379. /** @brief Disable the specified PKA peripheral.
  380. * @param __HANDLE__ specifies the PKA Handle
  381. * @retval None
  382. */
  383. #define __HAL_PKA_DISABLE(__HANDLE__) (CLEAR_BIT((__HANDLE__)->Instance->CR, PKA_CR_EN))
  384. /** @brief Start a PKA operation.
  385. * @param __HANDLE__ specifies the PKA Handle
  386. * @retval None
  387. */
  388. #define __HAL_PKA_START(__HANDLE__) (SET_BIT((__HANDLE__)->Instance->CR, PKA_CR_START))
  389. /**
  390. * @}
  391. */
  392. /* Private macros --------------------------------------------------------*/
  393. /* Exported functions --------------------------------------------------------*/
  394. /** @addtogroup PKA_Exported_Functions
  395. * @{
  396. */
  397. /** @addtogroup PKA_Exported_Functions_Group1
  398. * @{
  399. */
  400. /* Initialization and de-initialization functions *****************************/
  401. HAL_StatusTypeDef HAL_PKA_Init(PKA_HandleTypeDef *hpka);
  402. HAL_StatusTypeDef HAL_PKA_DeInit(PKA_HandleTypeDef *hpka);
  403. void HAL_PKA_MspInit(PKA_HandleTypeDef *hpka);
  404. void HAL_PKA_MspDeInit(PKA_HandleTypeDef *hpka);
  405. #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
  406. /* Callbacks Register/UnRegister functions ***********************************/
  407. HAL_StatusTypeDef HAL_PKA_RegisterCallback(PKA_HandleTypeDef *hpka, HAL_PKA_CallbackIDTypeDef CallbackID, pPKA_CallbackTypeDef pCallback);
  408. HAL_StatusTypeDef HAL_PKA_UnRegisterCallback(PKA_HandleTypeDef *hpka, HAL_PKA_CallbackIDTypeDef CallbackID);
  409. #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
  410. /**
  411. * @}
  412. */
  413. /** @addtogroup PKA_Exported_Functions_Group2
  414. * @{
  415. */
  416. /* IO operation functions *****************************************************/
  417. /* High Level Functions *******************************************************/
  418. HAL_StatusTypeDef HAL_PKA_ModExp(PKA_HandleTypeDef *hpka, PKA_ModExpInTypeDef *in, uint32_t Timeout);
  419. HAL_StatusTypeDef HAL_PKA_ModExp_IT(PKA_HandleTypeDef *hpka, PKA_ModExpInTypeDef *in);
  420. HAL_StatusTypeDef HAL_PKA_ModExpFastMode(PKA_HandleTypeDef *hpka, PKA_ModExpFastModeInTypeDef *in, uint32_t Timeout);
  421. HAL_StatusTypeDef HAL_PKA_ModExpFastMode_IT(PKA_HandleTypeDef *hpka, PKA_ModExpFastModeInTypeDef *in);
  422. void HAL_PKA_ModExp_GetResult(PKA_HandleTypeDef *hpka, uint8_t *pRes);
  423. HAL_StatusTypeDef HAL_PKA_ECDSASign(PKA_HandleTypeDef *hpka, PKA_ECDSASignInTypeDef *in, uint32_t Timeout);
  424. HAL_StatusTypeDef HAL_PKA_ECDSASign_IT(PKA_HandleTypeDef *hpka, PKA_ECDSASignInTypeDef *in);
  425. void HAL_PKA_ECDSASign_GetResult(PKA_HandleTypeDef *hpka, PKA_ECDSASignOutTypeDef *out, PKA_ECDSASignOutExtParamTypeDef *outExt);
  426. HAL_StatusTypeDef HAL_PKA_ECDSAVerif(PKA_HandleTypeDef *hpka, PKA_ECDSAVerifInTypeDef *in, uint32_t Timeout);
  427. HAL_StatusTypeDef HAL_PKA_ECDSAVerif_IT(PKA_HandleTypeDef *hpka, PKA_ECDSAVerifInTypeDef *in);
  428. uint32_t HAL_PKA_ECDSAVerif_IsValidSignature(PKA_HandleTypeDef const *const hpka);
  429. HAL_StatusTypeDef HAL_PKA_RSACRTExp(PKA_HandleTypeDef *hpka, PKA_RSACRTExpInTypeDef *in, uint32_t Timeout);
  430. HAL_StatusTypeDef HAL_PKA_RSACRTExp_IT(PKA_HandleTypeDef *hpka, PKA_RSACRTExpInTypeDef *in);
  431. void HAL_PKA_RSACRTExp_GetResult(PKA_HandleTypeDef *hpka, uint8_t *pRes);
  432. HAL_StatusTypeDef HAL_PKA_PointCheck(PKA_HandleTypeDef *hpka, PKA_PointCheckInTypeDef *in, uint32_t Timeout);
  433. HAL_StatusTypeDef HAL_PKA_PointCheck_IT(PKA_HandleTypeDef *hpka, PKA_PointCheckInTypeDef *in);
  434. uint32_t HAL_PKA_PointCheck_IsOnCurve(PKA_HandleTypeDef const *const hpka);
  435. HAL_StatusTypeDef HAL_PKA_ECCMul(PKA_HandleTypeDef *hpka, PKA_ECCMulInTypeDef *in, uint32_t Timeout);
  436. HAL_StatusTypeDef HAL_PKA_ECCMul_IT(PKA_HandleTypeDef *hpka, PKA_ECCMulInTypeDef *in);
  437. HAL_StatusTypeDef HAL_PKA_ECCMulFastMode(PKA_HandleTypeDef *hpka, PKA_ECCMulFastModeInTypeDef *in, uint32_t Timeout);
  438. HAL_StatusTypeDef HAL_PKA_ECCMulFastMode_IT(PKA_HandleTypeDef *hpka, PKA_ECCMulFastModeInTypeDef *in);
  439. void HAL_PKA_ECCMul_GetResult(PKA_HandleTypeDef *hpka, PKA_ECCMulOutTypeDef *out);
  440. HAL_StatusTypeDef HAL_PKA_Add(PKA_HandleTypeDef *hpka, PKA_AddInTypeDef *in, uint32_t Timeout);
  441. HAL_StatusTypeDef HAL_PKA_Add_IT(PKA_HandleTypeDef *hpka, PKA_AddInTypeDef *in);
  442. HAL_StatusTypeDef HAL_PKA_Sub(PKA_HandleTypeDef *hpka, PKA_SubInTypeDef *in, uint32_t Timeout);
  443. HAL_StatusTypeDef HAL_PKA_Sub_IT(PKA_HandleTypeDef *hpka, PKA_SubInTypeDef *in);
  444. HAL_StatusTypeDef HAL_PKA_Cmp(PKA_HandleTypeDef *hpka, PKA_CmpInTypeDef *in, uint32_t Timeout);
  445. HAL_StatusTypeDef HAL_PKA_Cmp_IT(PKA_HandleTypeDef *hpka, PKA_CmpInTypeDef *in);
  446. HAL_StatusTypeDef HAL_PKA_Mul(PKA_HandleTypeDef *hpka, PKA_MulInTypeDef *in, uint32_t Timeout);
  447. HAL_StatusTypeDef HAL_PKA_Mul_IT(PKA_HandleTypeDef *hpka, PKA_MulInTypeDef *in);
  448. HAL_StatusTypeDef HAL_PKA_ModAdd(PKA_HandleTypeDef *hpka, PKA_ModAddInTypeDef *in, uint32_t Timeout);
  449. HAL_StatusTypeDef HAL_PKA_ModAdd_IT(PKA_HandleTypeDef *hpka, PKA_ModAddInTypeDef *in);
  450. HAL_StatusTypeDef HAL_PKA_ModSub(PKA_HandleTypeDef *hpka, PKA_ModSubInTypeDef *in, uint32_t Timeout);
  451. HAL_StatusTypeDef HAL_PKA_ModSub_IT(PKA_HandleTypeDef *hpka, PKA_ModSubInTypeDef *in);
  452. HAL_StatusTypeDef HAL_PKA_ModInv(PKA_HandleTypeDef *hpka, PKA_ModInvInTypeDef *in, uint32_t Timeout);
  453. HAL_StatusTypeDef HAL_PKA_ModInv_IT(PKA_HandleTypeDef *hpka, PKA_ModInvInTypeDef *in);
  454. HAL_StatusTypeDef HAL_PKA_ModRed(PKA_HandleTypeDef *hpka, PKA_ModRedInTypeDef *in, uint32_t Timeout);
  455. HAL_StatusTypeDef HAL_PKA_ModRed_IT(PKA_HandleTypeDef *hpka, PKA_ModRedInTypeDef *in);
  456. HAL_StatusTypeDef HAL_PKA_MontgomeryMul(PKA_HandleTypeDef *hpka, PKA_MontgomeryMulInTypeDef *in, uint32_t Timeout);
  457. HAL_StatusTypeDef HAL_PKA_MontgomeryMul_IT(PKA_HandleTypeDef *hpka, PKA_MontgomeryMulInTypeDef *in);
  458. void HAL_PKA_Arithmetic_GetResult(PKA_HandleTypeDef *hpka, uint32_t *pRes);
  459. HAL_StatusTypeDef HAL_PKA_MontgomeryParam(PKA_HandleTypeDef *hpka, PKA_MontgomeryParamInTypeDef *in, uint32_t Timeout);
  460. HAL_StatusTypeDef HAL_PKA_MontgomeryParam_IT(PKA_HandleTypeDef *hpka, PKA_MontgomeryParamInTypeDef *in);
  461. void HAL_PKA_MontgomeryParam_GetResult(PKA_HandleTypeDef *hpka, uint32_t *pRes);
  462. HAL_StatusTypeDef HAL_PKA_Abort(PKA_HandleTypeDef *hpka);
  463. void HAL_PKA_RAMReset(PKA_HandleTypeDef *hpka);
  464. void HAL_PKA_OperationCpltCallback(PKA_HandleTypeDef *hpka);
  465. void HAL_PKA_ErrorCallback(PKA_HandleTypeDef *hpka);
  466. void HAL_PKA_IRQHandler(PKA_HandleTypeDef *hpka);
  467. /**
  468. * @}
  469. */
  470. /** @addtogroup PKA_Exported_Functions_Group3
  471. * @{
  472. */
  473. /* Peripheral State and Error functions ***************************************/
  474. HAL_PKA_StateTypeDef HAL_PKA_GetState(PKA_HandleTypeDef *hpka);
  475. uint32_t HAL_PKA_GetError(PKA_HandleTypeDef *hpka);
  476. /**
  477. * @}
  478. */
  479. /**
  480. * @}
  481. */
  482. /**
  483. * @}
  484. */
  485. #endif /* defined(PKA) && defined(HAL_PKA_MODULE_ENABLED) */
  486. /**
  487. * @}
  488. */
  489. #ifdef __cplusplus
  490. }
  491. #endif
  492. #endif /* STM32WBxx_HAL_PKA_H */
  493. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/