You copied the Doc URL to your clipboard.

About debugging FreeRTOS ™

FreeRTOS is an open-source real-time operating system.

DS-5™ Debugger provides the following support for debugging FreeRTOS:

  • Supports FreeRTOS on Cortex-M cores.
  • View FreeRTOS tasks in the Debug Control view.
  • View FreeRTOS tasks and queues in the RTOS Data view.

To enable FreeRTOS support in DS-5 Debugger, in the Debug Configuration dialog, select FreeRTOS in the OS tab. Debugger support is activated when FreeRTOS is initialized on the target device.


Operating system support in the debugger is activated only when OS-specific debug symbols are loaded. Ensure that the debug symbols for the operating system are loaded before using any of the OS-specific views and commands.

When building your FreeRTOS image, ensure that the following compiler flags are set:

  • -DINCLUDE_xTaskGetIdleTaskHandle
  • -DconfigQUEUE_REGISTRY_SIZE=n (where n >= 1)

If these flags are set incorrectly, FreeRTOS support might fail to activate in DS-5 Debugger. See the documentation supplied with FreeRTOS to view the details of these flags.