10.6 Creating a platform configuration

You can use the Platform Configuration wizard within DS-5 to create debug configurations for new platforms.

Creating a platform configuration in DS-5 requires a new Platform Configuration project in Eclipse.


  1. From the main menu in DS-5, select File > New > Other to open the new project dialog.
  2. Select DS-5 Configuration Database > Platform Configuration and then click Next.
    Figure 10-1 New PCE project
    New PCE project

  3. This shows the Create Platform Configuration dialog box. Select the required method to create the configuration for your platform and click Next.
    Figure 10-2 Platform creation options
    Platform creation options

    The options are:
    • Automatic/simple platform detection

      This is the recommended option. DS-5 automatically detects the devices that are present on your platform. It then provides you the opportunity to add more devices if needed and to specify how the devices are interconnected. Select this option, and click Next to select the debug hardware adapter that is attached to your platform or specify the Connection Address of your debug hardware adapter.

    • Advanced platform detection or manual creation

      This option gives you control over the individual stages that are involved in reading the device information from your platform. It is useful if reading certain device information is likely to make the platform unresponsive.

    • Import from an existing RDDI configuration file (*.rcf, *.rvc, *.sdf), or a CoreSight Creator system description file (*.xml)

      Use this option if you already have a configuration file for your platform. It imports minimal information about the components available on your platform, such as the base address. After importing, you can manually provide additional information and links between the components to enable full debug and trace support.

    • Import from a *.cmm file

      Use this option to import a platform configuration from a CMM script (*.cmm) file.

      CMM scripts can contain target description information such as JTAG pre- and post- IR/DR bit information, core types, device base addresses, and CoreSight topology information. The PCE can use this information to create a DS-5 platform configuration, complete with custom DTSL control tabs for trace configuration.

      Some CMM scripts describe different targets (or different cores and trace devices in the same target) depending on the value of parameters that are passed to the script. If a CMM script requires parameters, you can enter them in the CMM script parameters field.

      Figure 10-3 Enter CMM script parameters
      Enter CMM script parameters


    Your debug hardware must have the minimum firmware version installed when detecting a new platform. If you are using outdated firmware, DS-5 warns you during the platform detection process.

    For example:

    Figure 10-4 Debug hardware firmware update notification during platform configuration
    Debug hardware firmware update notification during platform configuration

    Click Update to update your debug hardware firmware.

    DS-5 connects to the platform and reads all the device information that it can from the platform. The Summary dialog box shows the list of devices that DS-5 autodetected on the platform.

    Depending on your target, you might receive warnings and errors. If it is unable to obtain this information from the platform, DS-5 does not make assumptions about how the devices are connected. In particular, DS-5 might not have obtained all the necessary information about the trace devices on the platform. You can provide this information in the PCE view.

  4. In the Summary dialog, choose what you would like to do next with the detected platform. You can:
    • Save a Debug-Only DS-5 Platform Configuration

      Select this option to save a debug-only configuration to your configuration database. You can open this in DS-5 later to modify it or you can use it to connect to and debug the platform later.

    • Save a Debug and Trace DS-5 Platform Configuration

      Select this option to save a debug and trace configuration to your configuration database. You can open this in DS-5 later to modify it or you can use it to connect to and debug the platform later.

    • Edit platform in DS-5 Platform Configuration Editor

      Select this option to save the configuration to your configuration database and open the PCE view.

      In the PCE view, you can provide information about the platform that DS-5 was unable to autodetect.


    All DS-5 platform configurations must be stored in a configuration database.
  5. Click Next.
  6. In the New Platform dialog box, select a configuration database, or click Create New Database to create a new configuration database and enter a name for your configuration database.
    Figure 10-5 Create new configuration database
    Create new configuration database

  7. Click OK to save your configuration database and click Next.
  8. In the Platform Information dialog box, enter the Platform Manufacturer, for example ARM. Enter the Platform Name, for example Juno. Optionally, if you want to provide a URL link to information about the platform, you can enter it in Platform Info URL. The URL appears in the Debug Configurations panel when you select a debug activity for the platform.
    Figure 10-6 New platform information
    New platform information

  9. Click Finish to complete adding the platform to your configuration database.
    You can view the configuration database and platform in the Project Explorer.

    If you selected the Edit platform in DS-5 Platform Configuration Editor option, the PCE view is opened with the details of your platform. See Editing a platform configuration in the PCE for information on how to edit your platform configuration using PCE.

Non-ConfidentialPDF file icon PDF versionARM DUI0446Z
Copyright © 2010-2016 ARM Limited or its affiliates. All rights reserved.