DS-5 Release Notes
(version 5.29.3 build 5293015 dated 2019/10/02 13:17:48 GMT)
Introduction
Arm® DS-5 Development Studio is the toolkit of choice for software developers who want to fully realize the benefits of the Arm Architecture. The DS-5 installation contains:
Arm Compiler 6 for embedded and bare-metal code, providing best-in-class code generation for processors based on architectures Armv6-M, Armv7-A/R/M, Armv8-A/R/M
Arm Compiler 5 for embedded and bare-metal code for architectures up to Armv7 (Armv8 is not supported)
Linaro GCC Toolchain for Linux applications and Linux kernel development targeting the AArch32 architecture
DS-5 Debugger, covering all stages of product development
Arm Streamline Performance Analyzer
Mali Graphics Debugger, allowing developers to trace Vulkan, OpenGL ES, EGL, and OpenCL API calls
Single and multi-core simulation models for architectures Armv6-M, Armv7-A/R/M and Armv8-A/R/M
Eclipse IDE, source code editor and project manager
Example projects and documentation
What's New
This is a summary of the new features and other major changes in this release:
Arm Compiler
Updated Arm Compiler 6 to version 6.10.1, adding support for latest processors, optimizations and bug fixes
Linaro GCC Toolchain
Linaro GCC toolchain 4.8-2014.04 has been removed from the DS-5 installer. A greater variety of GCC toolchains is available on developer.arm.com and can be installed alongside DS-5 following this tutorial
DS-5 Debugger
New processor support for Cortex-A76 (Ultimate) and Cortex-M35P (Professional)
Debugger support for CoreSight ELA-600 Embedded Logic Analyzer
Support for Arm Debug Interface version 6 (ADIv6)
Support for integration of third party debug probes
Operating System awareness for Keil RTX5
Target system autodetection using ULINK2, ULinkPro(D) and CMSIS-DAP debug probes
Performance improvements when connecting to many core systems
New device support for:
ARM Musca-A Board Cortex-M33 (SSE-200 subsystem)
Marvell 88f8040
NXP i.MX8M EVK
Renesas RZ/A2M
Intel Stratix 10 SoC FPGA – additional support for cross triggering between CPU and FPGA
Intel Agilex SoC FPGA
Arm Fixed Virtual Platforms:
Base Cortex-A76
MPS2 Cortex-M35P
Arm Streamline Performance Analyzer
Updated Streamline to version 6.7.1
Support added for Cortex-A76 (Ultimate), Mali-G76, Mali-G52 and Mali-G31 allowing Streamline to be used with the latest Arm cores
RTX5 Bare-metal example added to show how to instrument an operating system
Added support for comparing and merging captures together to see if optimizations have improved system performance
Hardware counters can now be selected and added when the trace is running by dragging them onto the trace
Support added for systems that have up to 128 cores allowing Streamline to be used with Arm servers
Non-root support greatly improved to add:
Sampling information for the user's application
CPU hardware counter information
Support for call stack unwinding from userspace gatord captures
Simulation models
Updated Fixed Virtual Platforms (FVPs) to version 11.4
Mali Graphics Debugger
Updated Mali Graphics Debugger (MGD) to version 4.9.4
Full trace replay support has been greatly improved:
OpenGL ES 3.2 support has been added so that all OpenGL ES traces can be replayed back on the target
Multi-context support has been added to replaying traces back on the target
Mali Graphics Debugger can automatically upload traces onto the target to be replayed
Examples
Added bare-metal examples for Cortex-A76
Added examples for Keil RTX version 5 RTOS
Added use-case scripts for ELA-600 to the DTSL examples
Added a multi-core primes example for Cortex-R8
Removed Linux kernel image for Cortex-A9 FVP. Examples which previously relied on this Linux kernel image have been updated to provide instructions to create a similar runtime environment.
Click here to view new feature videos online.
The following features are deprecated and might be removed in a future release
VSTREAM software
For more information about debugging against RTL emulation, please contact the Arm Development Solutions sales team
Support and Updates
Visit the DS-5 web resources at https://developer.arm.com/products/software-development-tools/ds-5-development-studio 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://developer.arm.com/support (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.
Queries and support issues relating to DS-5 can also be raised on Arm's public forums at: http://community.arm.com/groups/tools/.
Host Computer Requirements
DS-5 requires a minimum specification of computer with a dual core 2GHz processor (or equivalent) and 4GB of RAM. A full installation requires approximately 4GB of hard disk space. A minimum screen resolution of 1024x768 is required.
DS-5 is supported on the following operating systems:
Windows 10
Windows 7 Professional Service Pack 1
Windows 7 Enterprise Service Pack 1
Red Hat Enterprise Linux 7 Workstation
Red Hat Enterprise Linux 6 Workstation
Ubuntu Desktop Edition 16.04 LTS
Ubuntu Desktop Edition 14.04 LTS
Note: DS-5 is supported on 64-bit x86 host platforms only.
In addition, Arm Compiler toolchains are supported on the following host platforms:
Windows 8.1, 64-bit
Windows Server 2012, 64-bit
Note: on Windows operating systems, DS-5 and Arm Compiler toolchains require the Universal C Runtime (CRT) to be installed. Universal CRT is a Windows operating system component. It is a part of Windows 10. For Windows versions prior to Windows 10, the Universal CRT is distributed via Windows Update. You can download the update manually from https://support.microsoft.com/en-us/help/2999226/update-for-universal-c-runtime-in-windows.
Debug System Requirements
Linux application debug requires gdbserver on your target. The recommended version of gdbserver is 7.0 or later. DS-5 Debugger is unable to provide reliable multi-threaded debug support with gdbserver versions prior to 6.8.
DS-5 support for Linux application debug depends on infrastructure and features that are introduced in specific kernel versions:
DS-5 Debugger supports debugging Arm Linux kernel versions 2.6.28 and later.
Application debug on Symmetric MultiProcessing (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 Streamline Performance Analyzer supports Arm Linux kernel versions 3.4 and 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, DSTREAM-ST, 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, DSTREAM-ST, RVI and VSTREAM is 4.34.0. For DSTREAM, DSTREAM-ST 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
DSTREAM-ST uses Ethernet over USB to connect to your computer. DSTREAM-ST should automatically be detected as a network device and be visible as a network adapter in the Device Manager on Windows, or listed as a USB network interface by the ifconfig utility on Linux. If this is not the case then you may have to perform some configuration on your computer - please refer to the DSTREAM-ST troubleshooting section at: https://developer.arm.com/products/software-development-tools/debug-probes-and-adapters/dstream-st/troubleshooting-your-dstream-st-unit.
Install on Linux
To install DS-5 on Linux, run (not source) install.sh and follow the on-screen instructions. The installer unpacks DS-5 into your chosen directory, adds desktop shortcuts, and optionally installs support for hardware debug units.
Some of the tools installed 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/topic/com.arm.doc.faqs/ka14522.html.
The installer includes configuration files to allow USB connection to DSTREAM, DSTREAM-ST, RVI, ULINKpro and ULINKpro D hardware debug units. It is recommended to install these files if you intend to use these features. Installation of these files 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 files, then you can still install them after installation by running the
Install on Windows
To install DS-5 on Windows, run setup.exe and follow the on-screen instructions. If you have an earlier version of DS-5 already installed, this one will be installed alongside, without uninstalling your previous installation.
During installation you might be prompted to install device drivers. These drivers are to allow USB connections to DSTREAM, DSTREAM-ST, RVI, ULINKpro, ULINKpro D and Energy Probe hardware units. It is recommended to install these drivers if you intend to use these features.
Command-line installation and uninstallation are possible on Windows by opening a command prompt, with administrative privileges, and running Microsoft's installer, msiexec.exe. You must provide the location of the .msi file as an argument to msiexec. You can get a full list of options for using msiexec by running msiexec /? on the command-line. An example of how to install DS-5 using msiexec is:
msiexec.exe /i
Where:
/i: this option is to perform the installation.
EULA=1: this is an Arm specific option. Setting EULA to 1 means you accept the End User License Agreement (EULA). You must read the EULA in the GUI installer before accepting it on the command-line.
/qn: this option specifies quiet mode, so that the installation does not require user interaction. Note device driver installation still requires user interaction. If you do not require USB drivers or if you want the installation to avoid user interaction for USB drivers, you can use SKIP_DRIVERS=1 option on the command-line.
/l*v install.log: this option specifies the log file to log all output from the installation.
After Install
After installation, you can start Eclipse for DS-5 from the Arm DS-5 v5.29.3 -> Eclipse for DS-5 v5.29.3 entry in your desktop menu. Be aware that any existing "Eclipse for DS-5" entry in the desktop menu will point to the previous version of DS-5 that is still available for use on your host. Eclipse for DS-5 and other supplied tools can also be found within the
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
On Linux you can run
On Windows the Start menu contains DS-5 Command Prompt. This console is preconfigured with the bin directory added to the PATH environment variable.
On both Linux and Windows the command prompts do not provide a compiler toolchain by default, but you can select one using the select_toolchain or select_default_toolchain commands.
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
You can find further instructions on installation, licensing and tutorials on-line at: https://developer.arm.com/products/software-development-tools/ds-5-development-studio/resources/tutorials/getting-started-with-ds-5-development-studio.
Obtaining and Installing Your License
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
https://developer.arm.com/products/software-development-tools/license-management/tutorials/installing-floating-licenses-for-ds-5
https://developer.arm.com/products/software-development-tools/license-management/tutorials/installing-node-locked-licenses-for-ds-5
When the license and toolkit are configured within Eclipse then all license managed components will pick up the license and toolkit settings correctly, both within Eclipse and within the provided DS-5 Command Prompt (Windows) or suite_exec shell (Linux). If you use a different console then you must configure the tools manually. To do this, please refer to the tools documentation.
If you are using floating licenses, then the version of the FlexNet license server software must be greater or equal to the version of FlexNet used within the DS-5 tools. This release of DS-5 contains tools based on FlexNet 11.14.1.0.
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 protected] if you need additional help with registering or obtaining your license. Please provide your serial number and a detailed description of the problem.
Uninstall
To uninstall DS-5 on Windows, use Add or Remove Programs in Control Panel, select Arm DS-5 v5.29.3 and click the Remove button.
To uninstall DS-5 on Linux, run remove_menus_for_Arm_DS-5_v5.29.3.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. For Linux these files are stored in $HOME/.arm.
Known Issues and Limitations
The following known issues and limitations exist in this release:
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 "
Problem: Eclipse fails to start and reports "JVM terminated" or outputs a stack backtrace. [SDDEBUG-4443]
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