Debugger Xtensa

XTENSA Debugger
TRACE32 Online Help

TRACE32 Directory
TRACE32 Index
TRACE32 Documents ......................................................................................................................
ICD In-Circuit Debugger ................................................................................................................
Processor Architecture Manuals ..............................................................................................
XTENSA ....................................................................................................................................
XTENSA Debugger ...............................................................................................................
Brief Overview of Documents for New Users .................................................................
Warning ..............................................................................................................................
Quick Start of the JTAG Debugger ..................................................................................
Troubleshooting ................................................................................................................
10
SYStem.Up Errors
10
FAQ .....................................................................................................................................
11
XTENSA Specific Implementations .................................................................................
12
Breakpoints
12
Software Breakpoints
12
On-chip Breakpoints for Instructions
12
On-chip Breakpoints for Data
12
Example for Standard Breakpoints
13
Runtime Measurement
14
Memory Classes
15
MAP.BUS8
Bus width mapping
16
MAP.BUS16
Bus width mapping
16
MAP.BUS32
Bus width mapping
16
CPU specific SYStem Commands ...................................................................................
17
SYStem.CONFIG
Configure debugger according to target topology
17
<parameter> General
22
<parameter> describing the Debugport
23
<parameter> describing the JTAG scan chain and signal behavior
28
<parameter> describing a system level TAP Multitap
32
<parameter> configuring a CoreSight Debug Access Port DAP
34
<parameter> describing debug and trace Components
38
<parameter> which are Deprecated
47
SYStem.CPU
Select the used CPU

1989-2016 Lauterbach GmbH
XTENSA Debugger
51
SYStem.CpuAccess
Run-time memory access (intrusive)
52
Define JTAG frequency
53
Tristate the JTAG port
54
Real-time memory access (non-intrusive)
54
Establish the communication with the target
55
SYStem.JtagClock
SYStem.LOCK
SYStem.MemAccess
SYStem.Mode
SYStem.Option Endianess
Specify the byte ordering
55
Disable interrupts while single stepping
56
Disable interrupts while HLL single stepping
56
Core is part of Intel SoC
56
SYStem.Option IMASKASM
SYStem.Option IMASKHLL
SYStem.Option IntelSOC
SYStem.Option PWROVR
Specifies power override bit
57
Use 32-bit access to set breakpoint
57
Temporary memory
57
SYStem.TIE
TIE library files
58
SYStem.TIE.ADDtiedll
Add library file
58
SYStem.TIE.ADDALL
tbd.
58
SYStem.TIE.ADPerdll
tbd.
58
SYStem.TIE.CMList
tbd.
59
SYStem.TIE.DELete
Remove all library files
59
tbd.
59
SYStem.TIE.DISable
Unload and disable TIE instruction
59
SYStem.TIE.ENAble
Load and enable TIE instructions
60
SYStem.Option SOFTLONG
SYStem.Option SPILLLOC
SYStem.TIE.DEPerdll
SYStem.TIE.GENper
tbd.
60
SYStem.TIE.GETArchOPTions
tbd.
61
SYStem.TIE.LIBpath
tbd.
61
SYStem.TIE.REGlist
tbd.
61
CPU specific TERM.METHOD Command ........................................................................
62
TERM.METHOD
Define communication protocol
CPU specific TrOnchip Commands .................................................................................

TrOnchip.RESet
62
63
Reset on-chip trigger settings
63
Display on-chip trigger window
63
JTAG Connection ..............................................................................................................
64
TrOnchip.view
Mechanical Description of the 14-pin Debug Cable
64
Electrical Description of the 14-pin Debug Cable
64
Support ...............................................................................................................................
65
Available Tools
65
Compilers
66
Realtime Operation Systems
66
3rd Party Tool Integrations
67
Products .............................................................................................................................
68
Product Information
68
Order Information
68
XTENSA Debugger
XTENSA Debugger
XTENSA Debugger
Version 24-May-2016
Brief Overview of Documents for New Users

Architecture-independent information:
Debugger Basics - Training (training_debugger.pdf): Get familiar with the basic features of a
TRACE32 debugger.
T32Start (app_t32start.pdf): T32Start assists you in starting TRACE32 PowerView instances

for different configurations of the debugger. T32Start is only available for Windows.
General Commands (general_ref_<x>.pdf): Alphabetic list of debug commands.
Architecture-specific information:
Processor Architecture Manuals: These manuals describe commands that are specific for the
processor architecture supported by your debug cable. To access the manual for your processor
architecture, proceed as follows:
-
Choose Help menu > Processor Architecture Manual.
RTOS Debugger (rtos_<x>.pdf): TRACE32 PowerView can be extended for operating systemaware debugging. The appropriate RTOS manual informs you how to enable the OS-aware
debugging.
XTENSA Debugger
Brief Overview of Documents for New Users
Warning
NOTE:
To prevent debugger and target from damage it is recommended to connect or

disconnect the debug cable only while the target power is OFF.
Recommendation for the software start:
1.
Disconnect the debug cable from the target while the target power is
off.
2.
Connect the host system, the TRACE32 hardware and the debug
cable.
3.
Power ON the TRACE32 hardware.
4.
Start the TRACE32 software to load the debugger firmware.
5.
Connect the debug cable to the target.
6.
Switch the target power ON.
7.
Configure your debugger e.g. via a start-up script.
Power down:
1.
Switch off the target power.
2.
Disconnect the debug cable from the target.
3.
Close the TRACE32 software.
4.
Power OFF the TRACE32 hardware.
XTENSA Debugger
Warning
NOTE:
Spcial Registers can be viewed with the peripheral file with the command PER <path>\sfr_xt.per. To add your specific registers you
can do a copy of this file and modify it using the commad PER.Program
<path>\my_sfr_xt.per
The Register window can be resized to view additional registers by

pressing on the small field on the right bottom of the window
XTENSA Debugger
Warning
Quick Start of the JTAG Debugger

Starting up the debugger is done as follows:
1.
Select the device prompt for the ICD Debugger and reset the system.
B::
RESet
The device prompt B:: is normally already selected in the command line. If this is not the case enter
B:: to set the correct device prompt. The RESet command is only necessary if you do not start
directly after booting the TRACE32 development tool.
2.
Specify the CPU specific settings.

SYStem.CPU <cputype>
SYStem.Option Endianess [AUTO|Little|Big]
SYStem.Option SOFTLONG [OFF|ON]
The default values of all other option are set in such a way that it should be possible to work without
modification. Please consider that this is probably not the best configuration for your target.
3.
Inform the debugger about read only address ranges (ROM, FLASH).
MAP.BOnchip 0x060000000++3FFFF
The B(reak)Onchip information is necessary to decide where on-chip breakpoints must be used. Onchip breakpoints are necessary to set program breakpoints to FLASH/ROM.
4.
Specify ranges where the access width is restricted.

MAP.BUS32 0x060000000++1FFFF
If a memory location can only be accessed with a certain bus width you can use Map.BUS8 / BUS16
/ BUS32 to force the debugger to use solely the according load or store instructions. This allows for
example to have a byte-by-byte dump of a 32 bit wide memory area, where a byte access would
cause an exception.
5.
Enter debug mode.

SYStem.Up
This command resets the CPU and enters debug mode. After this command is executed it is possible
to access memory and registers.
XTENSA Debugger
6.
Load the program.

Data.LOAD <file> /LONG
;load the compiler output.

;the option /LONG tells the
;debugger to use 32 bit accesses
The format of the Data.LOAD command depends on the file format generated by the compiler. Refer
to Supported Compilers to find the command, that is necessary for your compiler.
A detailed description of the Data.LOAD command and all available options is given in the General
Commands Reference.
A typical start sequence without EPROM simulator is shown below. This sequence can be written to an
ASCII file (script file) and executed with the command DO <filename>.
B::
; Select the ICD device prompt
WinCLEAR
; Clear all windows
MAP.BOnchip 0x60000000++0xfffff
; Specify where FLASH/ROM is
MAP.BUS32 0x50000000++0x1ffff
; Force the debugger to access this ;

; area 32 bit wide
SYStem.Up
; Reset the target and enter debug

; mode
Data.LOAD.elf xtensa_project
; Load the application
Register.Set pc _ResetVector
; Set the PC to start point
Register.Set a1 0x63FFFFFC
; Set the stack pointer to address

; 0x63FFFFFC
Data.List
; Open source code window *)
Register /SpotLight
; Open register window *)
Frame.view /Locals /Caller
; Open the stack frame with

; local variables *)
Var.Watch %SpotLight flags ast
; Open watch window for variables *)
Break.Set 0x60100000 /Program
; Set software breakpoint to address

; 0x60100000 (address 0x60100000
; outside of BOnchip range)
; Set on-chip breakpoint

; to address 0x60001000 (address
; 0x60001000 is within BOnchip range)
XTENSA Debugger
*) These commands open windows on the screen. The window position can be specified with the WinPOS
command.
Please keep in mind that only the Processor Architecture Manual (the document you are reading at the
moment) is CPU specific, while all other parts of the online help are generic for all CPUs. So if there are
questions related to the CPU, the Processor Architecture Manual should be your first choice.
XTENSA Debugger
Troubleshooting
SYStem.Up Errors
The SYStem.UP command is the first command of a debug session where communication with the target is
required. If you receive error messages while executing this command this may have the following reasons.
The target has no power.
The target is in reset.
The XTENSA core is not enabled.
There is logic added to the JTAG state machine.
There are additional loads or capacities on the JTAG lines.
There is a shortcut on at least one output lines of the core.
XTENSA Debugger
10
Troubleshooting
FAQ
No information available
XTENSA Debugger
11
FAQ
XTENSA Specific Implementations
Breakpoints
Software Breakpoints
If a software breakpoint is used, the original code at the breakpoint location is patched by a breakpoint code.
On-chip Breakpoints for Instructions

If on-chip breakpoints are used, the resources to set the breakpoints are provided by the CPU. The
parameter NIBREAK of the Debug Option Architectural Addition defines the number of available instruction
breakpoints. On-chip breakpoints are usually needed for instructions in FLASH/ROM.
With the command MAP.BOnchip <range> it is possible to tell the debugger where you have ROM / FLASH
on the target.
On-chip Breakpoints for Data

To stop the CPU after a read or write access to a memory location on-chip breakpoints are required. The
parameter NDBREAK of the Debug Option (Architectural Option of the XTENSA core) defines the number
of available data breakpoints.
XTENSA Debugger
12
Example for Standard Breakpoints

Assume you have a target with NIBREAK=2, NDBREAK=2 and
FLASH from 0x0--0xfffff
RAM from 0x100000--0x11ffff
The command to configure TRACE32 correctly for this configuration is:

