From 674ad565f87342111c82da6e60beb974f7fbd3c7 Mon Sep 17 00:00:00 2001 From: renpeiying Date: Fri, 21 Mar 2025 10:41:08 +0800 Subject: [PATCH] docs: Update CN translation for 2 api files --- docs/zh_CN/api-guides/partition-tables.rst | 1 + docs/zh_CN/api-reference/storage/nvs_flash.rst | 8 ++++++++ 2 files changed, 9 insertions(+) diff --git a/docs/zh_CN/api-guides/partition-tables.rst b/docs/zh_CN/api-guides/partition-tables.rst index 58090c5f94..7b6b620d75 100644 --- a/docs/zh_CN/api-guides/partition-tables.rst +++ b/docs/zh_CN/api-guides/partition-tables.rst @@ -176,6 +176,7 @@ SubType 字段长度为 8 bit，内容与具体分区 Type 有关。目前，ESP - NVS API 还可以用于其他应用程序数据。 - 强烈建议为 NVS 分区分配至少 0x3000 字节空间。 - 如果使用 NVS API 存储大量数据，请增加 NVS 分区的大小（默认是 0x6000 字节）。 + - 当 NVS 用于存储出厂设置时，建议将这些设置保存在单独的只读 NVS 分区中。只读 NVS 分区最小为 0x1000 字节。有关更多详情，请参阅 :ref:`read-only-nvs` 了解详情。ESP-IDF 提供了 :doc:`NVS 分区生成工具 `，能够生成包含出厂设置的 NVS 分区，并与应用程序一起烧录。 - ``nvs_keys`` (4) 是 NVS 秘钥分区。详细信息，请参考 :doc:`非易失性存储 (NVS) API <../api-reference/storage/nvs_flash>` 文档。 - 用于存储加密密钥（如果启用了 `NVS 加密` 功能）。 diff --git a/docs/zh_CN/api-reference/storage/nvs_flash.rst b/docs/zh_CN/api-reference/storage/nvs_flash.rst index 59d131cf51..2282bf611d 100644 --- a/docs/zh_CN/api-reference/storage/nvs_flash.rst +++ b/docs/zh_CN/api-reference/storage/nvs_flash.rst @@ -369,6 +369,14 @@ CRC32 哈希列表中每个节点均包含一个 24 位哈希值和 8 位条目索引。哈希值根据条目命名空间、键名和块索引由 CRC32 计算所得，计算结果保留 24 位。为减少将 32 位条目存储在链表中的开销，链表采用了数组的双向链表。每个数组占用 128 个字节，包含 29 个条目、两个链表指针和一个 32 位计数字段。因此，每页额外需要的 RAM 最少为 128 字节，最多为 640 字节。 +.. _read-only-nvs: + +只读 NVS +^^^^^^^^ + +NVS 正常运行所需的最小大小默认为 12kiB (``0x3000``)，这意味着至少需要 3 个页面，其中一个页面必须处于 Empty 状态。但是，如果 NVS 分区在分区表 CSV 中标记为 ``readonly`` 并以只读 (read-only) 模式打开，则该分区大小最少只需 4kiB（``0x1000``），此时仅需一个 Active 状态的页面，无需 Empty 页面。因为在这种情况下，库无需向分区写入任何数据。此类型分区适用于存储不会更改的数据，如校准数据或出厂设置。大小为 0x1000 和 0x2000 的分区始终为只读分区。大小为 0x3000 及以上的分区始终支持读写 (read-write)，但仍可以在代码中以只读模式打开。 + + API 参考 -------------