alex/esp-idf
alex/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2024-10-05 20:47:46 -04:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
98199d50d6
esp-idf/components/freertos/linker_common.lf

104 lines
5.9 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 05:29:12 -05: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 02:27:09 -04: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 05:29:12 -05: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-28 14:04:51 -04: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 02:27:09 -04:00
# Task Creation
refactor(freertos/idf): Move task creation "PinnedToCore" API to addition headers This commit moves/merges the IDF FreeRTOS "PinnedToCore" task creation functions from tasks.c/task.h to idf_additions.h/freertos_task_c_additions.h. Also updated FreeRTOS Mock component to provide mocks for "idf_additions.h" headers for our mock tests.
2023-08-31 10:24:06 -04:00
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 02:27:09 -04:00
# Task Utilities
feat(freertos): Add SMP kernel changes to FreeRTOS v10.5.1 This commit adds the key kernel changes to the v10.5.1 kernel to support dual-core SMP. These changes are temporarily documented in the `idf_changes.md` document. This commit... - Added changes to kernel data structures to support multiple cores - Changes to scheduling algorithm support SMP scheduling. - Changes to each FreeRTOS function to support multiple cores and SMP scheduling algorithm.
2023-09-14 12:35:31 -04:00
tasks:xTaskGetCoreID (default)
tasks:xTaskGetIdleTaskHandleForCore (default)
tasks:xTaskGetCurrentTaskHandleForCore (default)
if FREERTOS_USE_KERNEL_10_5_1 = y && FREERTOS_GENERATE_RUN_TIME_STATS = y:
tasks:ulTaskGetIdleRunTimeCounterForCore (default)
tasks:ulTaskGetIdleRunTimePercentForCore (default)
refactor(freertos/idf): Move IDF task utility functions to API addition headers This commit combines various task utility API additions in IDF FreeRTOS and with their Amazon SMP FreeRTOS addition counterparts. The folloiwng functions have been moved to freertos_tasks_c_additions.h and idf_additions.h as these API are considered public: - xTaskGetCurrentTaskHandleForCPU() - xTaskGetIdleTaskHandleForCPU() - xTaskGetAffinity() - pxTaskGetStackStart() Also fixed in missing #if macros when vTaskCoreAffinityGet() is called in Amazon SMP FreerTOS tests.
2023-08-28 14:07:52 -04:00
tasks:pxTaskGetStackStart (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 05:29:12 -05:00
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 02:27:09 -04: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 05:29:12 -05:00
refactor(freertos/idf): Move compatibility functions This function moves ulTaskNotifyTake()/xTaskNotifyWait() from IDF FreeRTOS `tasks.c` to `freertos_compatibility.c`. These functions were kept for pre-compiled library compatibilty. Move them reduces the kernel source code difference when compared to upstream FreeRTOS.
2023-08-28 11:45:46 -04:00
# ------------------------------------------------------------------------------------------------------------------
# freertos_compatibility.c
# Placement Rules: Functions always in flash as they are never called from an ISR
# ------------------------------------------------------------------------------------------------------------------
freertos_compatibility (default)
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 10:36:58 -04: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 05:29:12 -05: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 06:06:10 -05: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 05:29:12 -05: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 04:08:51 -04: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