Newer
Older
mbed-os / targets / TARGET_STM / TARGET_STM32U5 / STM32Cube_FW / STM32U5xx_HAL_Driver / stm32u5xx_ll_pka.c
@Jerome Coutant Jerome Coutant on 10 Sep 2021 5 KB STM32U5: STM32Cube_FW_U5_V1.0.0
/**
  ******************************************************************************
  * @file    stm32u5xx_ll_pka.c
  * @author  MCD Application Team
  * @brief   PKA LL module driver.
  ******************************************************************************
  * @attention
  *
  * Copyright (c) 2021 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.
  *
  ******************************************************************************
  */
#if defined(USE_FULL_LL_DRIVER)

/* Includes ------------------------------------------------------------------*/
#include "stm32u5xx_ll_pka.h"
#include "stm32u5xx_ll_bus.h"

#ifdef  USE_FULL_ASSERT
#include "stm32_assert.h"
#else
#define assert_param(expr) ((void)0U)
#endif /* USE_FULL_ASSERT */

/** @addtogroup STM32U5xx_LL_Driver
  * @{
  */

#if defined(PKA)

/** @addtogroup PKA_LL
  * @{
  */

/* Private types -------------------------------------------------------------*/
/* Private variables ---------------------------------------------------------*/
/* Private constants ---------------------------------------------------------*/
/* Private macros ------------------------------------------------------------*/
/** @defgroup PKA_LL_Private_Macros PKA Private Constants
  * @{
  */
#define IS_LL_PKA_MODE(__VALUE__)     (((__VALUE__)==  LL_PKA_MODE_MODULAR_EXP)          ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_MONTGOMERY_PARAM)     ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_MODULAR_EXP_FAST)     ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_MODULAR_EXP_PROTECT)  ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_ECC_MUL)              ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_ECC_COMPLETE_ADD)     ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_ECDSA_SIGNATURE)      ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_ECDSA_VERIFICATION)   ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_POINT_CHECK)          ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_RSA_CRT_EXP)          ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_MODULAR_INV)          ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_ARITHMETIC_ADD)       ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_ARITHMETIC_SUB)       ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_ARITHMETIC_MUL)       ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_COMPARISON)           ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_MODULAR_REDUC)        ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_MODULAR_ADD)          ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_MODULAR_SUB)          ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_MONTGOMERY_MUL)       ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_DOUBLE_BASE_LADDER)   ||\
                                       ((__VALUE__) ==  LL_PKA_MODE_ECC_PROJECTIVE_AFF))
/**
  * @}
  */

/* Private function prototypes -----------------------------------------------*/

/* Exported functions --------------------------------------------------------*/
/** @addtogroup PKA_LL_Exported_Functions
  * @{
  */

/** @addtogroup PKA_LL_EF_Init
  * @{
  */

/**
  * @brief  De-initialize PKA registers (Registers restored to their default values).
  * @param  PKAx PKA Instance.
  * @retval ErrorStatus
  *          - SUCCESS: PKA registers are de-initialized
  *          - ERROR: PKA registers are not de-initialized
  */
ErrorStatus LL_PKA_DeInit(PKA_TypeDef *PKAx)
{
  ErrorStatus status = SUCCESS;

  /* Check the parameters */
  assert_param(IS_PKA_ALL_INSTANCE(PKAx));

  if (PKAx == PKA)
  {
    /* Force PKA reset */
    LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_PKA);

    /* Release PKA reset */
    LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_PKA);
  }
  else
  {
    status = ERROR;
  }

  return (status);
}

/**
  * @brief  Initialize PKA registers according to the specified parameters in PKA_InitStruct.
  * @param  PKAx PKA Instance.
  * @param  PKA_InitStruct pointer to a @ref LL_PKA_InitTypeDef structure
  *         that contains the configuration information for the specified PKA peripheral.
  * @retval ErrorStatus
  *          - SUCCESS: PKA registers are initialized according to PKA_InitStruct content
  *          - ERROR:   Not applicable
  */
ErrorStatus LL_PKA_Init(PKA_TypeDef *PKAx, LL_PKA_InitTypeDef *PKA_InitStruct)
{
  assert_param(IS_PKA_ALL_INSTANCE(PKAx));
  assert_param(IS_LL_PKA_MODE(PKA_InitStruct->Mode));

  LL_PKA_Config(PKAx, PKA_InitStruct->Mode);

  return (SUCCESS);
}

/**
  * @brief Set each @ref LL_PKA_InitTypeDef field to default value.
  * @param PKA_InitStruct pointer to a @ref LL_PKA_InitTypeDef structure
  *                       whose fields will be set to default values.
  * @retval None
  */

void LL_PKA_StructInit(LL_PKA_InitTypeDef *PKA_InitStruct)
{
  /* Reset PKA init structure parameters values */
  PKA_InitStruct->Mode       = LL_PKA_MODE_MODULAR_EXP;
}

/**
  * @}
  */

/**
  * @}
  */

/**
  * @}
  */

#endif /* defined (PKA) */

/**
  * @}
  */

#endif /* USE_FULL_LL_DRIVER */