Map.BOnchip 0x0--0xfffff
The following standard breakpoint combinations are possible.
1.
2.
3.
4.
Unlimited breakpoints in RAM and one breakpoint in ROM/FLASH

; Software breakpoint 1
Break.Set addr /Program
; On-chip instruction breakpoint
Unlimited breakpoints in RAM and one breakpoint on a read or write access

Break.Set addr /Program
Break.Set 0x108000 /Write
; On-chip data breakpoint
Two breakpoints in ROM/FLASH

; On-chip instruction breakpoint 1
; On-chip instruction breakpoint 2
Two breakpoints on a read or write access

Break.Set 0x108000 /Write
; On-chip data breakpoint 1
Break.Set 0x108010 /Read
; On-chip data breakpoint 2
XTENSA Debugger
13
Runtime Measurement
The command RunTime allows run time measurement based on polling the CPU run status by software.
Therefore the result will be about few milliseconds higher than the real value.
XTENSA Debugger
14
Memory Classes
The following ARM specific memory classes are available.
Memory Class
Description
Program Memory
Data Memory
VM
Virtual Memory (memory on the debug system)
Run-time memory access

(see SYStem.CpuAccess and SYStem.MemAccess)
XTENSA Debugger
15
To access a memory class write the class in front of the address.

Example: Data.dump D:0--3
Normally there is no need to use the following memory classes: P, D since program and data memory space
are not separated.
MAP.BUS8
Format:
Bus width mapping
MAP.BUS8 [<address range>]
This command is used to force the debugger to access the specified range with Load / Store 8-bit
commands. So if you do a 32 bit wide memory dump (Data.dump <addr> /LONG) the debugger reads byteby-byte while the window shows the information in 32 bit words.
MAP.BUS16
Format:
Bus width mapping
commands. So if you do a 8 bit wide memory dump (Data.dump <addr> /BYTE) the debugger reads wordby-word while the window shows the information byte-by-byte.
As a follow the debugger might read more than the dump window shows, so if a memory cell is sensitive on
read accesses you might touch it unintentional.
MAP.BUS32
Format:
Bus width mapping
commands. So if you do a 8 bit wide memory dump (Data.dump <addr> /BYTE) the debugger reads 32 bit
values while the window shows the information byte-by-byte.
As a follow the debugger might read more than the dump window shows, so if a memory cell is sensitive on
read accesses you might touch it unintentional.
XTENSA Debugger
16
CPU specific SYStem Commands
SYStem.CONFIG
Configure debugger according to target topology
Format:
SYStem.CONFIG <parameter>
SYStem.MultiCore <parameter> (deprecated syntax)
<parameter>:
(General)
state
<parameter>:
(Debugport)
CJTAGFLAGS <flags>
CJTAGTCA <value>
CONNECTOR [MIPI34 | MIPI20T]
CORE <core> <chip>
CoreNumber <number>
DEBUGPORT [DebugCable0 | DebugCableA | DebugCableB]
DEBUGPORTTYPE [JTAG | SWD | CJTAG | CJTAGSWD]
NIDNTTRSTTORST [ON | OFF]
NIDNTPSRISINGEDGE [ON | OFF]
NIDNTRSTPOLARITY [High | Low]
PortSHaRing [ON | OFF | Auto]
Slave [ON | OFF]
SWDP [ON | OFF]
SWDPIDLEHIGH [ON | OFF]
SWDPTargetSel <value>
TriState [ON | OFF]
<parameter>:
(JTAG)
CHIPDRLENGTH <bits>
CHIPDRPATTERN [Standard | Alternate <pattern>]
CHIPDRPOST <bits>
CHIPDRPRE <bits>
CHIPIRLENGTH <bits>
CHIPIRPATTERN [Standard | Alternate <pattern>]
CHIPIRPOST<bits>
CHIPIRPRE <bits>
DAP2DRPOST <bits>
DAP2DRPRE <bits>
XTENSA Debugger
17
<parameter>:
(JTAG contd)
DAP2IRPOST <bits>
DAP2IRPRE <bits>
DAPDRPOST <bits>
DAPDRPRE <bits>
DAPIRPOST <bits>
DAPIRPRE <bits>
DRPOST <bits>
DRPRE <bits>
ETBDRPOST <bits>
ETBDRPRE <bits>
ETBIRPOST <bits>
ETBIRPRE <bits>
IRPOST<bits>
IRPRE <bits>
<parameter>:
(JTAG contd)
NEXTDRPOST <bits>
NEXTDRPRE <bits>
NEXTIRPOST<bits>
NEXTIRPRE <bits>
RTPDRPOST <bits>
RTPDRPRE <bits>
RTPIRPOST <bits>
RTPIRPRE <bits>
Slave [ON | OFF]
TAPState <state>
TCKLevel <level>
TriState [ON | OFF]
<parameter>:
(Multitap)
CFGCONNECT <code>
DAP2TAP <tap>
DAPTAP <tap>
DEBUGTAP <tap>
ETBTAP <tap>
MULTITAP [NONE | IcepickA | IcepickB | IcepickC | IcepickD | IcepickBB |
IcepickBC | IcepickCC | IcepickDD | STCLTAP1 | STCLTAP2 |
STCLTAP3 |
MSMTAP <irlength> <irvalue> <drlength> <drvalue>]
NJCR <tap>
RTPTAP <tap>
SLAVETAP <tap>
XTENSA Debugger
18
<parameter>:
(DAP)
AHBACCESSPORT <port>
APBACCESSPORT <port>
AXIACCESSPORT <port>
COREJTAGPORT <port>
DAP2AHBACCESSPORT <port>
DAP2APBACCESSPORT <port>
DAP2AXIACCESSPORT <port>
DAP2COREJTAGPORT <port>
DAP2DEBUGACCESSPORT <port>
DAP2JTAGPORT <port>
DAP2AHBACCESSPORT <port>
DEBUGACCESSPORT <port>
JTAGACCESSPORT <port>
MEMORYACCESSPORT <port>
<parameter>:
(Components)
ADTF.Base <address>
ADTF.RESET
AET.Base <address>
AET.RESET
BMC.Base <address>
BMC.RESET
CMI.Base <address>
CMI.RESET
CMI.TraceID <id>
COREDEBUG.Base <address>
COREDEBUG.RESET
CTI.Base <address>
CTI.Config [NONE | ARMV1 | ARMPostInit | OMAP3 | TMS570 | CortexV1 |
QV1]
CTI.RESET
DRM.Base <address>
DRM.RESET
XTENSA Debugger
19
DTM.RESET
DTM.Type [None | Generic]
DWT.Base <address>
DWT.RESET
EPM.Base <address>
EPM.RESET
ETB2AXI.Base <address>
ETB2AXI.RESET
ETB.ATBSource <source>
ETB.Base <address>
ETB.RESET
ETB.Size <size>
ETF.ATBSource <source>
ETF.Base <address>
ETF.RESET
ETM.Base <address>
ETM.RESET
ETR.ATBSource <source>
ETR.Base <address>
ETR.RESET
FUNNEL.ATBSource <sourcelist>
FUNNEL.Base <address>
FUNNEL.Name <string>
FUNNEL.RESET
HSM.Base <address>
HSM.RESET
HTM.Base <address>
HTM.RESET
ICE.Base <address>
ICE.RESET
ITM.Base <address>
ITM.RESET
OCP.Base <address>
OCP.RESET
OCP.TraceID <id>
OCP.Type <type>
PMI.Base <address>
PMI.RESET
PMI.TraceID <id>
RTP.Base <address>
RTP.PerBase <address>
RTP.RamBase <address>
RTP.RESET
SC.Base <address>
SC.RESET
SC.TraceID <id>
STM.Base <address>
STM.Mode [NONE | XTIv2 | SDTI | STP | STP64 | STPv2]
STM.RESET
STM.Type [None | Generic | ARM | SDTI | TI]
TPIU.ATBSource <source>
XTENSA Debugger
20
TPIU.Base <address>
TPIU.RESET
TPIU.Type [CoreSight | Generic]
<parameter>:
(Deprecated)
BMCBASE <address>
BYPASS <seq>
COREBASE <address>
CTIBASE <address>
CTICONFIG [NONE | ARMV1 | ARMPostInit | OMAP3 | TMS570 | CortexV1 |
QV1]
DEBUGBASE <address>
DTMCONFIG [ON | OFF]
DTMETBFUNNELPORT <port>
DTMFUNNEL2PORT <port>
DTMFUNNELPORT <port>
DTMTPIUFUNNELPORT <port>
DWTBASE <address>
ETB2AXIBASE <address>
ETBBASE <address>
ETBFUNNELBASE <address>
ETFBASE <address>
ETMBASE <address>
ETMETBFUNNELPORT <port>
ETMFUNNEL2PORT <port>
ETMFUNNELPORT <port>
ETMTPIUFUNNELPORT <port>
FILLDRZERO [ON | OFF]
FUNNEL2BASE <address>
FUNNELBASE <address>
HSMBASE <address>
HTMBASE <address>
HTMETBFUNNELPORT <port>
HTMFUNNEL2PORT <port>
HTMFUNNELPORT <port>
HTMTPIUFUNNELPORT <port>
ITMBASE <address>
ITMETBFUNNELPORT <port>
ITMFUNNEL2PORT <port>
ITMFUNNELPORT <port>
ITMTPIUFUNNELPORT <port>
PERBASE <address>
RAMBASE <address>
RTPBASE <address>
SDTIBASE <address>
STMBASE <address>
STMETBFUNNELPORT<port>
STMFUNNEL2PORT<port>
STMFUNNELPORT<port>
STMTPIUFUNNELPORT<port>
TIADTFBASE <address>
TIDRMBASE <address>
XTENSA Debugger
21
TIEPMBASE <address>
TIICEBASE <address>
TIOCPBASE <address>
TIOCPTYPE <type>
TIPMIBASE <address>
TISCBASE <address>
TISTMBASE <address>
TPIUBASE <address>
TPIUFUNNELBASE <address>
TRACEETBFUNNELPORT <port>
TRACEFUNNELPORT<port>
TRACETPIUFUNNELPORT <port>
view
The SYStem.CONFIG commands inform the debugger about the available on-chip debug and trace
components and how to access them.
This is a common description of the SYStem.CONFIG command group for the ARM, CevaX, TI DSP and
Hexagon debugger. Each debugger will provide only a subset of these commands. Some commands need
a certain CPU type selection (SYStem.CPU <type>) to become active and it might additionally depend on
further settings.
Ideally you can select with SYStem.CPU the chip you are using which causes all setup you need and you do
not need any further SYStem.CONFIG command.
The SYStem.CONFIG command information shall be provided after the SYStem.CPU command which
might be a precondition to enter certain SYStem.CONFIG commands and before you start up the debug
session e.g. by SYStem.Up.
Syntax remarks:
The commands are not case sensitive. Capital letters show how the command can be shortened.
Example: SYStem.CONFIG.DWT.Base 0x1000 -> SYS.CONFIG.DWT.B 0x1000
The dots after SYStem.CONFIG can alternatively be a blank.
Example: SYStem.CONFIG.DWT.Base 0x1000 or SYStem.CONFIG DWT Base 0x1000.
<parameter> General
state
Opens a window showing most of the SYStem.CONFIG settings

