====== AVR Eclipse Tutorial ======
Eclipse ist ursprünglich eine IDE zur Entwicklung von Java Applikationen, hat sich aber inzwischen zu einer universellen Rich Client Platform entwickelt. Durch Plugins lässt sich Eclipse um beliebige Funktionen erweitern. Inzwischen werden jede Menge Programmiersprachen unterstützt, darunter auch C/C++. Das Plugin für C/C++ heißt [[http://www.eclipse.org/projects/project_summary.php?projectid=tools.cdt|CDT (C/C++ Development Tooling)]].

Es gibt Eclipse inzwischen für unterschiedliche Aufgaben vorkonfiguriert zum [[http://www.eclipse.org/downloads/|Download]]. Die Konfigurationen enthalten nur die für die jeweilige Aufgabe nötigen Plugins. 

Dieses Tutorial basiert auf der Version 3.4 mit dem Namen [[http://www.eclipse.org/ganymede/|Ganymed]] und wurde um [[http://www.eclipse.org/galileo/|Galileo]] erweitert. Bei älteren Versionen kann die Bedienung leicht abweichen.

Aktuelle Versionen:
  * Eclipse 3.5.1 Galileo
  * CDT 6.0.1
  * AVR Eclipse Plugin 2.3.1

===== Installation von Java =====
Da Eclipse in Java programmiert ist muss zunächst die Laufzeitumgebung installiert werden.
==== Linux ====
Unter Linux ist häufig eine Java Runtime vorinstalliert. Bei älteren Distributionen ist das noch GCJ, bei aktuelleren OpenJDK. Beide eignen sich nicht besonders gut für Eclipse. Man sollte in jedem Fall Java6 von Sun nachinstallieren. Unter Ubuntu/Debian

  sudo apt-get install sun-java6-jre

Im Zweifelsfall sollte man sicherstellen das GCJ bzw OpenJDK deinstalliert sind.

==== Windows ====
Für Windows läd man am besten die aktuelle Version von Java und installiert sie wie üblich - [[http://www.java.com/de/download/manual.jsp|Download]]

===== Download von Eclipse =====
Wie bereits erwähnt gibt es Eclipse in unterschiedlichen Konfigurationen. Sollte man Eclipse nur für die Programmierung in C/C++ verwenden wollen ist es sinnvoll, die Version **Eclipse IDE for C/C++ Developers** zu verwenden. Diese Version enhält ausschließlich Plugins für die Entwicklung von C/C++.

[[http://www.eclipse.org/downloads/|Eclipse Download]]

Möchte man Eclipse für andere Anwendungen nutzen kann man das CDT Plugin nachinstallieren. Es ist jedoch kein Problem unterschiedliche Versionen von Eclipse zu installieren, wozu ich auch raten würde. Dazu werden die Unterschiedlichen Eclipse Versionen einfach in eigenen Verzeichnissen installiert.

===== Installation von Eclipse =====
Die Installation von Eclipse ist einfach. Es handelt sich um ein ZIP bzw tar.gz Archiv. Man entpackt es in ein beliebiges Verzeichnis. Unter Windows kann man es mit eclipse.exe starten, unter Linux mit einem Doppelklick auf //eclipse//.

**Hinweis: Es gibt unter Linux auch Eclipse in den Paketquellen. Diese sind meist veraltet und sind so modifiziert das sie mit GCJ oder OpenJDK laufen. Ich habe es nie geschafft das die vernünftig funktionieren. Daher immer die aktuelle Originalversion von eclipse.org verwenden!!**

==== Installation unter Ubuntu Karmic Koala ====
Unter Karmic Koala macht die Version von eclipse.org Probleme. Es empfiehlt sich, Milestone 2 von Eclipse Galileo zu verwenden oder den Fehler zu patchen. Näheres dazu [[http://everflux.de/eclipse-galileo-probleme-mit-ubuntu-karmic-koala-1393/|hier]].

Bei Karmic Koala kann man jedoch auch die Version aus den Paketquellen installieren. 
  sudo apt-get install eclipse

==== Installation von CDT ====
Die Installation von CDT ist nur notwendig wenn man NICHT die **Eclipse IDE for C/C++ Developers** verwendet.

Sollte man bereits Eclipse installiert haben und man möchte keine getrennte Installation muss man CDT nachinstallieren. Hierfür startet man Eclipse und wählt das Menu **Help->Software Updates...**. In dem sich nun öffnenden Fenster wechselt man auf den Tab **Available Software** und klickt auf den Button **Add Site...**. Hier fügt man diesen Link ein.

Für Eclipse 3.4 (Ganymed)
  http://download.eclipse.org/tools/cdt/releases/ganymede

Für Eclipse 3.5 (Galileo)
  http://download.eclipse.org/tools/cdt/releases/galileo/
{{ :mikrocontroller:avr:galileo_cdt_install.png?500 |}}

Macht einen Haken bei dem entsprechenden Link (siehe Screenshot) und klickt auf Install. 

==== Installation des AVR Eclipse Plugins ====
Die Installation des AVR Eclipse Plugins erfolgt auf gleiche Weise wie die von CDT. Öffnet den Software Updates Dialog und fügt folgenden Link hinzu.

  http://avr-eclipse.sourceforge.net/updatesite/
{{ :mikrocontroller:avr:software_updates_and_add-ons_.png?500 |Software Updates and Add-ons}}

===== avr-gcc installieren =====
==== Windows ====
Für Windows läd man einfach [[http://sourceforge.net/project/showfiles.php?group_id=68108|WinAVR]] herunter und installiert es wie üblich. Nach der Installation ist ein Windows Neustart nötig. Hinweise zur Einrichtung von avrdude findet ihr im [[:mikrocontroller:avr:avrdude_tutorial|Avrdude Tutorial]].

==== Ubuntu/Debian ====
Die Installation erfolgt wie üblich über die Paketquellen.

  sudo apt-get install avrdude avr-libc binutils-avr gcc-avr gdb-avr simulavr

Hinweise zur Einrichtung von avrdude findet ihr im [[:mikrocontroller:avr:avrdude_tutorial|Avrdude Tutorial]].

===== Eclipse einrichten =====
Nach dem Start fragt Eclipse nach einem Speicherort für den Workspace. Wer noch nicht weiß was das ist sollte einfach den Standard Pfad beibehalten. Als nächstes sollte man einige Grundeinstellungen vornehmen. Dazu öffnet man das Menu **Windows->Preferences**.

  * Als erstes ändern wir einige Einstellungen in **General->Workspace**. Entferne den Haken von **Build automatically** und setze einen Haken bei **Save automatically bevor build**
  * Öffne **AVR->Paths** und überprüfe ob die Pfade korrekt eingetragen sind. (Kann u.U. etwas dauern falls das Dateisystem durchsucht wird). Setze einen Haken bei **Disable search for system paths at startup**
  * Öffne **C/C++->Indexer**. Stelle //Select indexer// auf //Full C/C++ Indexer// und setze einen Haken bei //Index all files//
==== avrdude in Eclipse einrichten ====
Das AVR Eclipse Plugin erlaubt es, mehrere Konfigurationen für avrdude anzulegen, z.B. für einen AVRISP mkII, einen AVR Dragon und einen AVR109 Bootloader. Diese kann man Projekt unabhängig erstellen und dann einem Projekt zuordnen. Die Einrichtung macht man am besten wieder in **Windows->Preferences** und dort **AVR->AVRDude**.

Klickt auf **Add...** um eine neue Konfiguration anzulegen
{{ :mikrocontroller:avr:edit_avrdude_programmer_configuration.png?500 |Edit Avrdude Programmer Configuration}}

Gib einen aussagekräftigen Namen und eine Beschreibung an. Dann wählst du den passenden Programmer aus, zb //Atmel AVR ISP mkII//. Sicherheitshalber gibt man noch den passenden Port, und wenn nötig, die entsprechende Baudrate an (Bei USB nicht angeben).

Hier zwei Beispiele:

__Für AVRISP mkII__
  * Programmer Hardware - Atmel AVR ISP mkII
  * Override default port - usb
  * Override default baudrate - (leer)

__Für AVR109 Bootloader mit 9600 Baud__
  * Programmer Hardware - Atmel AppNote AVR109 Boot Loader
  * Override default port - /dev/ttyS0 (bei Linux) oder COM1 (bei Windows)
  * Override default baudrate - 9600

Weiter gehts im [[:mikrocontroller:avr:avr_eclipse_tutorial_part_2]]

~~DISCUSSION~~