esp-idf/docs/zh_CN/migration-guides/release-5.x/5.1/system.rst

38 lines
2.2 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

系统
======
:link_to_translation:`en:[英文]`
FreeRTOS
--------
.. only:: SOC_SPIRAM_SUPPORTED
动态内存分配
^^^^^^^^^^^^^^^^^^^^^^^^^
过去FreeRTOS 通常使用 ``malloc()`` 函数来分配动态内存。因此,如果应用程序允许 ``malloc()`` 从外部 RAM 分配内存(通过将 :ref:`CONFIG_SPIRAM_USE` 选项配置为 ``CONFIG_SPIRAM_USE_MALLOC``FreeRTOS 就有可能从外部 RAM 分配动态内存,并且具体位置由堆分配器确定。
.. note::
任务的动态内存分配通常占用大部分内存与上述介绍的情况不同是种例外情况。FreeRTOS 会使用单独的内存分配函数,确保为任务分配的动态内存始终位于内部 RAM 中。
允许将 FreeRTOS 对象(如队列和信号量)放置在外部 RAM 中可能会出现问题,例如如果在访问这些对象时 cache 被禁用(如在 SPI flash 写入操作期间),则会导致 cache 访问错误(详细信息请参阅 :doc:`严重错误</api-guides/fatal-errors>`)。
因此FreeRTOS 已经更新为始终使用内部内存(即 DRAM进行动态内存分配。调用 FreeRTOS 创建函数(例如 :cpp:func:`xTaskCreate` 或 :cpp:func:`xQueueCreate` )将保证为这些任务/对象分配的内存来自内部内存(详细信息请参阅 :ref:`freertos-heap`)。
.. warning::
如果你之前使用 :ref:`CONFIG_SPIRAM_USE` 将 FreeRTOS 对象放置在外部内存中,这个更改则会导致内部内存的使用增加,因为现在 FreeRTOS 对象将被分配到内部内存中。
现在将 FreeRTOS 任务/对象放置在外部内存中,需要显示地设置,可采用以下方法之一:
- 使用 ``...CreateWithCaps()`` API 函数如 :cpp:func:`xTaskCreateWithCaps` 或 :cpp:func:`xQueueCreateWithCaps` 分配任务/对象到外部内存(详情请参阅 :ref:`freertos-idf-additional-api`)。
- 使用 :cpp:func:`heap_caps_malloc` 为 FreeRTOS 对象手动分配外部内存,然后使用 ``...CreateStatic()`` FreeRTOS 函数从分配的内存中创建对象。
电源管理
----------
* ``esp_pm_config_esp32xx_t`` 已被弃用,应使用 ``esp_pm_config_t`` 替代。
* ``esp32xx/pm.h`` 已被弃用,应使用 ``esp_pm.h`` 替代。