and allows to modify them.
XTENSA Debugger
22
<parameter> describing the Debugport
CJTAGFLAGS <flags>
Activates bug fixes for cJTAG implementations.

Bit 0: Disable scanning of cJTAG ID.
Bit 1: Target has no keeper.
Bit 2: Inverted meaning of SREDGE register.
Bit 3: Old command opcodes.
Bit 4: Unlock cJTAG via APFC register.
Default: 0
CJTAGTCA <value>
Selects the TCA (TAP Controller Address) to address a device in a

cJTAG Star-2 configuration. The Star-2 configuration requires a
unique TCA for each device on the debug port.
CONNECTOR
[MIPI34 | MIPI20T]
Specifies the connector MIPI34 or MIPI20T on the target. This

is mainly needed in order to notify the trace pin location.
Default: MIPI34 if CombiProbe is used.
XTENSA Debugger
23
CORE <core> <chip>
The command helps to identify debug and trace resources which

are commonly used by different cores. The command might be
required in a multicore environment if you use multiple debugger
instances (multiple TRACE32 GUIs) to simultaneously debug
different cores on the same target system.
Because of the default setting of this command
debugger#1: <core>=1 <chip>=1
...
each debugger instance assumes that all notified debug and trace
resources can exclusively be used.
But some target systems have shared resources for different
cores. For example a common trace port. The default setting
causes that each debugger instance will control the (same) trace
port. Sometimes it does not hurt if such a module will be controlled
twice. So even then it might work. But the correct specification
which might be a must is to tell the debugger that these cores
sharing resources are on the same <chip>. Whereby the chip
does not need to be identical with the device on your target board:
For cores on the same <chip> the debugger assumes they share
the same resource if the control registers of the resource has the
same address.
Default:
<core> depends on CPU selection, usually 1.
<chip> derives from CORE= parameter in the configuration file
(config.t32), usually 1. If you start multiple debugger instances with
the help of t32start.exe you will get ascending values (1, 2, 3,...).
CoreNumber <number>
Number of cores considered in an SMP (symmetric

multiprocessing) debug session. There are core types like
ARM11MPCore, CortexA5MPCore, CortexA9MPCore and
Scorpion which can be used as a single core processor or as a
scalable multicore processor of the same type. If you intend to
debug more than one such core in an SMP debug session you
need to specify the number of cores you intend to debug.
Default: 1.
DEBUGPORT
[DebugCable0 | DebugCableA | DebugCableB]
It specifies which probe cable shall be used e.g. DebugCableA or

DebugCableB. At the moment only the CombiProbe allows to
connect more than one probe cable.
Default: depends on detection.
XTENSA Debugger
24
DEBUGPORTTYPE
[JTAG | SWD | CJTAG |
CJTAGSWD]
It specifies the used debug port type JTAG, SWD, CJTAG,

CJTAG-SWD. It assumes the selected type is supported by the
target.
Default: JTAG.
What is NIDnT?
NIDnT is an acronym for Narrow Interface for Debug and Test.
NIDnT is a standard from the MIPI Alliance, which defines how to
reuse the pins of an existing interface (like for example a microSD
card interface) as a debug and test interface.
To support the NIDnT standard in different implementations,
TRACE32 has several special options:
NIDNTPSRISINGEDGE
[ON | OFF]
Send data on rising edge for NIDnT PS switching.

NIDnT specifies how to switch, for example, the microSD card
interface to a debug interface by sending in a special bit sequence
via two pins of the microSD card.
TRACE32 will send the bits of the sequence incident to the falling
edge of the clock, because TRACE32 expects that the target
samples the bits on the rising edge of the clock.
Some targets will sample the bits on the falling edge of the clock
instead. To support such targets, you can configure TRACE32 to
send bits on the rising edge of the clock by using
SYStem.CONFIG NIDNTPSRISINGEDGE ON
NOTE: Only enable this option right before you send the NIDnT
switching bit sequence.
Make sure to DISABLE this option, before you try to connect to the
target system with for example SYStem.Up.
NIDNTRSTPOLARITY
[High | Low]
Usually TRACE32 requires that the system reset line of a target

system is low active and has a pull-up on the target system.
When connecting via NIDnT to a target system, the reset line
might be a high-active signal.
To configure TRACE32 to use a high-active reset signal, use
SYStem.CONFIG NIDNTRSTPOLARITY High
This option must be used together with
SYStem.CONFIG NIDNTTRSTTORST ON
because you also have to use the TRST signal of an ARM debug
cable as reset signal for NIDnT in this case.
XTENSA Debugger
25
NIDNTTRSTTORST
[ON | OFF]
Usually TRACE32 requires that the system reset line of a target

system is low active and has a pull-up on the target system.
This is how the system reset line is usually implemented on regular
ARM-based targets.
When connecting via NIDnT (e.g. a microSD card slot) to the
target system, the reset line might not include a pull-up on the
target system.
To circumvent problems, TRACE32 allows to drive the target reset
line via the TRST signal of an ARM debug cable.
Enable this option if you want to use the TRST signal of an ARM
debug cable as reset signal for a NIDnT.
PortSHaRing [ON | OFF |

Auto]
Configure if the debug port is shared with another tool, e.g. an

ETAS ETK.
OFF: Default. Communicate with the target without sending
requests.
ON: Request for access to the debug port and wait until the access
is granted before communicating with the target.
Auto: Automatically detect a connected tool on next
SYStem.Mode Up, SYStem.Mode Attach or SYStem.Mode Go. If
a tool is detected switch to mode ON else switch to mode OFF.
The current setting can be obtained by the PORTSHARING()
function, immediate detection can be performed using
SYStem.DETECT PortSHaRing.
Slave [ON | OFF]
If several debuggers share the same debug port, all except one
must have this option active.
JTAG: Only one debugger - the master - is allowed to control the
signals nTRST and nSRST (nRESET). The other debugger need
to have Slave=OFF.
Default: OFF; ON if CORE=... >1 in config file (e.g. config.t32).
SWDP [ON | OFF]
With this command you can change from the normal JTAG
interface to the serial wire debug mode. SWDP (Serial Wire Debug
Port) uses just two signals instead of five. It is required that the
target and the debugger hard- and software supports this
interface.
Default: OFF.
XTENSA Debugger
26
SWDPIdleHigh
[ON | OFF]
Keep SWDIO line high when idle. Only for Serialwire Debug mode.
Usually the debugger will pull the SWDIO data line low, when no
operation is in progress, so while the clock on the SWCLK line is
stopped (kept low).
You can configure the debugger to pull the SWDIO data line
high, when no operation is in progress by using
SYStem.CONFIG SWDPIDLEHIGH ON
Default: OFF.
SWDPTargetSel <value>
Device address in case of a multidrop serial wire debug port.

Default: 0.
TriState [ON | OFF]
TriState has to be used if several debug cables are connected to a

common JTAG port. TAPState and TCKLevel define the TAP state
and TCK level which is selected when the debugger switches to
tristate mode. Please note: nTRST must have a pull-up resistor on the
target, TCK can have a pull-up or pull-down resistor, other trigger
inputs needs to be kept in inactive state.
Default: OFF.
XTENSA Debugger
27
<parameter> describing the JTAG scan chain and signal behavior

With the JTAG interface you can access a Test Access Port controller (TAP) which has implemented a state
machine to provide a mechanism to read and write data to an Instruction Register (IR) and a Data Register
(DR) in the TAP. The JTAG interface will be controlled by 5 signals: nTRST(reset), TCK (clock), TMS (state
machine control), TDI (data input), TDO (data output). Multiple TAPs can be controlled by one JTAG
interface by daisy-chaining the TAPs (serial connection). If you want to talk to one TAP in the chain you need
to send a BYPASS pattern (all ones) to all other TAPs. For this case the debugger needs to know the
position of the TAP he wants to talk to which can be notified with the first four commands in the table below.
... DRPOST <bits>
Defines the TAP position in a JTAG scan chain. Number of TAPs

in the JTAG chain between the TDI signal and the TAP you are
describing. In BYPASS mode each TAP contributes one data
register bit. See possible TAP types and example below.
Default: 0.
... DRPRE <bits>
Defines the TAP position in a JTAG scan chain. Number of TAPs

in the JTAG chain between the TAP you are describing and the
TDO signal. In BYPASS mode each TAP contributes one data
register bit. See possible TAP types and example below.
Default: 0.
... IRPOST <bits>
Defines the TAP position in a JTAG scan chain. Number of

Instruction Register (IR) bits of all TAPs in the JTAG chain
between TDI signal and the TAP you are describing. See
possible TAP types and example below.
Default: 0.
... IRPRE <bits>
Defines the TAP position in a JTAG scan chain. Number of

Instruction Register (IR) bits of all TAPs in the JTAG chain
between the TAP you are describing and the TDO signal. See
possible TAP types and example below.
Default: 0.
CHIPDRLENGTH <bits>
Number of Data Register (DR) bits which needs to get a certain

BYPASS pattern.
CHIPDRPATTERN [Standard | Alternate <pattern>]
Data Register (DR) pattern which shall be used for BYPASS

instead of the standard (1...1) pattern.
CHIPIRLENGTH <bits>
Number of Instruction Register (IR) bits which needs to get a

certain BYPASS pattern.
CHIPIRPATTERN [Standard
| Alternate <pattern>]
Instruction Register (IR) pattern which shall be used for BYPASS

instead of the standard pattern.
XTENSA Debugger
28
Slave [ON | OFF]
If several debugger share the same debug port, all except one
must have this option active.
JTAG: Only one debugger - the master - is allowed to control
the signals nTRST and nSRST (nRESET). The other debugger
need to have Slave=OFF.
Default: OFF; ON if CORE=... >1 in config file (e.g. config.t32).
For CortexM: Please check also
SYStem.Option DISableSOFTRES [ON | OFF]
TAPState <state>
This is the state of the TAP controller when the debugger

