2.3.4. ANALYZER

Controls the configuration of the trace logic analyzer.

Syntax

ANALYZER {[,disable] | [,enable]}

ANALYZER {[edit_properties] | [,map_log_phys] | [,triggers] | [,connect] | [,set_size]}

ANALYZER {[,clear] | [,clear_triggers]}

ANALYZER {[,before] | [,around] | [,after] | [,stop_on_trigger] | [,continue_on_trigger]}

ANALYZER { ,full_stop | ,full_ignore | ,full_ring}

ANALYZER { ,collect_all | ,collect_flow}

ANALYZER { ,dataonly | ,addronly | ,fulltrace}

ANALYZER { ,disconnect}

ANALYZER { ,auto_off | ,auto_instronly | ,auto_dataonly | ,auto_both}

ANALYZER { ,mode_continuous | ,mode_trigger}

where:

disable

Disable tracing.

enable

Enable tracing.

edit_properties

When connecting to a target other than an ARM® processor with Embedded Trace Macrocell (ETM™), this is the equivalent of the Configure Analyzer Properties... option on the Analysis window Edit menu.

Note

To configure an ETM use ETM_CONFIG.

map_log_phys

The equivalent of the Physical to Logical Address Mapping... option on the Analysis window Edit menu. Not available with an ARM ETM-enabled processor.

triggers

The equivalent of the Set/Edit Event Triggers option on the Analysis window Edit menu. Not available with an ARM ETM-enabled processor.

connect

The equivalent of the Connect Analyzer option on the Analysis window Edit menu. Not available with an ARM ETM-enabled processor because an ARM ETM is automatically connected.

set_size=(n)

Enables you to set the trace buffer size.The equivalent of the Set Trace Buffer Size... option on the Analysis window Edit menu. If the value is specified in the command it is used, otherwise display the Set Trace Buffer Size dialog and set the value from that.

clear

Clear the captured trace buffer.

clear_triggers

Clear any triggers set using an ANALYZER,triggers command. Not available with an ARM ETM-enabled processor.

before

Capture data before the trigger, that is, 100% before, 0% after.

around

Capture data around the trigger, that is, 50% before, 50% after.

after

Capture data after the trigger, that is, 0% before, 100% after.

stop_on_trigger

Stop the processor when a trigger point is reached. This option is only applicable to the ARM ETM.

continue_on_trigger

Continue program execution across trigger points. This option is only applicable to the ARM ETM.

full_stop

Stop the processor and put it into debug state when the trace buffer is full. Not available with an ARM ETM-enabled processor.

full_ignore

Stop collecting trace information when the trace buffer is full, but let the processor continue running. Not available with an ARM ETM-enabled processor.

full_ring

Continue collecting trace information when the trace buffer fills by discarding the oldest trace information, treating the buffer as a ring. This is the only option available for the ARM ETM.

collect_all

Store all trace the information generated. Not available with an ARM ETM-enabled processor.

collect_flow

Store only flow-control trace information. Cannot be changed for an ARM ETM-enabled processor because normal ETM operation is a variant of this that includes some additional synchronization points.

dataonly

Trace only data bus transfers.

addronly

Trace only address bus transfers.

fulltrace

Trace both data and address bus transfers.

disconnect

Disconnects the Analysis window.

auto_off

Disables automatic tracing.

auto_instronly

When no tracepoints are set, captures trace information only for executed instructions.

auto_dataonly

When no tracepoints are set, captures trace information only for data accesses. This is supported only by ETMv3.

auto_both

When no tracepoints are set, captures trace information for both executed instructions and data accesses.

Description

The ANALYZER command, and the ETM_CONFIG command, enables you to control the configuration of your trace capture analyzer.

Note

Because trace analyzer capabilities and implementations vary, some of the qualifiers provided by the ANALYZER command are not available on some of the trace targets supported by RealView Debugger. Operation of the ARM ETM is controlled in more depth with the ETM_CONFIG command.

The options are split into several groups:

  • Options config, edit_properties, map_log_phys, triggers, and set_size display a GUI dialog that enables you to configure the associated trace component.

    Note

    These options are not available when running in command line mode.

  • The clear option acts on the trace capture buffer.

  • Options before, around, after, clear_triggers, stop_on_trigger, and continue_on_trigger enable you to control the relative location of the trace trigger within the trace buffer and the effect of the trigger. See the TRACE, TRACEINSTREXEC, TRACEDATAACCESS and similar commands for control of tracepoint location in target memory.

  • Options full_stop, full_ignore, and full_ring enable control over the behavior of the trace buffer when it becomes full.

  • Options collect_all and collect_flow enable control of the trace data collection strategy. Collecting all bus transactions provides the benefit of following everything that is happening without recourse to external information, but conversely requires a very high bandwidth trace port. Collecting only bus transactions that change the flow of control provides most of the important information if you also have access to an accurate memory image.

Examples

The following examples show how to use ANALYZER:

ANALYZER,set_size=500

Set the trace buffer size to 500 records, if this action is supported by the logic analyzer you are using.

ANALYZER,full_ring,around

Set the logic analyzer to capture trace information around the defined trigger point, using the trace buffer in ring mode so that it cannot overflow.

See also

Copyright © 2002-2011 ARM. All rights reserved.ARM DUI 0175N
Non-ConfidentialID052111