ARM DSTREAM-HT User manual

DSTREAM-HT
Version 1.0
Getting Started Guide
Non-Confidential
Copyright © 2019, 2022 Arm Limited (or its affiliates).
All rights reserved.
Issue 02
101760_1.0_02_en

DSTREAM-HT Getting Started Guide Document ID: 101760_1.0_02_en
Version 1.0
DSTREAM-HT
Getting Started Guide
Copyright © 2019, 2022 Arm Limited (or its affiliates). All rights reserved.
Release information
Document history
Issue Date Confidentiality Change
0100-00 15 July 2019 Non-Confidential New document for v1.0
0100-01 13 December 2019 Non-Confidential Documentation update for version 1.0 release
0100-02 10 October 2022 Non-Confidential Documentation update for version 1.0 release
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, 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.
Copyright © 2019, 2022 Arm Limited (or its affiliates). All rights reserved.
Non-Confidential
Page 2 of 39

DSTREAM-HT Getting Started Guide Document ID: 101760_1.0_02_en
Version 1.0
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 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.
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 affiliates) 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 https://www.arm.com/company/policies/trademarks.
Copyright © 2019, 2022 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|version 21.0)
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.
Feedback
Arm® welcomes feedback on this product and its documentation. To provide feedback on the
product, create a ticket on https://support.developer.arm.com
To provide feedback on the document, fill the following survey: https://developer.arm.com/
documentation-feedback-survey.
Copyright © 2019, 2022 Arm Limited (or its affiliates). All rights reserved.
Non-Confidential
Page 3 of 39

DSTREAM-HT Getting Started Guide Document ID: 101760_1.0_02_en
Version 1.0
Inclusive language commitment
Arm values inclusive communities. Arm recognizes that we and our industry have used language
that can be offensive. Arm strives to lead the industry and create change.
Previous issues of this document included language that can be offensive. We have replaced this
language.
To report offensive language in this document, email [email protected]om.
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/UKCA Conformity
These marks indicate that this product meets all essential health, safety and environmental
requirements. The CE mark indicates conformity within EU member states and the UKCA mark
indicates conformity within the UK.
The Declarations of Conformity are available on request.
The Waste Electrical and Electronic Equipment (WEEE) marking, that is, the crossed out wheelie-bin
figure, indicates that this product must not be disposed of with general waste within the European
Union. To prevent possible harm to the environment from uncontrolled waste disposal, the user is
required to recycle the product responsibly to promote reuse of material resources. To comply with
EU law, you must dispose of the product in one of the following ways:
•Return it to the distributor where it was purchased. The distributor is required to arrange free
collection when requested.
•Recycle it using local WEEE recycling facilities. These facilities are now very common and might
provide free collection.
•If purchased directly from Arm, Arm provides free collection. Please e-mail [email protected] for
instructions.
Copyright © 2019, 2022 Arm Limited (or its affiliates). All rights reserved.
Non-Confidential
Page 4 of 39

DSTREAM-HT Getting Started Guide Document ID: 101760_1.0_02_en
Version 1.0
•End-of-Life products can be disposed of safely using an Approved Authorized Treatment Facility
(AATF). To support safe disposal, Arm has partnered with B2B Compliance. B2B can be
contacted at the following weblink: https://b2bcompliance.org.uk
During the lifetime of the product, you are advised to:
•Inspect the product regularly to ensure that it is in good working order.
•Ensure that the product is free from dust and debris that might cause damage.
•Clean the product with an air duster when necessary.
•Power down the system when not in use.
•Observe ESD precautions when handling the product.
The product can radiate Radio Frequency Interference (RFI) or Electromagnetic Interference
(EMI) and might cause harmful interference to radio communications. There is no guarantee that
interference cannot occur in a particular installation. If you suspect that this equipment is causing
interference to other equipment, you are encouraged to try to correct the interference by one or
more of the following measures:
•Ensure attached cables do not lie across any sensitive equipment.
•Increase the distance between the product and the receiver.
•Connect the equipment to an outlet on a circuit different from that to which the product is
connected.
•Consult Arm for help.
The product can be sensitive to Radio Frequency Interference (RFI) or Electromagnetic Interference
(EMI) which might cause incorrect operation of the product:
•Avoid using the product near sources of EMI.
•Never use the product in Safety-Critical-Systems (SCS), or Life-Critical-Systems (LCS).
Arm recommends that, wherever possible, shielded interface cables be used.
Copyright © 2019, 2022 Arm Limited (or its affiliates). All rights reserved.
Non-Confidential
Page 5 of 39

