mirror of
https://github.com/espressif/esp-idf.git
synced 2025-08-09 04:25:32 +00:00
71a79ac0b1
This commit adds a new Kconfig option, viz., CONFIG_FREERTOS_PLACE_ISR_FUNCTIONS_INTO_FLASH, which places additional FreeRTOS functions, such as those which can be called from and ISR context, into Flash memory. This feature utilizes the Flash auto suspend/resume feature of the Flash chip.
126 lines
7.0 KiB
Plaintext
126 lines
7.0 KiB
Plaintext
# Linker fragment file for common FreeRTOS files (i.e., both "port_common.c" and "esp_additions/..."
|
|
# Flash function placements are listed per source file, in the order that they appear in the source file.
|
|
|
|
[mapping:freertos_common]
|
|
archive: libfreertos.a
|
|
entries:
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
# esp_additions/private_include/freertos_tasks_c_additions.h
|
|
# Placement Rules (FreeRTOS API Additions):
|
|
# - Default: Place all functions in internal RAM.
|
|
# - CONFIG_FREERTOS_PLACE_FUNCTIONS_INTO_FLASH: Place functions in flash if they are never called from an ISR
|
|
# context (directly or indirectly).
|
|
# - xTaskIncrementTickOtherCores is always placed in internal RAM for better performance
|
|
# Placement Rules (Task Snapshot):
|
|
# - Default: Place all functions in internal RAM.
|
|
# - CONFIG_FREERTOS_PLACE_SNAPSHOT_FUNS_INTO_FLASH: Place functions in flash
|
|
# - vTaskGetSnapshot is omitted on purpose as it is used to by the Task Watchdog (TWDT) interrupt handler, we want
|
|
# to always keep it in IRAM unless CONFIG_FREERTOS_PLACE_ISR_FUNCTIONS_INTO_FLASH is enabled in which case
|
|
# we can place it in flash.
|
|
#
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
if FREERTOS_PLACE_FUNCTIONS_INTO_FLASH = y:
|
|
# Kernel Control
|
|
if FREERTOS_SMP = n && FREERTOS_UNICORE = n:
|
|
tasks:prvTakeKernelLock (default)
|
|
tasks:prvReleaseKernelLock (default)
|
|
# Task Creation
|
|
tasks:xTaskCreatePinnedToCore (default)
|
|
tasks:xTaskCreateStaticPinnedToCore (default)
|
|
# Task Utilities
|
|
tasks:xTaskGetCoreID (default)
|
|
tasks:xTaskGetIdleTaskHandleForCore (default)
|
|
tasks:xTaskGetCurrentTaskHandleForCore (default)
|
|
if FREERTOS_SMP = n && FREERTOS_GENERATE_RUN_TIME_STATS = y:
|
|
tasks:ulTaskGetIdleRunTimeCounterForCore (default)
|
|
tasks:ulTaskGetIdleRunTimePercentForCore (default)
|
|
tasks:pxTaskGetStackStart (default)
|
|
tasks:prvTaskPriorityRaise (default)
|
|
tasks:prvTaskPriorityRestore (default)
|
|
# TLSP Deletion Callbacks
|
|
if FREERTOS_TLSP_DELETION_CALLBACKS = y:
|
|
tasks:vTaskSetThreadLocalStoragePointerAndDelCallback (default)
|
|
# Newlib re-entrancy
|
|
tasks:__getreent (default)
|
|
# Miscellaneous
|
|
tasks:pvTaskGetCurrentTCBForCore (default)
|
|
if SPIRAM = y:
|
|
# PSRAM
|
|
tasks:prvTaskCreateDynamicPinnedToCoreWithCaps (default)
|
|
# Task Snapshot
|
|
if FREERTOS_PLACE_SNAPSHOT_FUNS_INTO_FLASH = y:
|
|
tasks:pxGetTaskListByIndex (default)
|
|
tasks:xTaskGetNext (default)
|
|
tasks:uxTaskGetSnapshotAll (default)
|
|
if FREERTOS_PLACE_ISR_FUNCTIONS_INTO_FLASH = y:
|
|
tasks:vTaskGetSnapshot (default)
|
|
|
|
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
# freertos_compatibility.c
|
|
# Placement Rules: Functions always in flash as they are never called from an ISR
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
freertos_compatibility (default)
|
|
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
# idf_additions.c
|
|
# Placement Rules: Functions always in flash as they are never called from an ISR
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
idf_additions (default)
|
|
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
# idf_additions_event_groups.c
|
|
# Placement Rules: Functions always in flash as they are never called from an ISR
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
idf_additions_event_groups (default)
|
|
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
# app_startup.c
|
|
# Placement Rules: Functions always in flash as they are never called from an ISR
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
app_startup (default) # Place functions (but not Data and BSS) to flash
|
|
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
# heap_idf.c
|
|
# Placement Rules:
|
|
# - Default: Place all functions in internal RAM.
|
|
# - CONFIG_FREERTOS_PLACE_FUNCTIONS_INTO_FLASH: Place functions in flash if they are never called from an ISR
|
|
# context (directly or indirectly).
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
heap_idf (noflash_text) # Default all functions to internal RAM
|
|
if FREERTOS_PLACE_FUNCTIONS_INTO_FLASH = y:
|
|
heap_idf:pvPortMalloc (default)
|
|
heap_idf:vPortFree (default)
|
|
heap_idf:xPortGetFreeHeapSize (default)
|
|
heap_idf:xPortGetMinimumEverFreeHeapSize (default)
|
|
heap_idf:xPortCheckValidListMem (default)
|
|
if FREERTOS_SMP = n:
|
|
heap_idf:xPortCheckValidTCBMem (default)
|
|
heap_idf:xPortcheckValidStackMem (default)
|
|
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
# port_common.c
|
|
# Placement Rules:
|
|
# - Default: Place all functions in internal RAM.
|
|
# - CONFIG_FREERTOS_PLACE_FUNCTIONS_INTO_FLASH: Place functions in flash if they are never called from an ISR
|
|
# context (directly or indirectly).
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
port_common (noflash_text) # Default all functions to internal RAM
|
|
if FREERTOS_PLACE_FUNCTIONS_INTO_FLASH = y:
|
|
port_common:vApplicationGetIdleTaskMemory (default)
|
|
if FREERTOS_SMP = y && FREERTOS_UNICORE = n:
|
|
port_common:vApplicationGetPassiveIdleTaskMemory (default)
|
|
port_common:vApplicationGetTimerTaskMemory (default)
|
|
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
# port_systick.c
|
|
# - Default: Place all functions in internal RAM.
|
|
# - CONFIG_FREERTOS_PLACE_FUNCTIONS_INTO_FLASH: Place functions in flash if they are never called from an ISR
|
|
# context (directly or indirectly).
|
|
# ------------------------------------------------------------------------------------------------------------------
|
|
port_systick(noflash_text)
|
|
if FREERTOS_PLACE_FUNCTIONS_INTO_FLASH = y:
|
|
if FREERTOS_SYSTICK_USES_SYSTIMER = y:
|
|
port_systick:vSystimerSetup (default)
|
|
port_systick:vPortSetupTimer (default)
|