2.2.23. CONNECT

The CONNECT command is used to connect the debugger to a specified target.

Syntax

CONNECT [,route] [,reset|,noreset] [,halt|,nohalt] [=][targetid]|[@targetname]

where:

route

Indicates that the specified targetid is the RealView ICE Micro Edition target, not the final target processor.

reset

Reset the target before connecting to it.

noreset

Do not reset the target on connecting to it.

halt

Stop the target on connecting to it.

nohalt

Do not stop the target on connecting to it.

targetid

Specifies the required target as a number. See Description for details.

targetname

Specifies the required target as a name. See Description for details.

Description

The CONNECT command creates a new target connection. There are two ways to specify the target:

  • as a number

  • as an identifier string.

Using the CONNECT command means that you do not use the Connection Control window (shown in Figure 2.1). However, it is helpful to think of that window when considering the operation of the CONNECT command.

Figure 2.1. Connection Control window

Connection Control window
Making numbered connections

To connect to the required target processor, shown in Figure 2.1, you must first specify the inteface device, that is RealView ICE Micro Edition. To do this, enter:

connect,route 1

This command enables the RealView ICE Micro Edition connection and expands it in the Connection Control window. (Entering the same command again disables the connection and collapses it.)

To connect to the target processor use CONNECT again, without the route qualifier:

connect 2

If you use the connect,route 1 command on the enabled RealView ICE Micro Edition connection, that is expanded in the Connection Control window, this immediately hides the target processor.

If you use the connect,route 1 command on a connected target processor, it has no effect.

Making named connections

You can use a named connection using similar principles to the numbered technique described in Making numbered connections. However, you can use a named connection to connect to the target processor when the RealView ICE Micro Edition connection is not currently enabled (see Making named target processor connections for details).

To enable or disable a route, you enter the route name with an @ prefix. So:

connect,route @RVI-ME

is the same as:

connect,route 1

This command enables the RealView ICE Micro Edition connection and expands it in the Connection Control window. (Entering the same command again disables the connection and collapses it.)

Note

If you specify a target that has not been configured, you are prompted to configure the target before the RealView ICE Micro Edition connection is enabled.

Now you can connect to a named target processor, for example:

connect @ARM7TDMI_0
Making named target processor connections

You can use named target processor connections to connect to a named target where the RealView ICE Micro Edition connection is not currently enabled. Specify the full target name in prefix notation:

connect @ARM7TDMI_0@RVI-ME

This command connects to the RealView ICE Micro Edition and opens the ARM7TDMI_0 device, expecting this to be available when the RealView ICE Micro Edition is enabled. If the RVI-ME connection, has not been configured with an ARM7TDMI, the connection fails with the message Types of objects in list do not match. You must configure the target before you connect to it.

See also

The following commands provide similar or related functionality:

Copyright © 2003, 2004 ARM Limited. All rights reserved.ARM DUI 0235B
Non-Confidential