refactor(hal): Created esp_hal_security for security code

2026-10-01 18:50:34 +03:00 · 2026-01-21 09:59:46 +05:30
parent 469ead652b
commit 5ee7af3afd
220 changed files with 4098 additions and 3766 deletions
@@ -0,0 +1,100 @@
+/*
+ * SPDX-FileCopyrightText: 2020-2025 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include "stdio.h"
+#include "esp_hal_security/hmac_hal.h"
+#include "esp_hal_security/hmac_ll.h"
+#include "hal/assert.h"
+#include "soc/soc_caps.h"
+
+#if SOC_KEY_MANAGER_HMAC_KEY_DEPLOY
+#include "esp_hal_security/key_mgr_hal.h"
+#include "esp_hal_security/key_mgr_ll.h"
+#endif
+
+void hmac_hal_start(void)
+{
+    hmac_ll_wait_idle();
+    hmac_ll_start();
+}
+
+uint32_t hmac_hal_configure(hmac_hal_output_t config, uint32_t key_id)
+{
+    hmac_ll_wait_idle();
+    hmac_ll_config_output(config);
+
+#if SOC_KEY_MANAGER_HMAC_KEY_DEPLOY
+    if (key_id == HMAC_KEY_KM) {
+        if (!key_mgr_ll_is_supported()) {
+            HAL_ASSERT(false && "Key manager is not supported");
+        }
+
+        if (config == HMAC_OUTPUT_USER) {
+            key_mgr_hal_set_key_usage(ESP_KEY_MGR_HMAC_KEY, ESP_KEY_MGR_USE_OWN_KEY);
+        } else {
+            // No other HMAC output type is allowed when using key manager
+            return 1;
+        }
+    } else {
+        key_mgr_hal_set_key_usage(ESP_KEY_MGR_HMAC_KEY, ESP_KEY_MGR_USE_EFUSE_KEY);
+    }
+#endif
+
+    hmac_ll_config_hw_key_id(key_id);
+    hmac_ll_config_finish();
+    hmac_ll_wait_idle();
+
+    uint32_t conf_error = hmac_ll_config_error();
+    if (conf_error) {
+        hmac_ll_calc_finish();
+        return 1;
+    } else if (config != HMAC_OUTPUT_USER) {
+        // In "downstream" mode, this will be the last hmac operation. Make sure HMAC is ready for
+        // the other peripheral.
+        hmac_ll_wait_idle();
+    }
+
+    return 0;
+}
+
+void hmac_hal_write_one_block_512(const void *block)
+{
+    hmac_ll_wait_idle();
+    hmac_ll_write_block_512(block);
+    hmac_ll_wait_idle();
+    hmac_ll_msg_one_block();
+}
+
+void hmac_hal_write_block_512(const void *block)
+{
+    hmac_ll_wait_idle();
+    hmac_ll_write_block_512(block);
+}
+
+void hmac_hal_next_block_padding(void)
+{
+    hmac_ll_wait_idle();
+    hmac_ll_msg_padding();
+}
+
+void hmac_hal_next_block_normal(void)
+{
+    hmac_ll_wait_idle();
+    hmac_ll_msg_continue();
+}
+
+void hmac_hal_read_result_256(void *result)
+{
+    hmac_ll_wait_idle();
+    hmac_ll_read_result_256(result);
+    hmac_ll_calc_finish();
+}
+
+void hmac_hal_clean(void)
+{
+    hmac_ll_wait_idle();
+    hmac_ll_clean();
+}