DSTREAM-HT Getting Started Guide Document ID: 101760_1.0_02_en
Version 1.0
Contents
Contents
List of Figures.......................................................................................................................................7
1. Introduction...................................................................................................................................................... 8
1.1 Conventions......................................................................................................................................................8
1.2 Useful resources..............................................................................................................................................9
1.3 Other information........................................................................................................................................... 9
2. The DSTREAM-HT system........................................................................................................................ 10
2.1 Buy Arm DSTREAM-HT............................................................................................................................. 11
2.2 Arm DSTREAM-HT box contents............................................................................................................ 11
2.3 The DSTREAM-ST unit...............................................................................................................................14
2.4 The HSSTP probe.........................................................................................................................................19
3. Set up your DSTREAM-HT........................................................................................................................23
3.1 Install the USB drivers for the DSTREAM-HT system on Windows................................................23
3.2 Install the USB drivers for the DSTREAM-HT system on Linux....................................................... 24
3.3 Connect and power up the DSTREAM-HT system............................................................................. 24
3.4 DSTREAM-HT system boot sequence....................................................................................................28
3.5 Update the DSTREAM-HT system firmware.........................................................................................29
4. Work with your DSTREAM-HT................................................................................................................ 31
4.1 Debug software for DSTREAM-HT......................................................................................................... 31
4.2 Hot-plug the debug cable.......................................................................................................................... 32
5. Troubleshooting.............................................................................................................................................34
5.1 HSSTP probe LED errors........................................................................................................................... 34
5.2 Host Link issues............................................................................................................................................36
5.3 DSTREAM-HT overheats............................................................................................................................37
5.4 Arm Development Studio invalid trace................................................................................................... 37
5.5 Restore a DSTREAM-HT system..............................................................................................................38
5.6 Remotely restart a DSTREAM-HT system............................................................................................. 39
Copyright © 2019, 2022 Arm Limited (or its affiliates). All rights reserved.
Non-Confidential
Page 6 of 39

DSTREAM-HT Getting Started Guide Document ID: 101760_1.0_02_en
Version 1.0
List of Figures
List of Figures
Figure 2-1: DSTREAM-ST unit......................................................................................................... 11
Figure 2-2: HSSTP Trace probe........................................................................................................11
Figure 2-3: DSTREAM-HT power supply and cables..................................................................12
Figure 2-4: 60-way Auxiliary (AUX) host port cable................................................................... 12
Figure 2-5: CoreSight 10/20-way 0.05" pitch ribbon cable...................................................... 12
Figure 2-6: CoreSight Short 20-way 0.05" pitch ribbon cable..................................................12
Figure 2-7: JTAG 20-way 0.1" pitch ribbon cable.......................................................................13
Figure 2-8: HSSTP 40-way co-axial ribbon cable........................................................................ 13
Figure 2-9: JTAG 14-way Texas Instruments adapter.................................................................13
Figure 2-10: MICTOR 38-way 4-bit adapter................................................................................ 13
Figure 2-11: Rear of the DSTREAM-ST unit................................................................................ 14
Figure 2-12: Front of the DSTREAM-ST unit............................................................................... 16
Figure 2-13: Indicator LEDs.............................................................................................................. 17
Figure 2-14: Rear of HSSTP Trace probe...................................................................................... 19
Figure 2-15: Top of HSSTP Trace probe........................................................................................20
Figure 3-1: DSTREAM-HT connection........................................................................................... 27
Figure 3-2: DSTREAM-HT debug bypass connection.................................................................27
Copyright © 2019, 2022 Arm Limited (or its affiliates). All rights reserved.
Non-Confidential
Page 7 of 39