switches to tristate mode. All states of the JTAG TAP controller
are selectable.
0 Exit2-DR
1 Exit1-DR
2 Shift-DR
3 Pause-DR
4 Select-IR-Scan
5 Update-DR
6 Capture-DR
7 Select-DR-Scan
8 Exit2-IR
9 Exit1-IR
10 Shift-IR
11 Pause-IR
12 Run-Test/Idle
13 Update-IR
14 Capture-IR
15 Test-Logic-Reset
Default: 7 = Select-DR-Scan.
TCKLevel <level>
Level of TCK signal when all debuggers are tristated. Normally

defined by a pull-up or pull-down resistor on the target.
Default: 0.
TriState [ON | OFF]
TriState has to be used if several debug cables are connected to a

common JTAG port. TAPState and TCKLevel define the TAP state
and TCK level which is selected when the debugger switches to
tristate mode. Please note: nTRST must have a pull-up resistor on
the target, TCK can have a pull-up or pull-down resistor, other
trigger inputs needs to be kept in inactive state.
Default: OFF.
XTENSA Debugger
29
TAP types:
Core TAP providing access to the debug register of the core you intend to debug.
-> DRPOST, DRPRE, IRPOST, IRPRE.
DAP (Debug Access Port) TAP providing access to the debug register of the core you intend to debug. It
might be needed additionally to a Core TAP if the DAP is only used to access memory and not to access the
core debug register.
-> DAPDRPOST, DAPDRPRE, DAPIRPOST, DAPIRPRE.
DAP2 (Debug Access Port) TAP in case you need to access a second DAP to reach other memory
locations.
-> DAP2DRPOST, DAP2DRPRE, DAP2IRPOST, DAP2IRPRE.
ETB (Embedded Trace Buffer) TAP if the ETB has an own TAP to access its control register (typical with
ARM11 cores).
-> ETBDRPOST, ETBDRPRE, ETBIRPOST, ETBIRPRE.
NEXT: If a memory access changes the JTAG chain and the core TAP position then you can specify the new
values with the NEXT... parameter. After the access for example the parameter NEXTIRPRE will replace the
IRPRE value and NEXTIRPRE becomes 0. Available only on ARM11 debugger.
-> NEXTDRPOST, NEXTDRPRE, NEXTIRPOST, NEXTIRPRE.
RTP (RAM Trace Port) TAP if the RTP has an own TAP to access its control register.
-> RTPDRPOST, RTPDRPRE, RTPIRPOST, RTPIRPRE.
CHIP: Definition of a TAP or TAP sequence in a scan chain that needs a different Instruction Register
(IR) and Data Register (DR) pattern than the default BYPASS (1...1) pattern.
-> CHIPDRPOST, CHIPDRPRE, CHIPIRPOST, CHIPIRPRE.
Example:
TDI
ARM11 TAP
ETB TAP
OfNoInterest TAP
DAP TAP
IR: 5bit
IR: 4bit
IR: 7bit
IR: 4bit
SYStem.CONFIG
SYStem.CONFIG
SYStem.CONFIG
SYStem.CONFIG
SYStem.CONFIG
SYStem.CONFIG
SYStem.CONFIG
SYStem.CONFIG
TDO
IRPRE 15.
DRPRE 3.
DAPIRPOST 16.
DAPDRPOST 3.
ETBIRPOST 5.
ETBDRPOST 1.
ETBIRPRE 11.
ETBDRPRE 2.
XTENSA Debugger
30
XTENSA Debugger
31
<parameter> describing a system level TAP Multitap

A Multitap is a system level or chip level test access port (TAP) in a JTAG scan chain. It can for example
provide functions to re-configure the JTAG chain or view and control power, clock, reset and security of
different chip components.
At the moment the debugger supports three types and its different versions:
Icepickx, STCLTAPx, MSMTAP:
Example:
JTAG
TDI
Multitap
IcepickC
ARM11
TAP
DAP
TAP
ETB
TAP
TDO
MULTITAP
DEBUGTAP
DAPTAP
ETBTAB
TMS
TCK
IcepickC
1
4
5
nTRST
CFGCONNECT <code>
The <code> is a hexadecimal number which defines the JTAG

scan chain configuration. You need the chip documentation to
figure out the suitable code. In most cases the chip specific
default value can be used for the debug session.
Used if MULTITAP=STCLTAPx.
DAPTAP <tap>
Specifies the TAP number which needs to be activated to get the

DAP TAP in the JTAG chain.
Used if MULTITAP=Icepickx.
DAP2TAP <tap>
Specifies the TAP number which needs to be activated to get a

2nd DAP TAP in the JTAG chain.
XTENSA Debugger
32
DEBUGTAP <tap>

core TAP in the JTAG chain. E.g. ARM11 TAP if you intend to
debug an ARM11.
ETBTAP <tap>

ETB TAP in the JTAG chain.
Used if MULTITAP=Icepickx. ETB = Embedded Trace Buffer.
MULTITAP
[NONE | IcepickA | IcepickB
| IcepickC | IcepickD |
IcepickBB | IcepickBC |
IcepickCC | IcepickDD |
STCLTAP1 | STCLTAP2 |
STCLTAP3 | MSMTAP
<irlength> <irvalue>
<drlength> <drvalue>]
Selects the type and version of the MULTITAP.
NJCR <tap>
Number of a Non-JTAG Control Register (NJCR) which shall be

used by the debugger.
In case of MSMTAP you need to add parameters which specify

which IR pattern and DR pattern needed to be shifted by the
debugger to initialize the MSMTAP. Please note some of these
parameters need a decimal input (dot at the end).
IcepickXY means that there is an Icepick version X which
includes a subsystem with an Icepick of version Y.
RTPTAP <tap>

RTP TAP in the JTAG chain.
Used if MULTITAP=Icepickx. RTP = RAM Trace Port.
SLAVETAP <tap>
Specifies the TAP number to get the Icepick of the sub-system in

the JTAG scan chain.
Used if MULTITAP=IcepickXY (two Icepicks).
XTENSA Debugger
33
<parameter> configuring a CoreSight Debug Access Port DAP

A Debug Access Port (DAP) is a CoreSight module from ARM which provides access via its debugport
(JTAG, cJTAG, SWD) to:
1. Different memory busses (AHB, APB, AXI). This is especially important if the on-chip debug register
needs to be accessed this way. You can access the memory buses by using certain access classes with the
debugger commands: AHB:, APB:, AXI:, DAP, E:. The interface to these buses is called Memory
Access Port (MEM-AP).
2. Other, chip-internal JTAG interfaces. This is especially important if the core you intend to debug is
connected to such an internal JTAG interface. The module controlling these JTAG interfaces is called JTAG
Access Port (JTAG-AP). Each JTAG-AP can control up to 8 internal JTAG interfaces. A port number between
0 and 7 denotes the JTAG interfaces to be addressed.
3. At emulation or simulation system with using bus transactors the access to the busses must be specified
by using the transactor identification name instead using the access port commands. For emulations/
simulations with a DAP transactor the individual bus transactor name dont need to be configured. Instead of
this the DAP transactor name need to be passed and the regular access ports to the busses.
XTENSA Debugger
34
Debug Access Port (DAP)
Debugger
0 Memory Access Port

(MEM-AP)
Debug Port
JTAG or
cJTAG or
SWD
System Memory
Debug Bus (APB)
Chip
System Bus (AHB)
Example:
Debug Register
Trace Register
1 Memory Access Port

(MEM-AP)
ROM Table
0 JTAG
2 JTAG Access Port
(JTAG-AP)
7 JTAG
AHBACCESSPORT 0
MEMORYACCESSPORT 0
APBACCESSPORT 1
DEBUGACCESSPORT 1
JTAGACCESSPORT 2
ARM9
COREJTAGPORT 7
AHBACCESSPORT <port>
DAP access port number (0-255) which shall be used for AHB:
access class. Default: <port>=0.
APBACCESSPORT <port>
DAP access port number (0-255) which shall be used for APB:
access class. Default: <port>=1.
AXIACCESSPORT <port>
DAP access port number (0-255) which shall be used for AXI:
access class. Default: port not available
COREJTAGPORT <port>
JTAG-AP port number (0-7) connected to the core which shall be

debugged.
XTENSA Debugger
35
DAP2AHBACCESSPORT
<port>
DAP2 access port number (0-255) which shall be used for

AHB2: access class. Default: <port>=0.
DAP2APBACCESSPORT
<port>

APB2: access class. Default: <port>=1.
DAP2AXIACCESSPORT
<port>

AXI2: access class. Default: port not available
DAP2DEBUGACCESSPORT <port>
DAP2 access port number (0-255) where the debug register can
be found (typically on APB). Used for DAP2: access class.
Default: <port>=1.
DAP2COREJTAGPORT
<port>
JTAG-AP port number (0-7) connected to the core which shall be

debugged. The JTAG-AP can be found on another DAP (DAP2).
DAP2JTAGPORT <port>
JTAG-AP port number (0-7) for an (other) DAP which is

connected to a JTAG-AP.
DAP2MEMORYACCESSPORT <port>
DAP2 access port number where system memory can be

accessed even during runtime (typically on AHB). Used for E:
access class while running, assuming SYStem.MemoryAccess
DAP2. Default: <port>=0.
DEBUGACCESSPORT
<port>
DAP access port number (0-255) where the debug register can
be found (typically on APB). Used for DAP: access class.
Default: <port>=1.
JTAGACCESSPORT <port>
DAP access port number (0-255) of the JTAG Access Port.
MEMORYACCESSPORT
<port>
DAP access port number where system memory can be

accessed even during runtime (typically on AHB). Used for E:
DAP. Default: <port>=0.
AHBNAME <name>
AHB bus transactor name that shall be used for AHB: access
class.
APBNAME <name>
APB bus transactor name that shall be used for APB: access
class.
AXINAME <name>
AXI bus transactor name that shall be used for AXI: access
class.
DAP2AHBNAME <name>
AHB bus transactor name that shall be used for AHB2: access
class.
XTENSA Debugger
36
DAP2APBNAME <name>
APB bus transactor name that shall be used for APB2: access
class.
DAP2AXINAME <name>
AXI bus transactor name that shall be used for AXI2: access
class.
DAP2DEBUGBUSNAME
<name>
APB bus transactor name identifying the bus where the debug
register can be found. Used for DAP2: access class.
DAP2MEMORYBUSNAME
<name>
AHB bus transactor name identifying the bus where system

