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.
From the main menu, select
From the main menu, select Debug Configuration
to open the
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
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 .
NoteIf you cannot find the platform you want to connect to, then you
must first import your platform configuration using the Platform
Select your debug hardware unit in the Target
Connection list. For example, DSTREAM.
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
Figure 2-1 MyBareMetalConfig - Connection tab
Use the Files tab to specify your application and additional
resources to download to the target:
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.
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
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
- 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.
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.
In the Paths area, specify any
directories on the host to search for files of your application using
the Source search directory
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
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 configuration
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.