Intel® System Debugger User Guide

ID Date Version Classification
648476 10/17/2024 Confidential
Document Table of Contents

Run Control

The first step in debugging with the Intel(R) System Debugger is controlling the execution of the target. Similar to any other software debugger, you can run, stop, and reset the target. When the target is stopped, you can perform various debugging operations at both assembly and source levels.

Details about the target, the connection method, and the connection status are displayed in the ISD Shell.

To control the target, select the desired hardware thread in the Debug view and use the following buttons in the toolbar or the Run menu:

Icon

Name

Action

Location

Enabling Condition

suspend

Suspend

Halts execution of the selected thread in a debug target.

Main toolbar, Run menu, and Debug view.

Enabled when the target is running and any hardware thread is selected in the Debug view under the debug configuration.

resume

Resume

Resumes execution of the currently suspended debug target.

Main toolbar, Run menu, and Debug view.

Enabled when the target is halted and any hardware thread is selected in the Debug view under the debug configuration.

terminate

Terminate

Ends the selected debug session or process.

Main toolbar, Run menu, and Debug view.

Enabled when the debug session or process is selected.

reset

Reset

Does a warm reset of the target.

Main toolbar.

Visible only when the debugger is launched. Enabled when a show_target_breakpoints CPU or thread_instance_suspended thread is selected in the Debug view.

power-cycle

Power-cycle

Does a target power-cycle using the Power-Good reset type.

Main toolbar, under reset drop-down.

Visible only when the debugger is launched. Enabled when a show_target_breakpoints CPU or thread_instance_suspended thread is selected in the Debug view.

load_this

Load the Current Module (formerly named Load This)

Loads debug information for the selected module. For more details, see Loading Debug Information.

Main toolbar.

Enabled when a thread_instance_suspended thread or a stack_frame_instance stack frame is selected in the Debug view.

find_bsp

Bootstrap Processor (BSP)

Searches for the BSP in all hardware threads. The BSP thread can subsequently be selected or filtered in the Debug view.

Run menu.

Enabled when the target is halted and any hardware thread is selected in the Debug view under the debug configuration.

step_into

Step Into

Executes the current line, including any routines, and proceeds to the next statement.

Main toolbar, Run menu, and Debug view.

Enabled when a stack_frame_instance call stack is selected in the Debug view.

step_over

Step Over

Executes the current line, following execution inside a routine. Check instructions on running multiple steps in a row below.

Main toolbar, Run menu, and Debug view.

Enabled when a stack_frame_instance call stack is selected in the Debug view.

step_return

Step Return

Continues execution to the end of the current routine, then follows execution to the caller of the routine.

Main toolbar, Run menu, and Debug view.

Enabled when a stack_frame_instance call stack is selected in the Debug view.

You can also execute multiple steps in a row with a scripting solution.

For solutions on fixing target run control issues, refer to the Troubleshooting section.