2.3.3. Setting connect mode

When you connect to a target, RealView Debugger attempts to establish the connection using the default connect mode, that is No Reset and Stop. This mode is used when you connect from the Connection Control window in any of the following ways:

Before connecting, RealView Debugger checks to see if a user-defined connect mode has been specified in your board file (see User-defined connect mode for details). If such a setting is found, it overrides the default connect mode and is used instead. If there is no connect mode specified in your target configuration file, RealView Debugger proceeds to connect using the default connect mode.

However, the connect mode that is actually used depends on the target hardware, the target vehicle, and the associated interface software that manages the connection. In some cases, the interface cannot complete the connection using the mode requested, for example where your RealView ICE unit configuration conflicts with the connect mode. In this case, the RealView ICE unit determines the connect mode and makes the connection. Similarly, some ARM processors require a reset before you can connect, for example XScale™, whereas other cores have no such restriction. RealView Debugger displays a warning message to say that the requested connect mode cannot be honored and tells you what connection mode was used instead.

Note

This behavior also applies to disconnect mode, for example mode substitution might occur when you try to disconnect from a running target. See Setting disconnect mode for more details.

RealView Debugger provides a mechanism to enable you to override both the default connect mode and any user-defined settings in your board file. This is useful when debugging multiprocessor debug target systems or multithreaded applications, but can also be used when debugging a single processor target system, for example using RealMonitor. Therefore, you can control the way a processor starts for individual connections. To do this you must select the option Connect (Defining Mode)... from the Connection context menu in the Connection Control window (see Connection context menu options). See Connect (Defining Mode)... for details on how to use this option.

User-defined connect mode

Before connecting, RealView Debugger checks to see if a user-defined connect mode has been specified by the Connect_mode setting in the Advanced_Information block in your board file, or in any .bcd file linked to the connection. If such a setting is found, it becomes the default connect mode for this connection and is used if you connect in any of the following ways:

  • Double-click on an unconnected connection entry.

  • Select the check box for a required connection entry so that it is checked.

  • Right-click on a connection entry and select Connect from the Connection context menu (see Connection context menu options).

Note

Be aware that the default connection behavior for RealView ICE differs from that for Multi-ICE. Set connect mode in your target configuration file to ensure that you connect to your chosen target in the correct way.

For more information about setting connect mode in your board file, see:

Connect (Defining Mode)...

To define a connection mode using the Connect (Defining Mode)... option:

  1. Right-click on a processor connection entry, for example ARM940T_0, using RealView ICE, to display the Connection context menu (see Connection context menu options).

  2. Select Connect (Defining Mode)... to display the Connect Mode list selection box shown in Figure 2.3.

Figure 2.3. Connect Mode selection box

Connect Mode selection box

The state options shown depend on the interface software making the connection, but are always one or more from:

No Reset and Stop

Does not submit a processor reset but explicitly halts any process currently running by issuing a Stop command.

No Reset and No Stop

Does not submit a processor reset or attempt to halt any process currently running.

Reset and Stop

Submits a processor reset and explicitly halts any process currently running by issuing a Stop command.

Reset and No Stop

Submits a processor reset but does not attempt to halt any process currently running.

Highlight the required state and click OK.

Note

If you set connect mode from the Connection Control window, this temporarily overrides any user-defined setting in your target configuration file.

Default state

The selection box, shown in Figure 2.3, offers a series of state options to make the connection. The options shown depend on the interface software that manages the target connection and so vary depending on the connection entry you select in the Connection Control window. In this example, the selection box contains an entry No Reset and Stop (default). This is either the:

  • default connect mode chosen by the debugger (see Setting connect mode for details)

  • user-defined connect mode specified in the target configuration file (see User-defined connect mode for details).

    Any user-defined connect mode takes precedence over the default connect mode chosen by the debugger.

If you click Cancel, RealView Debugger establishes the connection using the connect mode shown as the default. Where this mode is not supported by your target, a different connect mode is used and you are warned about the substitution.

Note

This selection box is also displayed if you specify a prompt as your user-defined connect mode. In this case, there is no default entry (see Using a prompt for details).

Using a prompt

You can specify a user-defined connect mode to display a prompt to enable you to choose the connection mode for each connection. In this case, RealView Debugger displays the Connect Mode selection box shown in Figure 2.3. However, where the prompt setting is defined, the state options offered are all supported by the target vehicle and so do not include a default option.

Note

If a prompt is specified in your board file, or in any .bcd file linked to the connection, it takes priority over any other user-defined connect mode setting. This prompt-first rule holds true regardless of where the setting is in the configuration hierarchy.

For more information about using a prompt, see:

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