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 views.
Figure 11-14 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 Control view.
- 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 timestamp.
- 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 source.
- Open Trace Control View
- Opens the Trace Control view.
- DTSL Options...
- Opens the DTSL Configuration Editor dialog box.
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.
NoteFor a given connection, the timestamp origin is global for all Trace and Events views.
- 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 ITM/STM protocol.
- Timestamp Format: (h:m:s)
- Sets the timestamp in hours:minutes:seconds format.