mirror of
https://github.com/espressif/esp-idf.git
synced 2024-09-20 00:36:01 -04:00
1696be719c
- Technical details covered in section "15.3.2 Anti-DPA Attack Security Control" chapter of the ESP32-C6 TRM - Default configuration sets the security level low for the DPA protection - This change applies to all the crypto peripherals where the clock frequency is dynamically adjusted to create randomness in the power consumption trajectory - This configuration helps to make the SCA attacks difficult on the crypto peripherals
41 lines
1.2 KiB
C
41 lines
1.2 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef enum {
|
|
ESP_CRYPTO_DPA_SEC_LEVEL_OFF = 0, /*!< DPA protection disabled */
|
|
ESP_CRYPTO_DPA_SEC_LEVEL_LOW, /*!< DPA protection level low */
|
|
ESP_CRYPTO_DPA_SEC_LEVEL_MIDDLE, /*!< DPA protection level medium */
|
|
ESP_CRYPTO_DPA_SEC_LEVEL_HIGH, /*!< DPA protection level high */
|
|
} esp_crypto_dpa_sec_level_t;
|
|
|
|
/**
|
|
* @brief Enable DPA (Differential Power Analysis) related protection
|
|
*
|
|
* @note
|
|
* Enabling the DPA protection can help to make it difficult to perform SCA
|
|
* attacks on the crypto peripherals. However, based on the security level
|
|
* set there will be a performance impact, higher the level higher the impact.
|
|
* Please refer to the TRM for more details.
|
|
*
|
|
* @param level DPA Security Level of type `esp_crypto_dpa_sec_level_t`
|
|
*/
|
|
void esp_crypto_dpa_protection_enable(esp_crypto_dpa_sec_level_t level);
|
|
|
|
/**
|
|
* @brief Disable DPA (Differential Power Analysis) related protection
|
|
*/
|
|
void esp_crypto_dpa_protection_disable(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|