Skip to main content

IAR Embedded Workbench for RISC-V 3.40

Trace window

In this section:

What do you want to do?

YellowStripe.png

The Trace window is available from the C-SPY driver menu.

This window displays the collected trace data.

The contents of the Tracewindow depend on the C-SPY driver you are using.

Requirements

One of these alternatives:

  • The C-SPY simulator

  • The I-jet driver and a device that supports trace

Trace toolbar

The toolbar in the Trace window contains:

Enable/Disable
activateButton.png

Enables and disables collecting and viewing trace data in this window.

Clear trace data
TraceClearButton.png

Clears the trace buffer. Both the Trace window and the Function Trace window are cleared.

Toggle source
TraceMixedModeButton.png

Toggles the Trace column between showing only disassembly or disassembly together with the corresponding source code.

Browse
TraceBrowseButtion_Mym80_01.png

Toggles browse mode on or off for a selected item in the Trace window, see Browsing through trace data.

Find
TraceFindButton_Mym80_01.png

Displays a dialog box where you can perform a search, see Find in Trace dialog box.

Save
saveButton.png

Displays a standard Save As dialog box where you can save the collected trace data to a text file, with tab-separated columns.

Edit Settings
EditSettingsButton.png

In the C-SPY simulator, this button is not enabled.

For the C-SPY I-jet driver, this button displays the Trace Settings dialog box, see Trace Settings dialog box.

Progress bar
TraceProgressBar_1.png

When a large amount of trace data has been collected, there might be a delay before all of it has been processed and can be displayed. The progress bar reflects that processing.

Display area (in the C-SPY simulator)

This area displays a collected sequence of executed machine instructions. In addition, the window can display trace data.

Trace_WinSlide_RISCV_02.png

This area contains these columns for the C-SPY simulator:

The leftmost column contains identifying icons to simplify navigation within the buffer:

EdCodeCompletionVariable.png

The yellow diamond indicates the trace execution point, marking when target execution has started.

NavigationCall_Mym80_01.png

The right green arrow indicates a call instruction.

NavigationReturn_Mym80_01.png

The left green arrow indicates a return instruction.

NavigationBookmark_Mym80_01.png

The dark green bookmark indicates a navigation bookmark.

NavigationInterrupt_Mym80_01.png

The red arrow indicates an interrupt.

NavigationSearchResult_Mym80_01.png

The violet bar indicates the results of a search.

Timestamp

The number of cycles elapsed to this point.

Trace

The collected sequence of executed machine instructions. Optionally, the corresponding source code can also be displayed.

Read Addr, Read Data, Write Addr, Write Data

These columns show reads and writes to memory.

A red-colored row indicates that the previous row and the red row are not consecutive. This means that there is a gap in the collected trace data, for example because trace data has been lost due to an overflow.

Display area (in the C-SPY I-jet driver)

This area displays a collected sequence of executed machine instructions and other trace data.

DisplayAreaI-jetTrace_01.png

This area contains these columns for the C-SPY I-jet driver:

The leftmost column contains identifying icons to simplify navigation within the buffer:

TraceExecStartPt_Mym80_01.PNG

The yellow diamond indicates the trace execution point, marking when target execution has started.

NavigationCall_Mym80_01.png

The right green arrow indicates a call instruction.

NavigationReturn_Mym80_01.png

The left green arrow indicates a return instruction.

NavigationBookmark_Mym80_01.png

The dark green bookmark indicates a navigation bookmark.

NavigationInterrupt_Mym80_01.png

The red arrow indicates an interrupt.

NavigationSearchResult_Mym80_01.png

The violet bar indicates the results of a search.

Timestamp

An internal I-jet index number.

Address

The address of the instruction associated with the trace frame.

Trace

The collected sequence of executed machine instructions. Optionally, the corresponding source code can also be displayed.

Except

The type of exception, when it occurs.

A red-colored row indicates that the previous row and the red row are not consecutive. This means that there is a gap in the collected trace data, for example because trace data has been lost due to an overflow.

Context menu

This context menu is available:

TraceWinPopupSliding_Mym80_01.png

