Troubleshooting your DSTREAM-ST unit
Your DSTREAM-ST is build for robust performance, but problems can arise when incompatible hardware is used with software, or when hardware is not configured or connected correctly, or from other hardware-related issues.
If you are having issues with connections to your DSTREAM-ST unit, try the following:
|Check List||Things to check|
|Are you using the latest version of DS-5 Development Studio?||
Download and install the latest version of DS-5 Development Studio.
New functionality, bug-fixes, and support for new targets are provided with every release of DS-5.
|Are you using the latest firmware for DSTREAM-ST?||Use the Debug Hardware Firmware Installer view in DS-5 to update the firmware for DSTREAM-ST.|
|Are all the cables connected and seated properly in the correct orientation?||
|Does the pin-out of the target's debug connector match the pin-out of your DSTREAM-ST unit?||Check the DSTREAM-ST System and Interface Design Reference guide for more information about connection pin outs.|
|Have the target and DSTREAM-ST power cycled to ensure normal operating conditions?||Power cycle the target and DSTREAM-ST.|
|Has the DSTREAM-ST unit booted successfully?||
|Is the target system fully powered-up?||
|Does the target SoC have security features that must be disabled or unlocked during connection?||Check the documentation of the SoC for details about security features.|
|Are there any switches or jumper links to set on the target?||
On some target boards, solder-links, jumper-links, or DIP switches must be configured to enable debug.
Check target board documentation or support channels for more information.
|Is the correct debug connector used on the target board?||
Some target boards use separate debug connectors for SoCs, FPGAs, and processor core supervisors.
Check if the correct debug connector is used.
|Is debugging disabled in the target SoC?||Some targets disable debugging facilities for security purposes. Check if debugging is enabled on your target.|
|Is the target's operating system disabling the debug interface during the boot process?||
|Is the connection attempting to load an image into the target SoC while the cores are running?||Try halting the cores through a bare-metal connection first.|
|Is the target's
||Check if the TARGET LED on the DSTREAM-ST unit is glowing steady green.|
|Does the DEBUG LED flash when trying to initiate the target connection?|
|Is the connection a simple Connect Only connection in the DS-5 debug configuration for your target?||
A simple Connect Only connection is useful to verify the connection to the hardware. This type of connection usually does not run any scripts or load any images on the target.
To start debugging, set the connection as either Debug from entry point or Debug from symbol in the debug configuration.
|Is the Clock Speed (Hz) in the platform configuration set correctly?||
Problems might occur if the clock speed is set too high.
Try setting the clock speed to lower frequencies in adaptive and non-adaptive clocking modes.
||Try enabling Linked_SRST_TRST in the Probe Configuration tab in Platform Configuration Editor available in DS-5.|
|Are initialization resets putting the target into an unwanted state?||Try disabling TResetOnInitConnect and AllowICETAPReset in the Probe Configuration tab in the Platform Configuration Editor available in DS-5.|
|In the DS-5 debug configuration for the target, does the Target Connection option match the debug unit?||Check if DSTREAM-ST is selected as the Target Connection option in the Connection tab of the debug configuration for your target.|
|Does the platform configuration settings for your target specify the correct debug interface mode?||Check if the LVDS Debug Interface mode is set correctly in the platform configuration settings for your target.|
|Is an SWD connection being attempted with hardware which only supports JTAG?||
Check and correct the connection setting.
Even if the SoC supports SWD, there might be buffers on the target board which prevent bi-directional data on the TMS signal.
|Are trace capture options correctly set?||Check that the trace capture settings used for the debug configuration is set correctly.|
|Are core trace options correctly set with the appropriate cores enabled?||Check that the core trace options used for the debug configuration is set correctly.|
|Is the TRACING LED lit but the DATA LED unlit?||
This indicates failure to synchronize with the trace data stream.
Check if the target SoC's TPIU or I/O pins are configured correctly.
|Are you having USB connectivity issues?||
DSTREAM-ST uses Ethernet over USB to connect to your Host PC.
On Windows 7 and Windows 10 hosts, the DSTREAM-ST unit is automatically detected as a DSTREAM-ST Network Adapter and you can view it in the Device Manager as a network adapter.
On Linux hosts, the DSTREAM-ST unit is detected as a USB network device.
The DHCP server running on DSTREAM-ST assigns an IP address in the link local address range to the USB interface connected to your unit. You can use the
If you have issues with connectivity on Linux hosts, you might need to enable your USB interface in the Network Manager, or enable it in the relevant configuration files for your Linux distribution.
Note: The following instructions use
On Ubuntu hosts:
On Red Hat hosts: