Documentation, tutorials: Getting Started with DS-5.

Installation Procedure

Community Edition host installation

If you want to install and use DS-5 Community Edition, look here: Be aware that version 5.8 of the Community Edition does not work with 64-bit Eclipse!. This will be fixed in future releases.

However it is possible to run DS-5 on a 64-bit workstation by using a 32-bit JRE. See this page. Here is also described how DS-5 works with Android.

Professional Edition host installation

(this procedure applies to the Application and Linux Editions as well)

  • Go to (need to login/register) and download "DS-5 Linux Installer"

  • Extract the tarball, execute ./

  • Answer "b" to the first question
  • Read the licence and answer "yes" ("y" won't work ;-) ) to the "do you agree" question

  • Select install directory ("~/DS-5" by default), if doesn't exists you will be asked "create?" (answer is "y", obviously)

  • "Installing to ..." (This may take a while...)
  • You may or may not want the installer to add menu items (suggested answer is "no")
  • Launch DS-5 Eclipse "<ds5>/bin/eclipse"

    • If you experience DS-5.6 Eclipse complaining about heap allocation and crashing, replace -XX:+AggressiveHeap with -Xmx2g in <ds5>/sw/eclipse/eclipse.ini and <ds5>/sw/debugger/

  • "Help" -> "ARM License Manager"

  • "Add Licence", select license file, "Close" (you may have to obtain a license first)

Target installation

(all editions)

From the Linaro 12.04 release onward, the required components are part of the main Linaro PPA and can be installed with:

  • apt-get update

  • apt-get install arm-ds5-target

  • passwd root (must *not* be empty)


Streamline validation

Documentation: Using ARM Streamline

  • Launch DS-5 Eclipse "<ds5>/bin/eclipse"

  • "Window" -> "Show View" -> "Other" (Shift-Alt-Q Q)

  • "Arm Streamline" -> "Arm Streamline Data", OK

  • Target IP in the "Address" field, click "Start Capture" (just right from "Address")

  • Let the circle rotate for 5 seconds
  • Click "Stop"
  • There should be about 5 seconds of data on the time charts, peaks should be visible approximately every second (on an unloaded system gator is flushing its buffers ca. every second)

RSE validation

Documentation: Using Eclipse

  • Launch DS-5 Eclipse "<ds5>/bin/eclipse"

  • "Window" -> "Show View" -> "Other" (Shift-Alt-Q Q)

  • "Remote Systems" -> "Remote Systems", OK

  • "Define a connection to remote system" (first icon in the view's tool bar)

  • "SSH Only", "Next >"

  • Target IP in the "Host Name" field, "Finish"
  • Unfold "<Target IP>" -> "Sftp files" -> "Root"

  • Enter "root" and password (if appropriate select saving user name and password)
  • Accept SSH key
  • Unfold "/" - you should see target filesystem directories
  • Right click on "Ssh Terminals", "Launch Terminal" - you should get target terminal

Application debugger validation

Documentation: Using The Debugger and Debugger Command Reference

  • Launch DS-5 Eclipse "<ds5>/bin/eclipse"

  • Configure RSE connection to the target, if not done previously

  • "Run" -> "Debug configurations..."

  • Double click on "DS-5 Debugger" (or right click and "New")
  • Select "New configuration"
  • On "Connection" tab:
    • Select "Platform" -> "Generic - gdbserver"

    • "Project type" should be "Linux Application Debug"
    • Select "Debug operation" -> "Start gdbserver and debug target resident application"

    • "RSE connection" -> "<Target IP>"

  • On "Files" tab:
    • Enter "/bin/echo" to "Application on target:"
  • On "Debugger" tab
    • Select "Connect only"
  • Click "Debug", agree to switch perspective
  • After a little while you should see code in "Disassembly" view, be able to step through (F5) and check registers contents in "Registers" view (at least PC, SP and LR should not be zeros)

Known Issues

  • In DS-5 v5.10 and earlier the pre-built examples are 'armel' ABI (and the tools default to 'armel' and the example distribution (sysroot) is 'armel'). 12.04 and later Linaro Ubuntu releases are 'armhf'. By default trying to run an 'armel' binary will fail with 'File not found' (it's /lib/ that's not found). (You can rebuild the examples on the target as 'armhf'.) To run 'armel' binaries on 12.04 you can install the 'armel' packages that are used by the binaries (see 'ldd' and 'dpkg-query -S'). These are enough to run the gnometris and xaos pre-built examples.

    dpkg --add-architecture armel
    echo 'deb [arch=armel] precise main universe' >>/etc/apt/sources.list.d/armel.list
    apt-get update
    apt-get -y install libc6:armel
    apt-get -y install libstdc++6:armel libgtk2.0-0:armel libglib2.0-0:armel libcairo2:armel
    apt-get -y install liboverlay-scrollbar-0.2-0:armel
    The liboverlay-scrollbar-0.2-0:armel seems to replace the 'armhf' version which probably means certain 'armhf' binaries will stop working.
  • There is no way of debugging packaged Linaro kernels before 11.09 release, because of lack of Kernel dbg packages:
  • For releases >= 11.09 you should be able to download the dbgsym package from the Overlay PPA:


Platform/DevPlatform/DS5 (last modified 2013-10-23 09:52:42)