Note

The contents of this menu are dynamic and depend on which features that your combination of software and hardware supports. However, the list of menu commands below is complete and covers all possible commands. Note that the shortcuts to the submenu commands do not use the Ctrl key.

These commands are available:

Enable

Enables and disables collecting and viewing trace data in this window.

Clear

Clears the trace buffer. Both the Trace window and the Function Trace window are cleared.

Embed source

Toggles the Trace column between showing only disassembly or disassembly together with the corresponding source code.

Browse

Toggles browse mode on or off for a selected item in the Trace window, see Browsing through trace data.

Find>Find (F)

Displays a dialog box where you can perform a search in the Trace window, see Find in Trace dialog box. The contents of the window will scroll to display the first match.

Find>Find Next (G)

Finds the next occurrence of the specified string.

Find>Find Previous (Shift+G)

Finds the previous occurrence of the specified string.

Find>Clear (Shift+F)

Removes all search highlighting in the window.

Find All

Displays a dialog box where you can perform a search in the Trace window, see Find in Trace dialog box. The search results are displayed in the Find in Trace window—available by choosing the View>Messages command, see Find in Trace window.

Navigate>After Current Loop (L)

Identifies the selected program counter and scans the trace data forward, collecting program counters, until it finds the same address again. It has now detected a loop. (Loops longer than 1000 instructions are not detected.) Then it navigates forward until it finds a program counter that is not part of the collected set. This is useful for navigating out of many iterations of an idle or polling loop.

Navigate>Before Current Loop (Shift+L)

Behaves as After Current Loop, but navigates backward out of the loop.

Navigate>After Current Function (U)

Navigates to the next unmatched return instruction. This is similar to stepping out of the current function.

Navigate>Before Current Function (Shift+U)

Navigates to the closest previous unmatched call instruction.

Navigate>Next Statement (S)

Navigates to the next instruction that belongs to a different C statement than the starting point. It skips function calls, i.e. it tries to reach the next statement in the starting frame.

Navigate>Previous Statement (Shift+S)

Behaves as Next statement, but navigates backward to the closest previous different C statement.

Navigate>Next on Same Address (A)

Navigates to the next instance of the starting program counter address, typically to the next iteration of a loop.

Navigate>Previous on Same Address (Shift+A)

Navigates to the closest previous instance of the starting program counter address.

Navigate>Next Interrupt (I)

Navigates to the next interrupt entry. (To then find the matching interrupt exit, follow up with After Current Function.)

Navigate>Previous Interrupt (Shift+I)

Navigates to the closest previous interrupt entry.

Navigate>Next Execution Start Point (E)

Navigates to the next point where the CPU was started, for example places where the application stopped at breakpoints, or was stepped.

Navigate>Previous Execution Start Point (Shift+E)

Navigates to the closest previous point where the CPU was started.

Navigate>Next Discontinuity (D)

Navigates to the next discontinuity in the trace data.

Navigate>Previous Discontinuity (Shift+D)

Navigates to the closest previous discontinuity in the trace data.

Bookmarks>Toggle (+)

Adds a new navigation bookmark or removes an existing bookmark.

Bookmarks>Goto Next (B)

Navigates to the next navigation bookmark.

Bookmarks>Goto Previous (Shift+B)

Navigates to the closest previous navigation bookmark.

Bookmarks>Clear All

Removes all navigation bookmarks.

Bookmarks>location (0–9)

At the bottom of the submenu, the ten most recently defined bookmarks are listed, with a shortcut key each from 0–9.

Timestamp>Set as Zero Point (Z)

Sets the selected row as a reference “zero” point in the collected sequence of trace data. The count of rows in the Trace window will show this row as 0 and recalculate the timestamps of all other rows in relation to this timestamp.

Timestamp>Go to Zero Point (Shift+Z)

Navigates to the reference “zero” point in the collected sequence of trace data (if you have set one).

Timestamp>Clear Zero Point

Removes the reference “zero” point from the trace data and restores the original timestamps of all rows.

Save

Displays a standard Save As dialog box where you can save the collected trace data to a text file, with tab-separated columns.