Trace Control view
Use the Trace Control view to start or stop trace capture and clear the trace buffer on a specified trace capture device.
The Trace Control view additionally displays information about the trace capture device, the trace source used, the status of the trace, and the size of the trace buffer.
Figure 11-46 Trace Control view
The trace capture device and trace sources available in the trace capture device are listed on the left hand side of the view. Select any trace source to view additional information.
The following Trace Capture Device information is displayed in the view:
- Trace Capture Device
- The name of the trace capture device.
- Capture Status
- The trace capture status. On when capturing trace data, Off when not capturing trace data.
- Trigger Position
- The location of the trigger within the buffer.
NoteThis information is only available for hardware targets.
- Buffer Size
- The capacity of the trace buffer.
- Buffer Used
- The amount of trace data currently in the buffer.
- Buffer Wrapped
- The trace buffer data wraparound status.
- Persistent Trace
- The persistent trace data status.
The following Trace Source information is displayed in the view:
- Trace Source
- The name of the selected trace source.
- Source ID
- The unique ID of the selected trace source.
- Source Encoding
- The trace encoding format.
- The core associated with the trace source.
- Context IDs
- The tracing context IDs availability status.
- Cycle Accurate Trace
- The cycle accurate trace support status.
- Virtualization Extensions
- The virtualization extensions availability status.
- Timestamp availability status for the trace.
- Timestamp Origin
- Whether a timestamp origin for the trace is set or cleared. When set, timestamps are displayed as offsets from the origin.
- Trace Triggers
- Trace triggers support status.
- Trace Start Points
- Trace start points support status.
- Trace Stop Points
- Trace stop points support status.
- Trace Ranges
- Trace ranges support status.
NoteThe information displayed varies depending on the trace source.
Trace Control view options
- Start Capture
- Click Start Capture to start trace capture on the trace capture device. This is the same as the trace start command.
- Stop Capture
- Click Stop Capture to stop trace capture on the trace capture device. This is the same as the trace stop command.
- Clear Trace Buffer
- Click Clear Trace Buffer to empty the trace buffer on the trace capture device. This is the same as the trace clear command.
- Start trace capture when target restarts (after a stop)
- Select this option to automatically start trace capture after a target restarts after a stop.
- Stop trace capture when target stops
- Select this option to automatically stop trace capture when a target stops.
- Stop trace capture on trigger
- Select this option to stop trace capture after a trace capture trigger has been hit.
- Post-trigger capture size
- Use this option to control the percentage of the trace buffer that should be reserved for after a trigger point is hit. The range is from 0 to 99.
NoteThe trace start and trace stop commands and the automatic start and stop trace options act as master switches. Trace triggers cannot override them.
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 specific connection or processor in a Symmetric MultiProcessing (SMP) 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.
- New Trace Control View
Select this option to open a new Trace Control view.
Select this option to refresh the current Trace Control view.
- DTSL Options...
Select this option to open the Debug and Trace Services Layer (DTSL) Configuration dialog. This dialog can be used to configure additional debug and trace settings, such as, adding, editing or choosing a DTSL connection configuration.
- Trace Dump...
Select this option to open the Trace Dump dialog. In this dialog you can configure and export the raw trace data from the buffer and write it to a file.