Installation
Table of Contents
Using installer for Windows
Windows users are advised to use our Windows installer for Eclipse for GNU Toolchain for IDE, that can be downloaded from this releases page. Installer already contains all of the necessary components.
ARC GNU IDE should be installed in the path no longer than 50 characters and cannot contain white spaces.
![../_images/run_arc_gnu_1.1.0_win_install.exe.png](../_images/run_arc_gnu_1.1.0_win_install.exe.png)
Run arc_gnu_2015.06_ide_win_install.exe
![../_images/license_page.png](../_images/license_page.png)
Accept Synopsys FOSS notice
![../_images/components_page.png](../_images/components_page.png)
Choose components to be installed
![../_images/choose_installer_paths.png](../_images/choose_installer_paths.png)
Choose installer paths
![../_images/installation_completed.png](../_images/installation_completed.png)
Installation Completed
Manual installation on Linux and Windows
Downloading Eclipse
Download Eclipse IDE for C/C++ Developers, that already contains CDT from this page
Downloading latest plugins
User can get this plug-in from website URL https://github.com/foss-for-synopsys-dwc-arc-processors/toolchain/releases/, this is an archived version of the GNU ARC Eclipse plug-in update site, the file name is arc_gnu_<version>_ide_plugins.zip
![../_images/components_of_arc_gnu_plugins_zip.png](../_images/components_of_arc_gnu_plugins_zip.png)
Components of arc_gnu_ide_plugins.zip
![../_images/components_of_arc_gnu_plugins_zip_features.png](../_images/components_of_arc_gnu_plugins_zip_features.png)
Components of arc_gnu_ide_plugins.zip features
![../_images/components_of_arc_gnu_plugins_zip_plugins.png](../_images/components_of_arc_gnu_plugins_zip_plugins.png)
Components of arc_gnu_ide_plugins.zip plugins
Installing into Eclipse
To run ARC plugins for Eclipse, it is required to have Target Terminal plugin installed in Eclipse.
Install “TM Terminal” plugin from Oxygen repository.
![../_images/installation_of_tm_terminal.png](../_images/installation_of_tm_terminal.png)
Installation of TM Terminal in Eclipse
After downloading arc_gnu_ide_plugins.zip successfully, user also can install it
from local by pointing Eclipse to it: Eclipse -> Install New Software -> Add ->
Archive ->
select arc_gnu_ide_plugins.zip file. Unzip this archived folder, there
will be six components in it.
![../_images/install_from_local_pc.png](../_images/install_from_local_pc.png)
Install from local PC
![../_images/check_gnu_arc_c%2B%2B_development_support.png](../_images/check_gnu_arc_c%2B%2B_development_support.png)
Check GNU ARC C++ Development Support
![../_images/get_copyright_by_clicking_more.png](../_images/get_copyright_by_clicking_more.png)
Get copyright by clicking “more”
![../_images/get_general_information_by_clicking_more.png](../_images/get_general_information_by_clicking_more.png)
Get General Information by clicking “more”
![../_images/get_license_agreement_by_clicking_more.png](../_images/get_license_agreement_by_clicking_more.png)
Get License Agreement by clicking “more”
![../_images/install_details.png](../_images/install_details.png)
10 Install Details
![../_images/accept_the_terms_of_license_agreement.png](../_images/accept_the_terms_of_license_agreement.png)
Accept the terms of license agreement
![../_images/install_arc_gnu_ide_plugin.png](../_images/install_arc_gnu_ide_plugin.png)
Install ARC GNU IDE Plugin
![../_images/warning_about_this_plugin_installation.png](../_images/warning_about_this_plugin_installation.png)
Warning about this plugins installation
![../_images/restarting_eclipse.png](../_images/restarting_eclipse.png)
Restarting Eclipse
Ignore the Security Warning, and click “Ok”, after restarting Eclipse IDE, the installation is finished. If user install plug-in successfully, the “ARC” icon will show up in “About Eclipse”.
![../_images/plug-in_in_eclipse_ide.png](../_images/plug-in_in_eclipse_ide.png)
Plug-in in Eclipse IDE
Click the “ARC” icon; user will get detailed plug-in features information.
![../_images/about_eclipse_elf32_plug-in_features.png](../_images/about_eclipse_elf32_plug-in_features.png)
About Eclipse ELF32 Plug-in Features
Click the “Installation Details” button, the Features and Plug-ins will also show up.
![../_images/arc_gnu_plugin_plug-ins.png](../_images/arc_gnu_plugin_plug-ins.png)
ARC GNU plugin Plug-ins
![../_images/arc_gnu_plugin_features.png](../_images/arc_gnu_plugin_features.png)
ARC GNU plugin Features
Updating existing plugin
To update the existing plugin, as shown in the figure below, and the version of this current plugin is for example “1.1.0.201402280630”, follow same instructions as plugin installation.
![../_images/arc_gnu_plugin_features.png](../_images/arc_gnu_plugin_features.png)
ARC GNU plugin Features
![../_images/current_arc_gnu_ide_plugin.png](../_images/current_arc_gnu_ide_plugin.png)
Current ARC GNU IDE plugin
![../_images/installation_of_latest_plugin.png](../_images/installation_of_latest_plugin.png)
Installation of latest plugin
![../_images/updated_arc_gnu_ide_plugin.png](../_images/updated_arc_gnu_ide_plugin.png)
Updated ARC GNU IDE plugin
![../_images/general_information_of_the_latest_plugin.png](../_images/general_information_of_the_latest_plugin.png)
General Information of the latest plugin
![../_images/installed_details_of_the_latest_plugin.png](../_images/installed_details_of_the_latest_plugin.png)
Installed details of the latest plugin
![../_images/update_existing_plugins_sucessfully.png](../_images/update_existing_plugins_sucessfully.png)
Update exiting plugins successfully
![../_images/updated_arc_gnu_plugin_features.png](../_images/updated_arc_gnu_plugin_features.png)
Updated ARC GNU plugin Features
![../_images/updated_arc_gnu_plugin_plug-ins.png](../_images/updated_arc_gnu_plugin_plug-ins.png)
Updated ARC GNU plugin Plug-ins
Installing plugin on Linux host
If you plan to connect to UART port on target board with RxTx plugin controlled by IDE you need to change permissions of directory /var/lock in your system. Usually by default only users with root access are allowed to write into this directory, however RxTx tries to write file into this directory, so unless you are ready to run IDE with sudo, you need to allow write access to /var/lock directory for everyone. Note that if /var/lock is a symbolic link to another directory then you need to change permissions for this directory as well. For example to set required permissions on Fedora:
$ ls -l /var/lock
lrwxrwxrwx. 1 root root 11 Jun 27 2013 /var/lock -> ../run/lock
$ ls -ld /run/lock/
drwxr-xr-x. 8 root root 160 Mar 28 17:32 /run/lock/
$ sudo chmod go+w /run/lock
$ ls -ld /run/lock/
drwxrwxrwx. 8 root root 160 Mar 28 17:32 /run/lock/
If it is not possible or not desirable to change permissions for this directory then serial port connection must be disable in Eclipse debugger configuration window.
If it is required to connect to UART of a development system, then another
problem that might happen is permissions to open UART device. For example on
Ubuntu 14.04 only root and members of dialout
group can use /dev/ttyUSB1
(typical UART port for boards based on FT2232 chip). Thus to use connect to
those port user must be made member of dialout
group. Command to do this:
$ sudo usermod -a -G dialout `whoami`
If OpenOCD is used, then it is required to set up proper permissions for
devices to allow OpenOCD to connect to those devices. Create file
/etc/udev/rules.d/99-ftdi.rulesi
with the following contents:
# allow users to claim the device
# Digilent HS1 and similar products
SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6010", MODE="0664", GROUP="plugdev"
# Digilent HS2
SUBSYSTEM=="usb", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6014", MODE="0664", GROUP="plugdev"
Then add yourself to plugdev
group:
$ sudo usermod -a -G plugdev `whoami`
Then restart udev and relogin to system, so changes will take effect.:
$ sudo udevadm control --reload-rules
# Disconnect JTAG cable from host, then connect again.
Even better is to reboot the system.