espressif/esp-idf
1
0
Fork 1
mirror of https://github.com/espressif/esp-idf.git synced 2025-11-04 00:51:42 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
db9d9658f9d4ca770d62c9f498e68190680d8cd0
esp-idf/components/freertos/linker_common.lf

95 lines
5.3 KiB
Plaintext
Raw Normal View History

freertos: Add linker fragments for common functions This commit adds a separate linker fragment file "linker_common.lf" for the functions in "port_common.c". The placement rules are now clearly specified inside the linker fragment file.
2022-12-01 18:29:12 +08:00
# 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
refactor(freertos): Uncrustify and format IDF addition headers - Uncrustified IDF addition related header/source files - Reorganized functions into groups - linker_common.lf updated to adhere to new function organization
2023-08-29 14:27:09 +08:00
# 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).
freertos: Add linker fragments for common functions This commit adds a separate linker fragment file "linker_common.lf" for the functions in "port_common.c". The placement rules are now clearly specified inside the linker fragment file.
2022-12-01 18:29:12 +08:00
# 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
# ------------------------------------------------------------------------------------------------------------------
if FREERTOS_PLACE_FUNCTIONS_INTO_FLASH = y:
refactor(freertos/idf): Move critical section API to IDF addition headers - The following IDF API additions are moved to freertos_tasks_c_additions.h (implementation) and freertos_idf_additions_priv.h (declaration) as APIs are private. This reduces the source code difference from upstream. - prvENTER_CRITICAL_OR_SUSPEND_ALL() - prvEXIT_CRITICAL_OR_RESUME_ALL() - prvENTER_CRITICAL_OR_MASK_ISR() - prvEXIT_CRITICAL_OR_UNMASK_ISR() - vTaskTakeKernelLock() - vTaskReleaseKernelLock() - Rename vTask[Take/Release]KernelLock() to prv[Take/Release]KernelLock() to indicate that the this API is private.
2023-08-29 02:04:51 +08:00
# Kernel Control
if FREERTOS_SMP = n && FREERTOS_UNICORE = n:
tasks:prvTakeKernelLock (default)
tasks:prvReleaseKernelLock (default)
refactor(freertos): Uncrustify and format IDF addition headers - Uncrustified IDF addition related header/source files - Reorganized functions into groups - linker_common.lf updated to adhere to new function organization
2023-08-29 14:27:09 +08:00
# Task Creation
freertos: Add linker fragments for common functions This commit adds a separate linker fragment file "linker_common.lf" for the functions in "port_common.c". The placement rules are now clearly specified inside the linker fragment file.
2022-12-01 18:29:12 +08:00
if FREERTOS_SMP = y:
tasks:xTaskCreatePinnedToCore (default)
tasks:xTaskCreateStaticPinnedToCore (default)
refactor(freertos): Uncrustify and format IDF addition headers - Uncrustified IDF addition related header/source files - Reorganized functions into groups - linker_common.lf updated to adhere to new function organization
2023-08-29 14:27:09 +08:00
# Task Utilities
freertos: Add linker fragments for common functions This commit adds a separate linker fragment file "linker_common.lf" for the functions in "port_common.c". The placement rules are now clearly specified inside the linker fragment file.
2022-12-01 18:29:12 +08:00
tasks:xTaskGetCurrentTaskHandleForCPU (default)
tasks:xTaskGetIdleTaskHandleForCPU (default)
tasks:xTaskGetAffinity (default)
tasks:prvTaskPriorityRaise (default)
tasks:prvTaskPriorityRestore (default)
refactor(freertos): Uncrustify and format IDF addition headers - Uncrustified IDF addition related header/source files - Reorganized functions into groups - linker_common.lf updated to adhere to new function organization
2023-08-29 14:27:09 +08:00
# TLSP Deletion Callbacks
if FREERTOS_TLSP_DELETION_CALLBACKS = y:
tasks:vTaskSetThreadLocalStoragePointerAndDelCallback (default)
# Task Snapshot
if FREERTOS_PLACE_SNAPSHOT_FUNS_INTO_FLASH = y:
tasks:pxGetNextTaskList (default)
tasks:pxTaskGetNext (default)
tasks:uxTaskGetSnapshotAll (default)
freertos: Add linker fragments for common functions This commit adds a separate linker fragment file "linker_common.lf" for the functions in "port_common.c". The placement rules are now clearly specified inside the linker fragment file.
2022-12-01 18:29:12 +08:00
freertos: Add wrapper functions to create objects with capabilities This commit adds various ...WithCaps() functions to create FreeRTOS objects with specific memory capabilities.
2023-04-06 22:36:58 +08:00
# ------------------------------------------------------------------------------------------------------------------
# idf_additions.c
# Placement Rules: Functions always in flash as they are never called from an ISR
# ------------------------------------------------------------------------------------------------------------------
idf_additions (default)
freertos: Add linker fragments for common functions This commit adds a separate linker fragment file "linker_common.lf" for the functions in "port_common.c". The placement rules are now clearly specified inside the linker fragment file.
2022-12-01 18:29:12 +08:00
# ------------------------------------------------------------------------------------------------------------------
# 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
freertos(IDF): Refactor port heap functions Vanilla FreeRTOS expects applications to use one of the heap implementations provided by FreeRTOS (i.e., heap_x.c), where functions such as pvPortMalloc() and vPortFree() are defined in the heap implementation. However, ESP-IDF already provides its own heap implementation (i.e., esp_heap_caps.h). Thus, the pvPortMallc()/vPortFree() functions were previously overriden by macro to call esp_heap functions directly. This commit refactors the FreeRTOS port's heap as such: - Added a heap_idf.c that implements all of the heap related functions required by FreeRTOS source - All dynamic memory allocated by FreeRTOS is from internal memory. Thus, the FreeRTOS heap is the internal memory subset of the ESP-IDF heap. - Removed some old macros to reduce diff from upstream source code.
2023-03-01 19:06:10 +08:00
# ------------------------------------------------------------------------------------------------------------------
# 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)
if FREERTOS_SMP = n:
heap_idf:xPortCheckValidTCBMem (default)
heap_idf:xPortcheckValidStackMem (default)
freertos: Add linker fragments for common functions This commit adds a separate linker fragment file "linker_common.lf" for the functions in "port_common.c". The placement rules are now clearly specified inside the linker fragment file.
2022-12-01 18:29:12 +08:00
# ------------------------------------------------------------------------------------------------------------------
# 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)
port_common:vApplicationGetTimerTaskMemory (default)
freertos: Refactor port_systick This commit refactors port_systick.c so that all ports (RISC-V vs Xtensa) of all FreeRTOS implementations (IDF vs Amazon SMP FreeRTOS) use the same set of tick interrupt functions. Thus, these funcitons are now common: - vPortSetupTimer() to setup the tick interrupt's timer - xPortSysTickHandler() that is called on each tick interrupt
2023-04-24 16:08:51 +08:00
# ------------------------------------------------------------------------------------------------------------------
# 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)
Reference in New Issue Copy Permalink