Merge branch 'docs/sync_psram_noinit_and_bss_description' into 'master'

docs(psram): sync psram noinit description

See merge request espressif/esp-idf!33360
This commit is contained in:
morris 2024-09-09 10:00:07 +08:00
commit 24047f9a04
4 changed files with 4 additions and 5 deletions

View File

@ -54,7 +54,7 @@ ESP-IDF fully supports the use of external RAM in applications. Once the externa
* :ref:`external_ram_config_capability_allocator`
* :ref:`external_ram_config_malloc` (default)
* :ref:`external_ram_config_bss`
:esp32: * :ref:`external_ram_config_noinit`
* :ref:`external_ram_config_noinit`
:SOC_SPIRAM_XIP_SUPPORTED: * :ref:`external_ram_config_xip`
.. _external_ram_config_memory_map:

View File

@ -42,7 +42,7 @@ Constant data may also be placed into DRAM, for example if it is used in an non-
The macro ``__NOINIT_ATTR`` can be used as attribute to place data into ``.noinit`` section. The values placed into this section will not be initialized at startup and should keep its value after software restart.
.. only:: esp32
.. only:: SOC_SPIRAM_SUPPORTED
By applying the ``EXT_RAM_NOINIT_ATTR`` macro, non-initialized value could also be placed in external RAM. To do this, the :ref:`CONFIG_SPIRAM_ALLOW_NOINIT_SEG_EXTERNAL_MEMORY` needs to be enabled. See :ref:`external_ram_config_noinit`. If the :ref:`CONFIG_SPIRAM_ALLOW_NOINIT_SEG_EXTERNAL_MEMORY` is not enabled, ``EXT_RAM_NOINIT_ATTR`` will behave just as ``__NOINIT_ATTR``, it will make data to be placed into ``.noinit`` segment in internal RAM.

View File

@ -54,7 +54,7 @@ ESP-IDF 完全支持将片外 RAM 集成到你的应用程序中。在启动并
* :ref:`external_ram_config_capability_allocator`
* :ref:`external_ram_config_malloc` (default)
* :ref:`external_ram_config_bss`
:esp32: * :ref:`external_ram_config_noinit`
* :ref:`external_ram_config_noinit`
:SOC_SPIRAM_XIP_SUPPORTED: * :ref:`external_ram_config_xip`
.. _external_ram_config_memory_map:
@ -184,7 +184,6 @@ ESP-IDF 启动过程中,片外 RAM 被映射到数据虚拟地址空间,该
启用此选项后SPI1 flash 操作期间 cache 保持启用状态,因此需要执行的代码在此期间不必放置在内部 RAM 中。由于 ESP32-P4 flash 和 PSRAM 使用两个独立的 SPI 总线,将 flash 内容移动到 PSRAM 实际上增加了 PSRAM MSPI 总线的负载,因此访问速度相对较慢。应用程序在运行过程中对 PSRAM 的使用会直接影响整体性能。因此,建议先进行性能分析以确定启用此选项是否会显著影响应用程序性能。
片外 RAM 使用限制
===================

View File

@ -42,7 +42,7 @@ DRAM数据 RAM
可以将 ``__NOINIT_ATTR`` 宏用作属性,从而将数据放入 ``.noinit`` 部分。放入该部分的值在启动时不会被初始化,在软件重启后也会保持值不变。
.. only:: esp32
.. only:: SOC_SPIRAM_SUPPORTED
通过使用 ``EXT_RAM_NOINIT_ATTR``noinit 数据也可以放入外部 RAM 中。为此,需要启用 :ref:`CONFIG_SPIRAM_ALLOW_NOINIT_SEG_EXTERNAL_MEMORY`,可参考 :ref:`external_ram_config_noinit`。如果没有启用 :ref:`CONFIG_SPIRAM_ALLOW_NOINIT_SEG_EXTERNAL_MEMORY` ``EXT_RAM_NOINIT_ATTR`` 会和 ``__NOINIT_ATTR`` 一样,将数据放入内部 RAM 的 ``.noinit`` 部分。