15.4.2 Connecting to DTSL

To use DTSL, a client must create a DTSLConnection object using the DTSL ConnectionManager class (com.arm.debug.dtsl.ConnectionManager). ConnectionManager has static methods that allow the DTSLConnection object to be created from a set of connection parameters. After a ConnectionManager object is obtained, calling its connect() method creates the DTSLConfiguration object which contains all the target component objects.

When the DTSL ConnectionManager class creates a new DTSLConnection, it assigns a unique key to it. It constructs this key from the connection properties:

If the DTSL ConnectionManager detects an attempt to connect to an already existing DTSLConnection (that is, the connection key matches an existing DTSLConnection instance) then DTSL returns the already existing instance. There can only be one DTSLConnection with any given key.

A DTSLConnection can also be created by obtaining an existing DTSL instance key and requesting a connection to that instance. Both DS-5 Debugger and third-party Eclipse plugins can therefore connect to an existing DTSLConnection instance. If the DS-5 Debugger creates the DTSLConnection instance for a platform, then a third-party plugin can connect to the same instance by one of two methods:

DTSL reference-counts connections to a platform instance and only closes the DTSLConnection instance when all clients have disconnected.

Non-ConfidentialPDF file icon PDF versionARM DUI0446Z
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.