espressif/esp-idf
1
0
Fork 1
mirror of https://github.com/espressif/esp-idf.git synced 2025-08-04 13:14:32 +02:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source 
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
parent 963fc9228e 42123b3115
commit 58ddea7946
2 changed files with 20 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/en/api-reference/peripherals/spi_flash/spi_flash_optional_feature.rst
View File

@@ -163,17 +163,23 @@ Restrictions
.. 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.
.. 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:

14
docs/zh_CN/api-reference/peripherals/spi_flash/spi_flash_optional_feature.rst
View File

@@ -163,17 +163,23 @@ QSPI flash 芯片的 32 位地址支持
.. important::
上述超过 16 MB 内存的 flash 区域只能用于 ``数据保存``，如文件系统。
上述超过 16 MB 内存的 flash 区域可用于数据存储，例如使用文件系统。
将数据或指令映射到 32 位物理地址空间（以便由 CPU 访问）需要 MMU 的支持。但 {IDF_TARGET_NAME} 并不支持此功能。目前只有 ESP32-S3 和 ESP32-P4 支持此功能。
.. 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: