ARM DSTREAM User instructions

Copyright © 2010 ARM. All rights reserved.
ARM DUI 0481A (ID052210)
DSTREAM
Setting up the Hardware

ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. ii
ID052210 Non-Confidential
DSTREAM
Setting up the Hardware
Copyright © 2010 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.

ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. iii
ID052210 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, RealView ICE, and RealView Trace
equipment.
The DSTREAM, RealView ICE, and RealView Trace 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 0481A Copyright © 2010 ARM. All rights reserved. iv
ID052210 Non-Confidential
Contents
DSTREAM Setting up the Hardware
Chapter 1 Conventions and feedback
Chapter 2 Introduction to DSTREAM
2.1 About DSTREAM ..................................................................................................... 2-2
2.2 DSTREAM contents ................................................................................................. 2-3
2.3 Availability and compatibility .................................................................................... 2-4
2.4 Introduction to the DSTREAM components ............................................................. 2-5
2.5 The DSTREAM unit ................................................................................................. 2-6
2.6 The DSTREAM probe .............................................................................................. 2-9
2.7 The DSTREAM firmware ....................................................................................... 2-11
2.8 The debug host software ....................................................................................... 2-12
2.9 Troubleshooting ..................................................................................................... 2-13
2.10 Recovery mode ...................................................................................................... 2-14
Chapter 3 System requirements for using DSTREAM
3.1 Requirements for connecting the DSTREAM hardware .......................................... 3-2
3.2 Connecting the DSTREAM hardware ...................................................................... 3-3
3.3 Hot-plugging and unplugging the debug cable ........................................................ 3-5
3.4 Tracing with DSTREAM ........................................................................................... 3-6

ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. v
ID052210 Non-Confidential
List of Tables
DSTREAM Setting up the Hardware
Change history ................................................................................................................................ ii

ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. vi
ID052210 Non-Confidential
List of Figures
DSTREAM Setting up the Hardware
Figure 2-1 Rear of DSTREAM unit ............................................................................................................... 2-6
Figure 2-2 Front of DSTREAM unit .............................................................................................................. 2-6
Figure 2-3 Indicator LEDs ............................................................................................................................ 2-7
Figure 2-4 DSTREAM probe ........................................................................................................................ 2-9
Figure 3-1 Connecting the DSTREAM hardware ......................................................................................... 3-3

ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 1-1
ID052210 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 0481A Copyright © 2010 ARM. All rights reserved. 1-2
ID052210 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 0481A
• 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
• Keil Distributors, http://www.keil.com/distis.

ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-1
ID052210 Non-Confidential
Chapter 2
Introduction to DSTREAM
The following topics introduce DSTREAM, and describe the software components:
•About DSTREAM on page 2-2
•DSTREAM contents on page 2-3
•Availability and compatibility on page 2-4
•Introduction to the DSTREAM components on page 2-5
•The DSTREAM unit on page 2-6
•The DSTREAM probe on page 2-9
•The DSTREAM firmware on page 2-11
•The debug host software on page 2-12
•Troubleshooting on page 2-13
•Recovery mode on page 2-14.

Introduction to DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-2
ID052210 Non-Confidential
2.1 About DSTREAM
DSTREAM is an ARM®debug and trace hardware unit. 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 contents on page 2-3
•Availability and compatibility on page 2-4
•Introduction to the DSTREAM components on page 2-5.

Introduction to DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-3
ID052210 Non-Confidential
2.2 DSTREAM 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
—anARM
®/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.
• An evaluation copy of RealView Development Suite.
• Documentation, including a Quick Start Guide.
2.2.1 See also
Concepts
•About DSTREAM on page 2-2
•Availability and compatibility on page 2-4
•Introduction to the DSTREAM components on page 2-5.

Introduction to DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-4
ID052210 Non-Confidential
2.3 Availability and compatibility
DSTREAM is available from ARM®and its resellers.
Contact ARM directly regarding OEM licenses.
DSTREAM is compatible with RealView Development Suite v4.1 and later.
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 the DSTREAM components on page 2-5.

Introduction to DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-5
ID052210 Non-Confidential
2.4 Introduction to the DSTREAM components
The following topics introduce the components of the DSTREAM product, and describe how
they fit together:
•The DSTREAM unit on page 2-6
•The DSTREAM probe on page 2-9
•The DSTREAM firmware on page 2-11
•The debug host software on page 2-12.
2.4.1 See also
Concepts
•About DSTREAM on page 2-2
•Availability and compatibility on page 2-4.
Reference
Using the Debug Hardware Configuration Utilities:
•Using Trace, ../com.arm.doc.dui0498a/I999867.html.

Introduction to DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-6
ID052210 Non-Confidential
2.5 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 DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-7
ID052210 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 DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-8
ID052210 Non-Confidential
2.5.1 See also
Tasks
•Recovery mode on page 2-14.
Using the Debug Hardware Configuration Utilities:
•Installing a firmware update or patch, ../com.arm.doc.dui0498a/Ciaihbfg.html.
Concepts
•The DSTREAM probe on page 2-9
•The DSTREAM firmware on page 2-11
•The debug host software on page 2-12
•Troubleshooting on page 2-13
•Tracing with DSTREAM on page 3-6.
Reference
Using the Debug Hardware Configuration Utilities:
•Debugging with a target reset, ../com.arm.doc.dui0498a/CHDBIEFI.html.

Introduction to DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-9
ID052210 Non-Confidential
2.6 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.6.1 See also
Concepts
•The DSTREAM unit on page 2-6
•The DSTREAM firmware on page 2-11
POWER VTREFA VTREFB TRC CLK
CORESIGHT 10/20
ARM JTAG 14
TI JTAG 14
ARM JTAG 20
MICTOR 38
MIPI 34

Introduction to DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-10
ID052210 Non-Confidential
•The debug host software on page 2-12
•Troubleshooting on page 2-13.
Reference
DSTREAM System and Interface Design Reference:
•Supported target connectors on page 3-10.

Introduction to DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-11
ID052210 Non-Confidential
2.7 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.
DSTREAM firmware is provided as part of RealView Development Suite.
You can update the DSTREAM firmware using the RVI Update utility. DSTREAM firmware
updates are obtained from your local supplier.
2.7.1 See also
Concepts
•The DSTREAM unit on page 2-6
•The DSTREAM probe on page 2-9
•The debug host software on page 2-12.
Using the Debug Hardware Configuration Utilities:
•Managing the firmware on your debug hardware unit,
../com.arm.doc.dui0498a/Ciadfiba.html.
Other information
• DSTREAM firmware patch downloads ,
http://www.keil.com

Introduction to DSTREAM
ARM DUI 0481A Copyright © 2010 ARM. All rights reserved. 2-12
ID052210 Non-Confidential
2.8 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 RVI Update utility 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, and for more information see the documentation that accompanies your debugger. The
software can also perform a synchronized start or stop of processors, for debugging
multiprocessor systems where the processors interact with each other.
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,
refer to 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.8.1 See also
Concepts
•The DSTREAM unit on page 2-6
•The DSTREAM probe on page 2-9
•The DSTREAM firmware on page 2-11.
Using the Debug Hardware Configuration Utilities:
•Managing the firmware on your debug hardware unit,
../com.arm.doc.dui0498a/Ciadfiba.html.