Understanding FreeRTOS Task Stack Usage and Kernel Awareness Information

When using the FreeRTOS Task List in the Eclipse based MCUXpresso IDE, it shows the list of tasks with their stack size used. But with the default FreeRTOS settings it is not able to determine the correct stack size and shows a warning icon:

Warning for Stack Usage

Warning for Stack Usage

The warning should tell me that the information shown about the stack size is wrong: I did create the App Task with 110 stack units (each 4 bytes) so it should show 440 bytes, but it shows only 308 bytes.

Why is that? The reason is that the debugger (or FreeRTOS Kernel Awareness in Eclipse) does not know the total size of the memory allocated for the task.

On ARM Cortex the stack is growing from the higher to the lower addresses, as shown in the image below:

FreeRTOS Task Stack Layout

FreeRTOS Task Stack Layout

What FreeRTOS stores in its TCB (Task Control Block, the descriptor of the task) is the pxTopOfStack (current task stack pointer, ‘Stack Top‘ in the Kernel Awareness view) and pxStack (the end of the stack, ‘Stack Base‘ in the Kernel Awareness view). The beginning of the task stack is not stored in the TCB as not necessary for the Kernel.

The ‘Stack High Water Mark’ is something very useful: FreeRTOS fills the stack space at task creation time with a 0x5a byte pattern. The debugger or the RTOS can find out that way the ‘high water mark’ for each task.

The solution is to add the following macro to the FreeRTOSConfig.h file:


With this turned on, FreeRTOS stores an extra pointer pxEndOfStack in each Task TCB:

FreeRTOS Task Stack Information with configRECORD_STACK_HIGH_ADDRESS

FreeRTOS Task Stack Information with configRECORD_STACK_HIGH_ADDRESS

Below such a TCB in the Global Variables View in Eclipse (MCUXpresso IDE):

Stack Information in FreeRTOS TCB

Stack Information of FreeRTOS TCB

With this, the debugger or FreeRTOS Task Awareness knows the real size of the stack and can show the correct information:

FreeRTOS Stack Size

FreeRTOS Stack Size

Actually it is still showing 432 Bytes and 440, because it does not count the first and last entry on the stack.

The image below should help you understand the information provided:

  • Blue: at the bottom there is the currently used stack, the stack is growing upwards here (from the higher to the lower addresses)
  • Orange: Used stack so far (high water mark) as it has overwritten the 0xA5 pattern
  • Yellow: not used stack space so far with the 0xA5 pattern
FreeRTOS Stack Memory

FreeRTOS Stack Memory

Of course there is a reason for FreeRTOS not to store that pxEndOfStack by default: it is not needed by the Kernel. So enabling configRECORD_STACK_HIGH_ADDRESS will need 4 more bytes of RAM for each task plus a few code bytes to set that value. But for debugging purposes and this is very well spent.

Happy Stacking 🙂



5 thoughts on “Understanding FreeRTOS Task Stack Usage and Kernel Awareness Information

  1. Thanks fort this article Eric.

    I am just wondering if FreeRTOS Kernel Awareness can be installed as a stand-alone add-on for native Eclipse (so for version without MCUExpresso base) ?


  2. Pingback: Tutorial: Understanding and Using FreeRTOS Software Timers | MCU on Eclipse

What do you think?

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.