memory can be accessed even during runtime. Used for E:
DAP2.
DEBUGBUSNAME <name>
APB bus transactor name identifying the bus where the debug
register can be found. Used for DAP: access class.
MEMORYBUSNAME
<name>
AHB bus transactor name identifying the bus where system

memory can be accessed even during runtime. Used for E:
DAP.
DAPNAME <name>
DAP transactor name that shall be used for DAP access ports.
DAP2NAME <name>
DAP transactor name that shall be used for DAP access ports of
2nd order.
XTENSA Debugger
37
<parameter> describing debug and trace Components

In the Components folder in the SYStem.CONFIG.state window you can comfortably add the debug and
trace components your chip includes and which you intend to use with the debuggers help.
Each configuration can be done by a command in a script file as well. Then you do not need to enter
everything again on the next debug session. If you press the button with the three dots you get the
corresponding command in the command line where you can view and maybe copy it into a script file.
XTENSA Debugger
38
You can have several of the following components: CMI, ETB, ETF, ETR, FUNNEL, STM.
Example: FUNNEL1, FUNNEL2, FUNNEL3,...
The <address> parameter can be just an address (e.g. 0x80001000) or you can add the access class in
front (e.g. AHB:0x80001000). Without access class it gets the command specific default access class which
is EDAP: in most cases.
Example:
Core
ETM
Core
ETM
0
1
FUNNEL
0
FUNNEL
STM
TPIU
SYStem.CONFIG.COREDEBUG.Base 0x80010000 0x80012000

SYStem.CONFIG.BMC.Base 0x80011000 0x80013000
SYStem.CONFIG.ETM.Base 0x8001c000 0x8001d000
SYStem.CONFIG.STM1.Base EAHB:0x20008000
SYStem.CONFIG.STM1.Type ARM
SYStem.CONFIG.STM1.Mode STPv2
SYStem.CONFIG.FUNNEL1.Base 0x80004000
SYStem.CONFIG.FUNNEL2.Base 0x80005000
SYStem.CONFIG.TPIU.Base 0x80003000
SYStem.CONFIG.FUNNEL1.ATBSource ETM.0 0 ETM.1 1
SYStem.CONFIG.FUNNEL2.ATBSource FUNNEL1 0 STM1 7
SYStem.CONFIG.TPIU.ATBSource FUNNEL2
XTENSA Debugger
39
... .ATBSource <source>
Specify for components collecting trace information from where the

trace data are coming from. This way you inform the debugger
about the interconnection of different trace components on a
common trace bus.
You need to specify the ... .Base <address> or other attributes
that define the amount of existing peripheral modules before you
can describe the interconnection by ... .ATBSource <source>.
A CoreSight trace FUNNEL has eight input ports (port 0-7) to
combine the data of various trace sources to a common trace
stream. Therefore you can enter instead of a single source a list
of sources and input port numbers.
Example:
SYStem.CONFIG FUNNEL.ATBSource ETM 0 HTM 1 STM 7
Meaning: The funnel gets trace data from ETM on port 0, from
HTM on port 1 and from STM on port 7.
In an SMP (Symmetric MultiProcessing) debug session where
you used a list of base addresses to specify one component per
core you need to indicate which component in the list is meant:
XTENSA Debugger
40
Example: Four cores with ETM modules.

SYStem.CONFIG ETM.Base 0x1000 0x2000 0x3000 0x4000
SYStem.CONFIG FUNNEL1.ATBSource ETM.0 0 ETM.1 1
ETM.2 2 ETM.3 3
"...2" of "ETM.2" indicates it is the third ETM module which has
the base address 0x3000. The indices of a list are 0, 1, 2, 3,...
If the numbering is accelerating, starting from 0, without gaps,
like the example above then you can shorten it to
SYStem.CONFIG FUNNEL1.ATBSource ETM
Example: Four cores, each having an ETM module and an ETB
module.
SYStem.CONFIG ETM.Base 0x1000 0x2000 0x3000 0x4000
SYStem.CONFIG ETB.Base 0x5000 0x6000 0x7000 0x8000
SYStem.CONFIG ETB.ATBSource ETM.2 2
The third "ETM.2" module is connected to the third ETB. The last
"2" in the command above is the index for the ETB. It is not a port
number which exists only for FUNNELs.
For a list of possible components including a short description
see Components and available commands.
... .BASE <address>
This command informs the debugger about the start address of

the register block of the component. And this way it notifies the
existence of the component. An on-chip debug and trace
component typically provides a control register block which
needs to be accessed by the debugger to control this
component.
Example: SYStem.CONFIG ETMBASE APB:0x8011c000
Meaning: The control register block of the Embedded Trace
Macrocell (ETM) starts at address 0x8011c000 and is accessible
via APB bus.
In an SMP (Symmetric MultiProcessing) debug session you can
enter for the components BMC, COREBEBUG, CTI, ETB, ETF,
ETM, ETR a list of base addresses to specify one component per
core.
Example assuming four cores: SYStem.CONFIG
COREDEBUG.Base 0x80001000 0x80003000 0x80005000
0x80007000
... .RESET
Undo the configuration for this component. This does not cause a
physical reset for the component on the chip.
XTENSA Debugger
41
... .TraceID <id>
Identifies from which component the trace packet is coming from.

Components which produce trace information (trace sources) for a
common trace stream have a selectable .TraceID <id>.
If you miss this SYStem.CONFIG command for a certain trace
source (e.g. ETM) then there is a dedicated command group for
this component where you can select the ID (ETM.TraceID <id>).
The default setting is typically fine because the debugger uses
different default TraceIDs for different components.
CTI.Config <type>
Informs about the interconnection of the core Cross Trigger

Interfaces (CTI). Certain ways of interconnection are common
and these are supported by the debugger e.g. to cause a
synchronous halt of multiple cores.
NONE: The CTI is not used by the debugger.
ARMV1: This mode is used for ARM7/9/11 cores which support
synchronous halt, only.
ARMPostInit: Like ARMV1 but the CTI connection differs from the
ARM recommendation.
OMAP3: This mode is not yet used.
TMS570: Used for a certain CTI connection used on a TMS570
derivative.
CortexV1: The CTI will be configured for synchronous start and
stop via CTI. It assumes the connection of DBGRQ, DBGACK,
DBGRESTART signals to CTI are done as recommended by
ARM. The CTIBASE must be notified. CortexV1 is the default
value if a Cortex-R/-A core is selected and the CTIBASE is
notified.
QV1: This mode is not yet used.
ARMV8V1: Channel 0 and 1 of the CTM are used to distribute
start/stop events from and to the CTIs. ARMv8 only.
ARMV8V2: Channel 2 and 3 of the CTM are used to distribute
start/stop events from and to the CTIs. ARMv8 only.
Informs the debugger that a customer proprietary Data Trace

Message (DTM) module is available. This causes the debugger
to consider this source when capturing common trace data.
Trace data from this module will be recorded and can be
accessed later but the unknown DTM module itself will not be
controlled by the debugger.
ETB.Size <size>
Specifies the size of the Embedded Trace Buffer. The ETB size
can normally be read out by the debugger. Therefore this
command is only needed if this can not be done for any reason.
XTENSA Debugger
42
It is possible that different funnels have the same address for

their control register block. This assumes they are on different
buses and for different cores. In this case it is needed to give the
funnel different names to differentiate them.
OCP.Type <type>
Specifies the type of the OCP module. The <type> is just a

number which you need to figure out in the chip documentation.
PERBASE specifies the base address of the core peripheral

registers which accesses shall be traced. PERBASE is needed
for the RAM Trace Port (RTP) which is available on some
derivatives from Texas Instruments. The trace packages include
only relative addresses to PERBASE and RAMBASE.
RAMBASE is the start address of RAM which accesses shall be

traced. RAMBASE is needed for the RAM Trace Port (RTP)
which is available on some derivatives from Texas Instruments.
The trace packages include only relative addresses to PERBASE
and RAMBASE.
STM.Mode [NONE | XTIv2 |

SDTI | STP | STP64 | STPv2]
Selects the protocol type used by the System Trace Module (STM).
STM.Type [None | Generic |

ARM | SDTI | TI]
Selects the type of the System Trace Module (STM). Some types
allow to work with different protocols (see STM.Mode).
TPIU.Type [CoreSight |
Generic]
Selects the type of the Trace Port Interface Unit (TPIU).

