background image

DSTREAM-XT Getting Started Guide

Document ID: 102443_1.0_00_en

Version 1.0

Using DSTREAM-XT

RDDI is located in 

<Arm_Development_Studio_install_directory>/sw/

debugger/RDDI

. For more information about RDDI, see the RDDI documentation available

at 

<Arm_Development_Studio_install_directory>/sw/debugger/RDDI/docs/

html/index.html

DTSL is located in 

<Arm_Development_Studio_install_directory>/sw/DTSL

. For

more information about DTSL, see the 

Arm Development Studio User Guide

.

CoreSight Access Tool (CSAT)

The CoreSight

 Access Tool (CSAT) provides a scriptable low-level interface to the CoreSight

Debug Access Port (DAP) on a target. CSAT is useful to perform initial bring-up tests before a

debugger connection to the target is available.

For more information, see the 

CoreSight Access Tool (CSAT) User Guide

. In your Arm

Development Studio installation, CSAT is located in 

<install_directory>/Arm/

Development Studio <version>/bin/csat.exe

.

4.2 Hot-plug the debug cable

At times, you might want to connect or disconnect the debug cable between the DSTREAM-XT

system and the target hardware, without powering off the target. This process is known as 

hot-

plugging

.

Arm recommends you avoid hot-plugging the debug cable. However, you can hot-plug without

affecting target operation, if:
• The DSTREAM-XT system is powered by its original power supply (which has an earthed-

output).

• The target hardware is earthed, either through its power supply, or a separate earth connection.

• If the DSTREAM-XT system or the target hardware are not properly earthed,

potential differences can occur between them. During connection, potential

differences can cause unwanted pulses in the debug interface. Pulses in the

debug interface can cause unwanted resets to occur.

• Hot-plugging of a PCIe interface is not recommended and could cause instability

in a target's operating system.

Hot-plugging: connecting

To connect a DSTREAM-XT system to a target without affecting its current state, you must:
1. Power up the DSTREAM-XT system. Allow the DSTREAM-ST and XT probe to boot up.

Copyright © 2021 Arm Limited (or its affiliates). All rights reserved.

Non-Confidential

Page 

33

 of 

38

Summary of Contents for DSTREAM-XT

Page 1: ...DSTREAM XT Version 1 0 Getting Started Guide Non Confidential Copyright 2021 Arm Limited or its affiliates All rights reserved Issue 00 102443_1 0_00_en ...

Page 2: ...S 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 ...

Page 3: ...il 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 https www arm com company policies trademarks Copyright 2021 Arm Limited or it...

Page 4: ...ilable 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 wi...

Page 5: ...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 Consu...

Page 6: ...B drivers for the DSTREAM XT system on Windows 25 3 2 Install the USB drivers for the DSTREAM XT system on Linux 26 3 3 Connect and power up the DSTREAM XT system 26 3 4 DSTREAM XT system boot sequence 30 3 5 Update the DSTREAM XT system firmware 31 4 Using DSTREAM XT 32 4 1 Debug software for DSTREAM XT 32 4 2 Hot plug the debug cable 33 5 Troubleshooting 35 5 1 Host Link issues 35 5 2 DSTREAM XT ...

Page 7: ...ibbon cable 14 Figure 9 JTAG 14 way Texas Instruments adapter 14 Figure 10 MICTOR 38 way 4 bit adapter 14 Figure 11 DSTREAM XT x1 card edge adapter 15 Figure 12 DSTREAM XT x4 card edge adapter 15 Figure 13 DSTREAM XT x8 card edge adapter 15 Figure 14 DSTREAM XT x16 card slot adapter 15 Figure 15 Rear of the DSTREAM ST unit 16 Figure 16 Front of the DSTREAM ST unit 18 Figure 17 Indicator LEDs 19 Fi...

Page 8: ... program names and source code 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 monospace underline Denotes 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...

Page 9: ...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 errata arm com Give The title DSTREAM XT Getting Started Guide The number 102443_1 0_00_en If applicable the page number s to which your comments refer A conci...

Page 10: ...0_en Version 1 0 Introduction 1 3 Other information See the Arm website for other relevant information Arm Developer Arm Documentation Technical Support Arm Glossary Copyright 2021 Arm Limited or its affiliates All rights reserved Non Confidential Page 10 of 38 ...

Page 11: ...o 12MB per second using JTAG SWD JTAG clock frequencies of up to 180MHz SWD frequencies of up to 125MHz PCIe debug as an alternative to JTAG SWD A wide range of target connectors Up to eight lanes of PCIe Gen 3 or four lanes of PCIe Gen 4 support 16GB of trace memory storage on the XT probe Support for up to 4096 active CoreSight device connections Remote target reset Device bring up and test util...

Page 12: ...t purchasing options see the Debug Probes subset of tools in the Arm Developer Store Related information Arm DSTREAM XT box contents on page 12 2 2 Arm DSTREAM XT box contents The DSTREAM XT product box contains the required components to set up and connect your host computer to your Arm architecture based development board The items are DSTREAM ST unit Figure 2 1 DSTREAM ST unit DSTREAM XT probe ...

