ARM DSTREAM DS-5 User manual

Arm® DS-5
Version 5.29
Arm DSTREAM User Guide
Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its affiliates. All rights reserved.
100955_0529_00_en

Arm® DS-5
Arm® DSTREAM User Guide
Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its affiliates. All rights reserved.
Release Information
Document History
Issue Date Confidentiality Change
A May 2010 Non-Confidential First release
B November 2010 Non-Confidential Second release
C 30 April 2011 Non-Confidential DSTREAM and RVI v4.2.1 Release
D 29 July 2011 Non-Confidential Update 1 for DSTREAM and RVI v4.2.1
E 30 September 2011 Non-Confidential DSTREAM and RVI v4.4 Release
F 29 February 2012 Non-Confidential Update for DS-5 version 5.9
G 29 July 2012 Non-Confidential Update for DS-5 version 5.11
H 12 October 2012 Non-Confidential Update for DS-5 version 5.12
I 20 March 2015 Non-Confidential Update for DS-5 version 5.21
J 15 July 2015 Non-Confidential Update for DS-5 version 5.22
K 15 October 2015 Non-Confidential Update for DS-5 version 5.23
0527-00 07 April 2017 Non-Confidential Document numbering scheme has changed. Update for DS-5
version 5.27.
0528-00 24 November 2017 Non-Confidential Update for DS-5 version 5.28.
0529-00 22 June 2018 Non-Confidential Update for DS-5 version 5.29.
Non-Confidential Proprietary Notice
This document is protected by copyright and other related rights and the practice or implementation of the information contained in
this document may be protected by one or more patents or pending patent applications. No part of this document may be
reproduced in any form by any means without the express prior written permission of Arm. No license, express or implied, by
estoppel or otherwise to any intellectual property rights is granted by this document unless specifically stated.
Your access to the information in this document is conditional upon your acceptance that you will not use or permit others to use
the information for the purposes of determining whether implementations infringe any third party patents.
THIS DOCUMENT IS PROVIDED “AS IS”. ARM PROVIDES NO REPRESENTATIONS AND NO WARRANTIES,
EXPRESS, IMPLIED OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTABILITY, SATISFACTORY QUALITY, NON-INFRINGEMENT OR FITNESS FOR A PARTICULAR PURPOSE
WITH RESPECT TO THE DOCUMENT. For the avoidance of doubt, Arm makes no representation with respect to, and has
undertaken no analysis to identify or understand the scope and content of, third party patents, copyrights, trade secrets, or other
rights.
This document may include technical inaccuracies or typographical errors.
TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL ARM BE LIABLE FOR ANY DAMAGES,
INCLUDING WITHOUT LIMITATION ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE, OR
CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING
OUT OF ANY USE OF THIS DOCUMENT, EVEN IF ARM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
This document consists solely of commercial items. You shall be responsible for ensuring that any use, duplication or disclosure of
this document complies fully with any relevant export laws and regulations to assure that this document or any portion thereof is
not exported, directly or indirectly, in violation of such export laws. Use of the word “partner” in reference to Arm’s customers is
Arm® DS-5
100955_0529_00_en Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its
affiliates. All rights reserved.
2
Non-Confidential

not intended to create or refer to any partnership relationship with any other company. Arm may make changes to this document at
any time and without notice.
If any of the provisions contained in these terms conflict with any of the provisions of any click through or signed written
agreement covering this document with Arm, then the click through or signed written agreement prevails over and supersedes the
conflicting provisions of these terms. This document may be translated into other languages for convenience, and you agree that if
there is any conflict between the English version of this document and any translation, the terms of the English version of the
Agreement shall prevail.
The Arm corporate logo and words marked with ® or ™ are registered trademarks or trademarks of Arm Limited (or its
subsidiaries) in the US and/or elsewhere. All rights reserved. Other brands and names mentioned in this document may be the
trademarks of their respective owners. Please follow Arm’s trademark usage guidelines at http://www.arm.com/company/policies/
trademarks.
Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited (or its affiliates). All rights reserved.
Arm Limited. Company 02557590 registered in England.
110 Fulbourn Road, Cambridge, England CB1 9NJ.
LES-PRE-20349
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.
Unrestricted Access is an Arm internal classification.
Product Status
The information in this document is Final, that is for a developed product.
Web Address
http://www.arm.com
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 equipment.
The DSTREAM 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 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.
• 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 Arm® Support for help.
Note
It is recommended that wherever possible shielded interface cables be used.
Arm® DS-5
100955_0529_00_en Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its
affiliates. All rights reserved.
3
Non-Confidential

Contents
Arm® DS-5 Arm DSTREAM User Guide
Preface
About this book ...................................................... ...................................................... 7
Chapter 1 Introduction to Arm DSTREAM
1.1 About DSTREAM .................................................. .................................................. 1-10
1.2 DSTREAM product contents .................................................................................... 1-11
1.3 DSTREAM availability and compatibility .................................................................. 1-12
1.4 The DSTREAM unit ................................................ ................................................ 1-13
1.5 The DSTREAM probe .............................................................................................. 1-16
1.6 Installing the USB drivers for the DSTREAM unit .................................................... 1-18
1.7 Updating the DSTREAM firmware ..................................... ..................................... 1-19
1.8 The DSTREAM host software ........................................ ........................................ 1-20
1.9 Troubleshooting your DSTREAM unit ...................................................................... 1-21
1.10 DSTREAM unit boot sequence ................................................................................ 1-22
1.11 Restoring a DSTREAM unit that fails to boot ............................. ............................. 1-23
Chapter 2 System requirements for using Arm DSTREAM
2.1 Requirements for connecting the DSTREAM unit ......................... ......................... 2-25
2.2 Connecting the DSTREAM unit ....................................... ....................................... 2-26
2.3 About hot-plugging and unplugging the debug cable .............................................. 2-28
2.4 About tracing with DSTREAM ........................................ ........................................ 2-29
2.5 Tracing with DSTREAM ............................................. ............................................. 2-30
100955_0529_00_en Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its
affiliates. All rights reserved.
4
Non-Confidential

