Skip to main content

IAR Embedded Workbench for Arm 9.70.x

Disassembly window

In this section:

What do you want to do?

YellowStripe.png

The C-SPY Disassembly window is available from the View menu.

DisassemblyWin_2_ARM.png

This window shows the application being debugged as disassembled application code.

To change the default color of the source code in the Disassembly window:

  1. Choose Tools>Options>Debugger.

  2. Set the default color using the Source code color in disassembly window option.

    Tip

    To view the corresponding assembler code for a function, you can select it in the editor window and drag it to the Disassembly window.

Requirements

Can be used with all C-SPY debugger drivers and debug probes.

Toolbar

The toolbar contains:

Go to

The memory location or symbol you want to view.

Zone

Selects a memory zone, see C-SPY memory zones.

Toggle Mixed-Mode

Toggles between displaying only disassembled code or disassembled code together with the corresponding source code. Source code requires that the corresponding source file has been compiled with debug information.

Display area

The display area shows the disassembled application code. This area contains these graphic elements:

Green highlight color

Indicates the current position, that is the next assembler instruction to be executed. To move the cursor to any line in the Disassembly window, click the line. Alternatively, move the cursor using the navigation keys.

Yellow highlight color

Indicates a position other than the current position, such as when navigating between frames in the Call Stack window or between items in the Trace window.

Red dot

Indicates a breakpoint. Double-click in the gray left-side margin of the window to set a breakpoint. For more information, see Breakpoints.

Green diamond

Code coverage icon—indicates code that has been executed.

Red diamond

Code coverage icon—indicates code that has not been executed.

Red/yellow diamond (red top/yellow bottom)

Code coverage icon—indicates a branch that is never taken.

Red/yellow diamond (red left side/yellow right side)

Code coverage icon—indicates a branch that is always taken.

If instruction profiling has been enabled from the context menu, an extra column in the left-side margin appears with information about how many times each instruction has been executed. For debug probes that support it, C-SPY can capture full instruction trace in real time.

Context menu

This context menu is available:

DisassemblyWinPopup_Mym_03.png

Note

The contents of this menu are dynamic, which means that the commands on the menu might depend on your product package.

These commands are available:

Move to PC

Displays code at the current program counter location.

Run to Cursor

Executes the application from the current position up to the line containing the cursor.

Code Coverage

Displays a submenu that provides commands for controlling code coverage. This command is only enabled if the driver you are using supports it.

Enable

Toggles code coverage on or off.

Show

Toggles the display of code coverage on or off. Code coverage is indicated by a red, green, and red/yellow diamonds in the left margin.

Clear

Clears all code coverage information.

Next Different Coverage >

Moves the insertion point to the next line in the window with a different code coverage status than the selected line.

Previous Different Coverage <

Moves the insertion point to the closest preceding line in the window with a different code coverage status than the selected line.

Instruction Profiling

Displays a submenu that provides commands for controlling instruction profiling. This command is only enabled if the driver you are using supports it.

Enable

Toggles instruction profiling on or off.

Show

Toggles the display of instruction profiling on or off. For each instruction, the left-side margin displays how many times the instruction has been executed.

Clear

Clears all instruction profiling information.

Toggle Breakpoint (Code)

Toggles a code breakpoint. Assembler instructions and any corresponding label at which code breakpoints have been set are highlighted in red. For more information, see Code breakpoints dialog box.

Toggle Breakpoint (Log)

Toggles a log breakpoint for trace printouts. Assembler instructions at which log breakpoints have been set are highlighted in red. For more information, see Log breakpoints dialog box.

Toggle Breakpoint (Trace Start)

Toggles a Trace Start breakpoint. When the breakpoint is triggered, the trace data collection starts. Note that this menu command is only available if the C-SPY driver you are using supports trace. For more information, see Trace Start Trigger breakpoint dialog box.

Toggle Breakpoint (Trace Stop)

Toggles a Trace Stop breakpoint. When the breakpoint is triggered, the trace data collection stops. Note that this menu command is only available if the C-SPY driver you are using supports trace. For more information, see Trace Stop Trigger breakpoint dialog box.

Enable/Disable Breakpoint

Enables and Disables a breakpoint. If there is more than one breakpoint at a specific line, all those breakpoints are affected by the Enable/Disable command.

Edit Breakpoint

Displays the breakpoint dialog box to let you edit the currently selected breakpoint. If there is more than one breakpoint on the selected line, a submenu is displayed that lists all available breakpoints on that line.

Set Next Statement

Sets the program counter to the address of the instruction at the insertion point.

Copy Window Contents

Copies the selected contents of the Disassembly window to the clipboard.

Mixed-Mode

Toggles between showing only disassembled code or disassembled code together with the corresponding source code. Source code requires that the corresponding source file has been compiled with debug information.

Find in Trace

Searches the contents of the Trace window for occurrences of the given location—the position of the insertion point in the source code—and reports the result in the Find in Trace window. This menu command requires support for Trace in the C-SPY driver you are using, see Differences between the C-SPY drivers.

Zone

Selects a memory zone, see C-SPY memory zones.