Keil Logo Arm Logo
Products Download Events Support Videos

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 Cortex-M Code and Data Trace Trace Features Tracepoint Expressions Tracepoint Intrinsics Tracepoint Limitations Configuring the Trace Hardware Tracepoint Marks 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
Home  /  µVision4 User's Guide

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 Name Description
Nr. Shows the current table row number. The value is limited to 32k for the Simulator.
Time Shows 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.
Address Shows the instruction address.
Opcode Shows the operation code.
Instruction Shows the assembler instruction.
Src Code Shows the source code.
Function Shows 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.
Details Shows 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 Item Description
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.
Reload/Refresh
Refresh Trace		 Refreshes the screen and reloads the data buffer.
Save
Save		 Saves the filtered data into a comma-separated-values (*.csv) file. This functionality corresponds to the Save... option of the Context menu.

Save Data Trace
  • File name - specifies the file for saving the records. An absolute path must be entered.
  • Button next to the File name drop-down list - opens the Explorer.
  • What - specifies the data selection.
    • Current Selection - stores the selected records.
    • Current Display - stores the currently displayed records, covering a time range of about 10ms. For Unlimited Trace only.
    • Available Data - stores all recorded data.
  • Button next to the What drop-down list - sets a time interval. Can be used for fine-tunig.

    Set Time Interval

    • From .. To - timestamp interval of the saved data. When Set Time Reference is active, this option allows using time differences. Any range entered will be displayed in the What drop-down list.
  • Files - maximum number of files that should be used for saving records. The file names have the form: File name_number.csv.
  • Records per file - maximum number of records to be stored in each file.
  • Disk space - total amount of disk space (in MB) allowed to be consumed by all files. A warning is displayed as soon as the total amout is reached and not all records could be saved.

Note

  • The stored values are separated by a comma.
Clear
Clear		 Empties the data buffer and clears the window cells.

Context Menu Items

Context Menu Item Short Key Description
Show Functions   Shows or hides the column Function.
Show Record Description   Shows or hides the Record Details field.
Go to Disassembly / Source Code Double click the record Positions the cursor to the assembler and source code line that corresponds to the instruction.
Copy Selection Ctrl+C Copies the current selection to the clipboard.
Copy Cell   Copies the cell content to the clipboard.
Set Time Reference Ctrl+F4 Sets 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 Reference Ctrl+Shift+F4 Clears the Time Reference. Actual timestamp values are displayed in the Time column.
Go To Time Reference F4 Jumps to the Time Reference record. A warning is displayed when the Time Reference record is outside of the data buffer.
Insert / Remove Bookmark Ctrl+F2 Bookmarks the record.
Go To Next Bookmark F2 Jumps to the next bookmark.
Go To Previous Bookmark Shift+F2 Jumps to the previous bookmark.
Clear All Bookmarks Ctrl+Shift+F2 Removes all bookmarks.
Find Ctrl+F Opens a search dialog to find patterns in the data buffer.
Save Ctrl+S Opens 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

  • Tracepoints that trigger a data stream HALT, SUSPEND, or RUN are marked in the window. It is possible to search for these keywords.
  • 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.

Products

Development Tools

 

Hardware & Collateral

Downloads

Support

Contact

Keil logo

Contact Us | Site Feedback | Terms of Use | Privacy Policy

Copyright © 2013 ARM Ltd and ARM Germany GmbH. All rights reserved.

 Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.