2.3.57. 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 opened 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 open the Connection Properties dialog box:

editboardfile

The following example shows how to use EDITBOARDFILE to open 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 opened 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 opened. 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
      Instruction Set System Model(ISSM).smc
      Model Library.cml
      Model Process.cmp
      Real-Time System Model(RTSM).smc
      RealView ICE.rvc
      RealView Instruction Set Simulator (RVISS).auc
      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 opened. 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 to open the Select Name of new file: dialog box.

    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-2011 ARM. All rights reserved.ARM DUI 0175N
Non-ConfidentialID052111