Skip to content

Add missing configuration macros to FreeRTOSConfig.h template#1398

Open
anand16158 wants to merge 1 commit intoFreeRTOS:mainfrom
anand16158:feature/issue-65-add-missing-config-macros
Open

Add missing configuration macros to FreeRTOSConfig.h template#1398
anand16158 wants to merge 1 commit intoFreeRTOS:mainfrom
anand16158:feature/issue-65-add-missing-config-macros

Conversation

@anand16158
Copy link
Copy Markdown

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:

  • `configINITIAL_TICK_COUNT` - initial tick counter value (useful for overflow testing)
  • `configEXPECTED_IDLE_TIME_BEFORE_SLEEP` - minimum idle ticks for tickless mode
  • `configPRE_SUPPRESS_TICKS_AND_SLEEP_PROCESSING` (commented)
  • `configPRE_SLEEP_PROCESSING` / `configPOST_SLEEP_PROCESSING` (commented)
    Task / Debug:
  • `configRECORD_STACK_HIGH_ADDRESS` - debugger backtrace support
  • `configRUN_TIME_COUNTER_TYPE` - run-time stats counter type
  • `configPRINTF` - application printf wrapper (commented)
    TLS / C Library:
  • `configUSE_PICOLIBC_TLS` - picolibc TLS integration
  • `configUSE_C_RUNTIME_TLS_SUPPORT` - generic C runtime TLS
    ARM / FPU:
  • `configUSE_TASK_FPU_SUPPORT` - per-task FPU context management
    Misc:
  • `configINCLUDE_FREERTOS_TASK_C_ADDITIONS_H`
    INCLUDE_ API toggles:*
  • `INCLUDE_uxTaskGetStackHighWaterMark2`
  • `INCLUDE_xQueueGetMutexHolder`
  • `INCLUDE_xSemaphoreGetMutexHolder`
  • `INCLUDE_xTimerGetTimerDaemonTaskHandle`

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

  1. Copy the updated template to a demo project as `FreeRTOSConfig.h`.
  2. Build for a 32-bit target (e.g. Posix_GCC or Cortex-M) — no new compiler errors or warnings.
  3. Verify all newly added macros are set to safe defaults (0 or commented out)."

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
@sonarqubecloud
Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant