When the trace has been captured the debugger extracts the information from the trace stream and decompresses it to provide a full disassembly, with symbols, of the executed code.
This view shows a graphical navigation chart that displays function executions with a navigational timeline. In addition, the disassembly trace shows function calls with associated addresses and if selected, instructions. Clicking on a specific time in the chart synchronizes the disassembly view.
In the left-hand column of the chart, percentages are shown
for each function of the total trace. For example, if a total of
1000 instructions are executed and 300 of these instructions are associated
with myFunction() then this function is displayed
with 30%.
In the navigational timeline, the color coding is a "heat" map showing the executed instructions and the amount of instructions each function executes in each timeline. The darker red color showing more instructions and the lighter yellow color showing less instructions. At a scale of 1:1 however, the color scheme changes to display memory access instructions as a darker red color, branch instructions as a medium orange color, and all the other instructions as a lighter green color.
The Trace view might not be visible by default. To add this view:
Ensure that you are in the DS-5 Debug perspective.
Select Window → Show View to open the Show View dialog box.
Select Trace view.
The Trace view contains several tabs:
Trace tab showing the graphical timeline and disassembly.
Right-click on the column headers to select the columns that you want displayed.
The Breakpoint, Index, Address, Opcode, Info and Disassembly columns
are displayed by default.
Toolbar and context menu optionsThe following options are available from the toolbar or context menu:
- Linked:
context Links this view to the selected connection in the Debug Control view. This is the default. Alternatively you can link the view to a specific connection. If the connection you want is not shown in the drop-down list you might have to select it first in the Debug Control view.
- Show Next Match
Moves the focus of the navigation chart and disassembly trace to the next matching occurrence for the selected function or instruction.
- Show Previous Match
Moves the focus of the navigation chart and disassembly trace to the previous matching occurrence for the selected function or instruction.
- Don’t mark other occurrences - click to start marking, Mark other occurrences - click to stop marking
When function trace is selected, marks all occurrences of the selected function with a shaded highlight. This is disabled when instruction trace is selected.
- Clear Trace
Clears the raw trace data that is currently contained in the trace buffer and the trace view.
- Showing instruction trace - click to switch to functions, Showing function trace - click to switch to instructions
Toggles the disassembly trace between instruction trace or function trace.
- Export Trace Report
Displays the Export Trace Report dialog box to save the trace data to a file.
- Home
Where enabled, moves the trace view to the beginning of the trace buffer. Changes might not be visible if the trace buffer is too small.
- Page Back
Where enabled, moves the trace view back one page. You can change the page size by modifying the Set Maximum Instruction Depth setting.
- Page Forward
Where enabled, moves the trace view forward one page. You can change the page size by modifying the Set Maximum Instruction Depth setting.
- End
Where enabled, moves the trace view to the end of the trace buffer. Changes might not be visible if the trace buffer is too small.
- Switch between navigation resolutions
Changes the timeline resolution in the navigation chart.
- Switch between alternate views
Changes the view to display the navigation chart, disassembly trace or both.
- Focus Here
At the top of the list, displays the function being executed in the selected time slot. The remaining functions are listed in the order that they are executed after the selected point in time. Any functions that do not appear after that point in time are placed at the bottom and ordered by total time.
- Order By Total Time
Displays the functions ordered by the total time spent within the function. This is the default ordering.
- View Menu
The following View Menu options are available:
- New Trace View
Displays a new instance of the Trace view.
- Copy
Copy the selected instruction trace.
- Set Trace Page Size...
Displays a dialog box where you can enter the maximum number of instructions to display in the disassembly trace. The number must be within the range of one thousand to one million instructions.
- Index From Start
Numbers each decoded instruction in the buffer from the start.
- Index From Middle
Numbers each decoded instruction in the buffer from the middle.
- Index From End
Numbers each decoded instruction in the buffer from the end.
- Find Trigger Packet
Enables you to search for trigger packets in the trace capture buffer.
- Show in Disassembly
Displays the Disassembly view starting at the address of the selected instruction.
- Refresh
Refreshes the view.
- Freeze Data
Toggles the freezing of data in the current view.
- Trace Filter Settings...
Displays a dialog box where you can select the trace record types that you want to see in the Trace view.
- Tasks
- Concepts
- Reference
PDF version