From 33a00cf19717ff76ea3b93ac0e22bddc9abbd000 Mon Sep 17 00:00:00 2001 From: Shang Zhou Date: Thu, 30 Dec 2021 18:50:55 +0800 Subject: [PATCH] docs: Updated CN translation for index files in api-guides and api-reference --- docs/en/api-guides/index.rst | 80 +++++++++---------- docs/en/api-reference/bluetooth/index.rst | 17 ++-- docs/en/api-reference/index.rst | 22 ++--- docs/en/api-reference/network/index.rst | 23 +++--- docs/en/api-reference/protocols/index.rst | 30 +++---- docs/en/api-reference/provisioning/index.rst | 14 ++-- docs/en/api-reference/storage/index.rst | 18 ++--- docs/en/api-reference/system/index.rst | 60 +++++++------- docs/zh_CN/api-guides/build-system.rst | 2 +- docs/zh_CN/api-guides/index.rst | 78 +++++++++--------- docs/zh_CN/api-reference/bluetooth/index.rst | 23 +++--- docs/zh_CN/api-reference/index.rst | 20 ++--- docs/zh_CN/api-reference/network/index.rst | 30 ++++--- docs/zh_CN/api-reference/protocols/index.rst | 32 ++++---- .../api-reference/provisioning/index.rst | 20 ++++- docs/zh_CN/api-reference/storage/index.rst | 20 ++--- docs/zh_CN/api-reference/system/index.rst | 40 +++++++++- 17 files changed, 295 insertions(+), 234 deletions(-) diff --git a/docs/en/api-guides/index.rst b/docs/en/api-guides/index.rst index 0ffe98c58a..066ad63410 100644 --- a/docs/en/api-guides/index.rst +++ b/docs/en/api-guides/index.rst @@ -3,44 +3,44 @@ API Guides :link_to_translation:`zh_CN:[中文]` .. toctree:: - :maxdepth: 1 + :maxdepth: 1 - Application Level Tracing - Application Startup Flow - :SOC_BT_SUPPORTED: BluFi - Bootloader - Build System - Deep Sleep Wake Stubs - :SOC_USB_OTG_SUPPORTED: Device Firmware Upgrade through USB - Error Handling - :SOC_BT_SUPPORTED: ESP-BLE-MESH - ESP-WIFI-MESH - Core Dump - Event Handling - :SOC_SPIRAM_SUPPORTED: External SPI-connected RAM - Fatal Errors - Flash Encryption <../security/flash-encryption> - :esp32s3: Flash and External SPI RAM Configuration - FreeRTOS SMP Changes - Hardware Abstraction - :CONFIG_IDF_TARGET_ARCH_XTENSA: High Level Interrupts - JTAG Debugging - Linker Script Generation - Memory Types - lwIP TCP/IP Stack - OpenThread - Partition Tables - Performance - :not esp32c2: RF Calibration - :esp32: Secure Boot <../security/secure-boot-v1> - Secure Boot V2 <../security/secure-boot-v2> - Thread Local Storage - Tools - :SOC_ULP_SUPPORTED: ULP Coprocessor - :SOC_RISCV_COPROC_SUPPORTED: ULP-RISC-V Coprocessor - Unit Testing (Target) - Unit Testing (Linux Host) - :SOC_USB_OTG_SUPPORTED: USB OTG Console - :SOC_USB_SERIAL_JTAG_SUPPORTED: USB Serial/JTAG Controller Console - :SOC_WIFI_SUPPORTED: Wi-Fi Driver - :SOC_WIFI_SUPPORTED: Wi-Fi Security + app_trace + startup + :SOC_BT_SUPPORTED: blufi + bootloader + build-system + core_dump + deep-sleep-stub + :SOC_USB_OTG_SUPPORTED: dfu + error-handling + :SOC_BT_SUPPORTED: esp-ble-mesh/ble-mesh-index + freertos-smp + esp-wifi-mesh + event-handling + fatal-errors + ../security/flash-encryption + :esp32s3: flash_psram_config + hardware-abstraction + :CONFIG_IDF_TARGET_ARCH_XTENSA: hlinterrupts + jtag-debugging/index + linker-script-generation + lwip + memory-types + openthread + partition-tables + performance/index + :not esp32c2: RF_calibration + :esp32: ../security/secure-boot-v1 + ../security/secure-boot-v2 + :SOC_SPIRAM_SUPPORTED: external-ram + thread-local-storage + tools/index + :SOC_ULP_SUPPORTED: ulp + :SOC_RISCV_COPROC_SUPPORTED: ulp-risc-v + unit-tests + linux-host-testing + :SOC_USB_OTG_SUPPORTED: usb-otg-console + :SOC_USB_SERIAL_JTAG_SUPPORTED: usb-serial-jtag-console + :SOC_WIFI_SUPPORTED: wifi + :SOC_WIFI_SUPPORTED: wifi-security \ No newline at end of file diff --git a/docs/en/api-reference/bluetooth/index.rst b/docs/en/api-reference/bluetooth/index.rst index d9421458c0..b7deb62e13 100644 --- a/docs/en/api-reference/bluetooth/index.rst +++ b/docs/en/api-reference/bluetooth/index.rst @@ -6,13 +6,13 @@ Bluetooth API .. toctree:: :maxdepth: 2 - Bluetooth Controller && VHCI - Bluetooth Common - Bluetooth LE - :SOC_CLASSIC_BT_SUPPORTED: Bluetooth Classic - NimBLE - ESP-BLE-MESH - + bt_common + bt_le + :SOC_CLASSIC_BT_SUPPORTED: classic_bt + controller_vhci + esp-ble-mesh + nimble/index + ESP-IDF currently supports two host stacks. The Bluedroid based stack (default) supports classic Bluetooth as well as BLE. On the other hand, Apache NimBLE based stack is BLE only. For users to make a choice: * For usecases involving classic Bluetooth as well as BLE, Bluedroid should be used. @@ -22,8 +22,7 @@ ESP-IDF currently supports two host stacks. The Bluedroid based stack (default) For the overview of the ESP32 Bluetooth stack architecture, follow the links below: - * `ESP32 Bluetooth Architecture (PDF) [English] `_ - * `ESP32 Bluetooth Architecture (PDF) [中文] `_ + * `ESP32 Bluetooth Architecture (PDF) `_ Code examples for this API section are provided in the :example:`bluetooth/bluedroid` directory of ESP-IDF examples. diff --git a/docs/en/api-reference/index.rst b/docs/en/api-reference/index.rst index 13b041f2ac..715fe0abae 100644 --- a/docs/en/api-reference/index.rst +++ b/docs/en/api-reference/index.rst @@ -4,15 +4,15 @@ API Reference :link_to_translation:`zh_CN:[中文]` .. toctree:: - :maxdepth: 2 + :maxdepth: 2 - :SOC_BT_SUPPORTED: Bluetooth - Networking - Peripherals - Protocols - Provisioning - Storage - System - API Conventions - Configuration Options - Error Codes Reference \ No newline at end of file + api-conventions + protocols/index + :SOC_BT_SUPPORTED: bluetooth/index + error-codes + network/index + peripherals/index + kconfig + provisioning/index + storage/index + system/index \ No newline at end of file diff --git a/docs/en/api-reference/network/index.rst b/docs/en/api-reference/network/index.rst index 348cfd6554..393cc5b17b 100644 --- a/docs/en/api-reference/network/index.rst +++ b/docs/en/api-reference/network/index.rst @@ -9,11 +9,11 @@ Wi-Fi .. toctree:: :maxdepth: 1 - Wi-Fi - SmartConfig - ESP-NOW - ESP-WIFI-MESH - EasyConnect + esp_now + esp-wifi-mesh + esp_smartconfig + esp_wifi + esp_dpp Code examples for the Wi-Fi API are provided in the :example:`wifi` directory of ESP-IDF examples. @@ -26,7 +26,7 @@ Ethernet .. toctree:: :maxdepth: 1 - Ethernet + esp_eth Code examples for the Ethernet API are provided in the :example:`ethernet` directory of ESP-IDF examples. @@ -36,7 +36,7 @@ Thread .. toctree:: :maxdepth: 1 - Thread + esp_openthread Thread is an IPv6-based mesh networking technology for IoT. Code examples for the Thread API are provided in the :example:`openthread` directory of ESP-IDF examples. @@ -47,7 +47,7 @@ ESP-NETIF .. toctree:: :maxdepth: 1 - ESP-NETIF + esp_netif IP Network Layer ================ @@ -55,13 +55,12 @@ IP Network Layer .. toctree:: :hidden: - TCP/IP Adapter Migration Guide - ESP-NETIF Custom I/O Driver + tcpip_adapter_migration + esp_netif_driver Code examples for TCP/IP socket APIs are provided in the :example:`protocols/sockets` directory of ESP-IDF examples. -The TCP/IP Adapter (legacy network interface library) has been deprecated, please consult the :doc:`/api-reference/network/tcpip_adapter_migration` -to update existing IDF applications. +The TCP/IP Adapter (legacy network interface library) has been deprecated, please consult the :doc:`/api-reference/network/tcpip_adapter_migration` to update existing IDF applications. Application Layer  ================= diff --git a/docs/en/api-reference/protocols/index.rst b/docs/en/api-reference/protocols/index.rst index dfc4c01503..d9560d1b1d 100644 --- a/docs/en/api-reference/protocols/index.rst +++ b/docs/en/api-reference/protocols/index.rst @@ -5,21 +5,21 @@ Application Protocols .. toctree:: :maxdepth: 1 - ASIO - ESP-MQTT - ESP-TLS - OpenSSL APIs - HTTP Client - HTTP Server - HTTPS Server - ICMP Echo - Local Control - mDNS - Modbus - Websocket Client - ESP Serial Slave Link - Certificate Bundle - + asio + modbus + mqtt + esp_tls + esp_http_client + esp_local_ctrl + esp_serial_slave_link + esp_websocket_client + esp_crt_bundle + esp_http_server + esp_https_server + icmp_echo + mdns + openssl_apis + Code examples for this API section are provided in the :example:`protocols` directory of ESP-IDF examples. diff --git a/docs/en/api-reference/provisioning/index.rst b/docs/en/api-reference/provisioning/index.rst index 0443208486..b6c3a85ecb 100644 --- a/docs/en/api-reference/provisioning/index.rst +++ b/docs/en/api-reference/provisioning/index.rst @@ -6,22 +6,22 @@ Provisioning API .. toctree:: :maxdepth: 1 - Protocol Communication - Unified Provisioning - Wi-Fi Provisioning + protocomm + provisioning + wifi_provisioning Code examples for above API are provided in the :example:`provisioning` directory of ESP-IDF examples. .. toctree:: :maxdepth: 1 - SmartConfig <../network/esp_smartconfig> + ../network/esp_smartconfig -Code example for above API is provided in :example:`wifi/smart_config` +Code example for above API is provided in :example:`wifi/smart_config`. .. toctree:: :maxdepth: 1 - EasyConnect <../network/esp_dpp> + ../network/esp_dpp -Code example for above API is provided in :example:`wifi/wifi_easy_connect/dpp-enrollee` +Code example for above API is provided in :example:`wifi/wifi_easy_connect/dpp-enrollee`. diff --git a/docs/en/api-reference/storage/index.rst b/docs/en/api-reference/storage/index.rst index eecf2d8e43..ead81fc6a1 100644 --- a/docs/en/api-reference/storage/index.rst +++ b/docs/en/api-reference/storage/index.rst @@ -6,15 +6,15 @@ Storage API .. toctree:: :maxdepth: 1 - FAT Filesystem - Mass Manufacturing Utility - Non-Volatile Storage - NVS Partition Generation Utility - SD/SDIO/MMC Driver - SPI Flash and Partition APIs - SPIFFS Filesystem - Virtual Filesystem - Wear Levelling API + fatfs + mass_mfg.rst + nvs_flash + nvs_partition_gen.rst + sdmmc + spi_flash + spiffs + vfs + wear-levelling diff --git a/docs/en/api-reference/system/index.rst b/docs/en/api-reference/system/index.rst index b1c41e51ea..831d2c6db7 100644 --- a/docs/en/api-reference/system/index.rst +++ b/docs/en/api-reference/system/index.rst @@ -1,37 +1,39 @@ System API ********** +:link_to_translation:`zh_CN:[中文]` + .. toctree:: :maxdepth: 1 - App image format - Application Level Tracing - :SOC_ASYNC_MEMCPY_SUPPORTED: Async Memory Copy - Console Component - eFuse Manager - Error Codes and Helper Functions - ESP HTTPS OTA - POSIX Threads Support - Event Loop Library - FreeRTOS - FreeRTOS Supplemental Features - Heap Memory Allocation - Heap Memory Debugging - High Resolution Timer - :esp32: Himem (large external SPI RAM) API - :not CONFIG_FREERTOS_UNICORE: Inter-Processor Call - Call function with external stack - Interrupt Allocation - Logging - Miscellaneous System APIs - Over The Air Updates (OTA) - :CONFIG_IDF_TARGET_ARCH_XTENSA: Performance Monitor - Power Management - Random Number Generation - Sleep Modes - Watchdogs - System Time - Internal and Unstable API - + app_image_format + app_trace + esp_function_with_shared_stack + console + efuse + esp_err + esp_https_ota + esp_event + freertos + freertos_additions + mem_alloc + heap_debug + esp_timer + internal-unstable + :not CONFIG_FREERTOS_UNICORE: ipc + intr_alloc + log + system + ota + :CONFIG_IDF_TARGET_ARCH_XTENSA: perfmon + power_management + pthread + random + sleep_modes + system_time + :SOC_ASYNC_MEMCPY_SUPPORTED: async_memcpy + :esp32: himem + wdts + Code examples for this API section are provided in the :example:`system` directory of ESP-IDF examples. diff --git a/docs/zh_CN/api-guides/build-system.rst b/docs/zh_CN/api-guides/build-system.rst index 2e0161a8f6..98cb9e73f3 100644 --- a/docs/zh_CN/api-guides/build-system.rst +++ b/docs/zh_CN/api-guides/build-system.rst @@ -1,4 +1,4 @@ -构建系统（CMake 版） +构建系统 ******************** :link_to_translation:`en:[English]` diff --git a/docs/zh_CN/api-guides/index.rst b/docs/zh_CN/api-guides/index.rst index 7dcf08f9bc..abf3f84862 100644 --- a/docs/zh_CN/api-guides/index.rst +++ b/docs/zh_CN/api-guides/index.rst @@ -5,42 +5,42 @@ API 指南 .. toctree:: :maxdepth: 1 - 应用层跟踪 - Application Startup Flow - :SOC_BT_SUPPORTED: BluFi - 引导加载程序 - 构建系统 - 深度睡眠唤醒存根 - :SOC_USB_OTG_SUPPORTED: 通过 USB 升级设备固件 - 错误处理 - :SOC_BT_SUPPORTED: ESP-BLE-MESH - ESP-WIFI-MESH - 核心转储 - 事件处理 - :SOC_SPIRAM_SUPPORTED: 片外 SPI RAM - 严重错误 - Flash 加密 <../security/flash-encryption> - :esp32s3: Flash and External SPI RAM Configuration - FreeRTOS SMP 变化 - 硬件抽象层 - :CONFIG_IDF_TARGET_ARCH_XTENSA: 高层中断 - JTAG 调试 - 链接脚本生成机制 - lwIP TCP/IP 协议栈 - OpenThread - Memory Types - 分区表 - Performance - :not esp32c2: 射频校准 - :esp32: 安全启动 <../security/secure-boot-v1> - 安全启动 V2 <../security/secure-boot-v2> - 线程本地存储 - 工具 - :SOC_ULP_SUPPORTED: ULP 协处理器 - :SOC_RISCV_COPROC_SUPPORTED: ULP-RISC-V 协处理器 - 单元测试 (Target) - 单元测试 (Linux Host) - :SOC_USB_OTG_SUPPORTED: USB 控制台 - :SOC_USB_SERIAL_JTAG_SUPPORTED: USB Serial/JTAG Controller Console - :SOC_WIFI_SUPPORTED: Wi-Fi 驱动 - :SOC_WIFI_SUPPORTED: Wi-Fi Security + app_trace + startup + :SOC_BT_SUPPORTED: blufi + bootloader + build-system + core_dump + deep-sleep-stub + :SOC_USB_OTG_SUPPORTED: dfu + error-handling + :SOC_BT_SUPPORTED: esp-ble-mesh/ble-mesh-index + freertos-smp + esp-wifi-mesh + event-handling + fatal-errors + ../security/flash-encryption + :esp32s3: flash_psram_config + hardware-abstraction + :CONFIG_IDF_TARGET_ARCH_XTENSA: hlinterrupts + jtag-debugging/index + linker-script-generation + lwip + memory-types + openthread + partition-tables + performance/index + :not esp32c2: RF_calibration + :esp32: ../security/secure-boot-v1 + ../security/secure-boot-v2 + :SOC_SPIRAM_SUPPORTED: external-ram + thread-local-storage + tools/index + :SOC_ULP_SUPPORTED: ulp + :SOC_RISCV_COPROC_SUPPORTED: ulp-risc-v + unit-tests + linux-host-testing + :SOC_USB_OTG_SUPPORTED: usb-otg-console + :SOC_USB_SERIAL_JTAG_SUPPORTED: usb-serial-jtag-console + :SOC_WIFI_SUPPORTED: wifi + :SOC_WIFI_SUPPORTED: wifi-security \ No newline at end of file diff --git a/docs/zh_CN/api-reference/bluetooth/index.rst b/docs/zh_CN/api-reference/bluetooth/index.rst index 53ba70bc49..c2f9774a22 100644 --- a/docs/zh_CN/api-reference/bluetooth/index.rst +++ b/docs/zh_CN/api-reference/bluetooth/index.rst @@ -6,20 +6,25 @@ .. toctree:: :maxdepth: 2 - Bluetooth Controller && VHCI - Bluetooth Common - Bluetooth LE - :SOC_CLASSIC_BT_SUPPORTED: Bluetooth Classic - NimBLE - ESP-BLE-MESH + bt_common + bt_le + :SOC_CLASSIC_BT_SUPPORTED: classic_bt + controller_vhci + esp-ble-mesh + nimble/index + +ESP-IDF 目前支持两个主机堆栈。基于 Bluedroid 的堆栈（默认）支持传统蓝牙和 BLE，而基于 Apache NimBLE 的堆栈仅支持 BLE。用户可参考如下信息进行选择： + +* 对于同时涉及传统蓝牙和 BLE 的用例，应该选用 Bluedroid。 +* 对于仅涉及 BLE 的用例，建议选用 NimBLE。在代码占用和运行时，NimBLE 对内存的要求较低，因此适用于此类场景。 .. only:: esp32 - 请点击下方链接，查看 ESP32 蓝牙架构： + 请点击下方链接，查看 ESP32 蓝牙架构： - `ESP32 蓝牙架构 (PDF) `_ + * `ESP32 蓝牙架构 (PDF) `_ -蓝牙 API 的示例代码存放于 ESP-IDF :example:`bluetooth/bluedroid` 示例目录下，请查看。 +蓝牙 API 的示例代码存放于 ESP-IDF 示例项目的 :example:`bluetooth/bluedroid` 目录下。 下面的示例给出了详细介绍： diff --git a/docs/zh_CN/api-reference/index.rst b/docs/zh_CN/api-reference/index.rst index ce0d6cc952..51601e0b23 100644 --- a/docs/zh_CN/api-reference/index.rst +++ b/docs/zh_CN/api-reference/index.rst @@ -6,13 +6,13 @@ API 参考 .. toctree:: :maxdepth: 2 - :SOC_BT_SUPPORTED: 蓝牙 - 连网 - 外设 - 协议 - 配网 - 存储 - System - API Conventions - Configuration Options - Error Codes Reference \ No newline at end of file + api-conventions + protocols/index + :SOC_BT_SUPPORTED: bluetooth/index + error-codes + network/index + peripherals/index + kconfig + provisioning/index + storage/index + system/index \ No newline at end of file diff --git a/docs/zh_CN/api-reference/network/index.rst b/docs/zh_CN/api-reference/network/index.rst index 92f1f8c72f..dbc8bf0010 100644 --- a/docs/zh_CN/api-reference/network/index.rst +++ b/docs/zh_CN/api-reference/network/index.rst @@ -4,16 +4,16 @@ :link_to_translation:`en:[English]` Wi-Fi -======= +===== .. toctree:: :maxdepth: 1 - Wi-Fi - Smart Config - ESP-NOW - ESP-WIFI-MESH - EasyConnect + esp_now + esp-wifi-mesh + esp_smartconfig + esp_wifi + esp_dpp 本部分的 Wi-Fi API 示例代码存放在 ESP-IDF 示例项目的 :example:`wifi` 目录下。 @@ -26,7 +26,7 @@ ESP-WIFI-MESH 的示例代码存放在 ESP-IDF 示例项目的 :example:`mesh` .. toctree:: :maxdepth: 1 - Ethernet + esp_eth 本部分的以太网 API 示例代码存放在 ESP-IDF 示例项目的 :example:`ethernet` 目录下。 @@ -36,29 +36,33 @@ Thread .. toctree:: :maxdepth: 1 - Thread + esp_openthread +Thread 是一种基于 IPv6 的物联网网状网络技术。 本部分的Thread API 示例代码存放在 ESP-IDF 示例项目的 :example:`openthread` 目录下。 - IP 网络层协议 ================ .. toctree:: :maxdepth: 1 - ESP-NETIF + esp_netif + +IP 网络层协议 +================ .. toctree:: :hidden: - TCP/IP Adapter Migration Guide - ESP-NETIF Custom I/O Driver + tcpip_adapter_migration + esp_netif_driver TCP/IP 套接字 API 的示例代码存放在 ESP-IDF 示例项目的 :example:`protocols/sockets` 目录下。 +目前已不再使用 TCP/IP 适配器（旧式网络接口库），请参考 :doc:`/api-reference/network/tcpip_adapter_migration` 来更新现有的 IDF 应用程序。 应用层协议  =========== -应用层网络协议（IP 网络层协议之上）的相关文档存放在 :doc:`../protocols/index`。 +应用层网络协议（IP 网络层协议之上）的相关文档存放在 :doc:`../protocols/index` 目录下。 diff --git a/docs/zh_CN/api-reference/protocols/index.rst b/docs/zh_CN/api-reference/protocols/index.rst index 186514e47d..d6ab991d9c 100644 --- a/docs/zh_CN/api-reference/protocols/index.rst +++ b/docs/zh_CN/api-reference/protocols/index.rst @@ -5,25 +5,25 @@ .. toctree:: :maxdepth: 1 - mDNS - ESP-TLS - OpenSSL APIs - HTTP Client - Websocket Client - HTTP 服务器 - HTTPS Server - ICMP Echo - ASIO - ESP-MQTT - Modbus slave - Local Control - ESP Serial Slave Link - Certificate Bundle + asio + modbus + mqtt + esp_tls + esp_http_client + esp_local_ctrl + esp_serial_slave_link + esp_websocket_client + esp_crt_bundle + esp_http_server + esp_https_server + icmp_echo + mdns + openssl_apis -此 API 部分的示例代码在 ESP-IDF 示例工程的 :example:`protocols` 目录下提供。 +此 API 部分的示例代码存放在 ESP-IDF 示例项目的 :example:`protocols` 目录下。 IP 网络层协议 ============= -IP 网络层协议（应用层协议之下）的文档位于 :doc:`../network/index` 。 +IP 网络层协议（应用层协议之下）的文档存放在 :doc:`../network/index` 目录下。 diff --git a/docs/zh_CN/api-reference/provisioning/index.rst b/docs/zh_CN/api-reference/provisioning/index.rst index 3248660a2d..cc57f16d19 100644 --- a/docs/zh_CN/api-reference/provisioning/index.rst +++ b/docs/zh_CN/api-reference/provisioning/index.rst @@ -6,8 +6,22 @@ .. toctree:: :maxdepth: 1 - Unified Provisioning - Protocol Communication - Wi-Fi Provisioning + protocomm + provisioning + wifi_provisioning 本部分的 API 示例代码存放在 ESP-IDF 示例项目的 :example:`provisioning` 目录下。 + +.. toctree:: + :maxdepth: 1 + + ../network/esp_smartconfig + +本部分的 API 示例代码存放在 :example:`wifi/smart_config` 目录下。 + +.. toctree:: + :maxdepth: 1 + + ../network/esp_dpp + +本部分的 API 示例代码存放在 :example:`wifi/wifi_easy_connect/dpp-enrollee` 目录下。 diff --git a/docs/zh_CN/api-reference/storage/index.rst b/docs/zh_CN/api-reference/storage/index.rst index 9b765ebbe0..5dfbfae2d5 100644 --- a/docs/zh_CN/api-reference/storage/index.rst +++ b/docs/zh_CN/api-reference/storage/index.rst @@ -6,16 +6,16 @@ .. toctree:: :maxdepth: 1 - FAT 文件系统 - 量产程序 - 非易失性存储库 - NVS 分区生成程序 - SD/SDIO/MMC 驱动程序 - SPI Flash API - SPIFFS 文件系统 - 虚拟文件系统组件 - 磨损均衡 API + fatfs + mass_mfg.rst + nvs_flash + nvs_partition_gen.rst + sdmmc + spi_flash + spiffs + vfs + wear-levelling -此部分 API 代码示例详见 ESP-IDF 项下 :example:`storage` 目录。 +此部分 API 代码示例存放在 ESP-IDF 示例项目的 :example:`storage` 目录下。 diff --git a/docs/zh_CN/api-reference/system/index.rst b/docs/zh_CN/api-reference/system/index.rst index cdf03b734d..a8d71545ad 100644 --- a/docs/zh_CN/api-reference/system/index.rst +++ b/docs/zh_CN/api-reference/system/index.rst @@ -1 +1,39 @@ -.. include:: ../../../en/api-reference/system/index.rst \ No newline at end of file +System API +********** + +:link_to_translation:`en:[English]` + +.. toctree:: + :maxdepth: 1 + + app_image_format + app_trace + esp_function_with_shared_stack + console + efuse + esp_err + esp_https_ota + esp_event + freertos + freertos_additions + mem_alloc + heap_debug + esp_timer + internal-unstable + :not CONFIG_FREERTOS_UNICORE: ipc + intr_alloc + log + system + ota + :CONFIG_IDF_TARGET_ARCH_XTENSA: perfmon + power_management + pthread + random + sleep_modes + system_time + :SOC_ASYNC_MEMCPY_SUPPORTED: async_memcpy + :esp32: himem + wdts + + +此部分 API 代码示例存放在 ESP-IDF 示例项目的 :example:`system` 目录下。