You copied the Doc URL to your clipboard.

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

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.

Note

This 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.
Core
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.
Timestamps
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.

Note

The 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.

Note

The 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:

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 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.

Refresh

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.

Was this page helpful? Yes No