doc(flash): updated 32bit addr support doc

This commit is contained in:
armando
2025-07-02 10:20:00 +08:00
parent e3eeb9d79c
commit f2629ca384

View File

@@ -161,17 +161,23 @@ Restrictions
.. important:: .. important::
Over 16 MBytes 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 MBytes 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 it can not be used on all flash chips stably. For more information, please contact Espressif Business Support. 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: