Configuring an Event Viewer connection to a bare-metal target

The Event Viewer allows you to capture and view textual logging information from bare-metal applications. Logging is captured from your application using annotations that you must add to the source code.

Note

The Event Viewer tab in the Debug Configurations dialog box is only enabled for targets where Instrumentation Trace Macrocell (ITM) capture is supported.

Show/hidePrerequisites

Before connecting you must ensure that you:

  • have the target IP address or name for the connection between the debugger and the debug hardware agent

  • annotate your application source code with logging points and recompile it.

Show/hideProcedure

To connect to the target:

  1. Select Window → Open Perspective → DS-5 Debug from the main menu.

  2. Select Debug Configurations... from the Run menu.

  3. Select DS-5 Debugger from the configuration tree and then click on New to create a new configuration.

  4. In the Name field, enter a suitable name for the new configuration.

  5. Click on the Connection tab to configure a DS-5 Debugger target connection:

    1. Select the required platform. For example, ARM-Versatile Express A9x4.

    2. Select the Bare Metal Debug project type.

    3. Select the required debug operation. For example, Debug and ETB Trace Cortex-A9x4 SMP via DSTREAM/RVI.

    4. Configure the connection between the debugger and the debug hardware agent.

  6. Click on the Files tab to define the target environment and select debug versions of the application file and libraries on the host that you want the debugger to use.

    1. In the Target Configuration panel, select the application on the host that you want to download to the target.

  7. Click on the Debugger tab to configure the debugger settings.

    1. In the Run control panel, specify the actions that you want the debugger to do after connection to the target.

    2. Configure the host working directory or use the default.

    3. In the Paths panel, specify any source search directories on the host that the debugger uses when it displays source code.

  8. If required, click on the Arguments tab to enter arguments that are passed, using semihosting, to the application when the debug session starts.

  9. Click on the Event Viewer tab to configure the ITM capture settings.

    1. Select Enable ITM capture.

    2. Enter the maximum size of the trace buffer.

    3. Add a configuration for each ITM channel that you want to receive trace on. This is dependent on how your program configures and uses the ITM.

  10. Click on Apply to save the configuration settings.

  11. Click on Debug to connect to the target.

  12. Debugging requires the DS-5 Debug perspective. If the Confirm Perspective Switch dialog box opens, click Yes to switch perspective.

When connected and the DS-5 Debug perspective opens you are presented with all the relevant Channel editors for the Event Viewer.

For more information on these options, use the dynamic help.

Show/hideSee also

Copyright © 2010, 2011 ARM. All rights reserved.ARM DUI 0446H
Non-ConfidentialID111711