123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478 |
- /**
- ******************************************************************************
- * @file stm32l4xx_hal_pka.c
- * @author MCD Application Team
- * @brief PKA HAL module driver.
- * This file provides firmware functions to manage the following
- * functionalities of public key accelerator(PKA):
- * + Initialization and de-initialization functions
- * + Start an operation
- * + Retrieve the operation result
- *
- ******************************************************************************
- * @attention
- *
- * Copyright (c) 2017 STMicroelectronics.
- * All rights reserved.
- *
- * This software is licensed under terms that can be found in the LICENSE file
- * in the root directory of this software component.
- * If no LICENSE file comes with this software, it is provided AS-IS.
- *
- ******************************************************************************
- @verbatim
- ==============================================================================
- ##### How to use this driver #####
- ==============================================================================
- [..]
- The PKA HAL driver can be used as follows:
- (#) Declare a PKA_HandleTypeDef handle structure, for example: PKA_HandleTypeDef hpka;
- (#) Initialize the PKA low level resources by implementing the HAL_PKA_MspInit() API:
- (##) Enable the PKA interface clock
- (##) NVIC configuration if you need to use interrupt process
- (+++) Configure the PKA interrupt priority
- (+++) Enable the NVIC PKA IRQ Channel
- (#) Initialize the PKA registers by calling the HAL_PKA_Init() API which trig
- HAL_PKA_MspInit().
- (#) Fill entirely the input structure corresponding to your operation:
- For instance: PKA_ModExpInTypeDef for HAL_PKA_ModExp().
- (#) Execute the operation (in polling or interrupt) and check the returned value.
- (#) Retrieve the result of the operation (For instance, HAL_PKA_ModExp_GetResult for
- HAL_PKA_ModExp operation). The function to gather the result is different for each
- kind of operation. The correspondence can be found in the following section.
- (#) Call the function HAL_PKA_DeInit() to restore the default configuration which trig
- HAL_PKA_MspDeInit().
- *** High level operation ***
- =================================
- [..]
- (+) Input structure requires buffers as uint8_t array.
- (+) Output structure requires buffers as uint8_t array.
- (+) Modular exponentiation using:
- (++) HAL_PKA_ModExp().
- (++) HAL_PKA_ModExp_IT().
- (++) HAL_PKA_ModExpFastMode().
- (++) HAL_PKA_ModExpFastMode_IT().
- (++) HAL_PKA_ModExp_GetResult() to retrieve the result of the operation.
- (+) RSA Chinese Remainder Theorem (CRT) using:
- (++) HAL_PKA_RSACRTExp().
- (++) HAL_PKA_RSACRTExp_IT().
- (++) HAL_PKA_RSACRTExp_GetResult() to retrieve the result of the operation.
- (+) ECC Point Check using:
- (++) HAL_PKA_PointCheck().
- (++) HAL_PKA_PointCheck_IT().
- (++) HAL_PKA_PointCheck_IsOnCurve() to retrieve the result of the operation.
- (+) ECDSA Sign
- (++) HAL_PKA_ECDSASign().
- (++) HAL_PKA_ECDSASign_IT().
- (++) HAL_PKA_ECDSASign_GetResult() to retrieve the result of the operation.
- (+) ECDSA Verify
- (++) HAL_PKA_ECDSAVerif().
- (++) HAL_PKA_ECDSAVerif_IT().
- (++) HAL_PKA_ECDSAVerif_IsValidSignature() to retrieve the result of the operation.
- (+) ECC Scalar Multiplication using:
- (++) HAL_PKA_ECCMul().
- (++) HAL_PKA_ECCMul_IT().
- (++) HAL_PKA_ECCMulFastMode().
- (++) HAL_PKA_ECCMulFastMode_IT().
- (++) HAL_PKA_ECCMul_GetResult() to retrieve the result of the operation.
- *** Low level operation ***
- =================================
- [..]
- (+) Input structure requires buffers as uint32_t array.
- (+) Output structure requires buffers as uint32_t array.
- (+) Arithmetic addition using:
- (++) HAL_PKA_Add().
- (++) HAL_PKA_Add_IT().
- (++) HAL_PKA_Arithmetic_GetResult() to retrieve the result of the operation.
- The resulting size can be the input parameter or the input parameter size + 1 (overflow).
- (+) Arithmetic subtraction using:
- (++) HAL_PKA_Sub().
- (++) HAL_PKA_Sub_IT().
- (++) HAL_PKA_Arithmetic_GetResult() to retrieve the result of the operation.
- (+) Arithmetic multiplication using:
- (++) HAL_PKA_Mul().
- (++) HAL_PKA_Mul_IT().
- (++) HAL_PKA_Arithmetic_GetResult() to retrieve the result of the operation.
- (+) Comparison using:
- (++) HAL_PKA_Cmp().
- (++) HAL_PKA_Cmp_IT().
- (++) HAL_PKA_Arithmetic_GetResult() to retrieve the result of the operation.
- (+) Modular addition using:
- (++) HAL_PKA_ModAdd().
- (++) HAL_PKA_ModAdd_IT().
- (++) HAL_PKA_Arithmetic_GetResult() to retrieve the result of the operation.
- (+) Modular subtraction using:
- (++) HAL_PKA_ModSub().
- (++) HAL_PKA_ModSub_IT().
- (++) HAL_PKA_Arithmetic_GetResult() to retrieve the result of the operation.
- (+) Modular inversion using:
- (++) HAL_PKA_ModInv().
- (++) HAL_PKA_ModInv_IT().
- (++) HAL_PKA_Arithmetic_GetResult() to retrieve the result of the operation.
- (+) Modular reduction using:
- (++) HAL_PKA_ModRed().
- (++) HAL_PKA_ModRed_IT().
- (++) HAL_PKA_Arithmetic_GetResult() to retrieve the result of the operation.
- (+) Montgomery multiplication using:
- (++) HAL_PKA_MontgomeryMul().
- (++) HAL_PKA_MontgomeryMul_IT().
- (++) HAL_PKA_Arithmetic_GetResult() to retrieve the result of the operation.
- *** Montgomery parameter ***
- =================================
- (+) For some operation, the computation of the Montgomery parameter is a prerequisite.
- (+) Input structure requires buffers as uint8_t array.
- (+) Output structure requires buffers as uint32_t array.(Only used inside PKA).
- (+) You can compute the Montgomery parameter using:
- (++) HAL_PKA_MontgomeryParam().
- (++) HAL_PKA_MontgomeryParam_IT().
- (++) HAL_PKA_MontgomeryParam_GetResult() to retrieve the result of the operation.
- *** Polling mode operation ***
- ===================================
- [..]
- (+) When an operation is started in polling mode, the function returns when:
- (++) A timeout is encounter.
- (++) The operation is completed.
- *** Interrupt mode operation ***
- ===================================
- [..]
- (+) Add HAL_PKA_IRQHandler to the IRQHandler of PKA.
- (+) Enable the IRQ using HAL_NVIC_EnableIRQ().
- (+) When an operation is started in interrupt mode, the function returns immediately.
- (+) When the operation is completed, the callback HAL_PKA_OperationCpltCallback is called.
- (+) When an error is encountered, the callback HAL_PKA_ErrorCallback is called.
- (+) To stop any operation in interrupt mode, use HAL_PKA_Abort().
- *** Utilities ***
- ===================================
- [..]
- (+) To clear the PKA RAM, use HAL_PKA_RAMReset().
- (+) To get current state, use HAL_PKA_GetState().
- (+) To get current error, use HAL_PKA_GetError().
- *** Callback registration ***
- =============================================
- [..]
- The compilation flag USE_HAL_PKA_REGISTER_CALLBACKS, when set to 1,
- allows the user to configure dynamically the driver callbacks.
- Use Functions HAL_PKA_RegisterCallback()
- to register an interrupt callback.
- [..]
- Function HAL_PKA_RegisterCallback() allows to register following callbacks:
- (+) OperationCpltCallback : callback for End of operation.
- (+) ErrorCallback : callback for error detection.
- (+) MspInitCallback : callback for Msp Init.
- (+) MspDeInitCallback : callback for Msp DeInit.
- This function takes as parameters the HAL peripheral handle, the Callback ID
- and a pointer to the user callback function.
- [..]
- Use function HAL_PKA_UnRegisterCallback to reset a callback to the default
- weak function.
- [..]
- HAL_PKA_UnRegisterCallback takes as parameters the HAL peripheral handle,
- and the Callback ID.
- This function allows to reset following callbacks:
- (+) OperationCpltCallback : callback for End of operation.
- (+) ErrorCallback : callback for error detection.
- (+) MspInitCallback : callback for Msp Init.
- (+) MspDeInitCallback : callback for Msp DeInit.
- [..]
- By default, after the HAL_PKA_Init() and when the state is HAL_PKA_STATE_RESET
- all callbacks are set to the corresponding weak functions:
- examples HAL_PKA_OperationCpltCallback(), HAL_PKA_ErrorCallback().
- Exception done for MspInit and MspDeInit functions that are
- reset to the legacy weak functions in the HAL_PKA_Init()/ HAL_PKA_DeInit() only when
- these callbacks are null (not registered beforehand).
- [..]
- If MspInit or MspDeInit are not null, the HAL_PKA_Init()/ HAL_PKA_DeInit()
- keep and use the user MspInit/MspDeInit callbacks (registered beforehand) whatever the state.
- [..]
- Callbacks can be registered/unregistered in HAL_PKA_STATE_READY state only.
- Exception done MspInit/MspDeInit functions that can be registered/unregistered
- in HAL_PKA_STATE_READY or HAL_PKA_STATE_RESET state,
- thus registered (user) MspInit/DeInit callbacks can be used during the Init/DeInit.
- [..]
- Then, the user first registers the MspInit/MspDeInit user callbacks
- using HAL_PKA_RegisterCallback() before calling HAL_PKA_DeInit()
- or HAL_PKA_Init() function.
- [..]
- When the compilation flag USE_HAL_PKA_REGISTER_CALLBACKS is set to 0 or
- not defined, the callback registration feature is not available and all callbacks
- are set to the corresponding weak functions.
- @endverbatim
- ******************************************************************************
- */
- /* Includes ------------------------------------------------------------------*/
- #include "stm32l4xx_hal.h"
- /** @addtogroup STM32L4xx_HAL_Driver
- * @{
- */
- #if defined(PKA) && defined(HAL_PKA_MODULE_ENABLED)
- /** @defgroup PKA PKA
- * @brief PKA HAL module driver.
- * @{
- */
- /* Private typedef -----------------------------------------------------------*/
- /* Private define ------------------------------------------------------------*/
- /** @defgroup PKA_Private_Define PKA Private Define
- * @{
- */
- #define PKA_RAM_SIZE 894U
- #define PKA_RAM_ERASE_TIMEOUT 1000U
- /* Private macro -------------------------------------------------------------*/
- #define __PKA_RAM_PARAM_END(TAB,INDEX) do{ \
- TAB[INDEX] = 0UL; \
- } while(0)
- /**
- * @}
- */
- /* Private variables ---------------------------------------------------------*/
- /* Private function prototypes -----------------------------------------------*/
- /** @defgroup PKA_Private_Functions PKA Private Functions
- * @{
- */
- uint32_t PKA_GetMode(const PKA_HandleTypeDef *hpka);
- HAL_StatusTypeDef PKA_PollEndOfOperation(const PKA_HandleTypeDef *hpka, uint32_t Timeout, uint32_t Tickstart);
- uint32_t PKA_CheckError(const PKA_HandleTypeDef *hpka, uint32_t mode);
- uint32_t PKA_GetBitSize_u8(uint32_t byteNumber);
- uint32_t PKA_GetOptBitSize_u8(uint32_t byteNumber, uint8_t msb);
- uint32_t PKA_GetBitSize_u32(uint32_t wordNumber);
- uint32_t PKA_GetArraySize_u8(uint32_t bitSize);
- void PKA_Memcpy_u32_to_u8(uint8_t dst[], __IO const uint32_t src[], size_t n);
- void PKA_Memcpy_u8_to_u32(__IO uint32_t dst[], const uint8_t src[], size_t n);
- void PKA_Memcpy_u32_to_u32(__IO uint32_t dst[], __IO const uint32_t src[], size_t n);
- HAL_StatusTypeDef PKA_Process(PKA_HandleTypeDef *hpka, uint32_t mode, uint32_t Timeout);
- HAL_StatusTypeDef PKA_Process_IT(PKA_HandleTypeDef *hpka, uint32_t mode);
- void PKA_ModExp_Set(PKA_HandleTypeDef *hpka, PKA_ModExpInTypeDef *in);
- void PKA_ModExpFastMode_Set(PKA_HandleTypeDef *hpka, PKA_ModExpFastModeInTypeDef *in);
- void PKA_ECDSASign_Set(PKA_HandleTypeDef *hpka, PKA_ECDSASignInTypeDef *in);
- void PKA_ECDSAVerif_Set(PKA_HandleTypeDef *hpka, PKA_ECDSAVerifInTypeDef *in);
- void PKA_RSACRTExp_Set(PKA_HandleTypeDef *hpka, PKA_RSACRTExpInTypeDef *in);
- void PKA_PointCheck_Set(PKA_HandleTypeDef *hpka, PKA_PointCheckInTypeDef *in);
- void PKA_ECCMul_Set(PKA_HandleTypeDef *hpka, PKA_ECCMulInTypeDef *in);
- void PKA_ECCMulFastMode_Set(PKA_HandleTypeDef *hpka, PKA_ECCMulFastModeInTypeDef *in);
- void PKA_ModRed_Set(PKA_HandleTypeDef *hpka, PKA_ModRedInTypeDef *in);
- void PKA_ModInv_Set(PKA_HandleTypeDef *hpka, PKA_ModInvInTypeDef *in);
- void PKA_MontgomeryParam_Set(PKA_HandleTypeDef *hpka, const uint32_t size, const uint8_t *pOp1);
- void PKA_ARI_Set(PKA_HandleTypeDef *hpka, const uint32_t size, const uint32_t *pOp1, const uint32_t *pOp2,
- const uint8_t *pOp3);
- /**
- * @}
- */
- /* Exported functions --------------------------------------------------------*/
- /** @defgroup PKA_Exported_Functions PKA Exported Functions
- * @{
- */
- /** @defgroup PKA_Exported_Functions_Group1 Initialization and de-initialization functions
- * @brief Initialization and de-initialization functions
- *
- @verbatim
- ===============================================================================
- ##### Initialization and de-initialization functions #####
- ===============================================================================
- [..] This subsection provides a set of functions allowing to initialize and
- deinitialize the PKAx peripheral:
- (+) User must implement HAL_PKA_MspInit() function in which he configures
- all related peripherals resources (CLOCK, IT and NVIC ).
- (+) Call the function HAL_PKA_Init() to configure the device.
- (+) Call the function HAL_PKA_DeInit() to restore the default configuration
- of the selected PKAx peripheral.
- @endverbatim
- * @{
- */
- /**
- * @brief Initialize the PKA according to the specified
- * parameters in the PKA_InitTypeDef and initialize the associated handle.
- * @param hpka PKA handle
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_Init(PKA_HandleTypeDef *hpka)
- {
- HAL_StatusTypeDef err = HAL_OK;
- uint32_t tickstart;
- /* Check the PKA handle allocation */
- if (hpka != NULL)
- {
- /* Check the parameters */
- assert_param(IS_PKA_ALL_INSTANCE(hpka->Instance));
- if (hpka->State == HAL_PKA_STATE_RESET)
- {
- #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
- /* Init the PKA Callback settings */
- hpka->OperationCpltCallback = HAL_PKA_OperationCpltCallback; /* Legacy weak OperationCpltCallback */
- hpka->ErrorCallback = HAL_PKA_ErrorCallback; /* Legacy weak ErrorCallback */
- if (hpka->MspInitCallback == NULL)
- {
- hpka->MspInitCallback = HAL_PKA_MspInit; /* Legacy weak MspInit */
- }
- /* Init the low level hardware */
- hpka->MspInitCallback(hpka);
- #else
- /* Init the low level hardware */
- HAL_PKA_MspInit(hpka);
- #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
- }
- /* Set the state to busy */
- hpka->State = HAL_PKA_STATE_BUSY;
- /* Get current tick */
- tickstart = HAL_GetTick();
- /* Reset the control register and enable the PKA (wait the end of PKA RAM erase) */
- while ((hpka->Instance->CR & PKA_CR_EN) != PKA_CR_EN)
- {
- hpka->Instance->CR = PKA_CR_EN;
- /* Check the Timeout */
- if ((HAL_GetTick() - tickstart) > PKA_RAM_ERASE_TIMEOUT)
- {
- /* Set timeout status */
- err = HAL_TIMEOUT;
- break;
- }
- }
- if (err == HAL_OK)
- {
- /* Reset any pending flag */
- SET_BIT(hpka->Instance->CLRFR, PKA_CLRFR_PROCENDFC | PKA_CLRFR_RAMERRFC | PKA_CLRFR_ADDRERRFC);
- /* Initialize the error code */
- hpka->ErrorCode = HAL_PKA_ERROR_NONE;
- /* Set the state to ready */
- hpka->State = HAL_PKA_STATE_READY;
- }
- else
- {
- /* Set the error code to timeout error */
- hpka->ErrorCode = HAL_PKA_ERROR_TIMEOUT;
- /* Set the state to error */
- hpka->State = HAL_PKA_STATE_ERROR;
- }
- }
- else
- {
- err = HAL_ERROR;
- }
- return err;
- }
- /**
- * @brief DeInitialize the PKA peripheral.
- * @param hpka PKA handle
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_DeInit(PKA_HandleTypeDef *hpka)
- {
- HAL_StatusTypeDef err = HAL_OK;
- /* Check the PKA handle allocation */
- if (hpka != NULL)
- {
- /* Check the parameters */
- assert_param(IS_PKA_ALL_INSTANCE(hpka->Instance));
- /* Set the state to busy */
- hpka->State = HAL_PKA_STATE_BUSY;
- /* Reset the control register */
- /* This abort any operation in progress (PKA RAM content is not guaranteed in this case) */
- hpka->Instance->CR = 0;
- /* Reset any pending flag */
- SET_BIT(hpka->Instance->CLRFR, PKA_CLRFR_PROCENDFC | PKA_CLRFR_RAMERRFC | PKA_CLRFR_ADDRERRFC);
- #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
- if (hpka->MspDeInitCallback == NULL)
- {
- hpka->MspDeInitCallback = HAL_PKA_MspDeInit; /* Legacy weak MspDeInit */
- }
- /* DeInit the low level hardware: GPIO, CLOCK, NVIC */
- hpka->MspDeInitCallback(hpka);
- #else
- /* DeInit the low level hardware: CLOCK, NVIC */
- HAL_PKA_MspDeInit(hpka);
- #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
- /* Reset the error code */
- hpka->ErrorCode = HAL_PKA_ERROR_NONE;
- /* Reset the state */
- hpka->State = HAL_PKA_STATE_RESET;
- }
- else
- {
- err = HAL_ERROR;
- }
- return err;
- }
- /**
- * @brief Initialize the PKA MSP.
- * @param hpka PKA handle
- * @retval None
- */
- __weak void HAL_PKA_MspInit(PKA_HandleTypeDef *hpka)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hpka);
- /* NOTE : This function should not be modified, when the callback is needed,
- the HAL_PKA_MspInit can be implemented in the user file
- */
- }
- /**
- * @brief DeInitialize the PKA MSP.
- * @param hpka PKA handle
- * @retval None
- */
- __weak void HAL_PKA_MspDeInit(PKA_HandleTypeDef *hpka)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hpka);
- /* NOTE : This function should not be modified, when the callback is needed,
- the HAL_PKA_MspDeInit can be implemented in the user file
- */
- }
- #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
- /**
- * @brief Register a User PKA Callback
- * To be used instead of the weak predefined callback
- * @param hpka Pointer to a PKA_HandleTypeDef structure that contains
- * the configuration information for the specified PKA.
- * @param CallbackID ID of the callback to be registered
- * This parameter can be one of the following values:
- * @arg @ref HAL_PKA_OPERATION_COMPLETE_CB_ID End of operation callback ID
- * @arg @ref HAL_PKA_ERROR_CB_ID Error callback ID
- * @arg @ref HAL_PKA_MSPINIT_CB_ID MspInit callback ID
- * @arg @ref HAL_PKA_MSPDEINIT_CB_ID MspDeInit callback ID
- * @param pCallback pointer to the Callback function
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_RegisterCallback(PKA_HandleTypeDef *hpka, HAL_PKA_CallbackIDTypeDef CallbackID,
- pPKA_CallbackTypeDef pCallback)
- {
- HAL_StatusTypeDef status = HAL_OK;
- if (pCallback == NULL)
- {
- /* Update the error code */
- hpka->ErrorCode |= HAL_PKA_ERROR_INVALID_CALLBACK;
- return HAL_ERROR;
- }
- if (HAL_PKA_STATE_READY == hpka->State)
- {
- switch (CallbackID)
- {
- case HAL_PKA_OPERATION_COMPLETE_CB_ID :
- hpka->OperationCpltCallback = pCallback;
- break;
- case HAL_PKA_ERROR_CB_ID :
- hpka->ErrorCallback = pCallback;
- break;
- case HAL_PKA_MSPINIT_CB_ID :
- hpka->MspInitCallback = pCallback;
- break;
- case HAL_PKA_MSPDEINIT_CB_ID :
- hpka->MspDeInitCallback = pCallback;
- break;
- default :
- /* Update the error code */
- hpka->ErrorCode |= HAL_PKA_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- break;
- }
- }
- else if (HAL_PKA_STATE_RESET == hpka->State)
- {
- switch (CallbackID)
- {
- case HAL_PKA_MSPINIT_CB_ID :
- hpka->MspInitCallback = pCallback;
- break;
- case HAL_PKA_MSPDEINIT_CB_ID :
- hpka->MspDeInitCallback = pCallback;
- break;
- default :
- /* Update the error code */
- hpka->ErrorCode |= HAL_PKA_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- break;
- }
- }
- else
- {
- /* Update the error code */
- hpka->ErrorCode |= HAL_PKA_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- }
- return status;
- }
- /**
- * @brief Unregister a PKA Callback
- * PKA callback is redirected to the weak predefined callback
- * @param hpka Pointer to a PKA_HandleTypeDef structure that contains
- * the configuration information for the specified PKA.
- * @param CallbackID ID of the callback to be unregistered
- * This parameter can be one of the following values:
- * @arg @ref HAL_PKA_OPERATION_COMPLETE_CB_ID End of operation callback ID
- * @arg @ref HAL_PKA_ERROR_CB_ID Error callback ID
- * @arg @ref HAL_PKA_MSPINIT_CB_ID MspInit callback ID
- * @arg @ref HAL_PKA_MSPDEINIT_CB_ID MspDeInit callback ID
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_UnRegisterCallback(PKA_HandleTypeDef *hpka, HAL_PKA_CallbackIDTypeDef CallbackID)
- {
- HAL_StatusTypeDef status = HAL_OK;
- if (HAL_PKA_STATE_READY == hpka->State)
- {
- switch (CallbackID)
- {
- case HAL_PKA_OPERATION_COMPLETE_CB_ID :
- hpka->OperationCpltCallback = HAL_PKA_OperationCpltCallback; /* Legacy weak OperationCpltCallback */
- break;
- case HAL_PKA_ERROR_CB_ID :
- hpka->ErrorCallback = HAL_PKA_ErrorCallback; /* Legacy weak ErrorCallback */
- break;
- case HAL_PKA_MSPINIT_CB_ID :
- hpka->MspInitCallback = HAL_PKA_MspInit; /* Legacy weak MspInit */
- break;
- case HAL_PKA_MSPDEINIT_CB_ID :
- hpka->MspDeInitCallback = HAL_PKA_MspDeInit; /* Legacy weak MspDeInit */
- break;
- default :
- /* Update the error code */
- hpka->ErrorCode |= HAL_PKA_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- break;
- }
- }
- else if (HAL_PKA_STATE_RESET == hpka->State)
- {
- switch (CallbackID)
- {
- case HAL_PKA_MSPINIT_CB_ID :
- hpka->MspInitCallback = HAL_PKA_MspInit; /* Legacy weak MspInit */
- break;
- case HAL_PKA_MSPDEINIT_CB_ID :
- hpka->MspDeInitCallback = HAL_PKA_MspDeInit; /* Legacy weak MspDeInit */
- break;
- default :
- /* Update the error code */
- hpka->ErrorCode |= HAL_PKA_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- break;
- }
- }
- else
- {
- /* Update the error code */
- hpka->ErrorCode |= HAL_PKA_ERROR_INVALID_CALLBACK;
- /* Return error status */
- status = HAL_ERROR;
- }
- return status;
- }
- #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
- /**
- * @}
- */
- /** @defgroup PKA_Exported_Functions_Group2 IO operation functions
- * @brief IO operation functions
- *
- @verbatim
- ===============================================================================
- ##### IO operation functions #####
- ===============================================================================
- [..]
- This subsection provides a set of functions allowing to manage the PKA operations.
- (#) There are two modes of operation:
- (++) Blocking mode : The operation is performed in the polling mode.
- These functions return when data operation is completed.
- (++) No-Blocking mode : The operation is performed using Interrupts.
- These functions return immediately.
- The end of the operation is indicated by HAL_PKA_ErrorCallback in case of error.
- The end of the operation is indicated by HAL_PKA_OperationCpltCallback in case of success.
- To stop any operation in interrupt mode, use HAL_PKA_Abort().
- (#) Blocking mode functions are :
- (++) HAL_PKA_ModExp()
- (++) HAL_PKA_ModExpFastMode()
- (++) HAL_PKA_ModExp_GetResult();
- (++) HAL_PKA_ECDSASign()
- (++) HAL_PKA_ECDSASign_GetResult();
- (++) HAL_PKA_ECDSAVerif()
- (++) HAL_PKA_ECDSAVerif_IsValidSignature();
- (++) HAL_PKA_RSACRTExp()
- (++) HAL_PKA_RSACRTExp_GetResult();
- (++) HAL_PKA_PointCheck()
- (++) HAL_PKA_PointCheck_IsOnCurve();
- (++) HAL_PKA_ECCMul()
- (++) HAL_PKA_ECCMulFastMode()
- (++) HAL_PKA_ECCMul_GetResult();
- (++) HAL_PKA_Add()
- (++) HAL_PKA_Sub()
- (++) HAL_PKA_Cmp()
- (++) HAL_PKA_Mul()
- (++) HAL_PKA_ModAdd()
- (++) HAL_PKA_ModSub()
- (++) HAL_PKA_ModInv()
- (++) HAL_PKA_ModRed()
- (++) HAL_PKA_MontgomeryMul()
- (++) HAL_PKA_Arithmetic_GetResult(P);
- (++) HAL_PKA_MontgomeryParam()
- (++) HAL_PKA_MontgomeryParam_GetResult();
- (#) No-Blocking mode functions with Interrupt are :
- (++) HAL_PKA_ModExp_IT();
- (++) HAL_PKA_ModExpFastMode_IT();
- (++) HAL_PKA_ModExp_GetResult();
- (++) HAL_PKA_ECDSASign_IT();
- (++) HAL_PKA_ECDSASign_GetResult();
- (++) HAL_PKA_ECDSAVerif_IT();
- (++) HAL_PKA_ECDSAVerif_IsValidSignature();
- (++) HAL_PKA_RSACRTExp_IT();
- (++) HAL_PKA_RSACRTExp_GetResult();
- (++) HAL_PKA_PointCheck_IT();
- (++) HAL_PKA_PointCheck_IsOnCurve();
- (++) HAL_PKA_ECCMul_IT();
- (++) HAL_PKA_ECCMulFastMode_IT();
- (++) HAL_PKA_ECCMul_GetResult();
- (++) HAL_PKA_Add_IT();
- (++) HAL_PKA_Sub_IT();
- (++) HAL_PKA_Cmp_IT();
- (++) HAL_PKA_Mul_IT();
- (++) HAL_PKA_ModAdd_IT();
- (++) HAL_PKA_ModSub_IT();
- (++) HAL_PKA_ModInv_IT();
- (++) HAL_PKA_ModRed_IT();
- (++) HAL_PKA_MontgomeryMul_IT();
- (++) HAL_PKA_Arithmetic_GetResult();
- (++) HAL_PKA_MontgomeryParam_IT();
- (++) HAL_PKA_MontgomeryParam_GetResult();
- (++) HAL_PKA_Abort();
- @endverbatim
- * @{
- */
- /**
- * @brief Modular exponentiation in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModExp(PKA_HandleTypeDef *hpka, PKA_ModExpInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ModExp_Set(hpka, in);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_MODULAR_EXP, Timeout);
- }
- /**
- * @brief Modular exponentiation in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModExp_IT(PKA_HandleTypeDef *hpka, PKA_ModExpInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ModExp_Set(hpka, in);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_MODULAR_EXP);
- }
- /**
- * @brief Modular exponentiation in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModExpFastMode(PKA_HandleTypeDef *hpka, PKA_ModExpFastModeInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ModExpFastMode_Set(hpka, in);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_MODULAR_EXP_FAST_MODE, Timeout);
- }
- /**
- * @brief Modular exponentiation in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModExpFastMode_IT(PKA_HandleTypeDef *hpka, PKA_ModExpFastModeInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ModExpFastMode_Set(hpka, in);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_MODULAR_EXP_FAST_MODE);
- }
- /**
- * @brief Retrieve operation result.
- * @param hpka PKA handle
- * @param pRes Output buffer
- * @retval HAL status
- */
- void HAL_PKA_ModExp_GetResult(PKA_HandleTypeDef *hpka, uint8_t *pRes)
- {
- uint32_t size;
- /* Indicate to the user the final size */
- size = (hpka->Instance->RAM[PKA_MODULAR_EXP_IN_OP_NB_BITS] + 7UL) / 8UL;
- /* Move the result to appropriate location (indicated in out parameter) */
- PKA_Memcpy_u32_to_u8(pRes, &hpka->Instance->RAM[PKA_MODULAR_EXP_OUT_SM_ALGO_ACC1], size);
- }
- /**
- * @brief Sign a message using elliptic curves over prime fields in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ECDSASign(PKA_HandleTypeDef *hpka, PKA_ECDSASignInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ECDSASign_Set(hpka, in);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_ECDSA_SIGNATURE, Timeout);
- }
- /**
- * @brief Sign a message using elliptic curves over prime fields in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ECDSASign_IT(PKA_HandleTypeDef *hpka, PKA_ECDSASignInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ECDSASign_Set(hpka, in);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_ECDSA_SIGNATURE);
- }
- /**
- * @brief Retrieve operation result.
- * @param hpka PKA handle
- * @param out Output information
- * @param outExt Additional Output information (facultative)
- */
- void HAL_PKA_ECDSASign_GetResult(PKA_HandleTypeDef *hpka, PKA_ECDSASignOutTypeDef *out,
- PKA_ECDSASignOutExtParamTypeDef *outExt)
- {
- uint32_t size;
- size = (hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_MOD_NB_BITS] + 7UL) / 8UL;
- if (out != NULL)
- {
- PKA_Memcpy_u32_to_u8(out->RSign, &hpka->Instance->RAM[PKA_ECDSA_SIGN_OUT_SIGNATURE_R], size);
- PKA_Memcpy_u32_to_u8(out->SSign, &hpka->Instance->RAM[PKA_ECDSA_SIGN_OUT_SIGNATURE_S], size);
- }
- /* If user requires the additional information */
- if (outExt != NULL)
- {
- /* Move the result to appropriate location (indicated in outExt parameter) */
- PKA_Memcpy_u32_to_u8(outExt->ptX, &hpka->Instance->RAM[PKA_ECDSA_SIGN_OUT_FINAL_POINT_X], size);
- PKA_Memcpy_u32_to_u8(outExt->ptY, &hpka->Instance->RAM[PKA_ECDSA_SIGN_OUT_FINAL_POINT_Y], size);
- }
- }
- /**
- * @brief Verify the validity of a signature using elliptic curves over prime fields in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ECDSAVerif(PKA_HandleTypeDef *hpka, PKA_ECDSAVerifInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ECDSAVerif_Set(hpka, in);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_ECDSA_VERIFICATION, Timeout);
- }
- /**
- * @brief Verify the validity of a signature using elliptic curves
- * over prime fields in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ECDSAVerif_IT(PKA_HandleTypeDef *hpka, PKA_ECDSAVerifInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ECDSAVerif_Set(hpka, in);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_ECDSA_VERIFICATION);
- }
- /**
- * @brief Return the result of the ECDSA verification operation.
- * @param hpka PKA handle
- * @retval 1 if signature is verified, 0 in other case
- */
- uint32_t HAL_PKA_ECDSAVerif_IsValidSignature(PKA_HandleTypeDef const *const hpka)
- {
- /* Invert the state of the PKA RAM bit containing the result of the operation */
- return (hpka->Instance->RAM[PKA_ECDSA_VERIF_OUT_RESULT] == 0UL) ? 1UL : 0UL;
- }
- /**
- * @brief RSA CRT exponentiation in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_RSACRTExp(PKA_HandleTypeDef *hpka, PKA_RSACRTExpInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_RSACRTExp_Set(hpka, in);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_RSA_CRT_EXP, Timeout);
- }
- /**
- * @brief RSA CRT exponentiation in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_RSACRTExp_IT(PKA_HandleTypeDef *hpka, PKA_RSACRTExpInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_RSACRTExp_Set(hpka, in);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_RSA_CRT_EXP);
- }
- /**
- * @brief Retrieve operation result.
- * @param hpka PKA handle
- * @param pRes Pointer to memory location to receive the result of the operation
- * @retval HAL status
- */
- void HAL_PKA_RSACRTExp_GetResult(PKA_HandleTypeDef *hpka, uint8_t *pRes)
- {
- uint32_t size;
- /* Move the result to appropriate location (indicated in out parameter) */
- size = (hpka->Instance->RAM[PKA_RSA_CRT_EXP_IN_MOD_NB_BITS] + 7UL) / 8UL;
- PKA_Memcpy_u32_to_u8(pRes, &hpka->Instance->RAM[PKA_RSA_CRT_EXP_OUT_RESULT], size);
- }
- /**
- * @brief Point on elliptic curve check in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_PointCheck(PKA_HandleTypeDef *hpka, PKA_PointCheckInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_PointCheck_Set(hpka, in);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_POINT_CHECK, Timeout);
- }
- /**
- * @brief Point on elliptic curve check in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_PointCheck_IT(PKA_HandleTypeDef *hpka, PKA_PointCheckInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_PointCheck_Set(hpka, in);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_POINT_CHECK);
- }
- /**
- * @brief Return the result of the point check operation.
- * @param hpka PKA handle
- * @retval 1 if point is on curve, 0 in other case
- */
- uint32_t HAL_PKA_PointCheck_IsOnCurve(PKA_HandleTypeDef const *const hpka)
- {
- #define PKA_POINT_IS_ON_CURVE 0UL
- /* Invert the value of the PKA RAM containing the result of the operation */
- return (hpka->Instance->RAM[PKA_POINT_CHECK_OUT_ERROR] == PKA_POINT_IS_ON_CURVE) ? 1UL : 0UL;
- }
- /**
- * @brief ECC scalar multiplication in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ECCMul(PKA_HandleTypeDef *hpka, PKA_ECCMulInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ECCMul_Set(hpka, in);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_ECC_MUL, Timeout);
- }
- /**
- * @brief ECC scalar multiplication in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ECCMul_IT(PKA_HandleTypeDef *hpka, PKA_ECCMulInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ECCMul_Set(hpka, in);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_ECC_MUL);
- }
- /**
- * @brief ECC scalar multiplication in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ECCMulFastMode(PKA_HandleTypeDef *hpka, PKA_ECCMulFastModeInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ECCMulFastMode_Set(hpka, in);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_ECC_MUL_FAST_MODE, Timeout);
- }
- /**
- * @brief ECC scalar multiplication in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ECCMulFastMode_IT(PKA_HandleTypeDef *hpka, PKA_ECCMulFastModeInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ECCMulFastMode_Set(hpka, in);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_ECC_MUL_FAST_MODE);
- }
- /**
- * @brief Retrieve operation result.
- * @param hpka PKA handle
- * @param out Output information
- * @retval HAL status
- */
- void HAL_PKA_ECCMul_GetResult(PKA_HandleTypeDef *hpka, PKA_ECCMulOutTypeDef *out)
- {
- uint32_t size;
- /* Retrieve the size of the array from the PKA RAM */
- size = (hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_OP_NB_BITS] + 7UL) / 8UL;
- /* If a destination buffer is provided */
- if (out != NULL)
- {
- /* Move the result to appropriate location (indicated in out parameter) */
- PKA_Memcpy_u32_to_u8(out->ptX, &hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_OUT_RESULT_X], size);
- PKA_Memcpy_u32_to_u8(out->ptY, &hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_OUT_RESULT_Y], size);
- }
- }
- /**
- * @brief Arithmetic addition in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_Add(PKA_HandleTypeDef *hpka, PKA_AddInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, NULL);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_ARITHMETIC_ADD, Timeout);
- }
- /**
- * @brief Arithmetic addition in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_Add_IT(PKA_HandleTypeDef *hpka, PKA_AddInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, NULL);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_ARITHMETIC_ADD);
- }
- /**
- * @brief Arithmetic subtraction in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_Sub(PKA_HandleTypeDef *hpka, PKA_SubInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, NULL);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_ARITHMETIC_SUB, Timeout);
- }
- /**
- * @brief Arithmetic subtraction in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_Sub_IT(PKA_HandleTypeDef *hpka, PKA_SubInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, NULL);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_ARITHMETIC_SUB);
- }
- /**
- * @brief Arithmetic multiplication in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_Mul(PKA_HandleTypeDef *hpka, PKA_MulInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, NULL);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_ARITHMETIC_MUL, Timeout);
- }
- /**
- * @brief Arithmetic multiplication in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_Mul_IT(PKA_HandleTypeDef *hpka, PKA_MulInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, NULL);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_ARITHMETIC_MUL);
- }
- /**
- * @brief Comparison in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_Cmp(PKA_HandleTypeDef *hpka, PKA_CmpInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, NULL);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_COMPARISON, Timeout);
- }
- /**
- * @brief Comparison in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_Cmp_IT(PKA_HandleTypeDef *hpka, PKA_CmpInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, NULL);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_COMPARISON);
- }
- /**
- * @brief Modular addition in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModAdd(PKA_HandleTypeDef *hpka, PKA_ModAddInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, in->pOp3);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_MODULAR_ADD, Timeout);
- }
- /**
- * @brief Modular addition in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModAdd_IT(PKA_HandleTypeDef *hpka, PKA_ModAddInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, in->pOp3);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_MODULAR_ADD);
- }
- /**
- * @brief Modular inversion in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModInv(PKA_HandleTypeDef *hpka, PKA_ModInvInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ModInv_Set(hpka, in);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_MODULAR_INV, Timeout);
- }
- /**
- * @brief Modular inversion in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModInv_IT(PKA_HandleTypeDef *hpka, PKA_ModInvInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ModInv_Set(hpka, in);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_MODULAR_INV);
- }
- /**
- * @brief Modular subtraction in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModSub(PKA_HandleTypeDef *hpka, PKA_ModSubInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, in->pOp3);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_MODULAR_SUB, Timeout);
- }
- /**
- * @brief Modular subtraction in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModSub_IT(PKA_HandleTypeDef *hpka, PKA_ModSubInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, in->pOp3);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_MODULAR_SUB);
- }
- /**
- * @brief Modular reduction in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModRed(PKA_HandleTypeDef *hpka, PKA_ModRedInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ModRed_Set(hpka, in);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_MODULAR_RED, Timeout);
- }
- /**
- * @brief Modular reduction in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_ModRed_IT(PKA_HandleTypeDef *hpka, PKA_ModRedInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ModRed_Set(hpka, in);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_MODULAR_RED);
- }
- /**
- * @brief Montgomery multiplication in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_MontgomeryMul(PKA_HandleTypeDef *hpka, PKA_MontgomeryMulInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, in->pOp3);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_MONTGOMERY_MUL, Timeout);
- }
- /**
- * @brief Montgomery multiplication in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_MontgomeryMul_IT(PKA_HandleTypeDef *hpka, PKA_MontgomeryMulInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_ARI_Set(hpka, in->size, in->pOp1, in->pOp2, in->pOp3);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_MONTGOMERY_MUL);
- }
- /**
- * @brief Retrieve operation result.
- * @param hpka PKA handle
- * @param pRes Pointer to memory location to receive the result of the operation
- */
- void HAL_PKA_Arithmetic_GetResult(PKA_HandleTypeDef *hpka, uint32_t *pRes)
- {
- uint32_t mode = (hpka->Instance->CR & PKA_CR_MODE_Msk) >> PKA_CR_MODE_Pos;
- uint32_t size = 0;
- /* Move the result to appropriate location (indicated in pRes parameter) */
- switch (mode)
- {
- case PKA_MODE_ARITHMETIC_SUB:
- case PKA_MODE_MODULAR_ADD:
- case PKA_MODE_MODULAR_RED:
- case PKA_MODE_MODULAR_INV:
- case PKA_MODE_MODULAR_SUB:
- case PKA_MODE_MONTGOMERY_MUL:
- size = hpka->Instance->RAM[1] / 32UL;
- break;
- case PKA_MODE_ARITHMETIC_ADD:
- size = hpka->Instance->RAM[1] / 32UL;
- /* Manage the overflow of the addition */
- if (hpka->Instance->RAM[500U + size] != 0UL)
- {
- size += 1UL;
- }
- break;
- case PKA_MODE_COMPARISON:
- size = 1;
- break;
- case PKA_MODE_ARITHMETIC_MUL:
- size = hpka->Instance->RAM[1] / 32UL * 2UL;
- break;
- default:
- break;
- }
- if (pRes != NULL)
- {
- switch (mode)
- {
- case PKA_MODE_ARITHMETIC_SUB:
- case PKA_MODE_MODULAR_ADD:
- case PKA_MODE_MODULAR_RED:
- case PKA_MODE_MODULAR_INV:
- case PKA_MODE_MODULAR_SUB:
- case PKA_MODE_MONTGOMERY_MUL:
- case PKA_MODE_ARITHMETIC_ADD:
- case PKA_MODE_COMPARISON:
- case PKA_MODE_ARITHMETIC_MUL:
- PKA_Memcpy_u32_to_u32(pRes, &hpka->Instance->RAM[PKA_ARITHMETIC_ALL_OPS_OUT_RESULT], size);
- break;
- default:
- break;
- }
- }
- }
- /**
- * @brief Montgomery parameter computation in blocking mode.
- * @param hpka PKA handle
- * @param in Input information
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_MontgomeryParam(PKA_HandleTypeDef *hpka, PKA_MontgomeryParamInTypeDef *in, uint32_t Timeout)
- {
- /* Set input parameter in PKA RAM */
- PKA_MontgomeryParam_Set(hpka, in->size, in->pOp1);
- /* Start the operation */
- return PKA_Process(hpka, PKA_MODE_MONTGOMERY_PARAM, Timeout);
- }
- /**
- * @brief Montgomery parameter computation in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param in Input information
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_MontgomeryParam_IT(PKA_HandleTypeDef *hpka, PKA_MontgomeryParamInTypeDef *in)
- {
- /* Set input parameter in PKA RAM */
- PKA_MontgomeryParam_Set(hpka, in->size, in->pOp1);
- /* Start the operation */
- return PKA_Process_IT(hpka, PKA_MODE_MONTGOMERY_PARAM);
- }
- /**
- * @brief Retrieve operation result.
- * @param hpka PKA handle
- * @param pRes pointer to buffer where the result will be copied
- * @retval HAL status
- */
- void HAL_PKA_MontgomeryParam_GetResult(PKA_HandleTypeDef *hpka, uint32_t *pRes)
- {
- uint32_t size;
- /* Retrieve the size of the buffer from the PKA RAM */
- size = (hpka->Instance->RAM[PKA_MONTGOMERY_PARAM_IN_MOD_NB_BITS] + 31UL) / 32UL;
- /* Move the result to appropriate location (indicated in out parameter) */
- PKA_Memcpy_u32_to_u32(pRes, &hpka->Instance->RAM[PKA_MONTGOMERY_PARAM_OUT_PARAMETER], size);
- }
- /**
- * @brief Abort any ongoing operation.
- * @param hpka PKA handle
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_PKA_Abort(PKA_HandleTypeDef *hpka)
- {
- HAL_StatusTypeDef err = HAL_OK;
- /* Clear EN bit */
- /* This abort any operation in progress (PKA RAM content is not guaranteed in this case) */
- CLEAR_BIT(hpka->Instance->CR, PKA_CR_EN);
- SET_BIT(hpka->Instance->CR, PKA_CR_EN);
- /* Reset any pending flag */
- SET_BIT(hpka->Instance->CLRFR, PKA_CLRFR_PROCENDFC | PKA_CLRFR_RAMERRFC | PKA_CLRFR_ADDRERRFC);
- /* Reset the error code */
- hpka->ErrorCode = HAL_PKA_ERROR_NONE;
- /* Reset the state */
- hpka->State = HAL_PKA_STATE_READY;
- return err;
- }
- /**
- * @brief Reset the PKA RAM.
- * @param hpka PKA handle
- * @retval None
- */
- void HAL_PKA_RAMReset(PKA_HandleTypeDef *hpka)
- {
- uint32_t index;
- /* For each element in the PKA RAM */
- for (index = 0; index < PKA_RAM_SIZE; index++)
- {
- /* Clear the content */
- hpka->Instance->RAM[index] = 0UL;
- }
- }
- /**
- * @brief This function handles PKA event interrupt request.
- * @param hpka PKA handle
- * @retval None
- */
- void HAL_PKA_IRQHandler(PKA_HandleTypeDef *hpka)
- {
- uint32_t mode = PKA_GetMode(hpka);
- uint32_t itsource = READ_REG(hpka->Instance->CR);
- uint32_t flag = READ_REG(hpka->Instance->SR);
- /* Address error interrupt occurred */
- if (((itsource & PKA_IT_ADDRERR) == PKA_IT_ADDRERR) && ((flag & PKA_FLAG_ADDRERR) == PKA_FLAG_ADDRERR))
- {
- hpka->ErrorCode |= HAL_PKA_ERROR_ADDRERR;
- /* Clear ADDRERR flag */
- __HAL_PKA_CLEAR_FLAG(hpka, PKA_FLAG_ADDRERR);
- }
- /* RAM access error interrupt occurred */
- if (((itsource & PKA_IT_RAMERR) == PKA_IT_RAMERR) && ((flag & PKA_FLAG_RAMERR) == PKA_FLAG_RAMERR))
- {
- hpka->ErrorCode |= HAL_PKA_ERROR_RAMERR;
- /* Clear RAMERR flag */
- __HAL_PKA_CLEAR_FLAG(hpka, PKA_FLAG_RAMERR);
- }
- /* Check the operation success in case of ECDSA signature */
- if (mode == PKA_MODE_ECDSA_SIGNATURE)
- {
- /* If error output result is different from 0, ecdsa sign operation need to be repeated */
- if (hpka->Instance->RAM[PKA_ECDSA_SIGN_OUT_ERROR] != 0UL)
- {
- hpka->ErrorCode |= HAL_PKA_ERROR_OPERATION;
- }
- }
- /* Trigger the error callback if an error is present */
- if (hpka->ErrorCode != HAL_PKA_ERROR_NONE)
- {
- #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
- hpka->ErrorCallback(hpka);
- #else
- HAL_PKA_ErrorCallback(hpka);
- #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
- }
- /* End Of Operation interrupt occurred */
- if (((itsource & PKA_IT_PROCEND) == PKA_IT_PROCEND) && ((flag & PKA_FLAG_PROCEND) == PKA_FLAG_PROCEND))
- {
- /* Clear PROCEND flag */
- __HAL_PKA_CLEAR_FLAG(hpka, PKA_FLAG_PROCEND);
- /* Set the state to ready */
- hpka->State = HAL_PKA_STATE_READY;
- #if (USE_HAL_PKA_REGISTER_CALLBACKS == 1)
- hpka->OperationCpltCallback(hpka);
- #else
- HAL_PKA_OperationCpltCallback(hpka);
- #endif /* USE_HAL_PKA_REGISTER_CALLBACKS */
- }
- }
- /**
- * @brief Process completed callback.
- * @param hpka PKA handle
- * @retval None
- */
- __weak void HAL_PKA_OperationCpltCallback(PKA_HandleTypeDef *hpka)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hpka);
- /* NOTE : This function should not be modified, when the callback is needed,
- the HAL_PKA_OperationCpltCallback could be implemented in the user file
- */
- }
- /**
- * @brief Error callback.
- * @param hpka PKA handle
- * @retval None
- */
- __weak void HAL_PKA_ErrorCallback(PKA_HandleTypeDef *hpka)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hpka);
- /* NOTE : This function should not be modified, when the callback is needed,
- the HAL_PKA_ErrorCallback could be implemented in the user file
- */
- }
- /**
- * @}
- */
- /** @defgroup PKA_Exported_Functions_Group3 Peripheral State and Error functions
- * @brief Peripheral State and Error functions
- *
- @verbatim
- ===============================================================================
- ##### Peripheral State and Error functions #####
- ===============================================================================
- [..]
- This subsection permit to get in run-time the status of the peripheral.
- @endverbatim
- * @{
- */
- /**
- * @brief Return the PKA handle state.
- * @param hpka PKA handle
- * @retval HAL status
- */
- HAL_PKA_StateTypeDef HAL_PKA_GetState(const PKA_HandleTypeDef *hpka)
- {
- /* Return PKA handle state */
- return hpka->State;
- }
- /**
- * @brief Return the PKA error code.
- * @param hpka PKA handle
- * @retval PKA error code
- */
- uint32_t HAL_PKA_GetError(const PKA_HandleTypeDef *hpka)
- {
- /* Return PKA handle error code */
- return hpka->ErrorCode;
- }
- /**
- * @}
- */
- /**
- * @}
- */
- /** @addtogroup PKA_Private_Functions
- * @{
- */
- /**
- * @brief Get PKA operating mode.
- * @param hpka PKA handle
- * @retval Return the current mode
- */
- uint32_t PKA_GetMode(const PKA_HandleTypeDef *hpka)
- {
- /* return the shifted PKA_CR_MODE value */
- return (uint32_t)(READ_BIT(hpka->Instance->CR, PKA_CR_MODE) >> PKA_CR_MODE_Pos);
- }
- /**
- * @brief Wait for operation completion or timeout.
- * @param hpka PKA handle
- * @param Timeout Timeout duration in millisecond.
- * @param Tickstart Tick start value
- * @retval HAL status
- */
- HAL_StatusTypeDef PKA_PollEndOfOperation(const PKA_HandleTypeDef *hpka, uint32_t Timeout, uint32_t Tickstart)
- {
- /* Wait for the end of operation or timeout */
- while ((hpka->Instance->SR & PKA_SR_PROCENDF) == 0UL)
- {
- /* Check if timeout is disabled (set to infinite wait) */
- if (Timeout != HAL_MAX_DELAY)
- {
- if (((HAL_GetTick() - Tickstart) > Timeout) || (Timeout == 0UL))
- {
- return HAL_TIMEOUT;
- }
- }
- }
- return HAL_OK;
- }
- /**
- * @brief Return a hal error code based on PKA error flags.
- * @param hpka PKA handle
- * @param mode PKA operating mode
- * @retval error code
- */
- uint32_t PKA_CheckError(const PKA_HandleTypeDef *hpka, uint32_t mode)
- {
- uint32_t err = HAL_PKA_ERROR_NONE;
- /* Check RAMERR error */
- if (__HAL_PKA_GET_FLAG(hpka, PKA_FLAG_RAMERR) == SET)
- {
- err |= HAL_PKA_ERROR_RAMERR;
- }
- /* Check ADDRERR error */
- if (__HAL_PKA_GET_FLAG(hpka, PKA_FLAG_ADDRERR) == SET)
- {
- err |= HAL_PKA_ERROR_ADDRERR;
- }
- /* Check the operation success in case of ECDSA signature */
- if (mode == PKA_MODE_ECDSA_SIGNATURE)
- {
- #define EDCSA_SIGN_NOERROR 0UL
- /* If error output result is different from no error, ecsa sign operation need to be repeated */
- if (hpka->Instance->RAM[PKA_ECDSA_SIGN_OUT_ERROR] != EDCSA_SIGN_NOERROR)
- {
- err |= HAL_PKA_ERROR_OPERATION;
- }
- }
- return err;
- }
- /**
- * @brief Get number of bits inside an array of u8.
- * @param byteNumber Number of u8 inside the array
- */
- uint32_t PKA_GetBitSize_u8(uint32_t byteNumber)
- {
- /* Convert from number of uint8_t in an array to the associated number of bits in this array */
- return byteNumber * 8UL;
- }
- /**
- * @brief Get optimal number of bits inside an array of u8.
- * @param byteNumber Number of u8 inside the array
- * @param msb Most significant uint8_t of the array
- */
- uint32_t PKA_GetOptBitSize_u8(uint32_t byteNumber, uint8_t msb)
- {
- uint32_t position;
- position = 32UL - __CLZ(msb);
- return (((byteNumber - 1UL) * 8UL) + position);
- }
- /**
- * @brief Get number of bits inside an array of u32.
- * @param wordNumber Number of u32 inside the array
- */
- uint32_t PKA_GetBitSize_u32(uint32_t wordNumber)
- {
- /* Convert from number of uint32_t in an array to the associated number of bits in this array */
- return wordNumber * 32UL;
- }
- /**
- * @brief Get number of uint8_t element in an array of bitSize bits.
- * @param bitSize Number of bits in an array
- */
- uint32_t PKA_GetArraySize_u8(uint32_t bitSize)
- {
- /* Manage the non aligned on uint8_t bitsize: */
- /* 512 bits requires 64 uint8_t */
- /* 521 bits requires 66 uint8_t */
- return ((bitSize + 7UL) / 8UL);
- }
- /**
- * @brief Copy uint32_t array to uint8_t array to fit PKA number representation.
- * @param dst Pointer to destination
- * @param src Pointer to source
- * @param n Number of uint8_t to copy
- * @retval dst
- */
- void PKA_Memcpy_u32_to_u8(uint8_t dst[], __IO const uint32_t src[], size_t n)
- {
- if (dst != NULL)
- {
- if (src != NULL)
- {
- uint32_t index_uint32_t = 0UL; /* This index is used outside of the loop */
- for (; index_uint32_t < (n / 4UL); index_uint32_t++)
- {
- /* Avoid casting from uint8_t* to uint32_t* by copying 4 uint8_t in a row */
- /* Apply __REV equivalent */
- uint32_t index_uint8_t = n - 4UL - (index_uint32_t * 4UL);
- dst[index_uint8_t + 3UL] = (uint8_t)((src[index_uint32_t] & 0x000000FFU));
- dst[index_uint8_t + 2UL] = (uint8_t)((src[index_uint32_t] & 0x0000FF00U) >> 8UL);
- dst[index_uint8_t + 1UL] = (uint8_t)((src[index_uint32_t] & 0x00FF0000U) >> 16UL);
- dst[index_uint8_t + 0UL] = (uint8_t)((src[index_uint32_t] & 0xFF000000U) >> 24UL);
- }
- /* Manage the buffers not aligned on uint32_t */
- if ((n % 4UL) == 1UL)
- {
- dst[0UL] = (uint8_t)((src[index_uint32_t] & 0x000000FFU));
- }
- else if ((n % 4UL) == 2UL)
- {
- dst[1UL] = (uint8_t)((src[index_uint32_t] & 0x000000FFU));
- dst[0UL] = (uint8_t)((src[index_uint32_t] & 0x0000FF00U) >> 8UL);
- }
- else if ((n % 4UL) == 3UL)
- {
- dst[2UL] = (uint8_t)((src[index_uint32_t] & 0x000000FFU));
- dst[1UL] = (uint8_t)((src[index_uint32_t] & 0x0000FF00U) >> 8UL);
- dst[0UL] = (uint8_t)((src[index_uint32_t] & 0x00FF0000U) >> 16UL);
- }
- else
- {
- /* The last element is already handle in the loop */
- }
- }
- }
- }
- /**
- * @brief Copy uint8_t array to uint32_t array to fit PKA number representation.
- * @param dst Pointer to destination
- * @param src Pointer to source
- * @param n Number of uint8_t to copy (must be multiple of 4)
- * @retval dst
- */
- void PKA_Memcpy_u8_to_u32(__IO uint32_t dst[], const uint8_t src[], size_t n)
- {
- if (dst != NULL)
- {
- if (src != NULL)
- {
- uint32_t index = 0UL; /* This index is used outside of the loop */
- for (; index < (n / 4UL); index++)
- {
- /* Apply the equivalent of __REV from uint8_t to uint32_t */
- dst[index] = ((uint32_t)src[(n - (index * 4UL) - 1UL)]) \
- | ((uint32_t)src[(n - (index * 4UL) - 2UL)] << 8UL) \
- | ((uint32_t)src[(n - (index * 4UL) - 3UL)] << 16UL) \
- | ((uint32_t)src[(n - (index * 4UL) - 4UL)] << 24UL);
- }
- /* Manage the buffers not aligned on uint32_t */
- if ((n % 4UL) == 1UL)
- {
- dst[index] = (uint32_t)src[(n - (index * 4UL) - 1UL)];
- }
- else if ((n % 4UL) == 2UL)
- {
- dst[index] = ((uint32_t)src[(n - (index * 4UL) - 1UL)]) \
- | ((uint32_t)src[(n - (index * 4UL) - 2UL)] << 8UL);
- }
- else if ((n % 4UL) == 3UL)
- {
- dst[index] = ((uint32_t)src[(n - (index * 4UL) - 1UL)]) \
- | ((uint32_t)src[(n - (index * 4UL) - 2UL)] << 8UL) \
- | ((uint32_t)src[(n - (index * 4UL) - 3UL)] << 16UL);
- }
- else
- {
- /* The last element is already handle in the loop */
- }
- }
- }
- }
- /**
- * @brief Copy uint32_t array to uint32_t array.
- * @param dst Pointer to destination
- * @param src Pointer to source
- * @param n Number of u32 to be handled
- * @retval dst
- */
- void PKA_Memcpy_u32_to_u32(__IO uint32_t dst[], __IO const uint32_t src[], size_t n)
- {
- /* If a destination buffer is provided */
- if (dst != NULL)
- {
- /* If a source buffer is provided */
- if (src != NULL)
- {
- /* For each element in the array */
- for (uint32_t index = 0UL; index < n; index++)
- {
- /* Copy the content */
- dst[index] = src[index];
- }
- }
- }
- }
- /**
- * @brief Generic function to start a PKA operation in blocking mode.
- * @param hpka PKA handle
- * @param mode PKA operation
- * @param Timeout Timeout duration
- * @retval HAL status
- */
- HAL_StatusTypeDef PKA_Process(PKA_HandleTypeDef *hpka, uint32_t mode, uint32_t Timeout)
- {
- HAL_StatusTypeDef err = HAL_OK;
- uint32_t tickstart;
- if (hpka->State == HAL_PKA_STATE_READY)
- {
- /* Set the state to busy */
- hpka->State = HAL_PKA_STATE_BUSY;
- /* Clear any pending error */
- hpka->ErrorCode = HAL_PKA_ERROR_NONE;
- /* Init tickstart for timeout management*/
- tickstart = HAL_GetTick();
- /* Set the mode and deactivate the interrupts */
- MODIFY_REG(hpka->Instance->CR, PKA_CR_MODE | PKA_CR_PROCENDIE | PKA_CR_RAMERRIE | PKA_CR_ADDRERRIE,
- mode << PKA_CR_MODE_Pos);
- /* Start the computation */
- hpka->Instance->CR |= PKA_CR_START;
- /* Wait for the end of operation or timeout */
- if (PKA_PollEndOfOperation(hpka, Timeout, tickstart) != HAL_OK)
- {
- /* Abort any ongoing operation */
- CLEAR_BIT(hpka->Instance->CR, PKA_CR_EN);
- hpka->ErrorCode |= HAL_PKA_ERROR_TIMEOUT;
- /* Make ready for the next operation */
- SET_BIT(hpka->Instance->CR, PKA_CR_EN);
- }
- /* Check error */
- hpka->ErrorCode |= PKA_CheckError(hpka, mode);
- /* Clear all flags */
- hpka->Instance->CLRFR |= (PKA_CLRFR_PROCENDFC | PKA_CLRFR_RAMERRFC | PKA_CLRFR_ADDRERRFC);
- /* Set the state to ready */
- hpka->State = HAL_PKA_STATE_READY;
- /* Manage the result based on encountered errors */
- if (hpka->ErrorCode != HAL_PKA_ERROR_NONE)
- {
- err = HAL_ERROR;
- }
- }
- else
- {
- err = HAL_ERROR;
- }
- return err;
- }
- /**
- * @brief Generic function to start a PKA operation in non-blocking mode with Interrupt.
- * @param hpka PKA handle
- * @param mode PKA operation
- * @retval HAL status
- */
- HAL_StatusTypeDef PKA_Process_IT(PKA_HandleTypeDef *hpka, uint32_t mode)
- {
- HAL_StatusTypeDef err = HAL_OK;
- if (hpka->State == HAL_PKA_STATE_READY)
- {
- /* Set the state to busy */
- hpka->State = HAL_PKA_STATE_BUSY;
- /* Clear any pending error */
- hpka->ErrorCode = HAL_PKA_ERROR_NONE;
- /* Set the mode and activate interrupts */
- MODIFY_REG(hpka->Instance->CR, PKA_CR_MODE | PKA_CR_PROCENDIE | PKA_CR_RAMERRIE | PKA_CR_ADDRERRIE,
- (mode << PKA_CR_MODE_Pos) | PKA_CR_PROCENDIE | PKA_CR_RAMERRIE | PKA_CR_ADDRERRIE);
- /* Start the computation */
- hpka->Instance->CR |= PKA_CR_START;
- }
- else
- {
- err = HAL_ERROR;
- }
- return err;
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param in Input information
- */
- void PKA_ModExp_Set(PKA_HandleTypeDef *hpka, PKA_ModExpInTypeDef *in)
- {
- /* Get the number of bit per operand */
- hpka->Instance->RAM[PKA_MODULAR_EXP_IN_OP_NB_BITS] = PKA_GetBitSize_u8(in->OpSize);
- /* Get the number of bit of the exponent */
- hpka->Instance->RAM[PKA_MODULAR_EXP_IN_EXP_NB_BITS] = PKA_GetBitSize_u8(in->expSize);
- /* Move the input parameters pOp1 to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_MODULAR_EXP_IN_EXPONENT_BASE], in->pOp1, in->OpSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_EXP_IN_EXPONENT_BASE + ((in->OpSize + 3UL) / 4UL));
- /* Move the exponent to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_MODULAR_EXP_IN_EXPONENT], in->pExp, in->expSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_EXP_IN_EXPONENT + ((in->expSize + 3UL) / 4UL));
- /* Move the modulus to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_MODULAR_EXP_IN_MODULUS], in->pMod, in->OpSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_EXP_IN_MODULUS + ((in->OpSize + 3UL) / 4UL));
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param in Input information
- */
- void PKA_ModExpFastMode_Set(PKA_HandleTypeDef *hpka, PKA_ModExpFastModeInTypeDef *in)
- {
- /* Get the number of bit per operand */
- hpka->Instance->RAM[PKA_MODULAR_EXP_IN_OP_NB_BITS] = PKA_GetBitSize_u8(in->OpSize);
- /* Get the number of bit of the exponent */
- hpka->Instance->RAM[PKA_MODULAR_EXP_IN_EXP_NB_BITS] = PKA_GetBitSize_u8(in->expSize);
- /* Move the input parameters pOp1 to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_MODULAR_EXP_IN_EXPONENT_BASE], in->pOp1, in->OpSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_EXP_IN_EXPONENT_BASE + (in->OpSize / 4UL));
- /* Move the exponent to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_MODULAR_EXP_IN_EXPONENT], in->pExp, in->expSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_EXP_IN_EXPONENT + (in->expSize / 4UL));
- /* Move the modulus to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_MODULAR_EXP_IN_MODULUS], in->pMod, in->OpSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_EXP_IN_MODULUS + (in->OpSize / 4UL));
- /* Move the Montgomery parameter to PKA RAM */
- PKA_Memcpy_u32_to_u32(&hpka->Instance->RAM[PKA_MODULAR_EXP_IN_MONTGOMERY_PARAM], in->pMontgomeryParam,
- in->OpSize / 4UL);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_EXP_IN_MONTGOMERY_PARAM + (in->OpSize / 4UL));
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param in Input information
- * @note If the modulus size is bigger than the hash size (with a curve SECP521R1 when using a SHA256 hash
- * for example)the hash value should be written at the end of the buffer with zeros padding at beginning.
- */
- void PKA_ECDSASign_Set(PKA_HandleTypeDef *hpka, PKA_ECDSASignInTypeDef *in)
- {
- /* Get the prime order n length */
- hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_ORDER_NB_BITS] = PKA_GetOptBitSize_u8(in->primeOrderSize, *(in->primeOrder));
- /* Get the modulus p length */
- hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_MOD_NB_BITS] = PKA_GetOptBitSize_u8(in->modulusSize, *(in->modulus));
- /* Get the coefficient a sign */
- hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_A_COEFF_SIGN] = in->coefSign;
- /* Move the input parameters coefficient |a| to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_A_COEFF], in->coef, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_SIGN_IN_A_COEFF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters modulus value p to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_MOD_GF], in->modulus, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_SIGN_IN_MOD_GF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters integer k to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_K], in->integer, in->primeOrderSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_SIGN_IN_K + ((in->primeOrderSize + 3UL) / 4UL));
- /* Move the input parameters base point G coordinate x to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_INITIAL_POINT_X], in->basePointX, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_SIGN_IN_INITIAL_POINT_X + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters base point G coordinate y to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_INITIAL_POINT_Y], in->basePointY, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_SIGN_IN_INITIAL_POINT_Y + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters hash of message z to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_HASH_E], in->hash, in->primeOrderSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_SIGN_IN_HASH_E + ((in->primeOrderSize + 3UL) / 4UL));
- /* Move the input parameters private key d to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_PRIVATE_KEY_D], in->privateKey, in->primeOrderSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_SIGN_IN_PRIVATE_KEY_D + ((in->primeOrderSize + 3UL) / 4UL));
- /* Move the input parameters prime order n to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_SIGN_IN_ORDER_N], in->primeOrder, in->primeOrderSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_SIGN_IN_ORDER_N + ((in->primeOrderSize + 3UL) / 4UL));
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param in Input information
- */
- void PKA_ECDSAVerif_Set(PKA_HandleTypeDef *hpka, PKA_ECDSAVerifInTypeDef *in)
- {
- /* Get the prime order n length */
- hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_ORDER_NB_BITS] = PKA_GetOptBitSize_u8(in->primeOrderSize, *(in->primeOrder));
- /* Get the modulus p length */
- hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_MOD_NB_BITS] = PKA_GetOptBitSize_u8(in->modulusSize, *(in->modulus));
- /* Get the coefficient a sign */
- hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_A_COEFF_SIGN] = in->coefSign;
- /* Move the input parameters coefficient |a| to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_A_COEFF], in->coef, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_VERIF_IN_A_COEFF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters modulus value p to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_MOD_GF], in->modulus, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_VERIF_IN_MOD_GF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters base point G coordinate x to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_INITIAL_POINT_X], in->basePointX, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_VERIF_IN_INITIAL_POINT_X + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters base point G coordinate y to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_INITIAL_POINT_Y], in->basePointY, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_VERIF_IN_INITIAL_POINT_Y + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters public-key curve point Q coordinate xQ to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_PUBLIC_KEY_POINT_X], in->pPubKeyCurvePtX,
- in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_VERIF_IN_PUBLIC_KEY_POINT_X + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters public-key curve point Q coordinate xQ to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_PUBLIC_KEY_POINT_Y], in->pPubKeyCurvePtY,
- in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_VERIF_IN_PUBLIC_KEY_POINT_Y + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters signature part r to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_SIGNATURE_R], in->RSign, in->primeOrderSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_VERIF_IN_SIGNATURE_R + ((in->primeOrderSize + 3UL) / 4UL));
- /* Move the input parameters signature part s to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_SIGNATURE_S], in->SSign, in->primeOrderSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_VERIF_IN_SIGNATURE_S + ((in->primeOrderSize + 3UL) / 4UL));
- /* Move the input parameters hash of message z to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_HASH_E], in->hash, in->primeOrderSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_VERIF_IN_HASH_E + ((in->primeOrderSize + 3UL) / 4UL));
- /* Move the input parameters curve prime order n to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECDSA_VERIF_IN_ORDER_N], in->primeOrder, in->primeOrderSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECDSA_VERIF_IN_ORDER_N + ((in->primeOrderSize + 3UL) / 4UL));
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param in Input information
- */
- void PKA_RSACRTExp_Set(PKA_HandleTypeDef *hpka, PKA_RSACRTExpInTypeDef *in)
- {
- /* Get the operand length M */
- hpka->Instance->RAM[PKA_RSA_CRT_EXP_IN_MOD_NB_BITS] = PKA_GetBitSize_u8(in->size);
- /* Move the input parameters operand dP to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_RSA_CRT_EXP_IN_DP_CRT], in->pOpDp, in->size / 2UL);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_RSA_CRT_EXP_IN_DP_CRT + (in->size / 8UL));
- /* Move the input parameters operand dQ to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_RSA_CRT_EXP_IN_DQ_CRT], in->pOpDq, in->size / 2UL);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_RSA_CRT_EXP_IN_DQ_CRT + (in->size / 8UL));
- /* Move the input parameters operand qinv to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_RSA_CRT_EXP_IN_QINV_CRT], in->pOpQinv, in->size / 2UL);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_RSA_CRT_EXP_IN_QINV_CRT + (in->size / 8UL));
- /* Move the input parameters prime p to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_RSA_CRT_EXP_IN_PRIME_P], in->pPrimeP, in->size / 2UL);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_RSA_CRT_EXP_IN_PRIME_P + (in->size / 8UL));
- /* Move the input parameters prime q to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_RSA_CRT_EXP_IN_PRIME_Q], in->pPrimeQ, in->size / 2UL);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_RSA_CRT_EXP_IN_PRIME_Q + (in->size / 8UL));
- /* Move the input parameters operand A to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_RSA_CRT_EXP_IN_EXPONENT_BASE], in->popA, in->size);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_RSA_CRT_EXP_IN_EXPONENT_BASE + (in->size / 4UL));
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param in Input information
- */
- void PKA_PointCheck_Set(PKA_HandleTypeDef *hpka, PKA_PointCheckInTypeDef *in)
- {
- /* Get the modulus length */
- hpka->Instance->RAM[PKA_POINT_CHECK_IN_MOD_NB_BITS] = PKA_GetOptBitSize_u8(in->modulusSize, *(in->modulus));
- /* Get the coefficient a sign */
- hpka->Instance->RAM[PKA_POINT_CHECK_IN_A_COEFF_SIGN] = in->coefSign;
- /* Move the input parameters coefficient |a| to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_POINT_CHECK_IN_A_COEFF], in->coefA, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_POINT_CHECK_IN_A_COEFF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters coefficient b to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_POINT_CHECK_IN_B_COEFF], in->coefB, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_POINT_CHECK_IN_B_COEFF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters modulus value p to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_POINT_CHECK_IN_MOD_GF], in->modulus, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_POINT_CHECK_IN_MOD_GF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters Point P coordinate x to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_POINT_CHECK_IN_INITIAL_POINT_X], in->pointX, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_POINT_CHECK_IN_INITIAL_POINT_X + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters Point P coordinate y to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_POINT_CHECK_IN_INITIAL_POINT_Y], in->pointY, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_POINT_CHECK_IN_INITIAL_POINT_Y + ((in->modulusSize + 3UL) / 4UL));
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param in Input information
- */
- void PKA_ECCMul_Set(PKA_HandleTypeDef *hpka, PKA_ECCMulInTypeDef *in)
- {
- /* Get the scalar multiplier k length */
- hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_EXP_NB_BITS] = PKA_GetOptBitSize_u8(in->scalarMulSize, *(in->scalarMul));
- /* Get the modulus length */
- hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_OP_NB_BITS] = PKA_GetOptBitSize_u8(in->modulusSize, *(in->modulus));
- /* Get the coefficient a sign */
- hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_A_COEFF_SIGN] = in->coefSign;
- /* Move the input parameters coefficient |a| to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_A_COEFF], in->coefA, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECC_SCALAR_MUL_IN_A_COEFF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters modulus value p to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_MOD_GF], in->modulus, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECC_SCALAR_MUL_IN_MOD_GF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters scalar multiplier k to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_K], in->scalarMul, in->scalarMulSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECC_SCALAR_MUL_IN_K + ((in->scalarMulSize + 3UL) / 4UL));
- /* Move the input parameters Point P coordinate x to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_INITIAL_POINT_X], in->pointX, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECC_SCALAR_MUL_IN_INITIAL_POINT_X + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters Point P coordinate y to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_INITIAL_POINT_Y], in->pointY, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECC_SCALAR_MUL_IN_INITIAL_POINT_Y + ((in->modulusSize + 3UL) / 4UL));
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param in Input information
- */
- void PKA_ECCMulFastMode_Set(PKA_HandleTypeDef *hpka, PKA_ECCMulFastModeInTypeDef *in)
- {
- /* Get the scalar multiplier k length */
- hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_EXP_NB_BITS] = PKA_GetOptBitSize_u8(in->scalarMulSize, *(in->scalarMul));
- /* Get the modulus length */
- hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_OP_NB_BITS] = PKA_GetOptBitSize_u8(in->modulusSize, *(in->modulus));
- /* Get the coefficient a sign */
- hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_A_COEFF_SIGN] = in->coefSign;
- /* Move the input parameters coefficient |a| to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_A_COEFF], in->coefA, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECC_SCALAR_MUL_IN_A_COEFF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters modulus value p to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_MOD_GF], in->modulus, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECC_SCALAR_MUL_IN_MOD_GF + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters scalar multiplier k to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_K], in->scalarMul, in->scalarMulSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECC_SCALAR_MUL_IN_K + ((in->scalarMulSize + 3UL) / 4UL));
- /* Move the input parameters Point P coordinate x to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_POINT_CHECK_IN_INITIAL_POINT_X], in->pointX, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_POINT_CHECK_IN_INITIAL_POINT_X + ((in->modulusSize + 3UL) / 4UL));
- /* Move the input parameters Point P coordinate y to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_POINT_CHECK_IN_INITIAL_POINT_Y], in->pointY, in->modulusSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_POINT_CHECK_IN_INITIAL_POINT_Y + ((in->modulusSize + 3UL) / 4UL));
- /* Move the Montgomery parameter to PKA RAM */
- PKA_Memcpy_u32_to_u32(&hpka->Instance->RAM[PKA_ECC_SCALAR_MUL_IN_MONTGOMERY_PARAM], in->pMontgomeryParam,
- (in->modulusSize + 3UL) / 4UL);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ECC_SCALAR_MUL_IN_MONTGOMERY_PARAM + ((in->modulusSize + 3UL) / 4UL));
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param in Input information
- */
- void PKA_ModInv_Set(PKA_HandleTypeDef *hpka, PKA_ModInvInTypeDef *in)
- {
- /* Get the number of bit per operand */
- hpka->Instance->RAM[PKA_MODULAR_INV_NB_BITS] = PKA_GetBitSize_u32(in->size);
- /* Move the input parameters operand A to PKA RAM */
- PKA_Memcpy_u32_to_u32(&hpka->Instance->RAM[PKA_MODULAR_INV_IN_OP1], in->pOp1, in->size);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_INV_IN_OP1 + in->size);
- /* Move the input parameters modulus value n to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_MODULAR_INV_IN_OP2_MOD], in->pMod, in->size * 4UL);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_INV_IN_OP2_MOD + in->size);
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param in Input information
- */
- void PKA_ModRed_Set(PKA_HandleTypeDef *hpka, PKA_ModRedInTypeDef *in)
- {
- /* Get the number of bit per operand */
- hpka->Instance->RAM[PKA_MODULAR_REDUC_IN_OP_LENGTH] = PKA_GetBitSize_u32(in->OpSize);
- /* Get the number of bit per modulus */
- hpka->Instance->RAM[PKA_MODULAR_REDUC_IN_MOD_LENGTH] = PKA_GetBitSize_u8(in->modSize);
- /* Move the input parameters operand A to PKA RAM */
- PKA_Memcpy_u32_to_u32(&hpka->Instance->RAM[PKA_MODULAR_REDUC_IN_OPERAND], in->pOp1, in->OpSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_REDUC_IN_OPERAND + in->OpSize);
- /* Move the input parameters modulus value n to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_MODULAR_REDUC_IN_MODULUS], in->pMod, in->modSize);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MODULAR_REDUC_IN_MODULUS + ((in->modSize + 3UL) / 4UL));
- }
- /**
- * @brief Set input parameters.
- * @param hpka PKA handle
- * @param size Size of the operand
- * @param pOp1 Generic pointer to input data
- */
- void PKA_MontgomeryParam_Set(PKA_HandleTypeDef *hpka, const uint32_t size, const uint8_t *pOp1)
- {
- uint32_t bytetoskip = 0UL;
- uint32_t newSize;
- if (pOp1 != NULL)
- {
- /* Count the number of zero bytes */
- while ((bytetoskip < size) && (pOp1[bytetoskip] == 0UL))
- {
- bytetoskip++;
- }
- /* Get new size after skipping zero bytes */
- newSize = size - bytetoskip;
- /* Get the number of bit per operand */
- hpka->Instance->RAM[PKA_MONTGOMERY_PARAM_IN_MOD_NB_BITS] = PKA_GetOptBitSize_u8(newSize, pOp1[bytetoskip]);
- /* Move the input parameters pOp1 to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_MONTGOMERY_PARAM_IN_MODULUS], pOp1, size);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_MONTGOMERY_PARAM_IN_MODULUS + ((size + 3UL) / 4UL));
- }
- }
- /**
- * @brief Generic function to set input parameters.
- * @param hpka PKA handle
- * @param size Size of the operand
- * @param pOp1 Generic pointer to input data
- * @param pOp2 Generic pointer to input data
- * @param pOp3 Generic pointer to input data
- */
- void PKA_ARI_Set(PKA_HandleTypeDef *hpka, const uint32_t size, const uint32_t *pOp1, const uint32_t *pOp2,
- const uint8_t *pOp3)
- {
- /* Get the number of bit per operand */
- hpka->Instance->RAM[PKA_ARITHMETIC_ALL_OPS_NB_BITS] = PKA_GetBitSize_u32(size);
- if (pOp1 != NULL)
- {
- /* Move the input parameters pOp1 to PKA RAM */
- PKA_Memcpy_u32_to_u32(&hpka->Instance->RAM[PKA_ARITHMETIC_ALL_OPS_IN_OP1], pOp1, size);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ARITHMETIC_ALL_OPS_IN_OP1 + size);
- }
- if (pOp2 != NULL)
- {
- /* Move the input parameters pOp2 to PKA RAM */
- PKA_Memcpy_u32_to_u32(&hpka->Instance->RAM[PKA_ARITHMETIC_ALL_OPS_IN_OP2], pOp2, size);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ARITHMETIC_ALL_OPS_IN_OP2 + size);
- }
- if (pOp3 != NULL)
- {
- /* Move the input parameters pOp3 to PKA RAM */
- PKA_Memcpy_u8_to_u32(&hpka->Instance->RAM[PKA_ARITHMETIC_ALL_OPS_IN_OP3], pOp3, size * 4UL);
- __PKA_RAM_PARAM_END(hpka->Instance->RAM, PKA_ARITHMETIC_ALL_OPS_IN_OP3 + size);
- }
- }
- /**
- * @}
- */
- /**
- * @}
- */
- #endif /* defined(PKA) && defined(HAL_PKA_MODULE_ENABLED) */
- /**
- * @}
- */
|