Page 13: ... 60 way Auxiliary AUX host port cable Figure 2 4 60 way Auxiliary AUX host port cable CoreSight 10 20 way 0 05 pitch ribbon cable Figure 2 5 CoreSight 10 20 way 0 05 pitch ribbon cable CoreSight Short 20 way 0 05 pitch ribbon cable Figure 2 6 CoreSight Short 20 way 0 05 pitch ribbon cable Copyright 2021 Arm Limited or its affiliates All rights reserved Non Confidential Page 13 of 38 ...

Page 14: ... 2 7 JTAG 20 way 0 1 pitch ribbon cable 98 way ribbon cable Figure 2 8 98 way ribbon cable JTAG 14 way Texas Instruments adapter Figure 2 9 JTAG 14 way Texas Instruments adapter MICTOR 38 way 4 bit adapter Figure 2 10 MICTOR 38 way 4 bit adapter Copyright 2021 Arm Limited or its affiliates All rights reserved Non Confidential Page 14 of 38 ...

Page 15: ...M XT x1 card edge adapter DSTREAM XT x4 card edge adapter Figure 2 12 DSTREAM XT x4 card edge adapter DSTREAM XT x8 card edge adapter Figure 2 13 DSTREAM XT x8 card edge adapter DSTREAM XT x16 card slot adapter Figure 2 14 DSTREAM XT x16 card slot adapter Copyright 2021 Arm Limited or its affiliates All rights reserved Non Confidential Page 15 of 38 ...

Page 16: ...ce It also contains the RESET button and the USER IO port Figure 2 15 Rear of the DSTREAM ST unit USB 3 0 port Ethernet port User IO port Reset button Power input Ethernet port If you want to access your DSTREAM ST unit over a local area network use the Ethernet port The green LED indicates that the Ethernet link is up and running The yellow LED indicates that activity is taking place Supported da...

Page 17: ... unit press and release the RESET button The RESET button operates immediately and performs a full internal power cycle This also resets any attached probes Always use the RESET button to power cycle your DSTREAM ST unit Disconnecting and reconnecting the DC plug to power cycle your target might cause ground loop issues If you continue to hold the RESET button for 10 seconds more the STATUS LED fla...

Page 18: ...ts 14 way adapter Used in conjunction with the Arm JTAG 20 cable provides debug access to any target with a TI JTAG 14 header MICTOR adapter Used in conjunction with both the Arm JTAG 20 and CoreSight 20 cables this adapter provides debug and trace access to any target with a MICTOR socket Optional adapters The following adapters are also available for use with DSTREAM ST Each of these allows DSTR...

Page 19: ... IP view or the Debug Hardware Firmware Installer view in Arm Development Studio STATUS Illuminates green to show that DSTREAM ST is in its ready state If a critical error is detected the STATUS LED illuminates as continuous red If the STATUS LED is red then you must reset the DSTREAM ST unit to the factory settings before you can continue using it If the DSTREAM ST unit fails to boot after a rese...

Page 20: ... only operating in USB 2 0 mode if the Ethernet port is only operating at 100Mbps or if other applications on the host computer are using too much USB or Ethernet bandwidth When streaming trace data the best practice is to keep usage of other applications on the host computer to a minimum TRC CLK This LED is for parallel trace only If the TRC CLK LED is green it indicates that a valid trace clock ...

Page 21: ... your DSTREAM XT system to the PCIe port of your target Rear Figure 2 18 Rear of XT probe Power input 5VDC Power input Connect the power supply unit to Power input port using the unified power cable Top The top of the XT probe has connectors for connecting to a DSTREAM ST unit and to a target Copyright 2021 Arm Limited or its affiliates All rights reserved Non Confidential Page 21 of 38 ...

Page 22: ...ects to the DSTREAM ST unit using the Arm JTAG 20 cable This connector is only required when using the low level single ended JTAG connections of the PCIe interface When performing debug using the main PCIe interface or a separate debug connector on the target this connector is not required If the target uses separate debug and trace connectors the debug connection must be made directly between th...

Page 23: ...up the Host Link LED 1 Briefly flashes blue to indicate that the link to the DSTREAM ST unit is initializing 2 Illuminates green to indicate that the link is ready If the Host Link LED does not flash blue or continues to only flash blue see Host Link issues Full Illuminates green to indicate that the trace buffer is full Lanes 0 7 The Lane LEDs indicate the numbers of the lanes that are in use during t...

Page 24: ... DSTREAM XT system Related information The DSTREAM ST unit on page 16 Connect and power up the DSTREAM XT system on page 26 Troubleshooting on page 35 DSTREAM XT trace probe configuration Copyright 2021 Arm Limited or its affiliates All rights reserved Non Confidential Page 24 of 38 ...

