Introduction
This article provides additional information on installing Arm® Development Studio 5 Intel® SoC FPGA Edition (DS-5). Please use the linked articles for basic instructions.
How to Install SoC FPGA Embedded Development Suite (SoC EDS) ver. 18.1 - (In Japanese)
1. Pre-installation of required packages
In the Linux OS environment, when DS-5 is installed, responding with "yes" to "Run installation platform requirement checks?" will check the installation status of packages with dependencies.
The following are the results of the checks OK (succeeded) and NG (failed), but note that even in the case of NG, you can proceed with the DS-5 installation.
Please refer to the following links for information on the packages/libraries required to use DS-5 in a Linux OS environment. Installation scripts are also available.
Missing DS-5 Linux dependencies | Arm® Infocenter
2. Recommended installation location
The recommended installation location is directly under the installation directory of the SoC FPGA Embedded Development Suite (SoC EDS) tool with the name ds-5. If installed in a different location, a warning message stating that the installation location of DS-5 cannot be detected will be displayed when launching Embedded Command Shell, as shown below.
In the case of Windows, it may be detected automatically from the Program File directory, but the same warning message may appear depending on the environment.
If the above warning message is displayed, you can take countermeasures by editing env.sh under the SoC EDS installation directory. Describe the DS-5 installation location immediately before the if statement on line 201 as follows
File name: <SoC EDS install DIR>/embedded/env.sh
00193| if [ "${SOCEDS_OVERLAY}" = "1" ] && [ -d "${_SOCEDS_DEST_ROOT}/ds-5" ]; then
00194| _DS5_ROOT="${_SOCEDS_DEST_ROOT}/ds-5"
00195| else
00196| _DS5_ROOT="$("${_SOCEDS_DEST_ROOT}/host_tools/altera/ds5_link/soceds_config" --get-ds5-root)"
00197| _DS5_ROOT="${_DS5_ROOT#DS5_ROOT=}"
00198| fi
00199| _DS5_ROOT="/usr/local/DS-5_v5.29.1"
00200|
00201| if [ -n "${_DS5_ROOT}" ]; then
As a result, if the warning message at the time of Embedded Command Shell startup is no longer displayed, the countermeasure has succeeded.
3. Setting up the bare-metal toolchain link
After the installation of DS-5 is completed, the script called ds5_link must be executed. Without this setting, the linkage setting between the bare-metal toolchain included in SoC EDS and DS-5 will not be configured.
Information about running ds5_link will be notified in the following popup when the SoC EDS installation is complete.
The ds5_link script will be executed by moving to <SoC EDS install DIR>/embedded/host_tools/altera/ds5_link directory and then executing the following command.
The argument of ds5_link specifies the location of the DS-5 installation. (e.g. /usr/local/DS-5_v5.29.1/)
sudo ./ds5_link /usr/local/DS-5_v5.29.1/
If a message similar to the blue box below is displayed, the script has been successfully executed.
4. How to start DS-5
Although it is not an installation note, when using DS-5 targeting a SoC FPGA, it is recommended to start DS-5 by typing "eclipse" at the Embedded Command Shell prompt. If you start DS-5 in a different way, the necessary environment settings will not be transferred to DS-5, which may cause problems.
Conclusion
In this article, we have introduced some points to note when installing DS-5, which may cause problems.
For information on how to use DS-5, please refer to the manuals available on the Arm® Developer site.
DS-5 Documentation Page | Arm® Developer
How to use the debugger (Arm® DS / DS-5) for SoC FPGAs