Adding a new platform

  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]...

    where:

    --help

    Displays a summary of the main command-line options.

    --list-cores

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

    --cdb=cdbpath

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

    --target-cdb=targetpath

    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.

    file.rvc

    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.

    --model[=modelpath]]

    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.

    option

    Where option can be any of the following:

    --use-defaults

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

    --toolkit=key

    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.

Show/hideSee also

Copyright © 2010-2012 ARM. All rights reserved.ARM DUI 0446K
Non-ConfidentialID071912