CoreSight: Default. CoreSight TPIU. TPIU control register
located at TPIU.Base <address> will be handled by the
debugger.
Generic: Proprietary TPIU. TPIU control register will not be
handled by the debugger.
Components and available commands
See the description of the commands above. Please note that there is a common description for
... .ATBSource, ... .Base, , ... .RESET, ... .TraceID.
ADTF.Base <address>
ADTF.RESET
AMBA trace bus DSP Trace Formatter (ADTF) - Texas Instruments
Module of a TMS320C5x or TMS320C6x core converting program and data trace information in ARM
CoreSight compliant format.
AET.Base <address>
AET.RESET
Advanced Event Triggering unit (AET) - Texas Instruments
Trace source module of a TMS320C5x or TMS320C6x core delivering program and data trace information.
XTENSA Debugger
43
BMC.Base <address>
BMC.RESET
Performance Monitor Unit (PMU) - ARM debug module, e.g. on Cortex-A/R
Bench-Mark-Counter (BMC) is the TRACE32 term for the same thing.
The module contains counter which can be programmed to count certain events (e.g. cache hits).
CMI.Base <address>
CMI.RESET
CMI.TraceID <id>
Clock Management Instrumentation (CMI) - Texas Instruments
Trace source delivering information about clock status and events to a system trace module.
COREDEBUG.RESET
Core Debug Register - ARM debug register, e.g. on Cortex-A/R
Some cores do not have a fix location for their debug register used to control the core. In this case it is
essential to specify its location before you can connect by e.g. SYStem.Up.
CTI.Base <address>
CTI.Config [NONE | ARMV1 | ARMPostInit | OMAP3 | TMS570 | CortexV1 | QV1]
CTI.RESET
Cross Trigger Interface (CTI) - ARM CoreSight module
If notified the debugger uses it to synchronously halt (and sometimes also to start) multiple cores.
DRM.Base <address>
DRM.RESET
Debug Resource Manager (DRM) - Texas Instruments
It will be used to prepare chip pins for trace output.
DTM.RESET
Data Trace Module (DTM) - generic, CoreSight compliant trace source module
If specified it will be considered in trace recording and trace data can be accessed afterwards.
DTM module itself will not be controlled by the debugger.
DWT.Base <address>
DWT.RESET
Data Watchpoint and Trace unit (DWT) - ARM debug module on Cortex-M cores
Normally fix address at 0xE0001000 (default).
EPM.Base <address>
EPM.RESET
Emulation Pin Manager (EPM) - Texas Instruments
It will be used to prepare chip pins for trace output.
ETB2AXI.RESET
ETB to AXI module
Similar to an ETR.
XTENSA Debugger
44
ETB.ATBSource <source>
ETB.Base <address>
ETB.RESET
ETB.Size <size>
Embedded Trace Buffer (ETB) - ARM CoreSight module
Enables trace to be stored in a dedicated SRAM. The trace data will be read out through the debug port after
the capturing has finished.
ETF.ATBSource <source>
ETF.Base <address>
ETF.RESET
Embedded Trace FIFO (ETF) - ARM CoreSight module
On-chip trace buffer used to lower the trace bandwidth peaks.
ETM.Base <address>
ETM.RESET
Embedded Trace Macrocell (ETM) - ARM CoreSight module
Program Trace Macrocell (PTM) - ARM CoreSight module
Trace source providing information about program flow and data accesses of a core.
The ETM commands will be used even for PTM.
ETR.ATBSource <source>
ETR.Base <address>
ETR.RESET
Embedded Trace Router (ETR) - ARM CoreSight module
Enables trace to be routed over an AXI bus to system memory or to any other AXI slave.
FUNNEL.ATBSource <sourcelist>
FUNNEL.Base <address>
FUNNEL.RESET
CoreSight Trace Funnel (CSTF) - ARM CoreSight module
Combines multiple trace sources onto a single trace bus (ATB = AMBA Trace Bus)
HSM.Base <address>
HSM.RESET
Hardware Security Module (HSM) - Infineon
HTM.Base <address>
HTM.RESET
AMBA AHB Trace Macrocell (HTM) - ARM CoreSight module
Trace source delivering trace data of access to an AHB bus.
ICE.Base <address>
ICE.RESET
ICE-Crusher (ICE) - Texas Instruments
ITM.Base <address>
ITM.RESET
Instrumentation Trace Macrocell (ITM) - ARM CoreSight module
Trace source delivering system trace information e.g. sent by software in printf() style.
XTENSA Debugger
45
OCP.Base <address>
OCP.RESET
OCP.TraceID <id>
OCP.Type <type>
Open Core Protocol watchpoint unit (OCP) - Texas Instruments
Trace source module delivering bus trace information to a system trace module.
PMI.Base <address>
PMI.RESET
PMI.TraceID <id>
Power Management Instrumentation (PMI) - Texas Instruments
Trace source reporting power management events to a system trace module.
RTP.Base <address>
RTP.RESET
RAM Trace Port (RTP) - Texas Instruments
Trace source delivering trace data about memory interface usage.
SC.Base <address>
SC.RESET
SC.TraceID <id>
Statistic Collector (SC) - Texas Instruments
Trace source delivering statistic data about bus traffic to a system trace module.
STM.Base <address>
STM.Mode [NONE | XTIv2 | SDTI | STP | STP64 | STPv2]
STM.RESET
STM.Type [None | Generic | ARM | SDTI | TI]
System Trace Macrocell (STM) - MIPI, ARM CoreSight, others
Trace source delivering system trace information e.g. sent by software in printf() style.
TPIU.ATBSource <source>
TPIU.Base <address>
TPIU.RESET
TPIU.Type [CoreSight | Generic]
Trace Port Interface Unit (TPIU) - ARM CoreSight module
Trace sink sending the trace off-chip on a parallel trace port (chip pins).
XTENSA Debugger
46
<parameter> which are Deprecated

In the last years the chips and its debug and trace architecture became much more complex. Especially the
CoreSight trace components and their interconnection on a common trace bus required a reform of our
commands. The new commands can deal even with complex structures.
... BASE <address>
This command informs the debugger about the start address of

the register block of the component. And this way it notifies the
existence of the component. An on-chip debug and trace
component typically provides a control register block which
needs to be accessed by the debugger to control this
component.
Example: SYStem.CONFIG ETMBASE APB:0x8011c000
Meaning: The control register block of the Embedded Trace
Macrocell (ETM) starts at address 0x8011c000 and is accessible
via APB bus.
In an SMP (Symmetric MultiProcessing) debug session you can
enter for the components BMC, CORE, CTI, ETB, ETF, ETM, ETR a
list of base addresses to specify one component per core.
Example assuming four cores: SYStem.CONFIG COREBASE
0x80001000 0x80003000 0x80005000 0x80007000.
COREBASE (old syntax: DEBUGBASE): Some cores e.g. CortexA or Cortex-R do not have a fix location for their debug register
which are used for example to halt and start the core. In this case it
is essential to specify its location before you can connect by e.g.
SYStem.UP.
PERBASE and RAMBASE are needed for the RAM Trace Port
(RTP) which is available on some derivatives from Texas
Instruments. PERBASE specifies the base address of the core
peripheral registers which accesses shall be traced, RAMBASE
is the start address of RAM which accesses shall be traced. The
trace packages include only relative addresses to PERBASE and
RAMBASE.
XTENSA Debugger
47
... PORT <port>
Informs the debugger about which trace source is connected to

which input port of which funnel. A CoreSight trace funnel
provides 8 input ports (port 0-7) to combine the data of various
trace sources to a common trace stream.
Example: SYStem.CONFIG STMFUNNEL2PORT 3
Meaning: The System Trace Module (STM) is connected to input
port #3 on FUNNEL2.
On an SMP debug session some of these commands can have a
list of <port> parameter.
In case there are dedicated funnels for the ETB and the TPIU
their base addresses are specified by ETBFUNNELBASE,
TPIUFUNNELBASE respectively. And the funnel port number for
the ETM are declared by ETMETBFUNNELPORT,
ETMTPIUFUNNELPORT respectively.
TRACE... stands for the ADTF trace source module.
BYPASS <seq>
With this option it is possible to change the JTAG bypass

instruction pattern for other TAPs. It works in a multi-TAP JTAG
chain for the IRPOST pattern, only, and is limited to 64 bit. The
specified pattern (hexadecimal) will be shifted least significant bit
first. If no BYPASS option is used, the default value is 1 for all
bits.
CTICONFIG <type>
Informs about the interconnection of the core Cross Trigger

Interfaces (CTI). Certain ways of interconnection are common
and these are supported by the debugger e.g. to cause a
synchronous halt of multiple cores.
NONE: The CTI is not used by the debugger.
ARMV1: This mode is used for ARM7/9/11 cores which support
synchronous halt, only.
ARMPostInit: Like ARMV1 but the CTI connection differs from the
ARM recommendation.
OMAP3: This mode is not yet used.
TMS570: Used for a certain CTI connection used on a TMS570
derivative.
CortexV1: The CTI will be configured for synchronous start and
stop via CTI. It assumes the connection of DBGRQ, DBGACK,
DBGRESTART signals to CTI are done as recommended by
ARM. The CTIBASE must be notified. CortexV1 is the default
value if a Cortex-R/-A core is selected and the CTIBASE is
notified.
QV1: This mode is not yet used.
XTENSA Debugger
48
Informs the debugger that a customer proprietary Data Trace

Message (DTM) module is available. This causes the debugger
to consider this source when capturing common trace data.
Trace data from this module will be recorded and can be
accessed later but the unknown DTM module itself will not be
controlled by the debugger.
This changes the bypass data pattern for other TAPs in a multiTAP JTAG chain. It changes the pattern from all 1 to all 0. This
is a workaround for a certain chip problem. It is available on the
ARM9 debugger, only.
TIOCPTYPE <type>
Specifies the type of the OCP module from Texas Instruments

(TI).
view
Opens a window showing most of the SYStem.CONFIG settings

and allows to modify them.
Deprecated versa new command
In the following you find the list of deprecated commands which can still be used for compatibility reasons
and the corresponding new command.
SYStem.CONFIG <parameter>
<parameter>:
(Deprecated)
<parameter>:
(New)
BMCBASE <address>
BMC.Base <address>
BYPASS <seq>
CHIPIRPRE <bits>
CHIPIRLENGTH <bits>
CHIPIRPATTERN.Alternate <pattern>
COREBASE <address>
CTIBASE <address>
CTI.Base <address>
CTICONFIG <type>
CTI.Config <type>
DEBUGBASE <address>
DTM.Type.Generic
DTMETBFUNNELPORT <port>
FUNNEL4.ATBSource DTM <port> (1)
DTMFUNNEL2PORT <port>
DTMFUNNELPORT <port>
DTMTPIUFUNNELPORT <port>
DWTBASE <address>
DWT.Base <address>
ETB2AXIBASE <address>
XTENSA Debugger
49
ETBBASE <address>
ETB1.Base <address>
ETBFUNNELBASE <address>
FUNNEL4.Base <address>
ETFBASE <address>
ETF1.Base <address>
ETMBASE <address>
ETM.Base <address>
ETMETBFUNNELPORT <port>
FUNNEL4.ATBSource ETM <port> (1)
ETMFUNNEL2PORT <port>
ETMFUNNELPORT <port>
ETMTPIUFUNNELPORT <port>
CHIPDRPRE 0
CHIPDRPOST 0
CHIPDRLENGTH <bits_of_complete_DR_path>
CHIPDRPATTERN.Alternate 0
FUNNEL2BASE <address>
FUNNELBASE <address>
HSMBASE <address>
HSM.Base <address>
HTMBASE <address>
HTM.Base <address>
HTMETBFUNNELPORT <port>
FUNNEL4.ATBSource HTM <port> (1)
HTMFUNNEL2PORT <port>
HTMFUNNELPORT <port>
HTMTPIUFUNNELPORT <port>
ITMBASE <address>
ITM.Base <address>
ITMETBFUNNELPORT <port>
FUNNEL4.ATBSource ITM <port> (1)
ITMFUNNEL2PORT <port>
ITMFUNNELPORT <port>
ITMTPIUFUNNELPORT <port>
PERBASE <address>
RAMBASE <address>
RTPBASE <address>
RTP.Base <address>
SDTIBASE <address>
STM1.Base <address>
STM1.Mode SDTI
STM1.Type SDTI
STMBASE <address>
STM1.Base <address>
STM1.Mode STPV2
STM1.Type ARM
STMETBFUNNELPORT <port>
FUNNEL4.ATBSource STM1 <port> (1)
STMFUNNEL2PORT <port>
STMFUNNELPORT <port>
STMTPIUFUNNELPORT <port>

