diff --git a/docs/en/api-reference/peripherals/spi_flash/spi_flash_optional_feature.rst b/docs/en/api-reference/peripherals/spi_flash/spi_flash_optional_feature.rst index a77d8fce95..fe5eefddf9 100644 --- a/docs/en/api-reference/peripherals/spi_flash/spi_flash_optional_feature.rst +++ b/docs/en/api-reference/peripherals/spi_flash/spi_flash_optional_feature.rst @@ -161,17 +161,23 @@ Restrictions .. 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. .. 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 `_. + + .. 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: