4.4. Creating a BCD file to use as a template

To create definitions for the memory map, memory mapped registers, and peripheral registers of your development platform, you are recommended to create a BCD file. You can then use this BCD file as a template for all future BCD files you create. You might want to create a different template for each vendor-specific target used on your development platform.

Note

The template BCD file created in this procedure is used as the starting point for many of the examples described in this chapter.

To create a BCD file to use as a template:

  1. Select Target → Connection Properties... from the Code window main menu to open the Connection Properties window. Figure 4.10 shows an example:

    Figure 4.10. Connection Properties window

    Connection Properties window

  2. Expand the (*.bcd) Board/Chip Definitions group in the left pane. A list of existing BCD files is displayed.

  3. Save a copy of an existing BCD file:

    1. Right-click on the AP.bcd file group to display the context menu.

    2. Select Save As... from the context menu to open the Enter New Name dialog box.

    3. Locate your RealView Debugger home directory.

    4. Enter the name for your new BCD file, for example, aatemplate.bcd.

    5. Click Save to save the BCD file and close the Enter New Name dialog box.

    6. Select File → Save Changes from the menu from the Connection Properties window menu to save your changes.

    7. Select File → Refresh from the menu to update the list of BCD files.

  4. Expand the (*.bcd) Board/Chip Definitions group again to show the list of BCD files.

  5. Rename the BOARD= group as appropriate:

    1. Expand the entry for the new BCD file, ...\aatemplate.bcd in this example.

    2. Right-click on the BOARD= group in the left pane to display the context menu.

    3. Select Rename from the context menu to open the Group/Type Name Selector dialog box.

    4. Enter an appropriate name, for example ARM_TEMPLATE.

    5. Click OK to close the dialog box.

  6. Clear all settings that are currently configured:

    1. Right-click on the BOARD=ARM_TEMPLATE group in the left pane to display the context menu.

    2. Select Reset Contents from the context menu. All settings in the BOARD=ARM_TEMPLATE group are reset to the default settings.

  7. Click the BOARD=ARM_TEMPLATE group. The group settings are displayed in the right pane.

  8. Change the Description in the right pane to an appropriate description:

    1. Right-click on the Description to display the context menu.

    2. Select Edit Value... from the context menu.

    3. Enter Template BCD File. Make sure you press Enter to complete the entry.

  9. Add a new Advanced_Information group:

    1. Expand the BOARD=ARM_TEMPLATE group.

    2. Expand the Advanced_Information group.

    3. Right-click on the Advanced_Information group in the left pane to display the context menu.

    4. Select Make New... from the context menu to open the Enter Name of New object dialog box. The name default is inserted.

    5. Enter a name that is appropriate to the target for which this template is to be used. For this example, enter ARM.

    6. Click Create to close the dialog box.

  10. Delete the Default group:

    1. Right-click on the Default group in the left pane to display the context menu.

    2. Select Delete from the context menu. The Default group is deleted.

  11. Select File → Save and Close from the menu to save your changes and close the Connection Properties window.

Copyright © 2002-2011 ARM. All rights reserved.ARM DUI 0182N
Non-ConfidentialID052111