1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
|
/**
******************************************************************************
* @file stm32wbxx_ll_pka.h
* @author MCD Application Team
* @brief Header file of PKA LL module.
******************************************************************************
* @attention
*
* <h2><center>© Copyright (c) 2019 STMicroelectronics.
* All rights reserved.</center></h2>
*
* This software component is licensed by ST under BSD 3-Clause license,
* the "License"; You may not use this file except in compliance with the
* License. You may obtain a copy of the License at:
* opensource.org/licenses/BSD-3-Clause
*
******************************************************************************
*/
/* Define to prevent recursive inclusion -------------------------------------*/
#ifndef STM32WBxx_LL_PKA_H
#define STM32WBxx_LL_PKA_H
#ifdef __cplusplus
extern "C" {
#endif
/* Includes ------------------------------------------------------------------*/
#include "stm32wbxx.h"
/** @addtogroup STM32WBxx_LL_Driver
* @{
*/
#if defined(PKA)
/** @defgroup PKA_LL PKA
* @{
*/
/* Private variables ---------------------------------------------------------*/
/* Exported types ------------------------------------------------------------*/
#if defined(USE_FULL_LL_DRIVER)
/** @defgroup PKA_LL_ES_INIT PKA Exported Init structure
* @{
*/
/**
* @brief PKA Init structures definition
*/
typedef struct
{
uint32_t Mode; /*!< Specifies the PKA operation mode.
This parameter can be a value of @ref PKA_LL_EC_MODE.
This feature can be modified afterwards using unitary function @ref LL_PKA_SetMode(). */
} LL_PKA_InitTypeDef;
/**
* @}
*/
#endif /* USE_FULL_LL_DRIVER */
/* Exported constants --------------------------------------------------------*/
/** @defgroup PKA_LL_Exported_Constants PKA Exported Constants
* @{
*/
/** @defgroup PKA_LL_EC_GET_FLAG Get Flags Defines
* @brief Flags defines which can be used with LL_PKA_ReadReg function
* @{
*/
#define LL_PKA_SR_ADDRERRF PKA_SR_ADDRERRF
#define LL_PKA_SR_RAMERRF PKA_SR_RAMERRF
#define LL_PKA_SR_PROCENDF PKA_SR_PROCENDF
#define LL_PKA_SR_BUSY PKA_SR_BUSY
/**
* @}
*/
/** @defgroup PKA_LL_EC_IT IT Defines
* @brief IT defines which can be used with LL_PKA_ReadReg and LL_PKA_WriteReg functions
* @{
*/
#define LL_PKA_CR_ADDRERRIE PKA_CR_ADDRERRIE
#define LL_PKA_CR_RAMERRIE PKA_CR_RAMERRIE
#define LL_PKA_CR_PROCENDIE PKA_CR_PROCENDIE
#define LL_PKA_CLRFR_PROCENDFC PKA_CLRFR_PROCENDFC
#define LL_PKA_CLRFR_RAMERRFC PKA_CLRFR_RAMERRFC
#define LL_PKA_CLRFR_ADDRERRFC PKA_CLRFR_ADDRERRFC
/**
* @}
*/
/** @defgroup PKA_LL_EC_MODE Operation Mode
* @brief List of opearation mode.
* @{
*/
#define LL_PKA_MODE_MONTGOMERY_PARAM_MOD_EXP ((uint32_t)0x00000000U) /*!< Compute Montgomery parameter and modular exponentiation */
#define LL_PKA_MODE_MONTGOMERY_PARAM ((uint32_t)0x00000001U) /*!< Compute Montgomery parameter only */
#define LL_PKA_MODE_MODULAR_EXP ((uint32_t)0x00000002U) /*!< Compute modular exponentiation only (Montgomery parameter should be loaded) */
#define LL_PKA_MODE_MONTGOMERY_PARAM_ECC ((uint32_t)0x00000020U) /*!< Compute Montgomery parameter and compute ECC kP operation */
#define LL_PKA_MODE_ECC_KP_PRIMITIVE ((uint32_t)0x00000022U) /*!< Compute the ECC kP primitive only (Montgomery parameter should be loaded) */
#define LL_PKA_MODE_ECDSA_SIGNATURE ((uint32_t)0x00000024U) /*!< ECDSA signature */
#define LL_PKA_MODE_ECDSA_VERIFICATION ((uint32_t)0x00000026U) /*!< ECDSA verification */
#define LL_PKA_MODE_POINT_CHECK ((uint32_t)0x00000028U) /*!< Point check */
#define LL_PKA_MODE_RSA_CRT_EXP ((uint32_t)0x00000007U) /*!< RSA CRT exponentiation */
#define LL_PKA_MODE_MODULAR_INV ((uint32_t)0x00000008U) /*!< Modular inversion */
#define LL_PKA_MODE_ARITHMETIC_ADD ((uint32_t)0x00000009U) /*!< Arithmetic addition */
#define LL_PKA_MODE_ARITHMETIC_SUB ((uint32_t)0x0000000AU) /*!< Arithmetic subtraction */
#define LL_PKA_MODE_ARITHMETIC_MUL ((uint32_t)0x0000000BU) /*!< Arithmetic multiplication */
#define LL_PKA_MODE_COMPARISON ((uint32_t)0x0000000CU) /*!< Comparison */
#define LL_PKA_MODE_MODULAR_REDUC ((uint32_t)0x0000000DU) /*!< Modular reduction */
#define LL_PKA_MODE_MODULAR_ADD ((uint32_t)0x0000000EU) /*!< Modular addition */
#define LL_PKA_MODE_MODULAR_SUB ((uint32_t)0x0000000FU) /*!< Modular subtraction */
#define LL_PKA_MODE_MONTGOMERY_MUL ((uint32_t)0x00000010U) /*!< Montgomery multiplication */
/**
* @}
*/
/**
* @}
*/
/* Exported macro ------------------------------------------------------------*/
/** @defgroup PKA_LL_Exported_Macros PKA Exported Macros
* @{
*/
/** @defgroup PKA_LL_EM_WRITE_READ Common Write and read registers Macros
* @{
*/
/**
* @brief Write a value in PKA register
* @param __INSTANCE__ PKA Instance
* @param __REG__ Register to be written
* @param __VALUE__ Value to be written in the register
* @retval None
*/
#define LL_PKA_WriteReg(__INSTANCE__, __REG__, __VALUE__) WRITE_REG(__INSTANCE__->__REG__, (__VALUE__))
/**
* @brief Read a value in PKA register
* @param __INSTANCE__ PKA Instance
* @param __REG__ Register to be read
* @retval Register value
*/
#define LL_PKA_ReadReg(__INSTANCE__, __REG__) READ_REG(__INSTANCE__->__REG__)
/**
* @}
*/
/**
* @}
*/
/* Exported functions --------------------------------------------------------*/
/** @defgroup PKA_LL_Exported_Functions PKA Exported Functions
* @{
*/
/** @defgroup PKA_LL_EF_Configuration Configuration
* @{
*/
/**
* @brief Configure PKA peripheral.
* @brief Set PKA operating mode.
* @rmtoll CR MODE LL_PKA_Config
* @param PKAx PKA Instance.
* @param Mode This parameter can be one of the following values:
* @arg @ref LL_PKA_MODE_MONTGOMERY_PARAM_MOD_EXP
* @arg @ref LL_PKA_MODE_MONTGOMERY_PARAM
* @arg @ref LL_PKA_MODE_MODULAR_EXP
* @arg @ref LL_PKA_MODE_MONTGOMERY_PARAM_ECC
* @arg @ref LL_PKA_MODE_ECC_KP_PRIMITIVE
* @arg @ref LL_PKA_MODE_ECDSA_SIGNATURE
* @arg @ref LL_PKA_MODE_ECDSA_VERIFICATION
* @arg @ref LL_PKA_MODE_POINT_CHECK
* @arg @ref LL_PKA_MODE_RSA_CRT_EXP
* @arg @ref LL_PKA_MODE_MODULAR_INV
* @arg @ref LL_PKA_MODE_ARITHMETIC_ADD
* @arg @ref LL_PKA_MODE_ARITHMETIC_SUB
* @arg @ref LL_PKA_MODE_ARITHMETIC_MUL
* @arg @ref LL_PKA_MODE_COMPARISON
* @arg @ref LL_PKA_MODE_MODULAR_REDUC
* @arg @ref LL_PKA_MODE_MODULAR_ADD
* @arg @ref LL_PKA_MODE_MODULAR_SUB
* @arg @ref LL_PKA_MODE_MONTGOMERY_MUL
*/
__STATIC_INLINE void LL_PKA_Config(PKA_TypeDef *PKAx, uint32_t Mode)
{
MODIFY_REG(PKAx->CR, (PKA_CR_MODE), (Mode << PKA_CR_MODE_Pos));
}
/**
* @brief Enable PKA peripheral.
* @rmtoll CR EN LL_PKA_Enable
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_Enable(PKA_TypeDef *PKAx)
{
SET_BIT(PKAx->CR, PKA_CR_EN);
}
/**
* @brief Disable PKA peripheral.
* @rmtoll CR EN LL_PKA_Disable
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_Disable(PKA_TypeDef *PKAx)
{
CLEAR_BIT(PKAx->CR, PKA_CR_EN);
}
/**
* @brief Check if the PKA peripheral is enabled or disabled.
* @rmtoll CR EN LL_PKA_IsEnabled
* @param PKAx PKA Instance.
* @retval State of bit (1 or 0).
*/
__STATIC_INLINE uint32_t LL_PKA_IsEnabled(PKA_TypeDef *PKAx)
{
return ((READ_BIT(PKAx->CR, PKA_CR_EN) == (PKA_CR_EN)) ? 1UL : 0UL);
}
/**
* @brief Set PKA operating mode.
* @rmtoll CR MODE LL_PKA_SetMode
* @param PKAx PKA Instance.
* @param Mode This parameter can be one of the following values:
* @arg @ref LL_PKA_MODE_MONTGOMERY_PARAM_MOD_EXP
* @arg @ref LL_PKA_MODE_MONTGOMERY_PARAM
* @arg @ref LL_PKA_MODE_MODULAR_EXP
* @arg @ref LL_PKA_MODE_MONTGOMERY_PARAM_ECC
* @arg @ref LL_PKA_MODE_ECC_KP_PRIMITIVE
* @arg @ref LL_PKA_MODE_ECDSA_SIGNATURE
* @arg @ref LL_PKA_MODE_ECDSA_VERIFICATION
* @arg @ref LL_PKA_MODE_POINT_CHECK
* @arg @ref LL_PKA_MODE_RSA_CRT_EXP
* @arg @ref LL_PKA_MODE_MODULAR_INV
* @arg @ref LL_PKA_MODE_ARITHMETIC_ADD
* @arg @ref LL_PKA_MODE_ARITHMETIC_SUB
* @arg @ref LL_PKA_MODE_ARITHMETIC_MUL
* @arg @ref LL_PKA_MODE_COMPARISON
* @arg @ref LL_PKA_MODE_MODULAR_REDUC
* @arg @ref LL_PKA_MODE_MODULAR_ADD
* @arg @ref LL_PKA_MODE_MODULAR_SUB
* @arg @ref LL_PKA_MODE_MONTGOMERY_MUL
* @retval None
*/
__STATIC_INLINE void LL_PKA_SetMode(PKA_TypeDef *PKAx, uint32_t Mode)
{
MODIFY_REG(PKAx->CR, PKA_CR_MODE, Mode << PKA_CR_MODE_Pos);
}
/**
* @brief Get PKA operating mode.
* @rmtoll CR MODE LL_PKA_GetMode
* @param PKAx PKA Instance.
* @retval Returned value can be one of the following values:
* @arg @ref LL_PKA_MODE_MONTGOMERY_PARAM_MOD_EXP
* @arg @ref LL_PKA_MODE_MONTGOMERY_PARAM
* @arg @ref LL_PKA_MODE_MODULAR_EXP
* @arg @ref LL_PKA_MODE_MONTGOMERY_PARAM_ECC
* @arg @ref LL_PKA_MODE_ECC_KP_PRIMITIVE
* @arg @ref LL_PKA_MODE_ECDSA_SIGNATURE
* @arg @ref LL_PKA_MODE_ECDSA_VERIFICATION
* @arg @ref LL_PKA_MODE_POINT_CHECK
* @arg @ref LL_PKA_MODE_RSA_CRT_EXP
* @arg @ref LL_PKA_MODE_MODULAR_INV
* @arg @ref LL_PKA_MODE_ARITHMETIC_ADD
* @arg @ref LL_PKA_MODE_ARITHMETIC_SUB
* @arg @ref LL_PKA_MODE_ARITHMETIC_MUL
* @arg @ref LL_PKA_MODE_COMPARISON
* @arg @ref LL_PKA_MODE_MODULAR_REDUC
* @arg @ref LL_PKA_MODE_MODULAR_ADD
* @arg @ref LL_PKA_MODE_MODULAR_SUB
* @arg @ref LL_PKA_MODE_MONTGOMERY_MUL
*/
__STATIC_INLINE uint32_t LL_PKA_GetMode(PKA_TypeDef *PKAx)
{
return (uint32_t)(READ_BIT(PKAx->CR, PKA_CR_MODE) >> PKA_CR_MODE_Pos);
}
/**
* @brief Start the operation selected using LL_PKA_SetMode.
* @rmtoll CR START LL_PKA_Start
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_Start(PKA_TypeDef *PKAx)
{
SET_BIT(PKAx->CR, PKA_CR_START);
}
/**
* @}
*/
/** @defgroup PKA_LL_EF_IT_Management IT_Management
* @{
*/
/**
* @brief Enable address error interrupt.
* @rmtoll CR ADDRERRIE LL_PKA_EnableIT_ADDRERR
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_EnableIT_ADDRERR(PKA_TypeDef *PKAx)
{
SET_BIT(PKAx->CR, PKA_CR_ADDRERRIE);
}
/**
* @brief Enable RAM error interrupt.
* @rmtoll CR RAMERRIE LL_PKA_EnableIT_RAMERR
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_EnableIT_RAMERR(PKA_TypeDef *PKAx)
{
SET_BIT(PKAx->CR, PKA_CR_RAMERRIE);
}
/**
* @brief Enable end of operation interrupt.
* @rmtoll CR PROCENDIE LL_PKA_EnableIT_PROCEND
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_EnableIT_PROCEND(PKA_TypeDef *PKAx)
{
SET_BIT(PKAx->CR, PKA_CR_PROCENDIE);
}
/**
* @brief Disable address error interrupt.
* @rmtoll CR ADDRERRIE LL_PKA_DisableIT_ADDERR
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_DisableIT_ADDERR(PKA_TypeDef *PKAx)
{
CLEAR_BIT(PKAx->CR, PKA_CR_ADDRERRIE);
}
/**
* @brief Disable RAM error interrupt.
* @rmtoll CR RAMERRIE LL_PKA_DisableIT_RAMERR
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_DisableIT_RAMERR(PKA_TypeDef *PKAx)
{
CLEAR_BIT(PKAx->CR, PKA_CR_RAMERRIE);
}
/**
* @brief Disable End of operation interrupt.
* @rmtoll CR PROCENDIE LL_PKA_DisableIT_PROCEND
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_DisableIT_PROCEND(PKA_TypeDef *PKAx)
{
CLEAR_BIT(PKAx->CR, PKA_CR_PROCENDIE);
}
/**
* @brief Check if address error interrupt is enabled.
* @rmtoll CR ADDRERRIE LL_PKA_IsEnabledIT_ADDRERR
* @param PKAx PKA Instance.
* @retval State of bit (1 or 0).
*/
__STATIC_INLINE uint32_t LL_PKA_IsEnabledIT_ADDRERR(PKA_TypeDef *PKAx)
{
return ((READ_BIT(PKAx->CR, PKA_CR_ADDRERRIE) == (PKA_CR_ADDRERRIE)) ? 1UL : 0UL);
}
/**
* @brief Check if RAM error interrupt is enabled.
* @rmtoll CR RAMERRIE LL_PKA_IsEnabledIT_RAMERR
* @param PKAx PKA Instance.
* @retval State of bit (1 or 0).
*/
__STATIC_INLINE uint32_t LL_PKA_IsEnabledIT_RAMERR(PKA_TypeDef *PKAx)
{
return ((READ_BIT(PKAx->CR, PKA_CR_RAMERRIE) == (PKA_CR_RAMERRIE)) ? 1UL : 0UL);
}
/**
* @brief Check if end of operation interrupt is enabled.
* @rmtoll CR PROCENDIE LL_PKA_IsEnabledIT_PROCEND
* @param PKAx PKA Instance.
* @retval State of bit (1 or 0).
*/
__STATIC_INLINE uint32_t LL_PKA_IsEnabledIT_PROCEND(PKA_TypeDef *PKAx)
{
return ((READ_BIT(PKAx->CR, PKA_CR_PROCENDIE) == (PKA_CR_PROCENDIE)) ? 1UL : 0UL);
}
/**
* @}
*/
/** @defgroup PKA_LL_EF_FLAG_Management PKA flag management
* @{
*/
/**
* @brief Get PKA address error flag.
* @rmtoll SR ADDRERRF LL_PKA_IsActiveFlag_ADDRERR
* @param PKAx PKA Instance.
* @retval State of bit (1 or 0).
*/
__STATIC_INLINE uint32_t LL_PKA_IsActiveFlag_ADDRERR(PKA_TypeDef *PKAx)
{
return ((READ_BIT(PKAx->SR, PKA_SR_ADDRERRF) == (PKA_SR_ADDRERRF)) ? 1UL : 0UL);
}
/**
* @brief Get PKA RAM error flag.
* @rmtoll SR RAMERRF LL_PKA_IsActiveFlag_RAMERR
* @param PKAx PKA Instance.
* @retval State of bit (1 or 0).
*/
__STATIC_INLINE uint32_t LL_PKA_IsActiveFlag_RAMERR(PKA_TypeDef *PKAx)
{
return ((READ_BIT(PKAx->SR, PKA_SR_RAMERRF) == (PKA_SR_RAMERRF)) ? 1UL : 0UL);
}
/**
* @brief Get PKA end of operation flag.
* @rmtoll SR PROCENDF LL_PKA_IsActiveFlag_PROCEND
* @param PKAx PKA Instance.
* @retval State of bit (1 or 0).
*/
__STATIC_INLINE uint32_t LL_PKA_IsActiveFlag_PROCEND(PKA_TypeDef *PKAx)
{
return ((READ_BIT(PKAx->SR, PKA_SR_PROCENDF) == (PKA_SR_PROCENDF)) ? 1UL : 0UL);
}
/**
* @brief Get PKA busy flag.
* @rmtoll SR BUSY LL_PKA_IsActiveFlag_BUSY
* @param PKAx PKA Instance.
* @retval State of bit (1 or 0).
*/
__STATIC_INLINE uint32_t LL_PKA_IsActiveFlag_BUSY(PKA_TypeDef *PKAx)
{
return ((READ_BIT(PKAx->SR, PKA_SR_BUSY) == (PKA_SR_BUSY)) ? 1UL : 0UL);
}
/**
* @brief Clear PKA address error flag.
* @rmtoll CLRFR ADDRERRFC LL_PKA_ClearFlag_ADDERR
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_ClearFlag_ADDERR(PKA_TypeDef *PKAx)
{
SET_BIT(PKAx->CLRFR, PKA_CLRFR_ADDRERRFC);
}
/**
* @brief Clear PKA RAM error flag.
* @rmtoll CLRFR RAMERRFC LL_PKA_ClearFlag_RAMERR
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_ClearFlag_RAMERR(PKA_TypeDef *PKAx)
{
SET_BIT(PKAx->CLRFR, PKA_CLRFR_RAMERRFC);
}
/**
* @brief Clear PKA end of operation flag.
* @rmtoll CLRFR PROCENDFC LL_PKA_ClearFlag_PROCEND
* @param PKAx PKA Instance.
* @retval None
*/
__STATIC_INLINE void LL_PKA_ClearFlag_PROCEND(PKA_TypeDef *PKAx)
{
SET_BIT(PKAx->CLRFR, PKA_CLRFR_PROCENDFC);
}
/**
* @}
*/
#if defined(USE_FULL_LL_DRIVER)
/** @defgroup PKA_LL_EF_Init Initialization and de-initialization functions
* @{
*/
ErrorStatus LL_PKA_DeInit(PKA_TypeDef *PKAx);
ErrorStatus LL_PKA_Init(PKA_TypeDef *PKAx, LL_PKA_InitTypeDef *PKA_InitStruct);
void LL_PKA_StructInit(LL_PKA_InitTypeDef *PKA_InitStruct);
/**
* @}
*/
#endif /* USE_FULL_LL_DRIVER */
/**
* @}
*/
/**
* @}
*/
#endif /* defined(PKA) */
/**
* @}
*/
#ifdef __cplusplus
}
#endif
#endif /* STM32WBxx_LL_PKA_H */
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|