Add missing configuration macros to FreeRTOSConfig.h template#1398
Add missing configuration macros to FreeRTOSConfig.h template#1398anand16158 wants to merge 1 commit into
Conversation
| #define INCLUDE_xTaskResumeFromISR 1 | ||
| #define INCLUDE_xQueueGetMutexHolder 0 | ||
| #define INCLUDE_xSemaphoreGetMutexHolder 0 | ||
| #define INCLUDE_xTimerGetTimerDaemonTaskHandle 0 |
There was a problem hiding this comment.
I do not think that this macro is used anywhere. Other instances of macros look okay to me
Add 16 documented configuration macros that were missing from the template: configINITIAL_TICK_COUNT, configEXPECTED_IDLE_TIME_BEFORE_SLEEP, tickless idle hooks, configRECORD_STACK_HIGH_ADDRESS, configRUN_TIME_COUNTER_TYPE, configUSE_PICOLIBC_TLS, configUSE_C_RUNTIME_TLS_SUPPORT, configUSE_TASK_FPU_SUPPORT, configPRINTF, configINCLUDE_FREERTOS_TASK_C_ADDITIONS_H, and four INCLUDE_* API toggles. Refs FreeRTOS/FreeRTOS#65
AniruddhaKanhere
force-pushed
the
feature/issue-65-add-missing-config-macros
branch
from
371686f to
4b51b12
Compare
|
| /* configEXPECTED_IDLE_TIME_BEFORE_SLEEP sets the minimum number of idle ticks | ||
| * that must pass before the kernel will consider entering tickless idle mode. | ||
| * Must be >= 2. Defaults to 2 if left undefined. Only meaningful when | ||
| * configUSE_TICKLESS_IDLE is set to 1. */ |
There was a problem hiding this comment.
This comment appears incorrect. This page explains that this macro is the minimum number of ticks which must occur with all application tasks blocked for the scheduler to consider entering tickless idle mode.
There was a problem hiding this comment.
Further explanation:
When the idle task runs, FreeRTOS calculates how long the system is expected to remain idle (via prvGetExpectedIdleTime()).
If the expected idle time is greater than or equal to configEXPECTED_IDLE_TIME_BEFORE_SLEEP, the kernel will attempt to suppress ticks and enter low-power sleep (the tickless idle path).
If the expected idle time is shorter than this threshold, it's not considered worthwhile to go through the overhead of entering and exiting sleep mode, so the system just stays awake.
3 participants
Add 16 documented configuration macros to the existing `FreeRTOSConfig.h` template in `examples/template_configuration/`. These macros are supported by the kernel but were not represented in the template.
Macros added
Scheduling / Tick:
Task / Debug:
TLS / C Library:
ARM / FPU:
Misc:
INCLUDE_ API toggles:*
Context
Follows feedback from FreeRTOS/FreeRTOS#1402 (now closed) where a maintainer directed that additions to the config template should go in this repository.
Refs FreeRTOS/FreeRTOS#65
Test Steps