10.12 Importing a custom model

If you have built your own custom CADI-compliant model, to connect to it using DS-5, you have to create a new entry in the DS-5 configuration database. Depending on how the model is defined in the configuration database, DS-5 can either launch the model or can connect to an already running model.

Note

ARM® FVPs not provided with DS-5 installation should be defined in the PATH environment variable of your OS to be available for DS-5.
Add the DS-5_install_directory/bin directory to your PATH environment variable and restart Eclipse.
  • For Windows, enter set PATH=<your model path>\bin;%PATH%
  • For Linux, enter export PATH=<your model path>/bin:$PATH
To make the change permanent, so that the modified path is available in future sessions:
  • For Windows, right-click My Computer > Properties > Advanced system settings > Environment Variables and under User Variables, create a PATH variable with the value <your model path>\bin, or else append ;<your model path>\bin to any existing PATH variable.
  • For Linux, set up the PATH in the appropriate shell configuration file. For example, in .bashrc, add the line export PATH=<your model path>/bin:$PATH
For the models you build yourself, follow the instructions as described in this topic.

Procedure

  1. Launch your model and start the CADI server.
    • If your model is a library file:
      • On Windows, select Start > All Programs > ARM DS-5 > DS-5 Command Prompt and enter model_shell -m <your model path and name> -S.
      • On Linux, open a new terminal and run: DS-5_install_directory/bin/model_shell -m <your model path and name> -S
    • If your model is an executable file, at the command prompt, enter <your model path and name> -S.

    Note

    For more information about options available with the model_shell utility in DS-5, enter model_shell --help at the DS-5 command prompt.
  2. Launch DS-5 and open the DS-5 Configuration perspective. Create a new model configuration as shown in 10.11 Creating a new model configuration.
    1. Browse the list of models running on the local host.
    2. If there is more than one active CADI-compliant model simulation, DS-5 lists the available connections. Select the one you want to connect to.
    3. If needed, select a core to modify.
    4. If needed, enter the name of the Platform Manufacturer.

      Note

      If you do not enter a name for the platform manufacturer, you can find the platform you added listed under Imported in the list of platforms in the Debug Configurations dialog.
    5. Enter the name of the Platform.
  3. Rebuild the DS-5 Configuration database:
    • From the DS-5 menu, select Window > Preferences > DS-5 > Configuration Database and click Rebuild database.
    Your model is now available as one of the targets in the configuration database. Use the Debug Configurations dialog to create, manage, and run configurations for this target.
Related concepts
2.1 Overview: Debug connections in DS-5 Debugger
10.2 About importing platform and model configurations
Related tasks
2.5 Configuring a connection to a Fixed Virtual Platform (FVP) model for Linux application debug
2.6 Configuring a connection to a Linux application using gdbserver
2.7 Configuring a connection to a Linux kernel
2.3 Configuring a connection to a bare-metal hardware target
8.4 Specifying a custom configuration database using the command-line
Related information
Component Architecture Debug Interface Developer Guide
Non-ConfidentialPDF file icon PDF versionARM DUI0446W
Copyright © 2010-2015 ARM. All rights reserved.