Page 25: ...are optionally installed as part of the installation process for Arm Development Studio If you have skipped the driver install process in Arm Development Studio follow these steps to install them Procedure 1 Using administrative privileges run the driver_install bat batch file that is available in Arm_Development_Studio_install_directory sw driver_files directory 2 In the Arm Development Studio Dri...

Page 26: ...ges run the run_post_install_for_Arm_Development_Studio_vx x sh script file that is available in the Arm Development Studio install directory The x x in the filename denotes the Arm Development Studio version that is installed on your host computer 2 To confirm the installation enter yes Results The USB drivers are now installed on your host computer Related information Connect and power up the DSTRE...

Page 27: ...e Hot plug the debug cable for further details Ensure the target connector has a compatible pinout before use Incorrect connections might damage the debug or target hardware Procedure 1 Connect the DSTREAM ST unit the XT probe and the power supply unit a Connect the DSTREAM ST unit to the XT probe using the 60 way AUX cable b Attach the Power Supply Unit PSU to the PSU adapter end of the split pow...

Page 28: ...g Hardware Configure IP view in Arm Development Studio You can also use the Debug Hardware Configure IP view to assign a name for the DSTREAM ST unit 5 Connect the DSTREAM XT system to the target hardware Use the appropriate cables and adapters for the target debug and trace connector or connectors Some targets have debug and trace on a single connector and some targets split them between two connec...

Page 29: ...98 way ribbon cable and appropriate adapter b Connect the DSTREAM ST unit to the target using the appropriate JTAG or CoreSight ribbon cable Figure 3 2 DSTREAM XT debug bypass connection DSTREAM ST unit Target board Host computer Local network DSTREAM XT PSU Ethernet or USB Dual DC power cable 60 way AUX cable Debug cable 98 Way cable Adapter XT Probe In rare cases it might be necessary to use the...

Page 30: ...2 DSTREAM XT system boot sequence on page 30 3 4 DSTREAM XT system boot sequence When you power up the DSTREAM XT system it goes through a boot sequence The LEDs identify the progress of the boot sequence The boot sequence is 1 To indicate that both units are powered the DSTREAM logo of the DSTREAM ST unit illuminates blue and the STATUS LED of the XT probe illuminates red 2 The FLASH LED of the D...

Page 31: ...er is installed on the host computer In Arm Development Studio the latest firmware files are available at Arm_Development_Studio_install_directory sw debughw firmware You must use firmware version 7 6 or later to detect the XT probe Procedure 1 Open the Debug Hardware Firmware Installer view From the main menu in Arm Development Studio select Window Show View Debug Hardware Firmware Installer 2 For t...

Page 32: ...an download the latest version of Arm Development Studio from the Arm Development Studio downloads page Remote Device Debug Interface RDDI or Debug and Trace Services Layer DTSL Third party applications both for Arm and other processors can connect to the DSTREAM XT system using the RDDI or the DTSL libraries You can use them to Address each target device individually without affecting other device...

Page 33: ...mes you might want to connect or disconnect the debug cable between the DSTREAM XT system and the target hardware without powering off the target This process is known as hot plugging Arm recommends you avoid hot plugging the debug cable However you can hot plug without affecting target operation if The DSTREAM XT system is powered by its original power supply which has an earthed output The target ...

Page 34: ...cting When unplugging the debug connector you must be aware that If you are using a Return Test Clock RTCK system make sure that no communication is taking place between the system and the DSTREAM XT system Otherwise if the DSTREAM XT system is waiting for a return clock it might lock up If you are not using an RTCK system the debug software can handle this situation However you must perform a Tes...

Page 35: ...nection is incomplete This might be due to one or more of the following reasons The XT probe factory firmware version requires updating The flash memory on the XT probe is corrupt If the flash memory is the cause the STATUS LED illuminates red The connection of the AUX 60 way ribbon cable is not complete Solution 1 Disconnect the AUX 60 way ribbon cable 2 Ensure the Aux connector pins on the DSTREAM ...

Page 36: ...covery mode is useful to recover your DSTREAM XT system Before you begin Connect and power up the DSTREAM XT system For more information on how to connect and power up the DSTREAM XT system see Connect and power up the DSTREAM XT system Attempt a soft reset of your DSTREAM XT system by pressing the Reset button on the rear of the DSTREAM ST unit before running a full restore of the system Debug ha...

Page 37: ...AM XT system Using DSTREAM XT Related information Update the DSTREAM XT system firmware on page 31 5 4 Remotely restart a DSTREAM XT system There are multiple ways to remotely restart a DSTREAM XT system You can Use the DSTREAM dashboard To use the DSTREAM dashboard simply enter the IP address or host name of your DSTREAM ST unit into a web browser This then shows the dashboard for your DSTREAM ST ...

Page 38: ...e The Arm Development Studio IDE For instructions see Update the DSTREAM XT system firmware The dbghw_batchupdater utility on the command line For instructions see the Updating multiple debug hardware units topic in the Arm Development Studio User Guide Related information Update the DSTREAM XT system firmware on page 31 Updating multiple debug hardware units Copyright 2021 Arm Limited or its affiliat...

Reviews: