2.9 Configuring an Events view connection to a bare-metal target

The Events view allows you to capture and view textual logging information from bare-metal applications. It also allows you to view packets generated by the Data Watchpoint and Trace (DWT) unit on M-profile targets. Logging is captured from your application using annotations that you must add to the source code.


Before connecting, you must ensure that you:

  • Have the IP address or name of the target. If using a local connection, you can click Browse and select the target.

  • On M-profile targets, set registers appropriately to enable the required DWT packets. See the ARMv7-M Architecture Reference Manual for more information.
  • Annotate your application source code with logging points and recompile it. See the ITM and Event Viewer Example for Versatile Express Cortex-A9x4 provided with DS-5 examples for more information.


  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 New to create a new configuration.
  4. In the Name field, enter a suitable name for the new configuration.
  5. Click the Connection tab to configure a DS-5 Debugger target connection:
    1. Select the required platform. For example, ARM Development Boards > Versatile Express A9x4 > Bare Metal Debug > Debug Cortex-A9x4 SMP.
    2. In Target Connection, select the target connection type, for example, DSTREAM.
    3. In DTSL Options, click Edit to configure DSTREAM trace and other target options. In the DTSL Configuration Editor dialog box which opens:
      • In the Trace Capture tab, either select On Chip Trace Buffer (ETB) (for a JTAG cable connection) or DSTREAM 4GB Trace Buffer (for a Mictor cable connection).
      • In the ITM tab, enable or disable ITM trace and select the additional required settings.
  6. Click 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 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 connecting 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 the Arguments tab to enter arguments that are passed, using semihosting, to the application when the debug session starts.
  9. Click Apply to save the configuration settings.
  10. Click Debug to connect to the target. 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 views and editors.
  11. Click the Events view to set up event options.
    1. In the Events view, from the View menu, select Events Settings.
    2. In Select a Trace Source, ensure that the trace source matches the trace capture method specified earlier.
    3. Select the required Ports/Channels.
    4. On M-profile targets, if required, select any DWT packets.
    5. Click OK.
  12. Run the application for a few seconds, and then interrupt it.
You can view the relevant information in the Events view. For example:
Figure 2-11 Events view with data from the ITM source
Events view with data from the ITM source

For more information on these options, press F1 on your keyboard to display dynamic context help.

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