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
From the main menu, select Window > Open Perspective > DS-5 Debug.
From the main menu, select Run > Debug Configurations to open the Debug
In the configuration tree, select DS-5 Debugger and then click
New to create a new configuration.
Enter a suitable name for the new configuration, in the
Name field. For example, My_BareMetal_Configuration.
Use the Connection tab
to specify the target and connection settings:
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
which enables you to find the targets in
tab. See the Platform Configuration
Select your debug hardware unit in the Target Connection list. For example,
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.
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
Use the Files tab to
specify your application and additional resources to download to the
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
If you want to debug your application at source level,
select Load symbols.
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 to add resources, click to remove resources.
Figure 2-2 MyBareMetalConfig - Files tab
Use the Debugger tab
to configure debugger settings.
In the Run
- 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
- 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
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
In the Paths
area, specify any directories on the host to search for files of your
application using the Source search
If you need to use additional resources, click to add resources, click to remove resources.
Figure 2-3 MyBareMetalConfig - Debugger tab
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.
If required, use the Environment tab to create and configure environment variables
to pass into the launch configuration when it is executed.
Click Apply to save the
Click Debug to connect
to the target and start the debugging session.
Debug perspective starts up presenting the relevant views and
For specific help in a selected view, press F1 on your keyboard and use the dynamic help.