XTENSA Debugger
50
TIADTFBASE <address>
ADTF.Base <address>
TIDRMBASE <address>
DRM.Base <address>
TIEPMBASE <address>
EPM.Base <address>
TIICEBASE <address>
ICE.Base <address>
TIOCPBASE <address>
OCP.Base <address>
TIOCPTYPE <type>
OCP.Type <type>
TIPMIBASE <address>
PMI.Base <address>
TISCBASE <address>
SC.Base <address>
TISTMBASE <address>
STM1.Base <address>
STM1.Mode STP
STM1.Type TI
TPIUBASE <address>
TPIU.Base <address>
TPIUFUNNELBASE <address>
TRACEETBFUNNELPORT <port>
FUNNEL4.ATBSource ADTF <port> (1)
TRACEFUNNELPORT <port>
TRACETPIUFUNNELPORT <port>
view
state
(1) Further <component>.ATBSource <source> commands might be needed to describe the full trace data
path from trace source to trace sink.
SYStem.CPU
Select the used CPU
Format:
SYStem.CPU <cpu>
<cpu>:
XTENSA | DC108MINI | DC212GP | DC232L | DC330HIFI | DC545CK |

DC570T
Selects the processor type. IF XTENSA is selected the debugger detects the architectural options from the
CPU.
XTENSA Debugger
51
SYStem.CpuAccess
Format:
Run-time memory access (intrusive)
SYStem.CpuAccess Enable | Denied | Nonstop
Default: Denied. .
Enable
Allow intrusive run-time memory access.
Denied
Lock intrusive run-time memory access.
Nonstop
Lock all features of the debugger that affect the run-time behavior.
If SYStem.CpuAccess Enable is set, it is possible to read from memory, to write to memory and to set
software breakpoints while the CPU is executing the program. To make this possible, the program execution
is shortly stopped by the debugger. Each stop takes 0.1-100 ms depending on the speed of the JTAG port
and the operations that should be performed. A red S in the state line of the TRACE32 screen warns you,
that the program is no longer running in realtime.
If specific windows, that display memory or variables should be updated while the program is running select
the memory class E: or the format option %E.
Data.dump E:0x100
Var.View %E first
XTENSA Debugger
52
SYStem.JtagClock
Define JTAG frequency
Format:
SYStem.JtagClock [<frequency> | RTCK]

SYStem.BdmClock <frequency> (deprecated).
<frequency>
10000. 40000000.
1250000. | 2500000. | 5000000. | 10000000. (on obsolete ICD hardware)
Default frequency: 1 MHz.

Selects the JTAG port frequency (TCK) used by the debugger to communicate with the processor. This
influences e.g. the download speed. It could be required to reduce the JTAG frequency if there are buffers,
additional loads or high capacities on the JTAG lines or if VTREF is very low. A very high frequency will not
work on all systems and will result in an erroneous data transfer.
<frequency>
The debugger can not select all frequencies accurately. It chooses the next
possible frequency and displays the real value in the System Settings window.
Besides a decimal number like 100000. also short forms like 10kHz or
15MHz can be used. The short forms implies a decimal value, although no .
is used.
RTCK
The JTAG interface of XTENSA does not offer RTCK (Returned TCK).
However, in multicore applications with ARM, RTCK can be used to control the
JTAG clock.
On some processor derivatives, there is the need to synchronize the processor
clock and the JTAG clock. In this case RTCK shall be selected. Synchronization
is maintained, because the debugger does not progress to the next TCK edge
until after an RTCK edge is received.
In case you have a processor derivative requiring a synchronization of the
processor clock and the JTAG clock, but your target does not provide a RTCK
signal, you need to select a fix JTAG clock below 1/6 of the processor clock
(ARM7, ARM9), below 1/8 of the processor clock (ARM11), respectively.
When RTCK is selected, the frequency depends on the processor clock and on the
propagation delays. The maximum reachable frequency is about 16 MHz.
XTENSA Debugger
53
SYStem.LOCK
Format:
Tristate the JTAG port
SYStem.LOCK [ON | OFF]
Default: OFF.
If the system is locked no access to the JTAG port will be performed by the debugger. While locked the JTAG
connector of the debugger is tristated. The intention of the lock command is for example to give JTAG
access to another tool. The process can also be automated, see SYStem.CONFIG TriState.
It must be ensured that the state of the XTENSA core JTAG state machine remains unchanged while the
system is locked. To ensure correct hand over the options SYStem.CONFIG TAPState and
SYStem.CONFIG TCKLevel must be set properly. They define the TAP state and TCK level which is
selected when the debugger switches to tristate mode.
SYStem.MemAccess
Real-time memory access (non-intrusive)
Format:
SYStem.MemAccess CPU | Denied<cpu_specific>

SYStem.ACCESS (deprecated)
CPU
Real-time memory access during program execution to target is enabled.
Denied
Real-time memory access during program execution to target is disabled.
Default: Denied.
The XTENSA Debug Option does not offer a mermory access while code is executed.
XTENSA Debugger
54
SYStem.Mode
Establish the communication with the target
Format:
SYStem.Mode <mode>
<mode>:
Down
NoDebug
Go
Attach
Up
Down
Disables the debugger (default). The state of the CPU remains unchanged. The
JTAG port is tristated.
NoDebug
Disables the debugger. The state of the CPU remains unchanged. The JTAG
port is tristated.
Go
Resets the target and enables the debugger and start the program execution.
Program execution can be stopped by the break command or external trigger.
Attach
User program remains running (no reset) and the debug mode is activated.
After this command the user program can be stopped with the break command
or if any break condition occurs.
The automatic endian detection does not work in this case. Set the
SYStem.Option Endianess to Little or Big before executing SYStem.Mode
Attach.
StandBy
Not available for XTENSA.
Up
Resets the target, sets the CPU to debug mode and stops the CPU. After the
execution of this command the CPU is stopped and all register are set to the
default level.
SYStem.Option Endianess
Format:
Specify the byte ordering
SYStem.Option Endianess [AUTO | Little | Big]
Default: AUTO.
The instructions for the JTAG connection to the XTENSA core depend on the byte ordering. If AUTO is
selected, the debugger detects the Endianess when leaving down state. This does not work for
SYStem.Mode Attach.
XTENSA Debugger
55
SYStem.Option IMASKASM
Format:
Disable interrupts while single stepping
SYStem.Option IMASKASM [ON | OFF]
Default: OFF.
If enabled, the interrupt mask bits of the CPU will be set during assembler single-step operations. The
interrupt routine is not executed during single-step operations. After single step the interrupt mask bits are
restored to the value before the step.
SYStem.Option IMASKHLL
Format:
Disable interrupts while HLL single stepping
SYStem.Option IMASKHLL [ON | OFF]
Default: OFF.
If enabled, the interrupt mask bits of the cpu will be set during HLL single-step operations. The interrupt
routine is not executed during single-step operations. After single step the interrupt mask bits are restored to
the value before the step.
SYStem.Option IntelSOC
Format:
Core is part of Intel SoC
SYStem.Option IntelSOC [ON | OFF]
Default: OFF.
Inform the debugger that the Xtensa core is part of an Intel SoC. When enabled, all IR and DR pre/post
settings are handled automatically, no manuel configuration is necessary.
Requires that the Xtensa debugger is slave in a multicore setup with x86 as the master debugger and that
SYStem.Option.CLTAPOnly is enabled in the x86 debugger.
XTENSA Debugger
56
SYStem.Option PWROVR
Format:
Specifies power override bit
SYStem.Option PWROVR [ON | OFF]
Specifies the power override bit when a certain derivative providing this function is selected.
SYStem.Option SOFTLONG
Format:
Use 32-bit access to set breakpoint
SYStem.Option SOFTLONG [ON | OFF]
Default: OFF.
This option instructs the debugger to use 32-bit accesses to patch the software breakpoint code.
MAP.BUS8 / BUS16 / BUS32 does not influence the access used for patching the software breakpoint code.
So if you use map.bus32 for code area you have to activate this option.
SYStem.Option SPILLLOC
Format:
Temporary memory
SYStem.Option SPILLLOC <start_address>
Tells the debugger where to find memory which can be used to store data and to execute small pieces of
code (max. 256 bytes).
Some configurations contain registers which cannot be accessed directly. They can only be accessed by
executing a sequence of instructions. For this task, a small area of RAM is required. The debugger saves the
contents before the memory is used and restores the original contents after usage. With this option, you can
specify the first address of the memory range the debugger can use.
XTENSA Debugger
57
SYStem.TIE
TIE library files
The SYStem.TIE command group is used to configure TRACE32 to deal with architectural extensions. One
important extension, the Tensilica Instruction Extension gave the name for this set of commands.
The Tensilica tool chain generates libraries for a custom configuration. These libraries can be used to extract
information on the usage of architectural options, additional instructions and registers.
Add library file
Format:
SYStem.TIE.ADD <filename>
<filename>
Name of TIE library file.
Adds TIE library file to the TRACE32. It is important to add all needed library files. TIE library files are
internally dependent so if any file is missing an error may appear after executing SYSTEM.TIE.ENAble
command.
Example:
SYSTEM.TIE.ADD libisa-core.dll
SYStem.TIE.ADDALL
Format:
tbd.
SYStem.TIE.ADDALL <directory>
tbd.
SYStem.TIE.ADPerdll
Format:
tbd.
SYStem.TIE.ADP <filename>
tbd.
XTENSA Debugger
58
SYStem.TIE.CMList
Format:
tbd.
SYStem.TIE.CMList <filename>
tbd.
SYStem.TIE.DELete
Format:
Remove all library files
SYSTEM.TIE.DELete
Removes all added TIE library files from TRACE32. This command is recommended before SYStem.
TIE.ADDtiedll to be sure that there are no other library files added.
Example:
SYSTEM.TIE.DELete
SYStem.TIE.DEPerdll
Format:
tbd.
SYStem.TIE.DEPerdll
tbd.
SYStem.TIE.DISable
Format:
Unload and disable TIE instruction
SYSTEM.TIE.DISable
All loaded TIE library files are unloaded from disassembler decoder. Instructions are decoded only by the
internal TRACE32 decoder. To restart decoding with TIE library files use the command
SYStem.TIE.ENAble.
XTENSA Debugger
59
Example:
SYSTEM.TIE.DISable
Usage:
SYStem.TIE.DEL
;Delete all already added files
libisa-core.dll ;Add TIE library files

