Thread Viewer

nRF Connect for VS Code

tags
nRF Connect for VS Code

The Thread Viewer shows information about specific threads in your application. To see the Thread Viewer, you must enable full set of debugging options in the build configuration.

nRF Debug Thread Viewer

Note

The Thread Viewer is not available when CONFIG_MULTITHREADING is disabled. For more information, see also Operation without Threads in the Zephyr documentation.

See the following table for the description of the UI element and possible actions.

UI element (column) Description Actions
State icons Current state of the thread, based on Zephyr's thread states. Hover over to read the tooltip.

If the thread state is Waiting, you can check the tooltip to see which object the thread is waiting for:
Tooltip for the waiting state with the object name and address
Clicking the icon or the object's name in the tooltip jumps to its location in the Editor.
Name Name of the thread. Hover over to reveal the address. Click to open the source code location in the Editor, if known.
Priority Priority of the thread configured by the user, based on Zephyr's thread priorities.
Stack Usage Number of bytes used by the thread and the maximum number of bytes that can be allocated to the thread. Click the Enable Tracking Enable stack usage tracking button icon button to paint the stack and enable tracking of the stack pointer and the maximum stack usage. Clicking the button again clears the maximum stack usage value and restores the default value.

Hover over the Stack Usage entries to see the information in a tooltip:
Stack Usage tracking tooltip
Entry Name of the thread entry point function in the code. Click to open the source code location in the Editor, if known.
User Options Binary value associated with the thread. The numbers in this column represent bit fields which are based on Zephyr's thread options. Colors are for readability only. Hover over to reveal a tooltip that describes the values:
Example of User Options tooltip