2.1 Overview: Debug connections in DS-5 Debugger

You can set up connections to debug bare-metal targets, Linux kernel, and Linux applications. You can also use the Snapshot Viewer feature to view previously captured application states.

Bare-metal debug connections

Bare-metal targets run without an underlying operating system. To debug bare-metal targets using DS-5 Debugger:

  • If debugging on hardware, use a debug hardware adapter connected to the host workstation and the debug target.
  • If debugging on a model, use a CADI-compliant connection between the debugger and a model.
  • For RTL simulators and hardware emulators, use VSTREAM to create connections.

Linux kernel debug connections

DS-5 Debugger supports source-level debugging of a Linux kernel. For example, you can set breakpoints in the kernel code, step through the source, inspect the call stack, and watch variables. The connection methodology is similar to bare-metal debug connections.

Linux application debug connections

For Linux application debugging in DS-5 Debugger, you can connect to your target using TCP/IP or serial connection.

Before attempting to connect to your target, you need to ensure that:

  • gdbserver is present on the target.


    • If gdbserver is not installed on the target, either see the documentation for your Linux distribution or check with your provider.
    • See the Debug System Requirements section in the latest DS-5 Release Notes for information about the minimum required version of gdbserver.
    • For ARMv8 AArch64 targets, you need to use the AArch64 gdbserver.
  • ssh daemon (sshd) must be running on the target to use the Remote System Explorer (RSE) in DS-5.
  • sftp-server must be present on the target to use RSE for file transfers.
  • Application rewind server running on the target if you are planning to use application rewind.


    The application rewind server file undodb-server can be found in the DS-5_install_directory\arm\undodb\linux folder.

Snapshot Viewer

Use the Snapshot Viewer to analyze and debug a read-only representation of the application state of your processor using previously captured data. For more information, see Chapter 9 Working with the Snapshot Viewer.

This is useful in scenarios where interactive debugging with a target is not possible.

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