libisa-core-hw.dll
libisa-DC_330HiFi.dll
SYStem.TIE.ENA
;Load and enable TIE Instructions
SYStem.TIE.ENAble
Format:
Load and enable TIE instructions
SYStem.TIE.ENAble
Loads all added TIE library files to the TRACE32 disassembler. From this moment all instructions are
decoded by internal TRACE32 decoder and TIE library files. Before you execute this command, it is
necessary to add all needed library files to the TRACE32 otherwise an error will appear and TIE library files
will not be loaded. To add the file use SYStem.TIE.ADDtiedll command.
Example:
SYStem.TIE.ENAble
SYStem.TIE.GENper
Format:
tbd.
SYStem.TIE.GENper <filename>
tbd.
XTENSA Debugger
60
SYStem.TIE.GETArchOPTions
Format:
tbd.
SYStem.TIE.GETArchOPTions <filename>
tbd.
SYStem.TIE.LIBpath
Format:
tbd.
SYStem.TIE.LIBpath <directory>
tbd.
SYStem.TIE.REGlist
Format:
tbd.
SYStem.TIE.REGlist <filename>
tbd.
XTENSA Debugger
61
CPU specific TERM.METHOD Command
TERM.METHOD
Define communication protocol
Format:
TERM.METHOD BRK1_14 [<address>]
BRK1_14
The command TERM.METHOD BRK1_14 tells the debugger to use GNU

SYSCALL operations for terminal communication.
Use TERM.view to open the terminal window and to activate the
communication.
When an application reaches break 1,14, the application is stopped and the
debugger checks for the type of SYSCALL.
When receiving a SYSCALL_WRITE operation, the debugger writes the

relevant information to the terminal window and returns to Go state, i.e.
starts to execute user code again.
When receiving a SYSCALL_READ, the application remains stopped.

The debugger is waiting for some input to the terminal window. When you
press the Enter key, the application resumes operation.
The handling of "break 1,14" is only active when the TERM.view window is
open while TERM.METHOD BRK1_14 is selected. In all other cases, "break
1,14" is treated as a normal software break instruction.
For a description of the other options, see TERM.METHOD.
XTENSA Debugger
62
CPU specific TERM.METHOD Command
CPU specific TrOnchip Commands

The TrOnchip command group provides full access to both ICE Breaker units called A and B. Most of the
features can also utilized easier by setting regular breakpoints (Break.Set command).
The TrOnchip commands are only visible if the debugger detects TRAX-PC hardware. They cannot be
modified when the onchip trace is disabled.
For the bit descriptions of the control registers, please refer to the Trace Solutions Users Guide of the chip/
core manufacturer.
TrOnchip.RESet
Format:
Reset on-chip trigger settings
TrOnchip.RESet
Resets all TrOnchip settings.
TrOnchip.view
Format:
Display on-chip trigger window
TrOnchip.view
Open TrOnchip window.
XTENSA Debugger
63
CPU specific TrOnchip Commands
JTAG Connection
Mechanical Description of the 14-pin Debug Cable

Signal
TDI
TDO
TCK
N/C
RESETVCCS
N/C
Pin
1
3
5
7
9
11
13
Pin
2
4
6
10
12
14
Signal
GND
GND
GND
KEY PIN
TMS
N/C
TRST-
Tensilica has specified Pin 8 as a mechanical KEY Pin to define the orientation of the connector. This is a
standard 14 pin double row (two rows of seven pins) connector (pin to pin spacing: 0.100 in.).
Electrical Description of the 14-pin Debug Cable
TCK, TMS, TDI and nTRST are driven by CMOS drivers which are supplied with a voltage
following the level at VCCS. Therefore the ICD can work in an voltage range of 1.8 5.0 V. In
normal operation mode this driver is enabled, but it can be disabled to give another tool access to
the JTAG port. In environments where multiple tools can access the JTAG port, it is absolutely
required that there is a pull down resistor at TCK. This is to ensure that TCK is low during a hand
over between different tools.
TDO is ICD input only and needs standard TTL level.
VCCS is used as a sense line for the target voltage. It is also used to define the level which is
generated to supply the output drivers of the ICD interface to make an adaptation to the target
voltage (I(VCCS) appr. 3 mA).
nRESET (= nSRST) is used by the debugger to reset the target CPU or to detect a reset on the
target. It is driven by an open collector buffer. The debugger will only assert a pulse on nRESET
when the SYS.UP command is executed.
XTENSA Debugger
64
JTAG Connection
Support
CUSTOM_CPU
CUSTOM_DSP
DC_108MINI
DC_212GP
DC_232L
DC_330HIFI
DC_454CK
DC_570T
HIFI
XTENSA_9
XTENSA_LX2
XTENSA_LX3
XTENSA_LX4
INSTRUCTION
SIMULATOR
POWER
INTEGRATOR
ICD
TRACE
ICD
MONITOR
ICD
DEBUG
FIRE
ICE
CPU
Available Tools
YES
YES
YES
YES
YES
YES
YES
YES
YES
YES
YES
YES
YES
XTENSA Debugger
65
Support
Compilers
Language
Compiler
Company
Option
C++
GNU
Free Software
Foundation, Inc.
ELF/DWARF
Comment
Realtime Operation Systems

Name
Company
Comment
ThreadX
Express Logic Inc.
XTENSA Debugger
66
Support
3rd Party Tool Integrations

CPU
Tool
Company
ALL
ALL
ALL
ADENEO
X-TOOLS / X32
CODEWRIGHT
ALL
CODE CONFIDENCE
TOOLS
CODE CONFIDENCE
TOOLS
EASYCODE
ECLIPSE
RHAPSODY IN MICROC
RHAPSODY IN C++
CHRONVIEW
LDRA TOOL SUITE
UML DEBUGGER
Adeneo Embedded
blue river software GmbH
Borland Software
Corporation
Code Confidence Ltd
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ALL
ATTOL TOOLS
VISUAL BASIC
INTERFACE
LABVIEW
CODE::BLOCKS
C++TEST
RAPITIME
DA-C
TRACEANALYZER
SIMULINK
TA INSPECTOR
UNDODB
VECTORCAST UNIT
TESTING
VECTORCAST CODE
COVERAGE
WINDOWS CE PLATF.
BUILDER
Host
Windows
Windows
Windows
Code Confidence Ltd
Linux
EASYCODE GmbH
Eclipse Foundation, Inc
IBM Corp.
IBM Corp.
Inchron GmbH
LDRA Technology, Inc.
LieberLieber Software
GmbH
MicroMax Inc.
Microsoft Corporation
Windows
Windows
Windows
Windows
Windows
Windows
Windows
Windows
Windows
NATIONAL
INSTRUMENTS
Corporation
Open Source
Parasoft
Rapita Systems Ltd.
RistanCASE
Symtavision GmbH
The MathWorks Inc.
Timing Architects GmbH
Undo Software
Vector Software
Windows
Windows
Windows
Windows
Windows
Windows
Windows
Linux
Windows
Vector Software
Windows
Windows
Windows
XTENSA Debugger
67
Support
Products
Product Information
OrderNo Code
Text
LA-3760
JTAG Debugger for Xtensa 14 Pin
JTAG-XTENSA
supports Xtensa Cores from Tensilica

includes software for Windows, Linux and MacOSX
requires Power Debug Module
debug cable with 14 pin connector
LA-3760A
JTAG Debugger License for Xtensa Add.
JTAG-XTENSA-A

please add the base serial number of your debug
cable to your order
LA-3762
JTAG-XTENSA-20

via an ARM JTAG interface
includes software for Windows, Linux and MacOSX
requires Power Debug Module
debug cable with 20 pin connector
LA-3761
JTAG Converter XTENSA/XTAV60 Target
JTAG-AD-XTENSA
XTENSA JTAG Adapter to

XTAV60 Target
14 pin to 50 pin
Boards: XTAV60
Order Information
Order No.
Code
Text
LA-3760
LA-3760A
LA-3762
LA-3761
JTAG-XTENSA
JTAG-XTENSA-A
JTAG-XTENSA-20
JTAG-AD-XTENSA

JTAG Debugger License for Xtensa Add.
JTAG Converter XTENSA/XTAV60 Target
Additional Options
LA-3743A JTAG-ARMV8-A-A
LA-7843A JTAG-CORTEX-A/R-A
LA-7960X MULTICORE-LICENSE
JTAG Debugger Lic. Cortex-A (64-bit) Add.

JTAG Debugger Lic. Cortex-A/-R (32-bit) Add.
License for Multicore Debugging
XTENSA Debugger
68
Products

Debugger Xtensa

Uploaded by

Copyright:

Available Formats

Debugger Xtensa

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Debugger Xtensa

Uploaded by

Copyright:

Available Formats

XTENSA Debugger

TRACE32 Online Help

ICD In-Circuit Debugger ................................................................................................................

Processor Architecture Manuals ..............................................................................................

XTENSA Debugger ...............................................................................................................

Brief Overview of Documents for New Users .................................................................

Quick Start of the JTAG Debugger ..................................................................................

XTENSA Specific Implementations .................................................................................

On-chip Breakpoints for Instructions

On-chip Breakpoints for Data

Example for Standard Breakpoints

Bus width mapping

Bus width mapping

Bus width mapping

CPU specific SYStem Commands ...................................................................................

Configure debugger according to target topology

<parameter> describing the Debugport

<parameter> describing the JTAG scan chain and signal behavior

<parameter> describing a system level TAP Multitap

<parameter> configuring a CoreSight Debug Access Port DAP

<parameter> describing debug and trace Components

<parameter> which are Deprecated

Select the used CPU

Run-time memory access (intrusive)

Define JTAG frequency

Tristate the JTAG port

Real-time memory access (non-intrusive)

Establish the communication with the target

Specify the byte ordering

Disable interrupts while single stepping

Disable interrupts while HLL single stepping

Core is part of Intel SoC

Specifies power override bit

Use 32-bit access to set breakpoint

TIE library files

Add library file

Remove all library files

Unload and disable TIE instruction

Load and enable TIE instructions

CPU specific TERM.METHOD Command ........................................................................

Define communication protocol

CPU specific TrOnchip Commands .................................................................................

Reset on-chip trigger settings

Display on-chip trigger window

JTAG Connection ..............................................................................................................

Mechanical Description of the 14-pin Debug Cable

Electrical Description of the 14-pin Debug Cable

Realtime Operation Systems

3rd Party Tool Integrations

1989-2016 Lauterbach GmbH

Brief Overview of Documents for New Users

T32Start (app_t32start.pdf): T32Start assists you in starting TRACE32 PowerView instances

General Commands (general_ref_<x>.pdf): Alphabetic list of debug commands.

Choose Help menu > Processor Architecture Manual.

1989-2016 Lauterbach GmbH

Brief Overview of Documents for New Users

To prevent debugger and target from damage it is recommended to connect or

Power ON the TRACE32 hardware.

Start the TRACE32 software to load the debugger firmware.

Connect the debug cable to the target.