µVision4 User's Guide

Technical Support

On-Line Manuals

µVision4 User's Guide

About µVision User Interface Creating Applications Utilities Debugging Using the Debugger Simulation Start Debugging Application Program Execution Debug Windows and Dialogs Breakpoints Window Call Stack and Locals Window Code Coverage Command Window Disassembly Window Event Viewer Execution Profiler Instruction Trace Window Logic Analyzer Setup Setup in Detail Restrictions Using the Logic Analyzer Memory Map Memory Window Performance Analyzer Registers Window Serial Window Symbols Window System Viewer Adding System Viewer Windows Toolbox Trace Data Window Trace Navigation Watch Window Expressions Constants System Variables Peripheral Variables I/O Ports Serial Ports Program Variables (Symbols) Fully Qualified Symbols Non-Qualified Symbols Literal Symbols Using Symbols Line Numbers Bit Addresses Type Specifications Operators Memory Type Specifiers Differences Between µVision4 and C Expression Examples Tips and Tricks Review Peripherals and CPU Configuration Simulate I/O Ports Simulate Interrupts and Clock Inputs Simulate external I/O Devices Assign Serial I/O to a PC COM Port Check Illegal Memory Access Command Input from File Preset I/O Ports or Memory Contents Write Debug Output to a File Keyboard Shortcuts TPIU Initialization after RESET (Cortex-M) Debug Commands Debug Functions Simulation Flash Programming Dialogs Example Programs Command Line Appendix

Trace Data Window

The Trace Data Window shows the history of executed instructions for Cortex-M devices.

Instruction Trace buttonOpen the window from the toolbar or with the menu View – Trace - Trace Data. Enable the flag View – Trace - Enable Trace Recording when using the Simulator.

Trace Data Window

Column Description

Column NameDescription
Nr.Shows the current table row number. The value is limited to 32k for the Simulator.
TimeShows the timestamp of the record. This column can also show the time difference of a record relative to a Time Reference record. Use Set Time Reference of the Context menu to specify the record. Then, the column can contain additional characters:
  • 0.000 000 000 s - Indicates the record to which the Time Reference has been set.
  • - - Indicates the time difference of an instruction that was executed ahead of the Time Reference instruction.
  • + - Indicates the time difference of an instruction that was executed after the Time Reference instruction.
AddressShows the instruction address.
OpcodeShows the operation code.
InstructionShows the assembler instruction.
Src CodeShows the source code.
FunctionShows the function name to which the instruction belongs. Function names are displayed in black at function entry, otherwise in gray. Enable or disable this column through the Context menu Show Functions.
DetailsShows record specific information at the bottom of the table. Show or hide this field using the context menu Show Record Description.

Toolbar Items

Trace Data Toolbar

Toolbar ItemDescription
Display ...Allows filtering the records:
  • Execution - All shows all instructions.
  • Execution - Src Code shows all high-level source code instructions.
Go To Selection
GoTo
Jump to the Selected Record.
Find .. in ..
Find
Is a search function to find records that correspond to the entered pattern and the filter in use. When multiple records have been selected, the search is limited to the highlighted records. Wild-cards are not supported in the search string. This functionality corresponds to the Find... option of the Context menu.
Save
Save
Saves the filtered data into a comma-separated-values (*.csv) file. This functionality corresponds to the Save... option of the Context menu. Developers can specify the file name and the amount of data that should be stored:

Save Data Trace
  • File name - specifies the file to save the records.
  • Full buffer - saves the entire data buffer.
  • Time from .. to - specifies the timestamp interval. When Set Time Reference is active, this option allows using time differences.
  • Current Selection - saves the records that have been selected.
Clear
Clear
Empties the data buffer and clears the window cells.

Context Menu Items

Context Menu ItemShort KeyDescription
Show Functions Shows or hides the column Function.
Show Record Description Shows or hides the Record Details field.
Go to Disassembly / Source CodeDouble click the recordPositions the cursor to the assembler and source code line that corresponds to the instruction.
Copy SelectionCtrl+CCopies the current selection to the clipboard.
Copy Cell Copies the cell content to the clipboard.
Set Time ReferenceCtrl+F4Sets the Time Reference record and displays 0.000 000 000s in the Time column. Timestamps of other records are shown as delta values. The Time Reference record is highlighted.
Clear Time ReferenceCtrl+Shift+F4Clears the Time Reference. Actual timestamp values are displayed in the Time column.
Go To Time ReferenceF4Jumps to the Time Reference record. A warning is displayed when the Time Reference record is outside of the data buffer.
Insert / Remove BookmarkCtrl+F2Bookmarks the record.
Go To Next BookmarkF2Jumps to the next bookmark.
Go To Previous BookmarkShift+F2Jumps to the previous bookmark.
Clear All BookmarksCtrl+Shift+F2Removes all bookmarks.
FindCtrl+FOpens a search dialog to find patterns in the data buffer.
SaveCtrl+SOpens a dialog to enter criteria for saving the data. This option corresponds to the Save option in the toolbar.

Working with the Trace Data Window

  • Halt debugging to refresh the screen content.
  • Double-click any row to jump to the source code and disassembly line that corresponds to the instruction.
  • Press navigation keys for scrolling within the records.
  • Create a compact selection.
    • Click on a record.
    • Press Shift+Left-Mouse-Button on another record.
    The selected records get highlighted in blue.
  • Add or remove a single record from a selection.
    • Press Ctrl+Left-Mouse-Button on a highlighted record. The record is removed from the selection.
    • Press Ctrl+Left-Mouse-Button on a non-highlighted record. The record is added to the selection.
  • Scroll through the trace records to view the state of the registers in the Register Window. The values correspond to the instruction that was executed ahead of the highlighted instruction.

Navigation and Navigation Keys

  • Use the Trace Navigation window to scroll through the records.
  • UP- and DOWN keys - scroll through the records.
  • PAGE-UP and PAGE-DOWN keys - scroll entire record pages.
  • HOME key - jumps to the first record in the table.
  • END key - jumps to the last record in the table.
  • ENTER - highlights the disassembly and source code line (identical to double-clicking a record).

Note

  • Column names can differ when debugging on target hardware.
  • Refer to Instruction Trace Window for non-Cortex-M processor-based devices.