docs: Update translations for ESP-IDF unsynchronized files

2023-10-09 10:25:19 +08:00
parent 515a1a5f0d
commit 8dbff6a5fe
11 changed files with 56 additions and 39 deletions
@@ -28,3 +28,8 @@ API 参考

 .. include-build-file:: inc/esp_wifi.inc
 .. include-build-file:: inc/esp_wifi_types.inc
+.. include-build-file:: inc/esp_eap_client.inc
+.. include-build-file:: inc/esp_wps.inc
+.. include-build-file:: inc/esp_rrm.inc
+.. include-build-file:: inc/esp_wnm.inc
+.. include-build-file:: inc/esp_mbo.inc
@@ -50,6 +50,7 @@ Thread 是一种基于 IPv6 的物联网网状网络技术。

 ESP-NETIF
 =========
+
 .. toctree::
   :maxdepth: 1

@@ -93,7 +93,6 @@ ADC 单次转换模式驱动基于 {IDF_TARGET_NAME} SAR ADC 模块实现，不

    ADC IO 及其对应的 ADC 通道编号，请参阅 `技术规格书 <{IDF_TARGET_TRM_CN_URL}>`__。

-
    此外，可以使用 :cpp:func:`adc_continuous_io_to_channel` 和 :cpp:func:`adc_continuous_channel_to_io` 了解 ADC 通道和 ADC IO。

 为使以上设置生效，请使用上述配置结构体调用 :cpp:func:`adc_oneshot_config_channel`，并指定要配置的 ADC 通道。函数 :cpp:func:`adc_oneshot_config_channel` 支持多次调用，以配置不同的 ADC 通道。驱动程序将在内部保存每个通道的配置。
@@ -116,6 +116,7 @@ ESP32-C3    I2S 0     I2S 0     无        I2S 0     无         无
 ESP32-C6    I2S 0     I2S 0     无        I2S 0     无         无
 ESP32-S3   I2S 0/1    I2S 0     I2S 0    I2S 0/1    无         无
 ESP32-H2    I2S 0     I2S 0     无        I2S 0     无         无
+ESP32-P4   I2S 0~2    I2S 0     I2S 0    I2S 0~2    无         无
 =========  ========  ========  ========  ========  ========  ==========

 标准模式
@@ -65,7 +65,7 @@ ESP-TLS 服务器证书选择回调
 证书选择回调可在结构体 :cpp:type:`esp_tls_cfg_t` 中配置，具体如下：

 .. code-block:: c
-    
+
    int cert_selection_callback(mbedtls_ssl_context *ssl)
    {
        /* 回调应执行的代码 */
@@ -120,7 +120,7 @@ MbedTLS 与 WolfSSL 对比
    :header-rows: 1
    :widths: 40 30 30
    :align: center
-    
+
    * - 属性
      - WolfSSL
      - MbedTLS
@@ -163,7 +163,7 @@ MbedTLS 与 WolfSSL 对比

    如需了解更多 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>`_。

-    1) 在 :cpp:type:`esp_tls_cfg_t` 中提供以下配置，在 ESP-TLS 中启用 ATECC608A。
+    4) 在 :cpp:type:`esp_tls_cfg_t` 中提供以下配置，在 ESP-TLS 中启用 ATECC608A。

    .. code-block:: c

@@ -201,6 +201,28 @@ MbedTLS 与 WolfSSL 对比

    * 使用数字签名外设进行双向认证的示例请参阅 :example:`SSL 双向认证 <protocols/mqtt/ssl_mutual_auth>`，该示例使用 ESP-TLS 实现 TLS 连接。

+.. only:: SOC_ECDSA_SUPPORTED
+
+    在 ESP-TLS 中使用 ECDSA 外设
+    -----------------------------
+
+    ESP-TLS 支持在 {IDF_TARGET_NAME} 中使用 ECDSA 外设。使用 ECDSA 外设时，ESP-TLS 必须与 MbedTLS 一起作为底层 SSL/TLS 协议栈，并且 ECDSA 的私钥应存储在 eFuse 中。请参考 `espefuse.py <https://docs.espressif.com/projects/esptool/en/latest/esp32/espefuse/index.html>`__ 文档，了解如何在 eFuse 中烧写 ECDSA 密钥。
+    在 ESP-TLS 中启用 ECDSA 外设前，请将 :cpp:member:`esp_tls_cfg_t::use_ecdsa_peripheral` 设置为 `true`，并将 :cpp:member:`esp_tls_cfg_t::ecdsa_key_efuse_blk` 设置为存储了 ECDSA 密钥的 eFuse 块 ID。
+    这样就可以使用 ECDSA 外设进行私钥操作。由于客户私钥已经存储在 eFuse 中，因此无需将其传递给 :cpp:type:`esp_tls_cfg_t`。
+
+    .. code-block:: c
+
+        #include "esp_tls.h"
+        esp_tls_cfg_t cfg = {
+            .use_ecdsa_peripheral = true,
+            .ecdsa_key_efuse_blk = /* 存储 ECDSA 私钥的 eFuse 块 */,
+        };
+
+    .. note::
+
+        在 TLS 中使用 ECDSA 外设时，只支持 ``MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256`` 密码套件。如果使用 TLS v1.3，则支持 ``MBEDTLS_TLS1_3_AES_128_GCM_SHA256`` 密码套件。
+
+
 TLS 加密套件
 ------------------------------------

@@ -219,7 +241,7 @@ ESP-TLS 支持在客户端模式下设置加密套件列表，TLS 密码套件
 ESP-TLS 不会检查 ``ciphersuites_list`` 的有效性，因此需调用 :cpp:func:`esp_tls_get_ciphersuites_list` 获取 TLS 协议栈中支持的加密套件列表，并检查设置的加密套件是否在支持的加密套件列表中。

 .. note::
-    
+
   此功能仅在 MbedTLS 协议栈中有效。

 API 参考