ARM DSTREAM User instructions

Copyright © 2010-2011 ARM. All rights reserved.
ARM DUI 0481D (ID071311)
ARM®DSTREAM™
Version 4.2
Setting up the Hardware

ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. ii
ID071311 Non-Confidential
ARM DSTREAM
Setting up the Hardware
Copyright © 2010-2011 ARM. All rights reserved.
Release Information
The following changes have been made to this book.
Proprietary Notice
Words and logos marked with ®or ™are registered trademarks or trademarks of ARM®in the EU and other countries,
except as otherwise stated below in this proprietary notice. Other brands and names mentioned herein may be the
trademarks of their respective owners.
Neither the whole nor any part of the information contained in, or the product described in, this document may be
adapted or reproduced in any material form except with the prior written permission of the copyright holder.
The product described in this document is subject to continuous developments and improvements. All particulars of the
product and its use contained in this document are given by ARM in good faith. However, all warranties implied or
expressed, including but not limited to implied warranties of merchantability, or fitness for purpose, are excluded.
This document is intended only to assist the reader in the use of the product. ARM shall not be liable for any loss or
damage arising from the use of any information in this document, or any error or omission in such information, or any
incorrect use of the product.
Where the term ARM is used it means “ARM or any of its subsidiaries as appropriate”.
This product includes software developed by the Apache Software Foundation (see
http://www.apache.org ).
Confidentiality Status
This document is Non-Confidential. The right to use, copy and disclose this document may be subject to license
restrictions in accordance with the terms of the agreement entered into by ARM and the party that ARM delivered this
document to.
Product Status
The information in this document is final, that is for a developed product.
Web Address
http://www.arm.com
Change history
Date Issue Confidentiality Change
May 2010 A Non-Confidential First release
November 2010 B Non-Confidential Second release
30 April 2011 C Non-Confidential DSTREAM and RVI v4.2.1 Release
29 July 2011 D Non-Confidential Update 1 for DSTREAM and RVI v4.2.1

ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. iii
ID071311 Non-Confidential
Conformance Notices
This section contains conformance notices.
Federal Communications Commission Notice
This device is test equipment and consequently is exempt from part 15 of the FCC Rules under section 15.103 (c).
Class A
Important: This is a Class A device. In residential areas, this device may cause radio interference. The user should take
the necessary precautions, if appropriate.
CE Declaration of Conformity
The system should be powered down when not in use.
It is recommended that ESD precautions be taken when handling DSTREAM, RVI, and RVT equipment.
The DSTREAM, RVI, and RVT modules generate, use, and can radiate radio frequency energy and may cause harmful
interference to radio communications. There is no guarantee that interference will not occur in a particular installation.
If this equipment causes harmful interference to radio or television reception, which can be determined by turning the
equipment off or on, you are encouraged to try to correct the interference by one or more of the following measures:
• ensure attached cables do not lie across the target board
• reorient the receiving antenna
• increase the distance between the equipment and the receiver
• connect the equipment into an outlet on a circuit different from that to which the receiver is connected
• consult the dealer or an experienced radio/TV technician for help
Note
It is recommended that wherever possible shielded interface cables be used.

ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. iv
ID071311 Non-Confidential
Contents
ARM DSTREAM Setting up the Hardware
Chapter 1 Conventions and feedback
Chapter 2 Introduction to ARM DSTREAM
2.1 About DSTREAM .......................................................................................................... 2-2
2.2 DSTREAM product contents ......................................................................................... 2-3
2.3 DSTREAM availability and compatibility ....................................................................... 2-4
2.4 The DSTREAM unit ...................................................................................................... 2-5
2.5 The DSTREAM probe ................................................................................................... 2-8
2.6 The DSTREAM firmware ............................................................................................ 2-10
2.7 The debug host software ............................................................................................ 2-11
2.8 Troubleshooting your DSTREAM unit ......................................................................... 2-12
2.9 DSTREAM recovery mode ......................................................................................... 2-13
Chapter 3 System requirements for using ARM DSTREAM
3.1 Requirements for connecting the DSTREAM unit ........................................................ 3-2
3.2 Connecting the DSTREAM unit .................................................................................... 3-3
3.3 Hot-plugging and unplugging the debug cable ............................................................. 3-5
3.4 Tracing with DSTREAM ................................................................................................ 3-6

ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 1-1
ID071311 Non-Confidential
Chapter 1
Conventions and feedback
The following describes the typographical conventions and how to give feedback:
Typographical conventions
The following typographical conventions are used:
monospace Denotes text that can be entered at the keyboard, such as commands, file
and program names, and source code.
monospace Denotes a permitted abbreviation for a command or option. The
underlined text can be entered instead of the full command or option
name.
monospace italic
Denotes arguments to commands and functions where the argument is to
be replaced by a specific value.
monospace bold
Denotes language keywords when used outside example code.
italic Highlights important notes, introduces special terminology, denotes
internal cross-references, and citations.
bold Highlights interface elements, such as menu names. Also used for
emphasis in descriptive lists, where appropriate, and for ARM®processor
signal names.
Feedback on this product
If you have any comments and suggestions about this product, contact your supplier
and give:
• your name and company

Conventions and feedback
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 1-2
ID071311 Non-Confidential
• the serial number of the product
• details of the release you are using
• details of the platform you are using, such as the hardware platform,
operating system type and version
• a small standalone sample of code that reproduces the problem
• a clear explanation of what you expected to happen, and what actually
happened
• the commands you used, including any command-line options
• sample output illustrating the problem
• the version string of the tools, including the version number and build
numbers.
Feedback on content
If you have comments on content then send an e-mail to
[email protected] . Give:
• the title
• the number, ARM DUI 0481D
• if viewing online, the topic names to which your comments apply
• if viewing a PDF version of a document, the page numbers to which your
comments apply
• a concise explanation of your comments.
ARM also welcomes general suggestions for additions and improvements.
ARM periodically provides updates and corrections to its documentation on the ARM
Information Center, together with knowledge articles and Frequently Asked Questions (FAQs).
Other information
• ARM Information Center,
http://infocenter.arm.com/help/index.jsp
• ARM Technical Support Knowledge Articles,
http://infocenter.arm.com/help/topic/com.arm.doc.faqs/index.html
• ARM Support and Maintenance,
http://www.arm.com/support/services/support-maintenance.php
•ARMGlossary,
http://infocenter.arm.com/help/topic/com.arm.doc.aeg0014-/index.html .

ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-1
ID071311 Non-Confidential
Chapter 2
Introduction to ARM DSTREAM
The following topics introduce ARM®DSTREAM™, and describe the software components:
•About DSTREAM on page 2-2
•DSTREAM product contents on page 2-3
•DSTREAM availability and compatibility on page 2-4
•The DSTREAM unit on page 2-5
•The DSTREAM probe on page 2-8
•The DSTREAM firmware on page 2-10
•The debug host software on page 2-11
•Troubleshooting your DSTREAM unit on page 2-12
•DSTREAM recovery mode on page 2-13.

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-2
ID071311 Non-Confidential
2.1 About DSTREAM
DSTREAM is a debug and trace hardware unit that enables powerful software debug and
optimization on any ARM processor-based hardware target. It enables you to connect a software
debugger to an ARM processor-based target using a hardware interface such as JTAG or Serial
Wire Debug (SWD). It also enables the collection of trace from the device for non-intrusive
debug and code optimization.
Note
Some debuggers are unable to capture trace from the external trace port of a System-on-Chip
(SoC) device. See the documentation that accompanies your debugger for details of the trace
capabilities of your debugger.
2.1.1 See also
Concepts
•DSTREAM product contents on page 2-3
•DSTREAM availability and compatibility on page 2-4
•The DSTREAM unit on page 2-5
•The DSTREAM probe on page 2-8
•The DSTREAM firmware on page 2-10
•The debug host software on page 2-11.
Reference
ARM®DSTREAM™and RVI™Using the Debug Hardware Configuration Utilities:
•Using Trace,
../com.arm.doc.dui0498d/I999867.html .

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-3
ID071311 Non-Confidential
2.2 DSTREAM product contents
The DSTREAM product consists of:
• A DSTREAM unit.
• A DSTREAM probe.
• Mains cables and a power supply that powers the DSTREAM unit.
• An Ethernet cable.
• A USB cable.
• Probe cables:
— a 100-way probe cable
— an ARM/TI JTAG 14-way ribbon cable
— an ARM JTAG 20-way ribbon cable
— a Mictor 38 cable
— a MIPI 34-way ribbon cable
— a CoreSight 10-way ribbon cable
— a CoreSight 20-way ribbon cable.
• Documentation, including a Quick Start Guide.
2.2.1 See also
Concepts
•About DSTREAM on page 2-2
•DSTREAM availability and compatibility on page 2-4
•The DSTREAM unit on page 2-5
•The DSTREAM probe on page 2-8
•The DSTREAM firmware on page 2-10
•The debug host software on page 2-11.

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-4
ID071311 Non-Confidential
2.3 DSTREAM availability and compatibility
DSTREAM is available from ARM and its resellers.
Contact ARM directly regarding OEM licenses.
See the documentation for your ARM debug tools to determine the compatibility with
DSTREAM.
DSTREAM provides:
• The ability to access the target.
• Tools to configure your debugger so that it can connect to the target through DSTREAM.
Your debugger provides the user interface items, such as register windows and
disassemblers, that make it possible to debug your application.
2.3.1 See also
Concepts
•About DSTREAM on page 2-2.

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-5
ID071311 Non-Confidential
2.4 The DSTREAM unit
The DSTREAM unit provides the hardware interface to enable a software debugger to control
and trace multiple devices. The unit has ports at the rear for connecting to the host computer and
to a power source. These ports are shown in the following figure.
Figure 2-1 Rear of DSTREAM unit
The LEDs at the bottom of the Ethernet port display information about Ethernet speed and
activity:
• The green LED shows the Ethernet speed. When Off, it indicates a speed of 10Mbps, and
when On indicates a speed of 100Mbps.
• The yellow LED indicates that activity is taking place.
The RESET button is used to reset the DSTREAM unit when required:
• Press and hold the RESET button until the STATUS LED starts to flash green rapidly. If
you release the RESET button at this point, a normal reboot occurs.
• If you continue to hold the RESET button for 10 seconds more, the STATUS LED flashes
red rapidly. When you release the RESET button after this point, DSTREAM reboots and
enters a recovery mode, which enables you to update firmware.
The ports at the front of the unit are shown in the following figure.
Figure 2-2 Front of DSTREAM unit
The AUX port is included for future enhancement of the product.
--
-
RESET 5VDC
USB port
Ethernet port
LED
(100Mb
Ethernet)
LED
(Ethernet
activity)
USER IO PROBE AUX

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-6
ID071311 Non-Confidential
Ethernet, USB and probe cables are supplied to connect the DSTREAM unit to the host
computer, and to the target hardware.
The following figure shows the location and name of each of the indicator LEDs.
Figure 2-3 Indicator LEDs
When you power-up the DSTREAM unit, the DSTREAM logo on the top of the unit illuminates
and the STATUS LED begins to flash. The STATUS LED remains illuminated to show that
DSTREAM is in its ready state.
The DSTREAM logo flashes for five seconds when you use the Identify tool.
The LEDs representing the DSTREAM debug feature have the following functions:
STATUS The STATUS LED illuminates as continuous red if a critical error is detected. You
must reboot DSTREAM before you can continue using it. To do this, press and
hold the RESET button for approximately three seconds, then the STATUS LED
turns off.
FLASH The FLASH LED illuminates green to denote that the unit is accessing its internal
flash storage.
TARGET The TARGET LED illuminates when a target VTref is detected using the probe.
DEBUG The DEBUG LED illuminates green when debug data transfer is taking place.
The LEDs representing the DSTREAM trace feature have the following functions:
TRACING The TRACING LED indicates that tracing is in progress.
TRIGGER The TRIGGER LED indicates that a trigger is detected.
DATA The DATA LED indicates that there is valid data in the data buffer.
FULL The FULL LED illuminates when a sufficient amount of trace data has been
captured to fill the defined buffer size. The buffer then wraps, and continues to
capture trace data, overwriting the original trace data captured.
TRC CLK If green, the TRC CLK LED indicates that a valid trace clock is detected. If red,
the TRC CLK LED indicates that there is a problem with the trace clock.
The DSTREAM unit contains an internal cooling fan that operates to control the internal
temperature when necessary. Do not obscure the ventilation panels on the front and back of the
DSTREAM unit.
USER IO PROBE AUX
STATUS
FLASH
TARGET
DEBUG
TRIGGER
DATA
FULL
TRACING
TRC CLK

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-7
ID071311 Non-Confidential
2.4.1 See also
Tasks
•DSTREAM recovery mode on page 2-13.
ARM®DSTREAM™and RVI™Using the Debug Hardware Configuration Utilities:
•Installing a firmware update or patch,
../com.arm.doc.dui0498d/Ciaihbfg.html .
Concepts
•The DSTREAM probe on page 2-8
•The DSTREAM firmware on page 2-10
•The debug host software on page 2-11
•Troubleshooting your DSTREAM unit on page 2-12
•Tracing with DSTREAM on page 3-6.
Reference
ARM®DSTREAM™and RVI™Using the Debug Hardware Configuration Utilities:
•Debugging with a target reset,
../com.arm.doc.dui0498d/CHDBIEFI.html .

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-8
ID071311 Non-Confidential
2.5 The DSTREAM probe
The DSTREAM probe unit allows DSTREAM to interface with all commonly-used debug and
trace interfaces provided on a target. It connects to the main DSTREAM unit by a 100mm
high-density ribbon cable. An optional 2m cable is available. When connecting to the target,
select the appropriate connectors on the probe to match the connectors on the target. Cables for
each of these connectors are supplied with DSTREAM. At any one time, use only the cables that
are to be connected to the probe unit for the current debug trace session. The available
connectors are:
ARM JTAG 14
This is an older ARM connector standard which is now rarely used.
TI JTAG 14 This is a Texas Instruments connector standard used by most TI-based target
boards.
ARM JTAG 20
This is the most commonly-used debug connector standard for ARM-based target
boards.
MICTOR 38
This is the most commonly-used trace connector standard for ARM-based target
boards. It can also incorporate all the debug signals if they use the same voltage
domain.
MIPI 34 This is a MIPI connector standard that supports debug and trace signals. It has two
VTref signals, allowing debug and trace signals to use different voltage domains.
CORESIGHT 10/20
These are high-density connectors that support the 10-way and 20-way CoreSight
standards in addition to a subset of the MIPI debug connection standards.
See the following figure.
Figure 2-4 DSTREAM probe
2.5.1 See also
Concepts
•The DSTREAM unit on page 2-5
•The DSTREAM firmware on page 2-10
POWER VTREFA VTREFB TRC CLK
CORESIGHT 10/20
ARM JTAG 14
TI JTAG 14
ARM JTAG 20
MICTOR 38
MIPI 34

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-9
ID071311 Non-Confidential
•The debug host software on page 2-11
•Troubleshooting your DSTREAM unit on page 2-12.
Reference
ARM®DSTREAM™System and Interface Design Reference:
•Target connectors supported by DSTREAM on page 3-10.

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-10
ID071311 Non-Confidential
2.6 The DSTREAM firmware
The DSTREAM firmware is located in the DSTREAM unit. It receives commands from the
debugger and translates them into debug operations. The DSTREAM firmware contains specific
sections of code for each ARM processor. These are called templates.
You can update the DSTREAM firmware using the installed Update utility. DSTREAM
firmware updates are supplied with all ARM software development tools. You must ensure that
you align the firmware updates with the same version used by the tools.
2.6.1 See also
Concepts
•The DSTREAM unit on page 2-5
•The DSTREAM probe on page 2-8
•The debug host software on page 2-11.
ARM®DSTREAM™and RVI™Using the Debug Hardware Configuration Utilities:
•Managing the firmware on your debug hardware unit,
../com.arm.doc.dui0498d/Ciadfiba.html .

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-11
ID071311 Non-Confidential
2.7 The debug host software
The debug host software provides the interface between your debugger and the DSTREAM
hardware that controls the target devices. It translates debugger commands, such as start, stop,
and download, into control sequences for a particular processor. The debug software provides
support for debugging on a wide range of ARM processors. To see a list of supported processors,
open the installed Update utility, connect to your debug hardware, and expand the Templates
tree and sub-trees. A list of templates for all supported processors is displayed.
The debug software can address each target device individually, without affecting other devices
on the board. It uses this ability to create virtual connections for each of the JTAG devices on
the board. Your debugger can attach to one of these virtual connections, and perform debugging
operations with no knowledge of the other devices on the board.
The debug software enables multiple concurrent connections. You can debug multiprocessor
systems. The software can also perform a synchronized start or stop of processors, for
debugging multiprocessor systems where the processors interact with each other. For more
information on debugging, see the documentation that accompanies your debugger.
The debug hardware and software supports multiple concurrent connections from single or
multiple clients. You can debug or control multicore systems from a single client debugger or
you can debug or control distinct devices in the system from separate client debuggers.
Depending on the system, the software can also perform a synchronized start or stop of
processors. For more information on the capabilities of multicore debug and synchronization,
see the documentation that accompanies your debugger.
The debug software also supports connections across a network, so that you can run the
debugging software on several different computers.
2.7.1 See also
Concepts
•The DSTREAM unit on page 2-5
•The DSTREAM probe on page 2-8
•The DSTREAM firmware on page 2-10.
ARM®DSTREAM™and RVI™Using the Debug Hardware Configuration Utilities:
•Managing the firmware on your debug hardware unit,
../com.arm.doc.dui0498d/Ciadfiba.html .

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-12
ID071311 Non-Confidential
2.8 Troubleshooting your DSTREAM unit
If you encounter problems when using your DSTREAM unit, confirm that your DSTREAM unit
is booting properly.
The power-on sequence is:
1. The DSTREAM backlight illuminates blue.
2. The FLASH LED flashes as accesses take place.
3. The STATUS LED flashes green and then stays illuminated, and the blue power LED on
the DSTREAM probe illuminates.
4. If the target is connected and powered, the TARGET LED illuminates green, and the
appropriate VTREF LED on the DSTREAM probe illuminates.
The unit has now booted.
Errors are indicated as follows:
• If the STATUS LED flashes red, it signifies that a boot failure has occurred.
• If the Dynamic Host Configuration Protocol (DHCP) LED illuminates red when an
Ethernet cable is connected and the link light on the Ethernet socket illuminates, it
signifies that the unit has failed to obtain an IP address.
Note
The DHCP LED is accessible via the access panel on the underside of the unit.
2.8.1 See also
Tasks
•DSTREAM recovery mode on page 2-13.
Concepts
•The DSTREAM unit on page 2-5
•The DSTREAM probe on page 2-8.

Introduction to ARM DSTREAM
ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 2-13
ID071311 Non-Confidential
2.9 DSTREAM recovery mode
To restore a DSTREAM unit that fails to boot:
1. Press and hold the reset button on the DSTREAM unit for approximately 10 seconds.
2. When the STATUS LED flashes red, release the button. The unit is now in recovery mode,
and the STATUS LED flashes alternately red and green.
3. Use the installed Update utility to install a working firmware. The unit then reboots into
normal mode.
Note
While in recovery mode, debug and trace operations are not enabled. You must perform a
firmware update to restore full functionality.
2.9.1 See also
Concepts
•The DSTREAM unit on page 2-5
•The DSTREAM probe on page 2-8
•Troubleshooting your DSTREAM unit on page 2-12.
ARM®DSTREAM™and RVI™Using the Debug Hardware Configuration Utilities:
•Managing the firmware on your debug hardware unit,
../com.arm.doc.dui0498d/Ciadfiba.html .

ARM DUI 0481D Copyright © 2010-2011 ARM. All rights reserved. 3-1
ID071311 Non-Confidential
Chapter 3
System requirements for using ARM DSTREAM
The following topics describe the system requirements for ARM®DSTREAM™, and how to
connect the DSTREAM unit to your host computer and target system:
•Requirements for connecting the DSTREAM unit on page 3-2
•Connecting the DSTREAM unit on page 3-3
•Hot-plugging and unplugging the debug cable on page 3-5
•Tracing with DSTREAM on page 3-6.