7.4.8. Working with multiple connections

If you have a multiprocessor debugging license, you can establish multiple connections. Each new connection you make to a debug target becomes the current connection. This is the connection that is used when you enter connection-related commands, for example, when you load an image.

The following tasks might help you when you are working with multiple connections:

Displaying information about the current connection

Use the DTBOARD command to display information about the current connection, for example:


dtboard
Connected Board 'Simarm_1' Port 0: Server supporting Single Tasking.
  Port string: localhost
  Entry of router/broker localhost

Identifying other connections

To find out the names of your connections use the BOARD command with the ,next parameter to determine the next connection, for example:


board,next
= 39. CURRENT: New Current Board is Simarm_2:Sim (P1) {@Simarm_2:Sim}
Stop> New Current Board is Simarm_2:Sim (P1)

Note

This command also changes the current connection. Therefore, cycle through the connections until the details of your original current connection is displayed. See Changing the current connection for more details.

Disconnecting a named connection

You might want to disconnect a connection that is not the current connection. To do this, you must specify the name of the connection, for example:


disconnect @Simarm_2
= 40. CONNECT: Board Simarm_2 (Sim) is now disconnected {@Simarm_2:Sim}
Stop> = 41. Board Entries added/modified
Stop>

If you have more than one connection, then the next connection becomes the current connection. This is identified in the displayed messages, for example:


= 42. CONNECT: Board Simarm_2 (Sim) is now disconnected {@Simarm_2:Sim}
Stop> = 43. CURRENT: New Current Board is Simarm_1:Sim (P1)
Stop> = 44. Board Entries added/modified
Stop>

Changing the current connection

To perform a connection-related command on a connection other than the current connection, you must make that connection current. To do this, enter:


board ="target_name:access-provider"

For example:


board ="Simarm_2:localhost"
= 45. CURRENT: New Current Board is Simarm_2:Sim (P1) {@Simarm_2:Sim}
Stop> New Current Board is Simarm_2:Sim (P1)
Stop>

Alternatively, if you are not sure of the connection name, you can cycle through the connections using the ,next qualifier, for example:


board,next
= 46. CURRENT: New Current Board is Simarm_2:Sim (P1) {@Simarm_2:Sim}
Stop> New Current Board is Simarm_2:Sim (P1)

Each time you enter this command, the next connection becomes the current connection. Repeat this command until the required connection is current.

Copyright © 2002-2005 ARM Limited. All rights reserved.ARM DUI 0181G
Non-Confidential