3.3.3. Linking several board groups to one connection

You might want to link several groups to a single connection if the groups represent different, possibly optional, parts of the same target. For example, the Integrator/AP motherboard definition BOARD=AP and an Integrator core module definition such as BOARD=CM940T. This kind of layout is shown in tree form in Figure 3.7.

Figure 3.7. Linking one connection to two boards

When you reference multiple boards, RealView Debugger merges the settings from each matching group. Therefore the complete configuration is the combined configurations of all of the matching groups. If the same setting is specified in more than one group, the specification in the group that is listed first in the CONNECTION is used, for example BoardChip_name=AP in Figure 3.7.

To set up this linking configuration you must first ensure that the *.bcd files exist and contain the required BOARD, CHIP, or COMPONENT groups. Then reference these files from your board file:

  1. In the Connection Properties window, expand the connection that you are using, for example CONNECTION=RealView-ICE shown in Figure 3.4.

  2. Link the AP target description as described in Linking one board group to one connection, unless you have already done this.

  3. Right-click on the BoardChip_name, in the right pane, to display the BoardChip context menu shown in Figure 3.5.

  4. Select the name of the required group, for example CM940T. You might have to select the <More...> option to find the group you require. A new entry is displayed in the right pane with an asterisk * beside it, shown in Figure 3.8 (that is *BoardChip_name CM940T).

    Figure 3.8. Linking a second board

    Linking a second board
  5. Select File ? Save and Close to save your changes and close the Connection Properties window.

When you connect to your RealView ICE target, the configuration defined in your board groups is applied to the connection. This gives you visibility of all your custom hardware.

Use the method described here to set up as many configuration groups as you require.

Changing the order of board groups

This procedure describes adding board CM940T after board AP. A board group is always added at the top of the list.

However, you might want to reorder the boards in the BoardChip_name list (to recreate the structure shown in Figure 3.7). To do this:

  1. Right-click on any BoardChip_name entry to display the BoardChip context menu and select Manage List.... The Settings: List Manager dialog box is displayed.

  2. Select the checkbox for the AP entry, so that it is checked.

  3. Click Move Up. The AP entry is moved above the CM940T entry.

  4. Click OK to close the dialog box. The BoradChip_name list is reordered.

  5. Select File ? Save and Close to save your changes and close the Connection Properties window.

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