| |||
| Home > RealView Debugger Commands > Alphabetical command reference > CONNECT | |||
The CONNECT command is used to connect the debugger to a specified target.
CONNECT [,route]
[,reset|,noreset] [,halt|,nohalt] [=][targetid]|[@targetname]
where:
routeIndicates that the specified targetid is the RealView ICE Micro Edition target, not
the final target processor.
resetReset the target before connecting to it.
noresetDo not reset the target on connecting to it.
haltStop the target on connecting to it.
nohaltDo not stop the target on connecting to it.
targetidSpecifies the required target as a number. See Description for details.
targetnameSpecifies the required target as a name. See Description for details.
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.
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.
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.)
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
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.
The following commands provide similar or related functionality: