ARM® Development Studio 5 (DS-5™) is the toolkit of choice for software developers who want to fully realize the benefits of the ARM Architecture. The DS-5 installation contains:
- DS-5 Debugger, covering all stages of product development
- ARM Compiler 5.03u3 for embedded and bare-metal code
- Linaro GCC Toolchain 2013.03 for Linux applications and Linux kernel
- ARM Streamline™ Performance Analyzer for various operating systems, including Linux, Android and RTX
- Eclipse IDE, source code editor and project manager
- Fixed Virtual Platforms (FVP) for Cortex™-A8 and quad-core Cortex-A9 processors
- Example projects and documentation
This is a summary of the new features and other major changes in this release:
Supported host platforms
- added support for Red Hat Enterprise Linux 6 Workstation
- updated to ARM Compiler 5.03u3 for latest improvements and bug fixes
- for further information on changes see http://infocenter.arm.com/help/topic/com.arm.doc.arn0005m/index.html
- auto-discover Gator, DSTREAM, and RealView ICE connections over the local network
- support added for Mali-450 GPU
- Streamline Data view adds the ability to import and export zipped capture files
- chart configuration in the Timeline view provides settings for lower and upper extent of displayed data
- Timeline view allows filtering by thread name
- experimental support added for Cortex-A12 Performance Monitor Unit (PMU)
- experimental support added for CoreLink CCN-504 Cache Coherent Network hardware counters
- includes gator version 16
- added OS awareness for Express Logic ThreadX® on Cortex family devices
- OS awareness for Micrium® μCOS-III® extended to Cortex-A family devices
- Trace view now supports searching by instruction address, data address, function name and index
- new Trace Control view to display information about trace capture devices and configure when trace capture is started and stopped
- new commands trace-start and trace-stop allow starting and stopping trace capture from scripts
- support is added for 64-bit data from STM (System Trace Macrocell)
- Trace view allows display of captured trace data without stopping the target
- device support extended to include:
- i.MX6 Solo (Generic): DSTREAM and RVI
- Vybrid VF5xx: ULINKPro, ULINKPro D and CMSIS-DAP, RVI and DSTREAM
- Vybrid VF3xx: ULINKPro, ULINKPro D and CMSIS-DAP, RVI and DSTREAM
- mbed NXP LPC11U24: CMSIS-DAP
- mbed NXP LPC1768: CMSIS-DAP
- ULINKPro and ULINKPro D support added to:
- Altera - Arria V SoC
- Altera - Cyclone V SoC
- ARM Development Boards - Versatile Express A9x4
- Atmel - SAMA5D3x
- Avnet - Zedboard_JTAG_J15
- beagleboard.org - OMAP 3530
- Freescale - i.MX50 Generic
- Freescale - i.MX50 EVK
- Freescale - i.MX51 Generic
- Freescale - i.MX51 PDK
- Fujitsu - MB9BF506N Generic
- Nufront - NS115 Generic
- Nufront - NS115 Development Kit
- Phytec - Vybrid-VF65
- ST - SPEAr1310
- Texas Instruments - OMAP 3430 Generic
- Texas Instruments - OMAP 34XX Generic
- Texas Instruments - OMAP 3530 Generic
- Texas Instruments - OMAP 35XX Generic
- Texas Instruments - OMAP 3630 Generic
- Xilinx - Zynq-7000 EPP Emulation Board
- Xilinx - Zynq-7000 EPP ZC702
- ULINKPro D support added to:
- Keil - Keil MCBSTM32E Evaluation Board
- Freescale - Vybrid VF6xx
- Renesas - RZ/A1H R7S721001
- ULINK2 support added to:
- ARM Development Boards - Versatile Express A9x4
- CMSIS-DAP support added to:
- Phytec - Vybrid-VF65
- new 4.14.0 version of firmware included
- powerdown awareness for Freescale i.MX6 and TI KeyStone platforms is added
- support added for CoreSight components and Cortex cores on AHB/AXI interfaces
- allows simultaneous connection from DS-5 and csat tools to the same target
- notifications are added for support and maintenance expiry and impending license expiry
- updated to PyDev (Python development plug-ins) version 2.7.5 in Eclipse IDE for latest enhancements and fixes
- new Linux examples application_rewind_1 and application_rewind_2 demonstrating application rewind
- new bare-metal example Freescale-iMX6Q_RAM showing debug support for the Freescale i.MX6Q
- numerous fixes and improvements to RTX real-time operating system (see README.txt within the RTX example directory for further information)
The following features are at beta status:ARM Streamline Performance Analyzer
- Streamline can now analyse Cortex-M targets using DSTREAM, ITM and DWT with an RTOS such as RTX
- new Linux application rewind feature allows you to seamlessly run and step backwards, use breakpoints and watchpoints (on supported kernels and targets) and examine the state of your application at any point in the past
The following features are deprecated and might be removed in a future release:
Minimum supported Java version
- use of Java 6 is deprecated for running ARM's Eclipse plug-ins, and future releases of DS-5 will ship with Java 7 and require this as the minimum supported version
- Cortex-A8 simulation model for Emulation Baseboard is deprecated
- support for Ubuntu Desktop Edition 10.04 LTS is deprecated
Information about the full set of target platforms supported by DS-5 can be found on http://www.arm.com/products/tools/software-tools/ds-5/supported-platforms.php.
The list of changes in this and previous releases can be found on http://www.arm.com/products/tools/software-tools/ds-5/change-log.php.
Visit the DS-5 web resources at http://www.arm.com/ds-5 to find to tutorials, knowledgebase articles, and any software updates that are available.
Technical support for DS-5 should be obtained from your supplier. Support issues can be raised directly with ARM at https://silver.arm.com/ (requires registration). Where appropriate, please mention the build of DS-5 that you are using, which can be found at the top of these release notes beneath the title. Refer to http://www.arm.com/support/obtaining-support/index.html for further information on obtaining support.
Queries and support issues relating to DS-5 can also be raised on ARM's public forums at: http://forums.arm.com/.
DS-5 requires a minimum specification of computer with a dual core 2GHz processor (or equivalent) and 2GB of RAM. 4GB or more of RAM is recommended to improve performance when debugging large images, or when using the simulation models. A full installation requires approximately 1.5GB of hard disk space. A minimum screen resolution of 1024x768 is required.
DS-5 is supported (except where specified) on both 32-bit and 64-bit versions of the following host platforms (and service packs):
- Windows 7 Professional Service Pack 1
- Windows 7 Enterprise Service Pack 1
- Windows XP Professional Service Pack 3 (32-bit only)
- Windows Server 2008 R2 (ARM Compiler toolchain only)
- Windows Server 2003 (ARM Compiler toolchain only)
- Red Hat Enterprise Linux 5 Desktop with Workstation option
- Red Hat Enterprise Linux 6 Workstation
- Ubuntu Desktop Edition 12.04 LTS
- Ubuntu Desktop Edition 10.04 LTS (32-bit only) [deprecated: support for this platform might be removed in future releases]
All line drawings in the online help use SVG format. To view these graphics, your browser must support the SVG format. If your browser does not have native support for SVG, you must install an appropriate plug-in such as the Adobe SVG Viewer (http://www.adobe.com/svg/viewer/install/).
DS-5 can co-exist with the earlier ARM RVDS toolchain provided that they are installed into separate directories.
Android and ARM Linux application debug require gdbserver be available on your target. Depending on your chosen connection type, DS-5 Debugger might be able to copy gdbserver to the target for you, but otherwise you must copy it yourself. The recommended version of gdbserver is 7.0 or higher. gdbserver executables, built for Android and ARM Linux, that are compatible with DS-5 Debugger are provided in the <installdir>/arm/gdbserver directory. gdbserver executables for Android have been tested against Android Virtual Devices Froyo-v2.2 to ICS-v4.0. DS-5 Debugger is unable to provide reliable multi-threaded debug support with gdbserver versions prior to 6.8.
Android and Linux application rewind require undodb-server to be available on your target. DS-5 Debugger copies undodb-server to the target for you in the Download and Debug connection type, but for all other connection types you must copy it yourself. The undodb-server binary can be found in the <installdir>/arm/undodb/linux directory within your installation. Application rewind does not follow forked processes or allow modification of register values.
DS-5 support for Android and Linux depends upon infrastructure and features introduced in specific kernel versions:
- DS-5 Debugger supports debugging NDK-generated native libraries on Android versions 2.2, 2.3.x, 3.x.x, and 4.0.
- DS-5 Debugger supports debugging ARM Linux kernel versions 2.6.28 and later.
- ARM Streamline Performance Analyzer supports ARM Linux kernel versions 2.6.32 and later.
- Application debug on SMP systems requires ARM Linux kernel version 2.6.36 or later.
- Access to VFP and NEON registers requires ARM Linux kernel version 2.6.30 or later and gdbserver version 7.0 or later.
ARM Linux kernel and bare-metal debugging require the use of additional tools (not supplied with DS-5) to connect to your target system. DSTREAM, RVI, ULINKpro and ULINKpro D debug units allow connection to physical hardware targets. VSTREAM allows connection to RTL simulators and hardware emulators.
The minimum supported firmware version for DSTREAM, RVI and VSTREAM is 4.14.0. For DSTREAM and RVI it is recommended that you use the supplied debug hardware update tool to check that you are using the latest firmware and to update it if necessary. Updated firmware is available in the <installdir>/sw/debughw/firmware directory. The firmware for VSTREAM is delivered as part of the VSTREAM software, so you must obtain and install a newer version of this product if the firmware version is too old.
Separate installable products are provided for 32-bit and 64-bit Linux. Although you can install the 32-bit product on 64-bit Linux, it is recommended to install the 64-bit product instead. The 64-bit product is for use on 64-bit Linux only, and is capable of processing larger data sets and suffers from fewer operating system compatibility issues than the 32-bit product.
To install DS-5 on Linux, run (not source) install_x86_32.sh or install_x86_64.sh and follow the on-screen instructions. The installer unpacks DS-5 into your chosen directory, and optionally installs device drivers and desktop shortcuts. It is recommended that you delete any previous release of DS-5 before installing this release. The installer guides you through this process. Alternatively you can install this release into a different directory.
The tools installed by both 32-bit and 64-bit installers have dependencies on 32-bit system libraries. You must ensure that 32-bit compatibility libraries are installed when using DS-5 on 64-bit Linux host platforms. DS-5 tools might fail to run or report errors about missing libraries if 32-bit compatibility libraries are not installed. The ARM Knowledgebase contains further information about the required DS-5 dependencies: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.faqs/ka14522.html.
The installer includes device drivers to allow USB connection to DSTREAM, RVI, ULINKpro and ULINKpro D debug hardware units. It is recommended to install these drivers if you intend to use these features. Installation of these drivers requires that you run the installer with root privileges. If you do not run the installer with root privileges or choose not to install these drivers, then you can still install them after installation by running the <installdir>/run_post_install_for_ARM_DS-5.sh script with root privileges. The installer creates a desktop menu using the freedesktop.org menu system on supported Linux platforms.
Separate installable products are provided for 32-bit and 64-bit Windows. Although you can install the 32-bit product on 64-bit Windows, it is recommended to install the 64-bit product instead. The 64-bit product is for use on 64-bit Windows only, and is capable of processing larger data sets than the 32-bit product.
To install DS-5 on Windows, run setup.exe and follow the on-screen instructions. If you have an earlier release of DS-5 already installed, then you can install this release on top of it and an upgrade is performed.
During installation you might be prompted to install device drivers. These drivers are to allow USB connections to DSTREAM, RVI, ULINKpro, ULINKpro D and Energy Probe hardware units, and to support networking for the simulation models. It is recommended to install these drivers if you intend to use these features. You might receive warnings such as "Windows can't verify the publisher of this driver software" or "The software you are installing has not passed Windows Logo testing". You can safely ignore these warnings and continue with installation.
After installation, you can start Eclipse for DS-5, which includes C/C++ project management, DS-5 Debugger, ARM Streamline Performance Analyzer, examples and documentation from the ARM DS-5 -> Eclipse for DS-5 entry in your desktop menu. Eclipse for DS-5 and other supplied tools can also be found within the <installdir>/bin directory.
Portions of DS-5 are license managed and you must install a license before using them. See the Obtaining and Installing Your License section of these release notes below for further information about this.
The installer does not modify any environment variables on your system. To run the tools more easily from a console you can manually add the <installdir>/bin directory to your PATH environment variable. You should be aware that DS-5 includes copies of gcc and make that might behave differently from any copies that are installed elsewhere on your system. For this reason, if you modify your PATH environment variable, it is recommended that you do this locally within a console rather than globally for your entire system. See your operating system documentation for further information on setting environment variables.
On Linux you can run <installdir>/bin/suite_exec <shell> to open a shell with the PATH environment variable correctly configured. Run this tool with no arguments for more help.
On Windows the Start menu contains DS-5 Command Prompt. This console is preconfigured with the bin directory added to the PATH environment variable.
Further information on using DS-5 can be found in the on-line help within Eclipse for DS-5. To access the on-line help, start Eclipse for DS-5 and select Help -> Help Contents. The main documentation for DS-5 can be found under the DS-5 Documentation section in the contents.
Separate documentation is provided for the supplied examples in the <installdir>/examples/docs/index.html document, which is also linked to from the Examples Index menu entry in the ARM DS-5 Windows Start menu.
You must obtain a valid license before using DS-5.
You can use the License Manager dialog in Eclipse for DS-5 to obtain and install node-locked licenses on both Windows and Linux. You can open this dialog by selecting ARM License Manager in the Eclipse for DS-5 Help menu.
Alternatively, floating and commercial (paid-for) node-locked licenses can be obtained and installed manually. Further instructions on this can be found in the ARM DS-5 License Management Guide document in the <installdir>/documents directory.
Consult the License Management FAQ at http://infocenter.arm.com/help/topic/com.arm.doc.faqs/kiLwjCHu92xQmR.html for more assistance with the installation of your license.
Contact email@example.com if you need additional help with registering or obtaining your license. Please provide your serial number, a detailed description of the problem, and your ARM web licensing system username and password.
If you are installing a floating license server then the installation contains binaries for FlexNet 11.x. It is recommended that you use 11.x binaries on your license server in order to match the version of FlexNet that is used within the DS-5 tools.
To uninstall DS-5 on Windows, use Add or Remove Programs in Control Panel, select ARM DS-5 and click the Remove button.
To uninstall DS-5 on Linux, run remove_menus_for_ARM_DS-5.sh in the root directory of your installation to remove desktop menu entries, and then simply delete the installation directory.
On both Windows and Linux, some per-user configuration is stored outside of the installation directory, which you might optionally choose to delete. For Windows these files are stored in %APPDATA%\ARM\DS-5. For Linux these files are stored in $HOME/.ds-5.
The following known issues and limitations exist in this release:
Problem: Connecting to custom DTSL scripts might fail with errors such as: Unable to connect to ulink renesas. Python error in script <USER_DB>\Boards\Renesas\R7S721001\dtsl_config_script.py at line 14: ImportError: cannot import name IARMCoreTraceSource when creating configuration DtslScript_ULINK due to a change in interface locations in DS-5 5.16. [SDDS5-2194]
Workaround: DTSL interfaces have moved from directory com.arm.debug.dtsl.components to com.arm.debug.dtsl.interfaces. Edit your custom DTSL script to use the new location.
Eclipse for DS-5
Problem: Eclipse fails to start and reports "cannot restore segment prot after reloc: Permission denied" [SDDEBUG-13327]
Workaround: This error occurs because some of the shared libraries used by the applications require text relocation, but the Security-enhanced Linux (SELinux) policy on your machine prohibits this. To work around this, change the SELinux policy for your DS-5 applications and shared libraries to allow text relocation. This can be achieved with the following command, run under a super user account:
chcon -R -t texrel_shlib_t "<installdir>"
Problem: Eclipse fails to start and reports "JVM terminated" or outputs a stack backtrace. [SDDEBUG-6433]
Workaround: This problem is often caused by heap settings for Eclipse that are not suitable for the computer that you are running it on. To fix this you must edit <installdir>/sw/eclipse/eclipse.ini to supply alternative heap settings. The following knowledgebase article provides detailed instructions on making this change: http://infocenter.arm.com/help/topic/com.arm.doc.faqs/ka14185.html.
Streamline Performance Analyzer
Streamline supports CCN-504 in this release as experimental only. To enable CCN-504, insmod gator module with the ccn504_addr=<addr> parameter where addr is the base address of the CCN-504 configuration register space (PERIPHBASE), for example: insmod gator.ko ccn504_addr=0x2E000000.