Chapter 2. API Reference
• abort() on failed assertions (FREERTOS_ASSERT_FAIL_ABORT)
If a FreeRTOS configASSERT() fails, FreeRTOS will abort() and halt execution. The panic
handler can be configured to handle the outcome of an abort() in different ways.
If assertions are disabled for the entire project, they are also disabled in FreeRTOS and this
option is unavailable.
• Print and continue failed assertions (FREERTOS_ASSERT_FAIL_PRINT_CONTINUE)
If a FreeRTOS assertion fails, print it out and continue.
• Disable FreeRTOS assertions (FREERTOS_ASSERT_DISABLE)
FreeRTOS configASSERT() will not be compiled into the binary.
CONFIG_FREERTOS_IDLE_TASK_STACKSIZE
Idle Task stack size
Found in: Component config > FreeRTOS
The idle task has its own stack, sized in bytes. The default size is enough for most uses. Size can
be reduced to 768 bytes if no (or simple) FreeRTOS idle hooks are used and pthread local storage or
FreeRTOS local storage cleanup callbacks are not used.
The stack size may need to be increased above the default if the app installs idle or thread local storage
cleanup hooks that use a lot of stack memory.
Range:
• from 768 to 32768
Default value:
• 1536
CONFIG_FREERTOS_ISR_STACKSIZE
ISR stack size
Found in: Component config > FreeRTOS
The interrupt handlers have their own stack. The size of the stack can be defined here. Each processor
has its own stack, so the total size occupied will be twice this.
Range:
• from 2096 to 32768 if ESP_COREDUMP_DATA_FORMAT_ELF
• from 1536 to 32768
Default value:
• 2096 if ESP_COREDUMP_DATA_FORMAT_ELF
• 1536
CONFIG_FREERTOS_LEGACY_HOOKS
Use FreeRTOS legacy hooks
Found in: Component config > FreeRTOS
FreeRTOS offers a number of hooks/callback functions that are called when a timer tick hap-
pens, the idle thread runs etc. esp-idf replaces these by runtime registerable hooks using the
esp_register_freertos_xxx_hook system, but for legacy reasons the old hooks can also still be en-
abled. Please enable this only if you have code that for some reason can’t be migrated to the
esp_register_freertos_xxx_hook system.
Default value:
• No (disabled)
Espressif Systems 1149
Submit Document Feedback
Release v4.4