mirror of
https://github.com/espressif/esp-idf.git
synced 2026-09-22 13:01:16 +03:00
8956f3b86c
Report whether the SHA peripheral can run the SM3 mode. The LL function sha_ll_is_sm3_supported() exists on every chip. ESP32-S31 reads the DIS_SM_CRYPT eFuse, which disables SM2 and SM3 permanently. ESP32-C5 and ESP32-H4 have SM3 but no such eFuse. All other chips have no SM3.
97 lines
2.5 KiB
C
97 lines
2.5 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2015-2026 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/*******************************************************************************
|
|
* NOTICE
|
|
* The hal is not public api, don't use in application code.
|
|
* See readme.md in soc/include/hal/readme.md
|
|
******************************************************************************/
|
|
|
|
#pragma once
|
|
|
|
#include <stddef.h>
|
|
#include <stdbool.h>
|
|
#include "soc/soc_caps.h"
|
|
#include "soc/lldesc.h"
|
|
#include "hal/sha_types.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief Load the mode for the SHA engine
|
|
*
|
|
* @param sha_type The SHA algorithm type
|
|
*/
|
|
void sha_hal_set_mode(esp_sha_type sha_type);
|
|
|
|
/**
|
|
* @brief Hashes a single message block
|
|
*
|
|
* @param sha_type SHA algorithm to hash with
|
|
* @param data_block Input message to be hashed
|
|
* @param block_word_len Length of the input message
|
|
* @param first_block Is this the first block in a message or a continuation?
|
|
*/
|
|
void sha_hal_hash_block(esp_sha_type sha_type, const void *data_block, size_t block_word_len, bool first_block);
|
|
|
|
/**
|
|
* @brief Polls and waits until the SHA engine is idle
|
|
*
|
|
*/
|
|
void sha_hal_wait_idle(void);
|
|
|
|
/**
|
|
* @brief Reads the current message digest from the SHA engine
|
|
*
|
|
* @param sha_type SHA algorithm used
|
|
* @param digest_state Output buffer to which to read message digest to
|
|
*/
|
|
void sha_hal_read_digest(esp_sha_type sha_type, void *digest_state);
|
|
|
|
#if SOC_SHA_SUPPORT_RESUME
|
|
/**
|
|
* @brief Writes the message digest to the SHA engine
|
|
*
|
|
* @param sha_type The SHA algorithm type
|
|
* @param digest_state Message digest to be written to SHA engine
|
|
*/
|
|
void sha_hal_write_digest(esp_sha_type sha_type, void *digest_state);
|
|
#endif
|
|
|
|
#if SOC_SHA_SUPPORT_DMA
|
|
/**
|
|
* @brief Hashes a number of message blocks using DMA
|
|
*
|
|
* @param num_blocks Number of blocks to hash
|
|
* @param first_block Is this the first block in a message or a continuation?
|
|
*/
|
|
void sha_hal_hash_dma(size_t num_blocks, bool first_block);
|
|
#endif
|
|
|
|
/**
|
|
* @brief Check whether the SHA peripheral can run the SM3 mode.
|
|
*
|
|
* @return true if SM3 is available. false if the chip has no SM3 hardware
|
|
* or if an eFuse disables it.
|
|
*/
|
|
bool sha_hal_is_sm3_supported(void);
|
|
|
|
#if SOC_SHA_SUPPORT_SHA512_T
|
|
/**
|
|
* @brief Calculates and sets the initial digiest for SHA512_t
|
|
*
|
|
* @param t_string
|
|
* @param t_len
|
|
*/
|
|
void sha_hal_sha512_init_hash(uint32_t t_string, uint8_t t_len);
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|