RealView® Developer Kit Debugger User Guide 13.4.1. Setting up an Integrator board and core module

13.4.1. Setting up an Integrator board and core module

This example demonstrates how to use the Connection Properties window to create a specific Integrator/AP and core module target configuration. It shows how to use a predefined Board/Chip definition file, with extension .bcd, to set up your target.

After you set up your target, the example also demonstrates how you can connect to it using RVI/RVI-ME with the Connection Control window, and verify that RealView Debugger can connect to the target.

The example is split into the following sections, which must be executed in this sequence:

Setting up the hardware and debug interface

The first stage is to set up the hardware and configure the RVI/RVI-ME unit:

Ensure that your Integrator/AP and core module are connected and switched on. This example uses the ARM940T processor, but you can use any core module supported by the Integrator/AP.
Ensure that you have RVI/RVI-ME installed, and that the RVI/RVI-ME unit is connected and configured for use with RealView Debugger. If you have not configured the RVI/RVI-ME unit, do so now.

Configuring the new target

The next stage is to configure the new target:

Start RealView Debugger without connecting to a target.
Select Target → Connect to Target... to display the Connection Control window.
Right-click on the testconn2 entry and select Connection Properties... from the context menu to display the Connection Properties window.
Right-click on the CONNECTION=testconn2 entry and select Make Copy... from the context menu.
If the testconn2 target vehicle is not visible in the Connection Properties window, you must add it before continuing with this example. See Chapter 14 Configuring Custom Connections for full details on how to do this.
Use the Group Type/Name selector dialog box, shown in Figure 13.16, to name the new connection. For this example, enter MP3Player.
Figure 13.16. Creating a new connection
Click OK. The new entry, CONNECTION=MP3Player, is added to the List of Entries in the Connection Properties window.
Right-click on the Configuration setting for the new connection to display the context menu.
Select Reset to Empty to delete the current value.
Right-click on the Configuration setting again and select Edit Configuration-File Contents... the context menu. You are prompted to create a new configuration file either from an existing one, or from an empty one.
From the prompt dialog, select Copy to copy an existing configuration file. The Select file to copy from dialog box is displayed.
Set the Files of type field to All [*.*] , and locate the existing rvi.rvc in the directory install_directory\RVD\Core\...\etc\.
Click Open. A Select Name of new file dialog box is displayed. The filename is automatically set to the connection name you specified in step 6. In this example, MP3Player.rvi.
Locate your home directory, and click Save to save the file. The RVConfig dialog box is displayed.
Click File → Save to save the configuration file.
Click File → Exit to exit the RVConfig dialog box. The location of the MP3Player.rvi file is inserted into the Configuration setting.
In the Connection Properties window, select File → Save and Close to save your changes. The new target is added to the Connection Control window.
Right-click on the new MP3Player connection and select Connection Properties... from the context menu. This displays the Connection Properties window showing the contents of the new connection, shown in Figure 13.17.
Figure 13.17. Displaying the new MP3Player connection properties
Right-click on Description in the right pane to display the context menu. Select Edit Value and enter a short description for the new connection, for example Integrator/AP with ARM940 for MP3 product.
Note
Remember to press Enter to complete the entry.
Select File → Save and Close to save your changes. The new target description is added to the Connection Control window.

Linking board groups to the connection

The next stage is to link board groups to the new connection. This is not necessary but gives extended target visibility and enables you to view register contents and manipulate memory.

Note

The connection created in this example is used in other examples in the rest of this chapter. If you do not link the board groups, the contents of the Register pane differ from those shown here.

To link board groups:

Right-click on the MP3Player entry and select Connection Properties... from the context menu to display the Connection Properties window.
Right-click on BoardChip_name in the right pane to display the BoardChip context menu.
Select AP from the context menu to select the Integrator/AP description. A new entry *BoardChip_name AP is added to the pane.
Right-click on BoardChip_name (not on *BoardChip_name). The context menu is displayed again.
Select <More...> to display the List Selection dialog box.
Select CM940T from the list to select the ARM940T core module description, then click OK. The Connection Properties window now shows two BoardChip_name settings, shown in Figure 13.18.
Figure 13.18. Board groups linked to the new connection
Target configuration settings were copied from the source connection. However, depending on the target hardware, you might have to configure other settings, for example to enable semihosting or to set stack size. See Configuring a memory map for details. If required, you can do this now for the new connection.
Select File → Save and Close to save your changes and close the Connection Properties window.

Connecting to the new target

The next stage is to connect to the new target board and core module:

Select Target → Connect to Target... to display the Connection Control window.
Expand the new MP3Player entry.
The relevant processor name entry is displayed, shown in Figure 13.19.
Figure 13.19. Connecting to the new target
Click the check box for the processor entry under the new MP3Player entry to connect to the target. RealView Debugger retrieves information specific to the target.

Viewing the new target definition

To view details about the new target hardware:

In the Code window, select View → Registers to display the Register pane. Two new tabs are included at the bottom of the pane, AP and CM940T.
Click on the AP tab. RealView Debugger shows the abstraction of the hardware information specific to the Integrator/AP board, shown in Figure 13.20.
Figure 13.20. AP tab in the Register pane
This tab view enables you to modify your Integrator/AP board features, such as the memory mapped peripherals.
To illustrate how RealView Debugger communicates directly with your Integrator/AP board, right-click on the text OFF directly beneath the L2 entry in the Register pane, and select ON from the context menu. The relevant LED display on your Integrator/AP board is turned on.
Select the CM940T tab to see the abstraction of the hardware specific to the core module. The PRESENT status of the Motherboard indicates that the core module is connected to the Integrator/AP board.
For more details on the Register pane, see Chapter 7 Working with Debug Views.
In the Output pane at the bottom of the Code window, click on the Cmd tab. The display includes the line Advanced_info searched...BOARD=AP, BOARD=CM940T indicating that RealView Debugger is using the Integrator/AP and the CM940T board files.
Note
This information is only displayed when you first connect to the target after expanding the access-provider entry (MP3Player in this example).
As a result, the memory map now contains the definitions required to use the Flash memory on the Integrator. See Flash programming for details.

Copyright © 2005, 2006 ARM Limited. All rights reserved.	ARM DUI 0281C
Non-Confidential
PDF version