11.10 Events view
Use the Events view to view the output generated by the System Trace Macrocell (STM) and Instruction Trace Macrocell (ITM) events.
Data is captured from your application when it runs. However, no data appears
in the Events view until you stop the application.
To stop the target, either click the Interrupt icon in the Debug
Control view, or use the stop command in the
Commands view. When your application
stops, any captured logging information is automatically appended to the open
Figure 11-13 Events view (Shown with all ports enabled for an ETB:ITM trace source)
- Use the Event
Viewer Settings dialog to select a Trace Source as well as to set up Ports (if ITM is the trace source) or
Masters (if STM is the trace
source) to display in the view.
- To view the Live Decode tab and streaming trace data,
you must enable the Show live decode console option
in the Event Viewer Settings dialog.
Toolbar and context menu options
The following options are available from the toolbar or context menu:
Links this view to the selected connection in the Debug Control view. This is the default.
Alternatively you can link the view to a different connection. If the
connection you want is not shown in the drop-down list, you might have
to select it first in the Debug
- Clear Trace
- Clears the debug hardware device buffer and all trace sources. The views might retain data,
but after clearing trace, refreshing the views clears them as well.
- Start of page
- Displays events from the beginning of the trace buffer.
- Page back
- Moves one page back in the trace buffer.
- Page forward
- Moves one page forward in the trace buffer.
- End of page
- Displays events from the end of the trace buffer.
- View Menu
The following View Menu options are available:
- New Events View
Displays a new instance of the Events view.
- Find Global Timestamp...
- Displays the Search by Timestamp dialog which allows you to search
through the entire trace buffer. The search results opens up the
page where the timestamp is found and selects the closest
- Update View When Hidden
Enables the updating of the view when it is
hidden behind other views. By default this view does not
update when hidden.
Refreshes the view.
- Freeze Data
Toggles the freezing of data in the current view.
- Events Settings...
Displays the Settings dialog where you can select a
trace source and set options for the selected trace
- Open Trace Control View
- Opens the Trace Control view.
- DTSL Options...
- Opens the DTSL Configuration Editor dialog
Events context menu
- Advance / Go back local timestamp amount
Displays the Advance / Go back local timestamp
dialog box which allows you to move forward or backward from the current
record by a local timestamp amount. A negative number indicates a
movement backward. The search moves forward or backward from the current
record until the sum of intervening local timestamps is equal to or
exceeds the specified value.
- Global Timestamps
- Timestamps represent the approximate time when events are generated.
- Synchronize Timestamps
- Synchronizes all Trace and Events views to
display data around the same timestamp.
- Set Timestamp Origin
- Sets the selected event record as the timestamp origin.
Note: For a given connection, the
timestamp origin is global for all Trace and
- Clear Timestamp Origin
- Clears the timestamp origin.
- Timestamp Format: Numeric
- Sets the timestamp in numeric format. This is the raw timestamp value received from the
- Timestamp Format: (h:m:s)
- Sets the timestamp in hours:minutes:seconds format.