Merge branch 'backport/44987_v6.1' into 'release/v6.1'

feat(esp-tls): Added a PSA driver for Secure Element (backport v6.1)

See merge request espressif/esp-idf!50334

docs/zh_CN/api-reference/protocols/esp_http_client.rst

@@ -35,13 +35,18 @@ HTTP 基本请求
 为 TLS 使用安全元件 (ATECC608)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-安全元件 (ATECC608) 也可用于 HTTP 客户端连接中的底层 TLS 连接。详细内容请参考 :doc:`ESP-TLS 文档 </api-reference/protocols/esp_tls>` 中的 **ESP-TLS 中的 ATECC608A（安全元件）支持** 小节。如需支持安全元素，必须首先在 menuconfig 中通过 :ref:`CONFIG_ESP_TLS_USE_SECURE_ELEMENT` 对其进行启用，此后，可配置 HTTP 客户端使用安全元素，如下所示：
+安全元件 (ATECC608) 可通过 PSA Crypto 不透明驱动接口用于 HTTP 客户端连接中的底层 TLS 连接。有关设置 PSA 密钥的详细内容，请参考 :doc:`ESP-TLS 文档 </api-reference/protocols/esp_tls>` 中的 **ESP-TLS 中的 ATECC608A（安全元件）** 小节。然后通过 :cpp:type:`esp_http_client_config_t` 中的 ``client_key`` 字段配置 HTTP 客户端使用安全元件：
 
 .. code-block:: c
 
+    esp_key_config_t key_config = {
+        .source = ESP_KEY_SOURCE_PSA,
+        .psa.key_id = psa_key_id,  /* 通过 psa_import_key() 获取 */
+    };
+
     esp_http_client_config_t cfg = {
-        /* other configurations options */
-        .use_secure_element = true,
+        /* 其他配置选项 */
+        .client_key = &key_config,
     };
 
 .. only:: SOC_ECDSA_SUPPORTED

docs/zh_CN/api-reference/protocols/esp_tls.rst

@@ -204,10 +204,12 @@ ESP-TLS 组件支持通过 :cpp:func:`esp_tls_register_stack` API 注册自定
     * 更多函数签名和要求，请参阅 :component_file:`esp-tls/esp_tls_custom_stack.h`。
 
 
+.. _atecc608a-with-esp-tls:
+
 ESP-TLS 中的 ATECC608A（安全元件）
 -----------------------------------------
 
-ESP-TLS 支持在 ESP32 系列芯片上使用 ATECC608A 加密芯片，但必须将 MbedTLS 作为 ESP-TLS 的底层 SSL/TLS 协议栈。未经手动更改，ESP-TLS 默认以 MbedTLS 为其底层 TLS/SSL 协议栈。
+ESP-TLS 支持通过 PSA Crypto 不透明驱动接口在 ESP32 系列芯片上使用 ATECC608A 加密芯片。使用 ATECC608A 时必须将 MbedTLS 作为 ESP-TLS 的底层 SSL/TLS 协议栈。未经手动更改，ESP-TLS 默认以 MbedTLS 为其底层 TLS/SSL 协议栈。
 
 .. note::
 
@@ -215,13 +217,13 @@ ESP-TLS 支持在 ESP32 系列芯片上使用 ATECC608A 加密芯片，但必须
 
 要启用安全元件支持，并将其应用于工程 TLS 连接，请遵循以下步骤：
 
-1) 在工程中添加 `esp-cryptoauthlib <https://github.com/espressif/esp-cryptoauthlib>`_，详情请参阅 `如何在 ESP-IDF 中使用 esp-cryptoauthlib <https://github.com/espressif/esp-cryptoauthlib#how-to-use-esp-cryptoauthlib-with-esp-idf>`_。
+1) 在工程中添加 `esp-cryptoauthlib <https://github.com/espressif/esp-cryptoauthlib>`_ 作为依赖，详情请参阅 `如何在 ESP-IDF 中使用 esp-cryptoauthlib <https://github.com/espressif/esp-cryptoauthlib#how-to-use-esp-cryptoauthlib-with-esp-idf>`_。
 
-2) 启用 menuconfig 选项 :ref:`CONFIG_ESP_TLS_USE_SECURE_ELEMENT`：
+2) 启用 menuconfig 选项 :ref:`CONFIG_MBEDTLS_SECURE_ELEMENT_DRIVER_ENABLED`：
 
    .. code-block:: none
 
-       menuconfig > Component config > ESP-TLS > Use Secure Element (ATECC608A) with ESP-TLS
+       menuconfig > Component config > mbedTLS > Enable secure element hardware support
 
 3) 选择 ATECC608A 芯片类型：
 
@@ -231,13 +233,44 @@ ESP-TLS 支持在 ESP32 系列芯片上使用 ATECC608A 加密芯片，但必须
 
    如需了解更多 ATECC608A 芯片类型，或需了解如何获取连接到特定 ESP 模块的 ATECC608A 芯片类型，请参阅 `ATECC608A 芯片类型 <https://github.com/espressif/esp-cryptoauthlib/blob/master/esp_cryptoauth_utility/README.md#find-type-of-atecc608a-chip-connected-to-esp32-wroom32-se>`_。
 
-4) 在 :cpp:type:`esp_tls_cfg_t` 中提供以下配置，在 ESP-TLS 中启用 ATECC608A：
+4) 初始化 PSA Crypto，导入 ATECC608A 密钥，并通过 :cpp:type:`esp_key_config_t` 配置 ESP-TLS 使用：
 
    .. code-block:: c
 
+       #include "psa/crypto.h"
+       #include "psa_crypto_driver_secure_element.h"
+       #include "psa_crypto_driver_secure_element_contexts.h"
+       #include "esp_key_config.h"
+
+       /* 将 ATECC608A 密钥引用导入 PSA */
+       psa_key_attributes_t key_attr = PSA_KEY_ATTRIBUTES_INIT;
+       psa_set_key_lifetime(&key_attr, PSA_KEY_LIFETIME_SECURE_ELEMENT_VOLATILE);
+       psa_set_key_usage_flags(&key_attr, PSA_KEY_USAGE_SIGN_HASH);
+       psa_set_key_algorithm(&key_attr, PSA_ALG_ECDSA(PSA_ALG_SHA_256));
+       psa_set_key_type(&key_attr, PSA_KEY_TYPE_ECC_KEY_PAIR(PSA_ECC_FAMILY_SECP_R1));
+       psa_set_key_bits(&key_attr, 256);
+
+       secure_element_opaque_key_t opaque_key = {
+           .slot_id = 0,  /* ATECC608A 上的私钥槽位 */
+       };
+
+       psa_key_id_t psa_key_id;
+       psa_status_t status = psa_import_key(&key_attr, (const uint8_t *)&opaque_key,
+                                            sizeof(opaque_key), &psa_key_id);
+       if (status != PSA_SUCCESS) {
+           /* 处理错误 - 通常表示安全元件回调未注册或属性无效。 */
+           return;
+       }
+
+       /* 配置 ESP-TLS 使用 PSA 密钥 */
+       esp_key_config_t key_config = {
+           .source = ESP_KEY_SOURCE_PSA,
+           .psa.key_id = psa_key_id,
+       };
+
        esp_tls_cfg_t cfg = {
            /* 其他配置选项 */
-           .use_secure_element = true,
+           .client_key = &key_config,
        };
 
 .. only:: SOC_DIG_SIGN_SUPPORTED