Merge branch 'doc/update_32b_addr_limit_in_flash_doc_v5.4' into 'release/v5.4'

flash: updated 32bit addr support related doc (v5.4)

See merge request espressif/esp-idf!40332
This commit is contained in:
morris
2025-07-04 10:14:18 +08:00
2 changed files with 20 additions and 8 deletions

View File

@@ -163,17 +163,23 @@ Restrictions
.. important:: .. important::
Over 16 MB space on flash mentioned above can be only used for ``data saving``, like file system. The part of flash above 16 MB can be used for data storage, for example using a file system.
Mapping data/instructions to 32-bit physical address space (so as to be accessed by the CPU) needs the support of MMU. However {IDF_TARGET_NAME} doesn't support this feature. Only ESP32-S3 and ESP32-P4 supports this up to now. Mapping data/instructions to 32-bit physical address space (so as to be accessed by the CPU) needs the support of MMU. However {IDF_TARGET_NAME} doesn't support this feature. Only ESP32-S3 and ESP32-P4 supports this up to now.
.. only:: SOC_SPI_MEM_SUPPORT_CACHE_32BIT_ADDR_MAP .. only:: SOC_SPI_MEM_SUPPORT_CACHE_32BIT_ADDR_MAP
By default, space over 16 MB on flash mentioned above can be used for ``data saving``, like file system. For Quad flash chips, by default, the part of flash above 16 MB can be used for data storage, for example using a file system.
Furthermore, to map data/instructions to 32-bit physical address space (so as to be accessed by the CPU), please enable the config ``IDF_EXPERIMENTAL_FEATURES`` and ``BOOTLOADER_CACHE_32BIT_ADDR_QUAD_FLASH``. *Experimental Feature*: To enable full support for Quad flash addresses above 16MB (for both code execution and data access), enable this experimental feature by setting below options to ``y``:
- :ref:`CONFIG_IDF_EXPERIMENTAL_FEATURES`
- :ref:`CONFIG_BOOTLOADER_CACHE_32BIT_ADDR_QUAD_FLASH`
Please note that, this option is experimental, which means that it can not be used on all flash chips stably. For more information, please contact `Espressif's business team <https://www.espressif.com/en/contact-us/sales-questions>`_. Please note that, this option is experimental, which means that it can not be used on all Quad flash chips stably. For more information, please contact `Espressif's business team <https://www.espressif.com/en/contact-us/sales-questions>`_.
.. only:: SOC_SPI_MEM_SUPPORT_OPI_MODE
For Octal flash chips, this feature is enabled by default if :ref:`CONFIG_ESPTOOLPY_OCT_FLASH` is enabled.
.. _oct-flash-doc: .. _oct-flash-doc:

View File

@@ -163,17 +163,23 @@ QSPI flash 芯片的 32 位地址支持
.. important:: .. important::
上述超过 16 MB 内存的 flash 区域只能用于 ``数据保存``,如文件系统。 上述超过 16 MB 内存的 flash 区域可用于数据存储,例如使用文件系统。
将数据或指令映射到 32 位物理地址空间(以便由 CPU 访问)需要 MMU 的支持。但 {IDF_TARGET_NAME} 并不支持此功能。目前只有 ESP32-S3 和 ESP32-P4 支持此功能。 将数据或指令映射到 32 位物理地址空间(以便由 CPU 访问)需要 MMU 的支持。但 {IDF_TARGET_NAME} 并不支持此功能。目前只有 ESP32-S3 和 ESP32-P4 支持此功能。
.. only:: SOC_SPI_MEM_SUPPORT_CACHE_32BIT_ADDR_MAP .. only:: SOC_SPI_MEM_SUPPORT_CACHE_32BIT_ADDR_MAP
默认情况下,上述超过 16 MB 内存的 flash 区域可用于 ``数据保存``,如文件系统。 默认情况下,上述超过 16 MB 内存的 flash 区域可用于数据存储,例如使用文件系统。
此外,要将数据或指令映射到 32 位物理地址空间(以便由 CPU 访问),请启用配置 ``IDF_EXPERIMENTAL_FEATURES````BOOTLOADER_CACHE_32BIT_ADDR_QUAD_FLASH`` *实验性功能*:如需在超过 16 MB 的四线 flash 区域实现完整支持(包括代码执行和数据访问),请启用以下实验性配置选项:
- :ref:`CONFIG_IDF_EXPERIMENTAL_FEATURES`
- :ref:`CONFIG_BOOTLOADER_CACHE_32BIT_ADDR_QUAD_FLASH`
请注意,此选项为实验性选项,无法在所有 flash 芯片上稳定使用详情请咨询 `乐鑫商务部 <https://www.espressif.com/zh-hans/contact-us/sales-questions>`_。 请注意,此选项为实验性功能,无法在所有四线 flash 芯片上稳定使用详情请咨询 `乐鑫商务部 <https://www.espressif.com/zh-hans/contact-us/sales-questions>`_
.. only:: SOC_SPI_MEM_SUPPORT_OPI_MODE
对于八线 flash 芯片,如果启用了 :ref:`CONFIG_ESPTOOLPY_OCT_FLASH`,则该功能默认启用。
.. _oct-flash-doc: .. _oct-flash-doc: