1.4. What the configuration files contain

The target-related configuration files that RealView Debugger stores in your home directory include the following files:

*.auc

Configuration files for the RVISS Debug Interface.

*.brd

Top-level board files. By default, there is one board file rvdebug.brd for each user. This file contains an entry for each Debug Configuration that you create, which references the filenames of the other configuration files, for example .rvc and .bcd files.

Note

The first time you start RealView Debugger after installation, or after installing additional Debug Interface products, your user-specific rvdebug.brd is created or updated with the contents of the files in your default settings directory C:\Documents and Settings\userID\Local Settings\Application Data\ARM\rvdebug\version\shadowbase\etc\*.brd.

You can override this location with the RVDEBUG_SHADOW_DIR_ETC environment variable.

Your user-specific rvdebug.brd file is modified when you change and save Debug Configuration settings in the Connection Properties window.

Note

Only Debug Configuration settings must be configured in the rvdebug.brd file.

*.bcd

BCD files contain chip-specific and board-specific settings groups as named configurations. You must assign these groups to a Debug Configuration to use them. The name of the Advanced_Information block in each group determines whether the settings are used when you connect to a target in the related Debug Configuration.

Many BCD files are supplied by hardware manufacturers to define the memory map related settings for specific targets and development boards. By default, these files are located in your default settings directory:

C:\Documents and Settings\userID\Local Settings\Application Data\ARM\rvdebug\version\shadowbase\etc

You can override this location with the RVDEBUG_SHADOW_DIR_ETC environment variable.

RealView Debugger lists all BCD files that it finds in its search path in the (*.bcd) Board/Chip Definitions group when you display the Connection Properties window.

You are recommended to make changes to BCD files using the Connection Properties window. If you change a supplied file or you create your own, you are recommended to store them in your RealView Debugger home directory.

Note

Only memory map related settings must be configured in a BCD file.

*.cml

Configuration files for the Model Library Debug Interface.

*.cmp

Configuration files for the Model Process Debug Interface.

*.rvc

Configuration files for connections through a DSTREAM or RealView ICE unit, or to a simulated target through VSTREAM. You change the contents of one of these files when you modify the configuration using the RVConfig utility.

*.smc

Configuration files for the following Debug Interfaces:

  • ISSM

  • RTSM

  • SoC Designer.

You change the contents of one of these files when you modify the configuration using the related configuration utility.

See also:

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