1.3.211 trace report

Produces a trace report, containing the decoded trace data, for the currently selected core.

Syntax

trace report [option = value]...

Where:

option

Specifies the name of a trace report option to set.

value

Specifies the new value of the option.

The option names are not case sensitive. The options are:

OUTPUT_PATH

Specifies the directory to save the trace report files in. The default value is the current working directory.

FILE

Specifies the base file name of the trace report. If trace report generates multiple files, then each file will have a zero-padded number inserted before the file name extension. The default value is Trace_Report.txt.

SPLIT_FILE_SIZE

Specifies the maximum file size, in bytes, that trace report generates. If the file size is larger than SPLIT_FILE_SIZE, trace report generates a new report file. Specifying -1 indicates that there is no maximum file size, so the trace report is not split into separate files. The default value is 1073741824.

START

Specifies the position in the trace buffer to start decoding trace from. The default value is 0, which starts the decoding from the beginning of the buffer.

END

Specifies the position in the trace buffer to stop decoding trace. Specifying -1 indicates that the trace report should decode to the end of the buffer. The default value is -1.

FORMAT

Specifies the format of the report. Valid values are CSV (Comma-Separated Values) and TSV (Tab Separated Values). The default value is TSV. Format values are not case sensitive.

SOURCE

Specifies the trace source to report. Execute the trace list command to view the list of available trace sources. The default is to dump the trace source associated with the current core.

CORE

Specifies the core to report. Execute the info cores command to view the list of cores available. This option is analogous to the SOURCE option, except that the source for the given core will be discovered automatically. You can specify either a SOURCE or CORE but not both.

CONFIG

Specifies a configuration file. This is used to specify decoding details for STM and ITM trace sources. The default configuration is to decode all Ports, Masters, and Channels as binary data. This file is created by exporting it from the Event Viewer Settings dialog.

COLUMNS

Specifies a comma separated list of columns to include in the report. The column names are not case sensitive.

Valid values for instruction trace sources are:

RECORD_TYPE

The type of the record.

INDEX

The index of the instruction. Canceled instructions do not have an index.

ADDRESS

The address of the instruction.

OPCODE

The opcode of the instruction, in hexadecimal, with no prefix.

OPCODE_WITH_PREFIX

The opcode of the instruction, in hexadecimal, with a 0x prefix.

CYCLES

The cycle count of the instruction.

DETAIL

For instruction records, this gives the disassembly of the instruction. For other record types, this gives various information.

FUNCTION

The function of the instruction.

BRANCH

This is true if the instruction is a branch. Otherwise, this is false.

For instruction trace sources, the default is ADDRESS, OPCODE, DETAIL.

Valid values for STM trace sources are:

MASTER

The master number can be 0 to 128.

CHANNEL

The channel number can be 0 to 65535.

TIMESTAMP

An approximate timestamp for each record, if available.

SIZE

Size of the row in bytes.

DATA

The row data.

For STM trace sources, the default is MASTER, CHANNEL, DATA.

Valid values for ITM trace sources are:

PORT

The port number can be 0 to 255.

TIMESTAMP

The global timestamp for the record, if available (M-profile only). This column name is synonymous with the global time stamp (GTS).

DATA

The row data.

LTS

The local timestamp for the record, if available.

GTS

The global timestamp for the record, if available (M-profile only).

COMP

For DWT data trace packets, the number of the matching DWT comparator (M-profile only). This column is only useful if the DWT option is specified as true.

For ITM trace sources, the default is PORT, DATA.

DWT

For M-profile ITM trace sources, specifies whether to include DWT packets in the report. The default value is false. To include DWT packets, specify true.

PORTS
For ITM trace sources, specifies a comma-separated list of stimulus ports to include. Output from stimulus ports not listed is suppressed from the report. If the option is not present, output from all stimulus ports is included.
DECODERS

For ITM trace sources, specifies a comma-separated list of decoder assignments. Each decoder assignment has the form Pn:decoder_name where n is a stimulus port number, and decoder_name is one of the names available in the Encoding drop-down list in the Event Viewer Settings dialog. The decoders available by default are TAE, Text, and Binary. If no decoder is assigned to a stimulus port, the default is Binary.

HEADERS

Specifies whether to include the column headers in the report. The default value is false. To include headers, specify true.

Example 1-214 Examples

trace report
# Produces a default trace report named "Trace_Report.txt" in the current working 
# directory.
# Instruction trace for the current core is reported.

trace report FILE=MyReport.csv OUTPUT_PATH=C:/files/trace_reports FORMAT=CSV
# Produces a comma-separated value trace report named "MyReport.csv"
# in C:/files/trace_reports.

trace report COLUMNS=RECORD_TYPE,INDEX,ADDRESS,OPCODE_WITH_PREFIX,DETAIL HEADERS=true
# Produces a trace report with alternate columns.
# The first line of the report will contain the column names.

trace report SOURCE=ITM COLUMNS=PORT,DATA HEADERS=true
# Produces an ITM trace report with alternate columns.
# The first line of the report will contain the column names.

trace report SOURCE=ITM PORTS=1,2 DECODERS=P1:Text,P2:TAE HEADERS=true
# Specifies custom decoders for stimulus ports 1 and 2, and suppresses output from all other stimulus ports.
# The first line of the report will contain the column names.

trace report SOURCE=CSITM DWT=true COLUMNS=PORT,COMP,DATA HEADERS=true
# Produces an ITM trace report with DWT packets included, and DWT comparator numbers for data trace packets.
# The first line of the report will contain the column names.
Non-ConfidentialPDF file icon PDF versionARM DUI0452Z
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.