DSTREAM-HT Getting Started Guide Document ID: 101760_1.0_02_en
Version 1.0
Introduction
1. Introduction
Describes the DSTREAM-HT debug and trace system which enables you to debug and optimize
your software on Arm® processor-based hardware targets.
1.1 Conventions
The following subsections describe conventions used in Arm documents.
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: developer.arm.com/glossary.
Typographic conventions
Arm documentation uses typographical conventions to convey specific meaning.
Convention Use
italic Citations.
bold Interface elements, such as menu names.
Terms in descriptive lists, where appropriate.
monospace Text that you can enter at the keyboard, such as commands, file and program names, and source code.
monospace underline A permitted abbreviation for a command or option. You can enter the underlined text instead of the full
command or option name.
<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 Terms that have specific technical meanings as defined in the Arm® Glossary. For example,
IMPLEMENTATION DEFINED, IMPLEMENTATION SPECIFIC, UNKNOWN, and UNPREDICTABLE.
Recommendations. Not following these recommendations might lead to system failure or damage.
Requirements for the system. Not following these requirements might result in system failure or damage.
Requirements for the system. Not following these requirements will result in system failure or damage.
Copyright © 2019, 2022 Arm Limited (or its affiliates). All rights reserved.
Non-Confidential
Page 8 of 39

DSTREAM-HT Getting Started Guide Document ID: 101760_1.0_02_en
Version 1.0
Introduction
Convention Use
An important piece of information that needs your attention.
A useful tip that might make it easier, better or faster to perform a task.
A reminder of something important that relates to the information you are reading.
1.2 Useful resources
This document contains information that is specific to this product. See the following resources for
other useful information.
Access to Arm documents depends on their confidentiality:
•Non-Confidential documents are available at developer.arm.com/documentation. Each
document link in the following tables goes to the online version of the document.
•Confidential documents are available to licensees only through the product package.
Arm product resources Document ID Confidentiality
Arm Development Studio Getting Started
Guide
101469 Non-Confidential
Arm Development Studio Heterogeneous
system debug with Arm Development
Studio
102021 Non-Confidential
Arm Development Studio User Guide 101470 Non-Confidential
Arm DSTREAM-HT System and Interface
Design Reference Guide
101761 Non-Confidential
Arm DSTREAM-ST Getting Started Guide 100892 Non-Confidential
Arm DSTREAM-ST System and Interface
Design Reference Guide
100893 Non-Confidential
CoreSight Access Tool (CSAT) User Guide epm051792 Non-Confidential
1.3 Other information
See the Arm website for other relevant information.
•Arm® Developer.
•Arm® Documentation.
•Technical Support.
•Arm® Glossary.
Copyright © 2019, 2022 Arm Limited (or its affiliates). All rights reserved.
Non-Confidential
Page 9 of 39

DSTREAM-HT Getting Started Guide Document ID: 101760_1.0_02_en
Version 1.0
The DSTREAM-HT system
2. The DSTREAM-HT system
DSTREAM-HT is a debug and trace hardware system that enables software debug and trace for the
optimization of software running on Arm® processor-based targets.
DSTREAM-HT provides an interface between a host such as Arm Development Studio and an
Arm processor-based target using a hardware interface such as JTAG or Serial Wire Debug (SWD).
DSTREAM-HT also enables the collection of up to six lanes of HSSTP trace for powerful code
optimization.
The DSTREAM-HT debug system is made up of a standard Arm DSTREAM-ST unit, along with an
additional Arm HSSTP probe, enabling:
•Debug on Arm processors from Armv4 to Armv8.
•USB 3.0 and remote Gigabit Ethernet host connections.
•Code download speeds of up to 12MB per second.
•JTAG clock of up to 180MHz.
•Serial Wire Debug of up to 125MHz (standard single-ended signaling).
•A wide range of target connectors.
•Up to six lane HSSTP trace support (up to 60Gbps maximum trace bandwidth).
•Up to two lanes of SETM trace.
•Flexible HSSTP lane rates of up to 12.5Gbps.
•Up to 4-bit parallel trace support (up to 2.4Gbps maximum trace bandwidth).
•Flexible DDR trace clock timing of up to 300MHz (600Mbits/s, per pin).
•8GB of trace memory storage on the HSSTP probe.
•Support for up to 1022 CoreSight™ devices.
•Remote target reset.
•Device bring-up and test utilities.
•Flexible architecture to support third party IP and debuggers.
For more feature information, see the DSTREAM-HT web page on the Arm Developer website.
For the purposes of this content:
•The term DSTREAM-ST refers only to the DSTREAM-ST unit.
•The terms DSTREAM-HT or DSTREAM-HT system refer to both the DSTREAM-ST unit and
HSSTP probe working in combination.
This chapter describes the DSTREAM-HT hardware.
Copyright © 2019, 2022 Arm Limited (or its affiliates). All rights reserved.
Non-Confidential
Page 10 of 39