You copied the Doc URL to your clipboard.

Adding a new platform

Describes how to create a new configuration database containing a new platform for use with DS-5.


  1. Launch a command-line console:
    • On Windows, select Start > All Programs > ARM DS-5 > DS-5 Command Prompt.

    • On Linux:

      1. Add the install_directory/bin directory to your PATH environment variable. If it is already configured then you can skip this step.

      2. Open a Unix bash shell.

  2. Launch the import utility using the following command-line syntax:
    cdbimporter --help
    cdbimporter [--cdb=cdbpath] --list-cores
    cdbimporter [--cdb=cdbpath] [--target-cdb=targetpath] {file.rvc | --model[=modelpath]} [option]...				



    Displays a summary of the main command-line options.


    lists all the processors defined by the database supplied in the --cdb option.


    Specifies a path to the source configuration database (as shipped in DS-5) containing processor and register definitions to identify the target.


    Directory where the destination database is to reside. ARM® recommends that you build separate configuration databases in your own workspace to avoid accidental loss of data when updating DS-5. You can specify multiple configuration databases in DS-5 using the Preferences dialog. This enables platforms in the new database to use existing processor and register definitions.


    Imports from a configuration file (.rvc). You can use the Debug Hardware Configuration utility, dbghwconfig or rviconfig to connect to the target and save the information in a file. The resultant file contains limited debug and trace support for the platform that can be used to populate the DS-5 configuration database.


    Imports from a model that provides a CADI server.

    • If you supply the modelpath to the model executable, the utility launches the model for interrogation so that it can determine the connection settings that DS-5 uses to automatically launch the model on connection.

    • If you do not supply the modelpath to the model executable, you can force the utility to search for a running model to interrogate. You can then manually enter the data for the connection to the model. For example, processors names, IDs, and processor definitions. If you use this option then you must launch the model manually before connecting DS-5 to it.


    Where option can be any of the following:


    Disables the use of Cross Trigger Interface (CTI) synchronization in the resulting platform.


    Disables the use of trace components in the resulting platform.


    Displays default input when the database requires a user input. This does not apply to the output database path.


    Specifies a comma separated list of toolkits.

  3. During the import process, the import utility enables you to modify details about the processors of the new platform. Follow the instructions in the command-line prompts.

On successful completion a new configuration database is created containing the new platform that can be added to DS-5.