RealView Debugger Command Line Reference GuideVersion 4.0
Home > RealView Debugger Commands > Alphabetical command reference > EDITBOARDFILE

2.3.56. EDITBOARDFILE

Enables you to configure a Debug Configuration.

Note

This command is not available when running in command line mode.

Syntax

EDITBOARDFILE [,configure] [="boardfilename","routeID"...]

where:

configure

Opens the Debug Interface configuration dialog for the specified Debug Configuration.

boardfilename

Identifies the board file that you want to edit. This can be in single or double quotation marks, for example, "myboard.brd".

You can include one or more environment variables in the filename. For example, if MYPATH defines the location C:\Myfiles, you can specify:

editboardfile ="$MYPATH\\myboard.brd"
routeID

Identifies the route ID for the Debug Configuration associated with the board file that you want to edit. This can be in single or double quotation marks, for example, '3'.

Description

The EDITBOARDFILE command enables you to configure a Debug Configuration. By default, the command displays the Connection Properties dialog box to edit the specified Debug Configuration. If you do not specify a board file, the settings of the current board file are displayed for you to edit. If you specify the ,configure qualifier, then the Debug Interface configuration dialog box is displayed instead.

Note

If you specify a routeID, you must also specify a blank boardfilename, for example:

editboardfile,configure "","3"

You can specify one or more boardfilename/routeID combinations.

If you make any changes to a board file, the updated file is reread when you close the Connection Properties dialog box.

The command runs asynchronously.

Example

The following example shows how to use EDITBOARDFILE to display the Connection Properties dialog box:

editboardfile

The following example shows how to use EDITBOARDFILE to display the Debug Interface configuration dialog box:

editboardfile,configure "","4"

If you specify a board that does not have a target-specific configuration, then a Prompt dialog box is displayed informing you that a configuration file could not be found. To create a configuration file:

  • Click Empty to create the configuration file from an empty file. The Select Name of new file: dialog box is displayed. Do the following:

    1. Enter a name for the new file, together with the file extension for the related Debug Interface as shown in Table 2.21.

      Table 2.21. Configuration file extensions for each Debug Interface

      Debug InterfaceFile extension
      RealView Instruction Set Simulator (RVISS).auc
      Instruction Set System Model(ISSM).smc
      Real-Time System Model(RTSM).smc
      RealView ICE.rvi
      SoC Designer.smc

    2. Set Save as type to All Files (*).

    3. Click Save to create the new file. The configuration utility for the related Debug Interface is displayed. Configure the target in the usual way.

  • Click Copy to create the configuration file by copying an existing file. The Select file to copy from: dialog box is displayed. Do the following:

    1. Select the file to use for the copy. The file you use must be from the same Debug Interface as shown in Table 2.21.

    2. Click Open. The Select Name of new file: dialog box is displayed.

    3. Enter a name for the new file, together with the file extension for the related Debug Interface as shown in Table 2.21.

    4. Set Save as type to All Files (*).

    5. Click Save to create the new file. The configuration utility for the related Debug Interface is displayed. Configure the target in the usual way.

See also

Copyright © 2002-2009 ARM Limited. All rights reserved.ARM DUI 0175K
Non-Confidential
PDF file icon  PDF version
Home > RealView Debugger Commands > Alphabetical command reference > EDITBOARDFILE