|Non-Confidential||PDF version||ARM DUI0446Z|
|Home > Platform Configuration > 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.
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.
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.
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.
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.
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.
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.