RealView® Debugger Command Line Reference GuideVersion 1.8
Home > RealView Debugger Commands > Alphabetical command reference > ETM_CONFIG

2.3.58. ETM_CONFIG

The ETM_CONFIG command provides control over the ARM ETM.

Syntax

ETM_CONFIG [,qualifier...]

where:

qualifier

Is a list of qualifiers. The possible qualifiers are described in List of qualifiers.

Description

The ETM_CONFIG command provides control over the ARM ETM. The arguments to a single invocation of the command specify a configuration of the ETM, so the presence or absence of qualifiers is relevant.

For more information on the terms used by the ETM and options it provides, see the Embedded Trace Macrocell™ Specification and the chapter that describes tracing in RealView Debugger v1.8 Extensions User Guide.

List of qualifiers

The list of qualifiers is dependent on the processor and vehicle. The command handler generates an error if a specific combination is invalid for a specific processor or vehicle, but this is determined when you issue the command. The possible qualifiers are:

size:n

Set the ETM trace buffer size to n records.

mmap_decode:n

Set the ETM memory map value to n.

FIFO_hw:n

Set the FIFO high-water mark to n.

port_width:n

Set the ETM port width, where n is one of:

0

4-bit port.

1

8-bit port.

2

16-bit port.

3

24-bit port.

4

32-bit port.

The 24-bit and 32-bit settings are supported only for ETB11 connections using RealView ICE.

time_stamps

Enable time stamping if the ETM and trace capture hardware support it. To disable, issue the command without this qualifier.

stall_full

Enable processor stalling if the FIFO becomes full, if the ETM and processor support it. To disable, issue the command without this qualifier.

half_rate

Enable half-rate clocking of the trace port by the ETM. For full-rate, issue the command without this qualifier.

cycle_accurate

Enable cycle-accurate tracing, if the ETM supports it. To disable, issue the command without this qualifier.

coprocessor

Enable coprocessor tracing. To disable, issue the command without this qualifier.

disableport

Disable the ETM trace port. To enable, issue the command without this qualifier.

suppressdata

Suppress data tracing if the FIFO becomes full. To leave data tracing enabled, issue the command without this qualifier.

nomultiplex

Select the normal (not multiplexed or demultiplexed) trace port transmission mode.

multiplex

Select the multiplexed trace port transmission mode.

demultiplex

Select the demultiplexed trace port transmission mode.

dataonly

Trace only data bus transfers.

addronly

Trace only address bus transfers. (Deprecated)

fulltrace

Trace both data and address bus transfers. (Deprecated)

portratio:n

Enables ETM v3 port speed to ETM clock speed ratios to be set. This is supported only by ETM v3. Appropriate values for n are:

0

Use a 1:1 ratio.

1

Use a 1:2 ratio.

2

Use a 1:3 ratio.

3

Use a 1:4 ratio.

4

Use a 2:1 ratio.

5

Use dynamic ratio modes for on-chip trace.

6

Use the implementation-defined mode, if implemented by the ASIC designer.

datasuppression

Enables ETM v3 data suppression on FIFO full. This is supported only by ETM v3.

filtercoprocessor

Enables filtering of CPRTs when data trace is enabled. This is supported only by ETM v3.

packauto

Selects the automatic packing mode for the TPA.

packnormal

Selects the normal packing mode for the TPA.

packdouble

Selects the double packing mode for the TPA.

packquad

Selects the quad packing mode for the TPA.

twin

Selects the connection that the current connection is connected (twinned) with. This is supported only by DCP/TCM hardware.

twinmaster

Selects the processor that is to be the DCP master. This is supported only by DCP/TCM hardware.

Examples

The following examples show how to use ETM_CONFIG:

ETM_CONFIG,port_width:0,coprocessor,fulltrace,size:10240

Set up the ETM for a 4-bit, full-rate, nonmultiplexed trace port, no stalling or timestamps, 10K trace records, address and data tracing, and in non cycle-accurate mode.

ETM_CONFIG,port_width:1,stall_full,multiplex,fulltrace,suppressdata,size:1024

Set up the ETM for an 8-bit, full-rate, multiplexed trace port, processor stalling and data suppression on FIFO full, no timestamps, 1024 trace records, address and data tracing, and in non cycle-accurate mode.

See also

The following commands provide similar or related functionality:

Copyright © 2002-2005 ARM Limited. All rights reserved.ARM DUI 0175G
Non-Confidential
PDF file icon  PDF version
Home > RealView Debugger Commands > Alphabetical command reference > ETM_CONFIG