====== Installing Eclipse for Linux ======
This section describes how to install and use AVR development environment in Linux Ubuntu operation systems. For installation software repository of Robotic HomeLab is used.

===== Software automatic installation =====

**1. Software source setup**

For source setup HomeLab-keyring software package must be downloaded and installed.
Download it from webpage:
[[http://www.roboticlab.eu/repo/ubuntu/dists/oneiric/main/binary-all/misc/homelab-keyring_2012.02.26-1_all.deb|homelab-keyring]]. Next, Internet browser will open a window where opening package installation with automatic installation manager can be selected.

{{  :kit:repo2.png?400  |}}

If you select the correct option the manager will open (Ubuntu 10.04 example). 

{{  :kit:repo3.png?400  |}}

Ubuntu 10.10 and newer "Ubuntu Software Center" will popup.

{{  :kit:repo3maverick.png?400  |}}

Press "Install package" for installation and enter root password.

{{  :kit:repo4.png?400  |}}

If the installation has finished close the manager.

{{  :kit:repo5.png?400  |}}

As a conclusion you have successfully installed Robotic Homelab software source.

**2. Robotic HomeLab software installation**

To install Robotic HomeLab software in Gnome choose from menu: //Applications -> Programming -> Install Homelab//

{{  :kit:repo6.png?400  |}}

In case of Unity start typing: //homelab// in Dash

Enter root password when asked.
{{  :kit:repo4.png?400  |}}

If the password is correct terminal window will open and software installation will begin. If not installation will not start. Setup can be started later again if first attempt was unsuccessful.

{{  :kit:repo7.png?400  |}}

Software installation might take some time from few minutes to a quarter of hour depending on your Internet connection and computer speed.
As a result the following software packages will be installed:

  * HomelabSetup - HomeLab configuration program
  * Eclipse-CDT - development environment
  * gcc-avr – GNU C-language compiler for AVR platform
  * avrdude – program for loading HEX to microcontroller
  * avr-libc – C-language libraries for code writing into AVR platform
  * libhomelab - HomeLab library
  * hlflash - HomeLab flashing program
  * hlflash-gui - HomeLab flashing GUI
  * hlinit - HomeLab initialization program

Terminal will close after installation of these software packages.
Robotic HomeLab software is now successfully installed!

===== Software manual installation =====

In case automatic installation fails at some reasons required software packages can be also installed manually.

 **1. At first add Robotic HomeLab repository through terminal into Ubuntu package manager. **

The following line can be copied into terminal to do this:
<code>
sudo add-apt-repository http://roboticlab.eu/repo/ubuntu/
</code>

 **2. GnuPGP key installation **
Because of all Robotic HomeLab software packages contain GnuPGP key for validation you also need to install corresponding public key into your computer.

Download key from webpage: {{:et:examples:setup:homelab-keyring.gpg.zip|}}

Extract archive using user interface or terminal.

Corresponding command in terminal:
<code> unzip homelab-keyring.gpg.zip </code>

Then add this key into Ubuntu package manager. When in folder that contains homelab-keyring.gpg type:
<code>sudo apt-key add homelab-keyring.gpg</code>

 **3. Download all software updates. **

Use the following line for update :
<code>
sudo apt-get update
</code>

After downloading updates the following software packages are required to be installed:
  * eclipse
  * eclipse-cdt
  * urjtag-homelab
  * hlflash
  * hlinit
  * hlflash-gui
  * libhomelab
  * avrdude-homelab
  * eclipse-avr


Copy this line into terminal for installation:
<code>
sudo apt-get install eclipse eclipse-cdt urjtag-homelab hlflash hlinit hlflash-gui
libhomelab avrdude-homelab eclipse-avr
</code>

After completing installation of those software packages Robotic HomeLab is successfully installed!

To create new project and configure floating-point variables look at the instructions for Eclipse setup.