2.3 Configuring a connection to a bare-metal hardware target

To configure a connection to a bare-metal hardware target, create a debug configuration in DS-5 Debugger with the appropriate settings. Then, connect to your hardware target using JTAG or Serial Wire Debug (SWD) using DSTREAM or a similar debug hardware adapter. To connect to a bare-metal model target, use the same procedure and use the appropriate model settings.


  • Ensure that your target is powered on and is working. See the documentation supplied with the target for more information.
  • Ensure that the debug hardware adapter connecting your target with your workstation is powered on and working.
  • If using DSTREAM, ensure that your target is connected correctly to the DSTREAM unit. If the target is connected and powered, the TARGET LED illuminates green, and the appropriate VTREF LED on the DSTREAM probe illuminates.


  1. From the main menu, select Window > Open Perspective > DS-5 Debug.
  2. From the main menu, select Run > Debug Configurations to open the Debug Configuration dialog.
  3. In the configuration tree, select DS-5 Debugger and then click Create a new configuration New to create a new configuration.
  4. Enter a suitable name for the new configuration, in the Name field. For example, My_BareMetal_Configuration.
  5. Use the Connection tab to specify the target and connection settings:
    1. In the Select target area of the dialog, browse and select the platform you require. For example, to connect to the CoreTile Express A9x4 (V2P-CA9) running on the Versatile Express motherboard, browse and select ARM Development Boards > Versatile Express A9x4 > Bare Metal Debug > Debug Cortex-A9x4 SMP.


      For custom targets, you can create suitable debug configuration files using the Platform Configuration Editor (PCE). The configuration files can then be added to the Configuration Database which enables you to find the targets in the Connections tab. See the Platform Configuration chapter for details.
    2. Select your debug hardware unit in the Target Connection list. For example, DSTREAM.
    3. If you need to, Edit the Debug and Trace Services Layer (DTSL) settings in the DTSL Configuration Editor to configure additional debug and trace settings for your target.
    4. In the Connections area, enter the Connection name or IP address of your debug hardware adapter. If your connection is local, click Browse and select the connection using the Connection Browser.
      Figure 2-1 MyBareMetalConfig - Connection tab
      MyBareMetalConfig - Connection tab

  6. Use the Files tab to specify your application and additional resources to download to the target:
    1. If you want to load your application on the target at connection time, in the Target Configuration area, specify your application in the Application on host to download field.
    2. If you want to debug your application at source level, select Load symbols.
    3. If you want to load additional resources, for example, additional symbols or peripheral description files from a directory, use the Files area to add them. Click Add resource to add resources, click Remove resources to remove resources.
      Figure 2-2 MyBareMetalConfig - Files tab
      MyBareMetalConfig - Files tab

  7. Use the Debugger tab to configure debugger settings.
    1. In the Run control area:
      • Specify if you want to Connect only to the target or Debug from entry point. If you want to start debugging from a specific symbol, select Debug from symbol.
      • If you need to run target or debugger initialization scripts, select the relevant options and specify the script paths.
      • If you need to specify debugger commands at debugger start up, select Execute debugger commands options and specify the commands.
    2. The debugger uses the Eclipse workspace as the default working directory on the host. If you want to change the default location, deselect the Use default option under Host working directory and specify the location you want.
    3. In the Paths area, specify any directories on the host to search for files of your application using the Source search directory field.
    4. If you need to use additional resources, click Add resource to add resources, click Remove resources to remove resources.
      Figure 2-3 MyBareMetalConfig - Debugger tab
      MyBareMetalConfig - Debugger tab

  8. If required, use the Arguments tab to to enter arguments that are passed, using semihosting, to the main() function of the application when the debug session starts.
  9. If required, use the Environment tab to create and configure environment variables to pass into the launch configuration when it is executed.
  10. Click Apply to save the configuration settings.
  11. Click Debug to connect to the target and start the debugging session.

The DS-5 Debug perspective starts up presenting the relevant views and editors.

For specific help in a selected view, press F1 on your keyboard and use the dynamic help.

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