User manual

UM0036 STice features
Doc ID 7705 Rev 11 263/385
Figure 198. Trace Display Filter dialog box
● Filter lines: Trace records can be filtered using the Trace Display Filter dialog box
(Figure 198). To open this window, select Filter Lines from the Trace window
contextual menu. The line filter is used to restrict the trace display to the operation that
you are interested in. Only the selected trace entries appear in the Trace window (all
others are hidden). The record number and timestamp are not recalculated when lines
are removed from the display.
– Display Source Lines: This option includes the source line in the Trace
information. The Address column contains the name of the source file and the
source line content is displayed in the Disassembly window.
– Display event type cycles: Includes the recorded cycles in the trace information.
When enabled, the microprocessor actions selected in the Trace Display Filter
dialog box are included. When disabled, only the source lines are shown in the
Trace window.
Note that some of these events can occur in parallel. There is always an event in the
instruction event column. There may be an event in the read event column and/or in the
write event column. As a result, a cycle is displayed if at least one of its three possible
events (instruction event, read event if present, write event if present) is selected.
In the above example, the Discarded event type is unchecked, so that no trace record
with a "Discarded" event type is displayed. The last recorded cycle after the emulator's
execution of a debugging break action (breakpoint, stepping, user abort) is flagged as
discarded. By filtering these cycles out, you can see the true trace of instruction
execution. However you may miss some data read or write operations that occur in
parallel with the discarded instruction. Note also that breakpoints have an impact on the
trace as the normal flow of execution is stopped.
● Selecting the Timestamp unit: By clicking on the Select Timestamp unit option, you
can choose to have the Timestamp value shown in nanoseconds (ns), microseconds
(μs), milliseconds (ms) or seconds (s).