Keil Logo

Technical Support

On-Line Manuals

µVision User's Guide

About µVision User Interface Creating Applications 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 Component Viewer Disassembly Window Event Recorder Filter Component Levels Setup Event Recorder Event Viewer Execution Profiler Instruction Trace Window Logic Analyzer Setup Setup in Detail Restrictions Cortex-M Trace Configuration Memory Map Memory Window Performance Analyzer Registers Window Serial Window Symbols Window System Viewer Adding System Viewer Windows System and Thread Viewer Thread States Toolbox Trace Data Window Trace Navigation Watch Window Core Peripherals Cortex-M0 and Cortex-M0+ Nested Vector Interrupt Controller System Control and Configuration System Tick Timer Fault Reports (Cortex-M0+ only) Cortex-M3, Cortex-M4, and Cortex-M7 Nested Vector Interrupt Controller System Control and Configuration System Tick Timer Fault Reports Memory Protection Unit Cortex-M23 and Cortex-M33 Nested Vector Interrupt Controller System Control and Configuration System Tick Timer Fault Reports Memory Protection Unit Security Attribution Unit 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 Differences between µVision and C Expression Examples Code and Data Trace (Cortex-M) 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) Prevent Opening Files Show Japanese Messages Code Coverage Export MTB Trace Import for Code Coverage Debug Commands Debug Functions Simulation Flash Programming Dialogs Utilities Command Line Example Programs Appendix

Trace Data Window

The Trace Data Window shows the history of executed instructions for Cortex-M devices. (For non-Cortex-M processor-based devices refer to Instruction Trace Window.)

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

Trace Data Window

The column names described in here apply for the Simulator. Column names can differ when debugging on target hardware. Refer to Trace Data (Cortex-M) when debugging with ULINKpro.

Column name Description
Nr. Shows the current table row number. The value is limited to 32k.
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 (bottom) Shows record specific information. The context menu Show Record Description shows or hides this field.

Toolbar Items

Trace Data Toolbar

Toolbar Item Description
Display ... Filter records with:
  • Execution - All shows all instructions.
  • Execution - Src Code shows all high-level source code instructions.
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 amount 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. Not available when Unlimited Trace is enabled.
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.

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.
Clear Window Ctrl+S Empties the data buffer and clears the window cells.

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).

Related Knowledgebase Articles

  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.

Change Settings

Privacy Policy Update

Arm’s Privacy Policy has been updated. By continuing to use our site, you consent to Arm’s Privacy Policy. Please review our Privacy Policy to learn more about our collection, use and transfers
of your data.