List of Figures
Arm® DS-5 Arm DSTREAM User Guide
Figure 1-1 Rear of DSTREAM unit ......................................................................................................... 1-13
Figure 1-2 Front of DSTREAM unit ......................................................................................................... 1-13
Figure 1-3 Indicator LEDs ....................................................................................................................... 1-14
Figure 1-4 DSTREAM probe ................................................................................................................... 1-16
Figure 2-1 Connecting the DSTREAM hardware .................................................................................... 2-26
100955_0529_00_en Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its
affiliates. All rights reserved.
5
Non-Confidential

Preface
This preface introduces the Arm® DS-5 Arm DSTREAM User Guide.
It contains the following:
•About this book on page 7.
100955_0529_00_en Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its
affiliates. All rights reserved.
6
Non-Confidential

About this book
Arm® DSTREAM User Guide describes the DSTREAM debug and trace unit, and the hardware that
enables you to use it. This document is written for those using DSTREAM with DS-5 Debugger, and is
available as a PDF.
Using this book
This book is organized into the following chapters:
Chapter 1 Introduction to Arm DSTREAM
Describes Arm DSTREAM™, and describes the software components.
Chapter 2 System requirements for using Arm DSTREAM
Describes the system requirements for Arm DSTREAM and how to connect the DSTREAM unit
to your host computer and target system.
Glossary
The Arm® Glossary is a list of terms used in Arm documentation, together with definitions for those
terms. The Arm Glossary does not contain terms that are industry standard unless the Arm meaning
differs from the generally accepted meaning.
See the Arm® Glossary for more information.
Typographic conventions
italic
Introduces special terminology, denotes cross-references, and citations.
bold
Highlights interface elements, such as menu names. Denotes signal names. Also used for terms
in descriptive lists, where appropriate.
monospace
Denotes text that you can enter at the keyboard, such as commands, file and program names,
and source code.
monospace
Denotes a permitted abbreviation for a command or option. You can enter the underlined text
instead of the full command or option name.
monospace italic
Denotes arguments to monospace text where the argument is to be replaced by a specific value.
monospace bold
Denotes language keywords when used outside example code.
<and>
Encloses replaceable terms for assembler syntax where they appear in code or code fragments.
For example:
MRC p15, 0, <Rd>, <CRn>, <CRm>, <Opcode_2>
SMALL CAPITALS
Used in body text for a few terms that have specific technical meanings, that are defined in the
Arm® Glossary. For example, IMPLEMENTATION DEFINED, IMPLEMENTATION SPECIFIC, UNKNOWN, and
UNPREDICTABLE.
Feedback
Preface
About this book
100955_0529_00_en Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its
affiliates. All rights reserved.
7
Non-Confidential

Feedback on this product
If you have any comments or suggestions about this product, contact your supplier and give:
• The product name.
• The product revision or version.
• An explanation with as much information as you can provide. Include symptoms and diagnostic
procedures if appropriate.
Feedback on content
If you have comments on content then send an e-mail to [email protected]. Give:
• The title Arm DS-5 Arm DSTREAM User Guide.
• The number 100955_0529_00_en.
• If applicable, the page number(s) to which your comments refer.
• A concise explanation of your comments.
Arm also welcomes general suggestions for additions and improvements.
Note
Arm tests the PDF only in Adobe Acrobat and Acrobat Reader, and cannot guarantee the quality of the
represented document when used with any other PDF reader.
Other information
•Arm® Developer.
•Arm® Information Center.
•Arm® Technical Support Knowledge Articles.
•Technical Support.
•Arm® Glossary.
Preface
About this book
100955_0529_00_en Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its
affiliates. All rights reserved.
8
Non-Confidential

Chapter 1
Introduction to Arm DSTREAM
Describes Arm DSTREAM™, and describes the software components.
It contains the following sections:
•1.1 About DSTREAM on page 1-10.
•1.2 DSTREAM product contents on page 1-11.
•1.3 DSTREAM availability and compatibility on page 1-12.
•1.4 The DSTREAM unit on page 1-13.
•1.5 The DSTREAM probe on page 1-16.
•1.6 Installing the USB drivers for the DSTREAM unit on page 1-18.
•1.7 Updating the DSTREAM firmware on page 1-19.
•1.8 The DSTREAM host software on page 1-20.
•1.9 Troubleshooting your DSTREAM unit on page 1-21.
•1.10 DSTREAM unit boot sequence on page 1-22.
•1.11 Restoring a DSTREAM unit that fails to boot on page 1-23.
100955_0529_00_en Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its
affiliates. All rights reserved.
1-9
Non-Confidential

1.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 connects to the target using hardware interfaces such as
JTAG or Serial Wire Debug (SWD).
DSTREAM 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.
Related concepts
1.2 DSTREAM product contents on page 1-11
1.3 DSTREAM availability and compatibility on page 1-12
1.4 The DSTREAM unit on page 1-13
1.5 The DSTREAM probe on page 1-16
1.7 Updating the DSTREAM firmware on page 1-19
1.8 The DSTREAM host software on page 1-20
1 Introduction to Arm DSTREAM
1.1 About DSTREAM
100955_0529_00_en Copyright © 2010–2012, 2015, 2017, 2018 Arm Limited or its
affiliates. All rights reserved.
1-10
Non-Confidential