Mikrocontroller.net - Benutzerbeiträge [de]

AVRDUDE

2012-08-28T13:34:31Z

Vogtinator: Link entfernt

== Beschreibung ==
AVRDUDE (http://www.nongnu.org/avrdude/) ist eine Programmiersoftware für Atmel [[AVR]] Controller.

Funktionen unter Anderem:

* Übertragen von Programmcode in den Flash-Speicher
* Auslesen ungeschützen Codes aus dem Flash
* Setzen und Lesen von Fuse- und Lockbits (Siehe auch: [[AVR_Fuses#Vergleich_der_Fuses_bei_verschiedenen_Programmen|Vergleich der Fuses bei verschiedenen Programmen]])
* Schreiben und Lesen des EEPROMs

AVRDUDE kann das [[STK500]] (auch mit Firmware 2.x als stk500v2), das Atmel AVRISP (auch mit Firmware 2.x als avrispv2 o.ä.), das Atmel AVRISP MKII (USB Ansteuerung mittels lib-usb bzw. lib-usb-W32), [[AVR_In_System_Programmer#USB | AVR910-kompatible]] Programmierer, den [[AVR Butterfly]]/AVR109-kompatible Bootloader, [[STK200]]-Programmierdongles und verschiedene andere Parallelport-Adapter sowie "serielle Statusportprogrammierer" (Siprog) ansteuern. Auch das Atmel JTAGICE (oder Nachbauten wie Bootice oder Evertool), Atmel JTAGICE-MKII und der AVR Dragon können als Programmierhardware genutzt werden.

Das Programm ist unter MS-Windows (Cygwin nicht erforderlich), Linux, BSD, Solaris und Mac OS X lauffähig. Die Version für MS-Windows ist im [[WinAVR]]-Paket enthalten. Der Quellcode ist frei verfügbar (Lizenz beachten).

Da alle AVRDUDE-Funktionen über Kommandozeilenparamter gesteuert werden können, eignet es sich gut zur Integration in Makefiles. Beispiele finden sich in der Makefile-Vorlage von [[WinAVR]] und Mfile.

Die gesamte Konfiguration liegt in einer Textdatei (avrdude.conf), so dass sich bei Bedarf ein beliebiger neuer Parallelport-Programmierdongle oder auch ein noch nicht unterstützter AVR-Controller ergänzen lassen. Die Syntax für die Definition eines AVR-Controllers lehnt sich an die Datenblatt-Tabelle für die serielle Programmierung an, so dass man praktisch nur das Datenblatt "intelligent" abtippen muss.

Für die Ansteuerung von Parallelport-Adaptern unter MS-Windows NT/2000/XP wird ein spezieller Porttreiber (giveio) mitgeliefert. Bei der Installation von [[WinAVR]] wird giveio bereits mitinstalliert.

Programmer mit üblicher serieller Schnittstelle (RS232) benötigen keine zusätzliche Software oder Treiber zum Betrieb mit AVRDUDE.

Für Hardware mit USB-Anschluss muss die lib-usb bzw. lib-usb-win32 installiert sein.

===GUIs===
Bei [[WinAVR]] wird die grafische Oberfläche avrdude-gui.exe mitgeliefert.

Für Windows, Linux und andere Betriebssysteme gibt zwei weitere GUIs: den in Java geschriebene [[Burn-o-mat|AVR Burn-O-Mat]] und den [http://www.soft-land.de/index.php?page=avrburner avrburner] (avrburner: Link defekt).

Für Mac OS X gibt es noch [http://www.vonnieda.org/software/avrfuses AVRFuses.app]. AVRFuses muss beim ersten Starten auf den verwendeten Programmer und den Speicherort von AVRDUDE eingestellt werden.

GUIs vereinfachen vor allem Programmieren der Fuses.

== Kurzanleitung für Linux und STK200 ==

Dazu muss erst ein Hardware-Link auf die Printerport-Treiber eingerichtet werden:
<pre>
su
mknod /dev/parport0 c 99 0
chmod a+rw /dev/parport0
avrdude -p m8535 -c stk200 -e -U qqtraff.hex
</pre>

Hinweis :
Bei USB Programmern ist zu beachten, dass diese durch das Betriebssystem auf einen anderen Port gelegt werden können, als im Beispiel angegeben.
Diesen Port kann man unter Anderem "im Terminal" mit dem Befehl
<pre>
user@server: dmesg
</pre>
ermitteln.
Alternativ kann man sich eine Auflistung der Ports, im Verzeichnis "/dev" anzeigen lassen:
<pre>
user@server: ls /dev/
</pre>
Sollte man nicht sicher sein, auf welchem Port der Programmer liegt, kann man den Programmer nochmals ausstecken und "ls /dev/" ausführen. Der nun Fehlende Port, ist der Programmerport.
Diesen Port muss man statt "parport0" in die oben beschriebenen Terminalkommandos einsetzen.

Siehe auch :
* [http://wiki.ctbot.de/index.php/AVR_ISP_Programmer#BlueMP3_bzw._STK200_kompatible_Flasher weitere Beispiele für avrdude Kommandos (http://wiki.ctbot.de/index.php)]
* [[AVR_In_System_Programmer#STK200-kompatibel]]
* http://www.mikrocontroller.net/topic/200390#new

== Tipps + Tricks ==

=== [[AVR_In_System_Programmer#Parallelport|Parallelport-Programmer]] an aktuellen PCs ===
Aktuelle PCs sind einfach zu schnell mit dem Bitgewackel an der parallelen Schnittstelle, vor allem für AVRs, die noch mit den 1 MHz im Auslieferungszustand laufen (maximal zulässiger ISP-Takt < 250 kHz). Neuere Versionen von avrdude unterstützen zu diesem Zweck eine Option '''-i <N>''', wobei <N> die Anzahl der Mikrosekunden bezeichnet, die beim Bitwackeln zusätzlich zu warten ist. Einfach mal mit -i 10 anfangen und dann entweder die Fuses auf die Ziel-Taktfrequenz umstellen (falls diese wesentlich höher sein wird als die 1 MHz), oder sukkzessive mit kleineren Werten testen ([http://www.mikrocontroller.net/topic/83524#699933 Forenbeitrag von Jörg]).

Die Option -i ist auch nützlich bei AVRs, die für einen langsamen Takt konfiguriert sind. Bei einem ATmega8, der mit einem 32.768 kHz Quarz läuft, kann es z.B. notwendig sein, die Option -i 90 zu verwenden. Den Zahlenwert ggf. ausprobieren.

Manche Programmer werten die Option -i manchmal nicht aus, dann sollte man einen anderen Programmer versuchen.

Beim USBTINY und USBASP kann man die Geschwindigkeit der SPI-Schnittstelle mit dem Parameter -B [Periodendauer in Mikrosekunden] begrenzen. Da beide Geräte durch Interrupts der Software-USB-Schnittstelle stark belastet werden, handelt es sich hier um die Maximalbitrate.

Unter WinXPsp2 auf einem Thinkpad T40 lies sich die "avrdude: AVR device not responding"-Meldung beheben durch Ändern von Gerätemanager-->Ltp1-->Eigenschaften-->Anschlusseinstellungen-->Interrupt-nie-verwenden in "Jeden dem Anschluss zugewiesenem Interrupt verwenden".

===USB Programmer===
Die meisten USB- Programmer benötigen [http://sourceforge.net/apps/trac/libusb-win32/wiki libusb-win32] bzw [http://www.libusb.org/ libusb]

Ein Selbstbau USB-Programmer ist unter
[http://www.rototron.info/?Page=USBAVR/USBAVR.aspx http://www.rototron.info]
zu finden. Er läuft auch unter VISTA und benötigt mit der neuesten AVRDUDE Version keinen Treiber, da er im HID-Modus betrieben wird.

==== libusb0.dll wird bei WinAvr 20070525 nicht gefunden====
[http://www.mikrocontroller.net/topic/83524#701461 Forenbeitrag von Paul]: Habe leider noch etwas zu bemängeln, und zwar meckerte avrdude, dass es die "libusb0.dll" nicht fand. Musste dann erst noch manuell den Pfad c:\winavr\utils\libusb\bin in die autoxecec.bat eintragen. Siehe auch [http://www.avrfreaks.net/index.php?name=PNphpBB2&file=viewtopic&p=373283 Diskussion bei www.avrfreaks.net]

====Aufruf unter Linux als user (non-root)====

Unter Linux kann häufig avrdude nur als user 'root' auf den USB-Programmer zugreifen. Als normaler User bekommt man eine Fehlermeldung wie:

<pre>
#avrdude -c usbtiny -p m8

avrdude: error: usbtiny_transmit:
error sending control message:
Operation not permitted
</pre>

Dies liegt daran, dass die device-nodes, die beim Einstecken des USB-Programmers von udev angelegt werden, root zugeordnet sind. Man kann dies ändern, indem man udev-Regeln für die verwendeten Programmer anlegt. Unter Debian muß man dazu nur eine neue Datei, z. B. 015_usbprog.rules unter /etc/udev/rules.d anlegen, z. B. mit folgenden Inhalt:

<pre>
# Atmel AVR ISP mkII
SUBSYSTEM=="usb", SYSFS{idVendor}=="03eb", SYSFS{idProduct}=="2104", GROUP="users", MODE="0660"

# usbprog bootloader
ATTRS{idVendor}=="1781", ATTRS{idProduct}=="0c62", GROUP="users", MODE="0660"

# USBasp programmer
ATTRS{idVendor}=="16c0", ATTRS{idProduct}=="05dc", GROUP="users", MODE="0660"

# USBtiny programmer
ATTRS{idVendor}=="1781", ATTRS{idProduct}=="0c9f", GROUP="users", MODE="0660"
</pre>



Danach muss in der Regel der udev-Dienst neu gestartet werden, was -- je nach System -- mit einem der beiden folgenden Befehle funktionieren sollte (natürlich nur als root):


<pre>sudo /sbin/udevadm control --reload-rules</pre> bei aktueller udev-version, oder
<pre>sudo /sbin/udevcontrol --reload-rules</pre>, bei älteren udev-versionen.

Danach sollte der USB-Programmer erneut angeschlossen werden. Falls es immer noch nicht funktioniert kann es helfen, als GROUP "plugdev" statt "users" zu verwenden.

Hiermit werden der AVR ISP mkII, der usbprog Bootloader, USBasp und USBtiny bekannt gemacht, so daß alle User in der Gruppe "users" darauf zugreifen können.

Für weitere USB-Programmer muß man die entsprechende Zeile (mit ATTRS...) anlegen und die passenden Vendor und Product IDs eintragen.

Siehe auch:
* [http://www.reactivated.net/writing_udev_rules.html Writing udev rules]

=== Anzeige unterstützter AVRs ===
Wie die anderen Atmels bei avrdude heißen zeigt:
<pre>
avrdude -?
avrdude -p ?
</pre>

=== neuere AVRs hinzufügen ===
Manch neueres Silizium wird nicht erkannt da sich z.T. die IDs geändert haben. Um diese erfolgreich zu Programmieren empfiehlt sich ein eigenes config-File zu verwenden. Darin werden die 'fehlenden' CPUs ergänzt:

z.B. ATmega168P (Programmierung wie ATmega168): einfach den ATmega168 Teil duplizieren und die entsprechenden Änderungen (id, desc, signature) vornehmen
<pre>
#------------------------------------------------------------
# ATmega168P
#------------------------------------------------------------

part
id = "m168p";
desc = "ATMEGA168P";
has_debugwire = yes;
flash_instr = 0xB6, 0x01, 0x11;
eeprom_instr = 0xBD, 0xF2, 0xBD, 0xE1, 0xBB, 0xCF, 0xB4, 0x00,
0xBE, 0x01, 0xB6, 0x01, 0xBC, 0x00, 0xBB, 0xBF,
0x99, 0xF9, 0xBB, 0xAF;
stk500_devcode = 0x86;
# avr910_devcode = 0x;
signature = 0x1e 0x94 0x0b;

...
;
</pre>

danach kann, unter Angabe des neuen config-Files, auch ein ATmega168P programmiert werden, z.B.:

<pre>
avrdude -pm168p -C ~/.avrdude.config.neu -cstk500v2 -v -U flash:w:main.hex
</pre>

=== Anschluss an COM10 und höher (Windows) ===

Wenn AVRDUDE unter Windows an COM10 und höher betrieben werden soll, ist eine andere Schreibweise für die Schnittstelle in der Kommandozeile nötig. Beispiel:

<pre>
avrdude -c stk500v2 -p m16 -P \\.\com13 -uF -vvvv 2> logfile.txt
</pre>

In diesem Beispiel wird statt der gewohnten Schreibweise '''com13''' die spezielle Schreibweise '''\\.\com13''' verwendet und es wird mit ''-vvvv 2> logfile.txt'' eine ausführliche Debugausgabe für Fragen im Forum erzeugt. Näheres hierzu in der [http://www.mikrocontroller.net/topic/90401 Forumsdiskussion].

=== AVRISPmkII + AVRDUDE + Window Vista (32) ===

http://www.mikrocontroller.net/topic/126594#1157327

=== "avrdude was compiled without usb support" ===

Offenbar enthielt WinAVR-20100110 zunächst fälschlicherweise eine AVRDUDE Version ohne USB Support [http://www.mikrocontroller.net/topic/163022#1554907].

Abhilfe:

1. WinAVR deinstallieren, gleiches Release (WinAVR-20100110) nocheinmal herunterladen und installieren (mindestens seit Anfang März 2010 enthält dieses Release avrdude in der Version 5.10 und bringt USB-Support mit).

2. AVRDUDE selbst compilieren: http://www.mikrocontroller.net/topic/163675

3. Compilierte Version 5.10 downloaden: http://www.mikrocontroller.net/topic/163675#1594689

=== Textausgabe in Datei umleiten? ===

Die Windows-"Shell" ''cmd'' benutzt für die Ausgabeumleitung die gleiche Syntax wie die Bourne-Shell (und damit auch
Bash):

<pre>
programm >datei 2>&1
</pre>

zur Umleitung von STDOUT und STDERR in die gleiche Datei (Yalu in [http://www.mikrocontroller.net/topic/124509#1135568]).

Beispiel für Windows ([http://www.mikrocontroller.net/topic/124509#1136322], [http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/redirection.mspx?mfr=true M$]):

<pre>
avrdude -c avrispmkII -p m8 -P usb:xx -v > "C:\output.txt" 2>&1
</pre>

oder nur STDERR in Datei umleiten:

<pre>
avrdude -c avrispmkII -p m8 -P usb:xx -v 2> "C:\output.txt"
</pre>

=== [http://www.franzis.de/elektronik/lernpakete-elektronik/lernpaket-mikrocontroller Franzis] bzw. [http://www.elo-web.de/elo/mikrocontroller-und-programmierung/avr-grundlagen/experimente-mit-dem-attiny13 ELO] Lernpaket Mikrocontroller (Attiny13) ===

Markus hat in [http://www.mikrocontroller.net/topic/169549#1649459] einen Weg beschrieben, wie man den einfachen Programmieradapter des Lernpakets mit AVRDUDE ansteuern kann.

Eine weitere Anleitung [http://www.elektronik-labor.de/AVR/AVRdude.html LP Mikrocontroller und Attiny45 mit Avrdude] gibt es von Ralf Beesner auf der Webseite des Entwicklers Burkhard Kainka. In ''avrdude.conf'' wird dabei ein neuer Programmieradapter namens ''burkhard'' hinzugefügt. Ein zweiter Eintrag ''burkhard2'' in dieser '''avrdude.conf''' ist für die Programmierung des Atmega8 auf dem Franzis Retro-Pong Bausatz mit Hilfe des "Mega8-ISP-Programmer" (Layout siehe ELO-Webseite) vorgesehen.

=== AVRDUDE mit Arduino Bootloader benutzen ===

Mit der Option ''-c stk500v1'' kann AVRDUDE den [[Bootloader]] in Arduino Boards ansprechen [http://www.mikrocontroller.net/topic/195963#1919654].

Es existieren auch modifizierte Versionen von AVRDUDE, die einen Programmer namens ''arduino'' kennen (avrdude.conf untersuchen!). Damit lautet die Kommandozeile für ein Arduinoboard mit Atmega168 beispielsweise [http://www.neuraladvance.com/2010/04/08/using-avrdude-with-the-arduino-duemilanove/]

<pre>
avrdude -c arduino -p m168 -P usb -U flash:w:<filename>
</pre>

Die Bootloader-Hacks von [http://www.ladyada.net/library/arduino/bootloader.html Ladyada] arbeiten nochmal etwas anders.

Gelegentlich gibt es unter Windows Probleme mit der allgemeinen AVRDUDE Version und deren Handling der DTR/RTS Leitung ([[RS232]]). Es kann helfen, unmittelbar von dem Absenden der Kommandozeile einen RESET auf dem Arduinoboard durchzuführen.
Ein kurzes Setzen der DTR Leitung auf HIGH bewirkt ein RESET. So ist es möglich eine .bat Datei zu erstellen mit folgendem Code: (com6 ist ein Virtueller USB Comport)
<pre>
mode com6 dtr=on
avrdude -c arduino -p m168 -P \\.\com6 -U flash:w:<filename>
if %ERRORLEVEL%==0 goto fertig
Pause
:fertig
exit
</pre>

Wenn man den mode-Befehl nicht verwenden kann, etwa weil man cygwin und ein makefile verwendet, so kann man stattdessen <pre>cmd /c mode com6 dtr=on</pre> verwenden. In cygwin empfiehlt sich <pre>cmd /c mode com6 dtr=on > /dev/null</pre>, damit wird die unnütze Ausgabe des Befehls verborgen.

Siehe auch:
* http://www.mikrocontroller.net/topic/232367
* http://www.mikrocontroller.net/topic/238243

=== mysmartUSB V2.11 und ATtiny 13 ===

mysmartUSB V2.11 verlangt -cavr910 als Programmer. Leider ist in avrdude
5.10 immer noch nich der ATtiny13 damit zu programmieren. Also in die
avrdude.conf folgendes mit unter ATtiny13 aufnehmen, so kann er dann
korrekt programmiert werden(inkl. Fuse Bits).
<pre>
#------------------------------------------------------------
# ATtiny13
#------------------------------------------------------------

part
id = "t13";
desc = "ATtiny13";
has_debugwire = yes;
flash_instr = 0xB4, 0x0E, 0x1E;
eeprom_instr = 0xBB, 0xFE, 0xBB, 0xEE, 0xBB, 0xCC, 0xB2, 0x0D,
0xBC, 0x0E, 0xB4, 0x0E, 0xBA, 0x0D, 0xBB, 0xBC,
0x99, 0xE1, 0xBB, 0xAC;
stk500_devcode = 0x14;
avr910_devcode = 0x55;
......
</pre>

Achtung! Programmieren geht auch mit -cavr911. Allerdings geht das Fuse
setzen nicht und man bekommt eine Fehlermeldung.(Programm läuft aber)
<pre>
Reading | ################################################## | 100%
0.12s

avrdude: verifying ...
avrdude: 226 bytes of flash verified
avrdude: reading input file "0x7a"
avrdude: writing lfuse (1 bytes):

Writing | ***failed;
################################################## | 100% 0.00s

avrdude: 1 bytes of lfuse written
avrdude: verifying lfuse memory against 0x7a:
avrdude: load data lfuse data from input file 0x7a:
avrdude: input file 0x7a contains 1 bytes
avrdude: reading on-chip lfuse data:

Reading | ################################################## | 100%
0.00s

avrdude: verifying ...
avrdude: 1 bytes of lfuse verified
avrdude: reading input file "0xff"
avrdude: writing hfuse (1 bytes):

Writing | ***failed;
</pre>

== Anpassungen von avrdude.conf an neuere AVRs ==

* '''ATtiny167''' siehe [http://www.mikrocontroller.net/topic/236355 Forumbeitrag von Volker U.]

== Weblinks ==
* Offizielle AVRDUDE Homepage unter http://www.nongnu.org/avrdude/
* User Manual (engl.) unter http://www.nongnu.org/avrdude/user-manual/avrdude.html#Top
* Kompilierte Windows Version mit USB Support http://yuki-lab.jp/hw/avrdude-GUI/avrdude-5.5-win32-bin.zip
* Kompilierte Windows Version avrdude 5.10 mit USB Support http://www.mikrocontroller.net/topic/163675#1594689
* Kompilierte Windows Version avrdude 5.11.1 mit USB Support http://www.mikrocontroller.net/topic/163675#2383773
* Wer Interesse an der modifizierten Version von AVRDUDE und des AVR910-Programmer hat, kann sich bei http://www.fischl.de/thomas/elektronik/avr910e/ informieren. Der Programmer bleibt auch mit der Modifikation weiterhin kompatibel zu anderer Programmiersoftware.
* [[Burn-o-mat|AVR Burn-O-Mat]] GUI (Graphic User Interface) für AVRDUDE http://burn-o-mat.net mit FUSE-Editor (Java, für Windows und Linux)
* [http://www.soft-land.de/ AVRBurner] Ponyprog-ähnliche Oberfläche für AVRDUDE.

[[Kategorie:AVR-Programmer und -Bootloader]]
[[Kategorie:Entwicklungstools]]

AVR Eclipse

2012-08-24T18:19:54Z

Vogtinator: opensuse aktualisiert

Dieser Artikel beschreibt erste Erfahrungen mit Eclipse und der AVR-Toolchain.

== Allgemeines zu Eclipse ==
Eclipse ist eine IDE, die sich alleine nicht zur Programmierung von C/C++ eignet. Dafür gibt es dann das Eclipse-Plugin CDT (auch von ECLIPSE.ORG). Die CDT erweitert Eclipse mit der Möglichkeit, C/C++ zu programmieren. Das aber erstmal nur mit dem GCC. Um die Toolchain AVR-GCC (WINAVR) einzubinden, benötigt man noch ein weiteres Plugin (CDT AVRGCC oder auch CDT AVR Plugin). Es ist auch möglich, ohne die beiden letzt genannten Plugins zu arbeiten, dann sind die Einstellungen für den GCC an AVR-GCC anzupassen (unkomfortabler).

== Allgemeines zu dem AVR Eclipse Plugin ==

Da dieser Artikel nicht immer auf dem neuesten Stand ist, bekommt man weitere Informationen auf der englischen [http://avr-eclipse.sourceforge.net/wiki/index.php/The_AVR_Eclipse_Plugin AVR Eclipse Plugin WIKI] Seite

=== Eclipse Plugin Tutorials ===

* Kurzanleitung zur Installation des [http://winavr.scienceprog.com/other-valuable-tools/using-eclipse-as-ide-for-winavr-compiler.html Plugins] (englisch).

== Installation unter Windows ==

=== Was wird benötigt? ===
==== Compiler ====
* [http://winavr.sourceforge.net/ WINAVR] AVR-GCC Compiler Toolchain, siehe auch Artikel [[WinAVR]]

==== IDE ====
Eclipse braucht eine JAVA Runtime Enviroment, falls diese noch nicht installiert ist muss das auch noch heruntergeladen werden
* [http://java.sun.com/javase/downloads/index.jsp JDK 6 Update 23]

Am einfachsten geht es, wenn man die Version mit dem integrierten CDT-Plugin verwendet.
Unter diesem Link die "Helios SR2" '''Eclipse IDE for C/C++ Developers''' downloaden.
(Es kann Probleme mit der aktuellen Eclipse-Version (Indigo) und WinAVR geben [http://www.mikrocontroller.net/articles/AVR-GCC#Tipps_.26_Tricks Quelle])
* [http://www.eclipse.org/downloads/ Eclipse IDE]

Das zusätzliche AVR Plugin ist notwendig zum Einbinden des AVR-GCC. Kann hier heruntergeladen werden. Oder, besser, in einer installierten Eclipse Umgebung eingebunden werden.
* [http://sourceforge.net/projects/avr-eclipse CDT AVRGCC Plugin]

==== Programmer / Debugger ====
Zum Programmieren und Debuggen kann man eingentlich jedes beliebige Programm verwenden. Zum Debuggen kommt unter anderem AVaRICE zum Einsatz, mit dem man auch programmieren kann (JTAG).
Wahlweise ist auch AVRDUDE zum programmieren zu verwenden. Das kann man machen,
wie man möchte. Beide Programme sind in WINAVR (siehe oben unter Compiler) enthalten.

=== Wie Installieren ===
WinAVR sollte auf dem System installiert sein. Siehe [[AVR_Eclipse#Compiler|oben]].
==== JAVA ====

Java Runtime installieren.

==== IDE ====
Eclipse ist in einem Zip Archiv, das an einen beliebigen Ort entpackt werden kann. Gestartet wird das Programm mit der Datei eclipse.exe. Meldet Eclipse beim Start einen Fehler, ist wahrscheinlich keine oder eine unpassende JAVA Runtime Enviroment installiert.

==== Plugin ====
Es gibt zwei Möglichkeiten, wobei die [[AVR_Eclipse#.C3.9Cber_Updatesite:|erste]] empfohlen wird:

===== Über Updatesite: =====

* Eclipse starten. Zum Software Update Dialog gehen (Help > Install New Software ...)

* In der Zeile Work with ... http://avr-eclipse.sourceforge.net/updatesite eintragen.
*Button Add anklicken. Einen Namen vergeben z.B. AVR-Eclipse.
*Neuste Version von AVR-Eclipse auswählen und installieren.

===== Direkt installieren: =====
Das Plugin ist ebenfalls eine ZIP-Datei die entpackt werden muss. Alle Dateien und Ordner im features Ordner müssen in den features Ordner von Eclipse kopiert werden. Alle Dateien und Ordner im Verzeichnis plugins müssen in den plugins Ordner von Eclipse kopiert werden.

== Installation unter Linux ==

===openSuSE===
Eclipse läßt sich einfach via zypper oder yast installieren:

zypper install eclipse

Seit openSUSE 11.4 muss man ein neues Repository hinzufügen:

http://download.opensuse.org/repositories/CrossToolchain:/avr/openSUSE_12.1/

und dann

zypper install avr-libc cross-avr-gcc

ausführen.
Benutzt man noch 11.3, muss man avr-libc-1.7.0.5.1 aus den alten Repos installieren, da die neueste Version von cross-avr-gcc dort verbuggt ist (vllt. io.h vergessen?).

=== Gentoo ===
==== Eclipse-IDE ====
* emerge eclipse-sdk -av
Den Rest per eclipse update oder von Hand:
* [http://www.eclipse.org/cdt/ Eclipse-CDT-Plugin] Version 3.0.0
* [http://sf.net/projects/avr-eclipse Eclipse-CDT-Addon for AVR] Version 20070404

==== Compiler ====
crossdev emergen:
* emerge crossdev
Stabile Version der avr-toolchain inkl. g++ kompilieren:
* USE="-nocxx" crossdev -s4 -S -t avr --ov-output /usr/local/portage

Es gibt Probleme mit crossdev und den ldscripts. Der Link wird nicht angelegt. Fix für 64Bit:
* ln -s /usr/lib64/binutils/avr/2.20.1/ldscripts/ /usr/avr/lib/

==== Programmer ====
* emerge uisp

=== Debian ===
==== Eclipse-IDE ====
* [http://www.eclipse.org/downloads/index.php Eclipse-IDE] Version 3.1.0
* [http://www.eclipse.org/cdt/ Eclipse-CDT-Plugin] Version 3.0.0
* [http://sf.net/projects/avr-eclipse Eclipse-CDT-Addon for AVR] Version 20070404

==== Compiler ====
* binutils-avr 2.15-3
* gcc-avr 1:3.4.3-2
* avr-libc 1:1.2.3-3

==== Debugger ====
* simulavr 0.1.2.2-1
* gdb-avr 6.3-2
* ? avra 0.7-1

==== Programmer ====
* AVRDUDE und die GUI [http://avr8-burn-o-mat.aaabbb.de/ avr8-burn-o-mat]
* uisp 20050207
* ? avrp
* ? avrprog

=== Ubuntu 8.10 (Zum ersten) ===
==== Eclipse-IDE ====
* [http://www.eclipse.org/downloads Eclipse IDE for C/C++ Developers] Version 3.3, CDT Version 4.0
* [http://sourceforge.net/projects/avr-eclipse AVR-Eclipse-Plugin] Version 2.2.0

==== Compiler ====
* binutils-avr: 2.18-3
* gcc-avr: 1:4.3.0-2
* avr-libc: 1:1.6.2-1

==== Debugger ====
* [ftp://ftp.gnu.org/gnu/gdb/gdb-6.6.tar.bz2 avr-gdb]: 6.6; '''In den Repositories ist 6.4.90!'''
* avarice: 2.7-2
* simulavr: 0.1.2.2-6.1 (nicht getestet, sollte aber genauso funktionieren)

==== Programmer ====
* avrdude: 5.5-3 und GUI [http://avr8-burn-o-mat.aaabbb.de/ avr8-burn-o-mat]

==== Zusätzliche notwendige Programme/Libraries ====
* gcc
* binutils-avr
* build-essential
* ncurses-dev

=== Ubuntu (Zum zweiten) ===
==== AVR-Toolchain ====
Leider ist in den Repositories nur eine veraltete Version von avr-gdb (bzw. gdb-avr) enthalten. Diese Version hat bei mir zu Fehlern geführt. Deshalb wird die aktuelle Releaseversion 6.6 verwendet.

==== Schritt für Schritt ====
Als erstes werden die notwendigen Programme aus den Repositories installiert:

<pre>sudo apt-get install gcc gcc-avr avr-libc avrdude binutils-avr avarice build-essential ncurses-dev</pre>

Ubuntu 6.10:
<pre>sudo apt-get install gcc gcc-avr avr-libc avrdude binutils-avr avarice build-essential libncurses5-dev</pre>

Zusätzlich können auch noch folgende Packages interessant sein:
* Simulavr: Ein Simulator für die AVR-Reihe
* uisp: Alternativer Downloader

<pre>sudo apt-get install simulavr uisp</pre>

Jetzt kann man bereits das AVR-Target ansprechen, um z. B. die Fuses auszulesen:

<pre>avarice -j /dev/ttyUSB0 -P atmega128 -r</pre>
* -j: Gibt das Gerät an, mit dem das Target verbunden ist.
* -P: Zielarchitektur
* -r: Read Fuses

Dazu ist die Manpage von avarice zu empfehlen:
<pre>man avarice</pre>

Als nächstes muss gdb-avr heruntergeladen und dann kompiliert werden:

<pre>wget ftp://ftp.gnu.org/gnu/gdb/gdb-6.6.tar.bz2
tar jxf gdb-6.6.tar.bz2
cd gdb-6.6
./configure --target=avr --prefix=/usr/local/avr
make
sudo make install
cd ..
rm -rf gdb-6.6</pre>

Dies installiert die aktuelle Version von gdb-avr unter /usr/local/avr. Diesen Pfad könnte man zur PATH-Variable hinzufügen, dies ist allerdings nicht zwingend notwendig.

Unter Ubuntu 8.10 kommt es bei der Installation zu Problemen.
Hier gibt es Abhilfe:
http://www.mikrocontroller.net/topic/76404#1198507

'''Zitat:'''

Die Fehlermeldung lautet ja:
<pre>
avr-dis.c:xxx: error: format not a string literal and no format arguments
</pre>
und Zeile xxx in dieser Datei lautet: <c>sprintf (buf, xyz);</c> Wenn man das in <c>strcpy(buf, xyz);</c> ändert, sollte es funktionieren.

== Einrichten von Eclipse unter Windows ==
Beim ersten Start muss man einen Workspace angeben, dazu kann das vorgeschlagene Standardverzeichnis verwendet werden, wenn nur ein Benutzer diesen Workspace verwendet, ansonsten sollte man einen Ort auswählen, auf den alle Zugriff haben. Danach sollte das Bild so aussehen. Klicke auf Workbench.

[[Bild:EclipseStart.png]]

== Einrichten von Eclipse unter Linux ==

=== Alternative 1 ===

Das AVR-Eclipse Plugin kann über die Update-Site http://avr-eclipse.sourceforge.net/updatesite/ installiert werden. (Help->Software Updates...)

=>Ab AVR-Eclipse Plugin V 2.0.1 ist es nicht mehr nötig was mit avr-objsplit zu machen da die flash und EEPROM Dateien direkt erzeugt werden. (laut Thomas Holland, Forum)

Zum Schluss muss noch, die avr-objsplit.bat-Datei, wie folgt, umgeschrieben, nach /usr/bin/avr-objsplit kopiert und ausführbar gemacht werden.

<pre>
#!/bin/bash

avr-objcopy -j .text -j .data -O ihex *.elf flash.hex
avr-objcopy -j .eeprom --change-section-lma .eeprom=0 -O ihex *.elf eeprom.hex
if [ ! -f eeprom.hex ]; then
echo ":00000001FF" > eeprom.hex
fi
</pre>

Ändern der Rechte:
<pre>
chmod +x avr-objsplit
</pre>

==== Einstellungen ====
Jetzt müssen noch gewisse Einstellungen in Eclipse angepasst werden:
Unter Window->Preferences->AVR->AVRdude:

* Programmer auswählen
* Programmerport auswählen
* Target MCU Type auswählen

==== Projekteinstellungen ====
Jetzt kann ein neues C-Project angelegt werden, wobei als Projekttyp "AVR Cross-Target Project" ausgewählt werden muss.<br/>Im "New Project Wizard" kann der MCU-Typ und die Quarzfrequenz eingestellt werden. Weitere Compiler-Optionen sind in den Projekteinstellungen unter "C/C++ Build->Settings" möglich.

=== Alternative 2 ===

Dabei werden die Projekteinstellungen eines Standard-C-Projekts so verändert, dass die AVR-Toolchain verwendet wird.

Mein erster erfolgreicher Versuch lief mit einen "managed C Projekt". Ich hoffe in der folgenden Beschreibung fehlt kein Schritt:
* File / New / Managed Make C Project
** Project Name '''"test2" [Next]'''
** Project Type '''"Executable (GNU)" [Next]'''
** C/C++ Indexer '''"full ..." [Finish]''' (hab ich später geändert siehe unten)

==== Projekteinstellungen ====
* File / New / SourceFile
** '''[Browse] "test2" [OK]'''
** Source File: '''"test2.c" [Finish]'''
* Project / Properties
** C/C++ Build / ToolSettings
*** GCC-C-Compiler
**** Command: '''gcc''' ändern auf '''avr-gcc -mmcu=atmega16 -c'''
**** Das '''-c''' ist wichtig, damit nur kompliert aber nicht gelinkt wird.
**** Directorys Eintrag '''/usr/avr/include''' einfügen
**** Debugging gewünschten Wert einstellen (z. B. -g)
*** GCC-C-Linker
**** Command: '''gcc''' auch ändern auf '''avr-gcc -mmcu=atmega16 '''
**** Libraries: Library Search Path= '''/usr/avr'''
**** Miscellaneous: Linker Flags = '''-Wl,-Map,avr.map'''
*** GCC Assembler
**** Command: '''as''' ändern auf ''avr-as''
** C/C++ Build / Build Steps
*** Post-Build-Step
**** Command: '''avr-objcopy -j .text -j .data -O ihex test2 test2.hex'''
** C/C++ Indexer
*** Available Indexers = '''CTags Indexer (declarations only)'''
*** Include Files: Index Include paths ''' einschalten'''

==== später eingefügt: ====
* Project / Properties
** C/C++ Build / Build Steps
*** Pre-Build-Step
**** Command: '''uisp -dprog=dasa2 -dserial=/dev/ttyS0 -dpart=atmega16 --erase'''
* Project / Properties
** C/C++ Build / Build Steps
*** Post-Build-Step
**** Command: '''avr_upload'''
* Project / Properties
** C/C++ Build / Build Settings
*** Build Output
**** Artifact Name: '''avr_main'''

avr_upload ist eine kleine Batchdatei im Verzeichniss '''/usr/bin ''', die ich neu angelegt hab:
<pre>
#!/bin/sh
# .lst-Datei erzeugen (optional)
# avr-objdump -h -S avr_main > avr.lst
# Datei in Intel-hex erzeugen
avr-objcopy -j .text -j .data -O ihex avr_main avr.hex
# Intel-hex-Datei uploaden
#uisp -dprog=dasa2 -dserial=/dev/ttyS0 -dpart=atmega16 --upload if=avr.hex
# Intel-hex Datei uploaden und verifizieren.
uisp -dprog=dasa2 -dserial=/dev/ttyS0 -dpart=atmega16 --upload if=avr.hex --verify
</pre>

==== Eclipse Plugin ====

Im Forum gibt es ein Plugin für Eclipse, das einen Großteil dieser Einstellungen bereits beinhaltet. Der Thread steht unter:

http://www.mikrocontroller.net/forum/read-2-229419.html#new

Das Plugin wird dort zum Download angeboten. Aber es ist sicher hilfreich die dortige Anleitung zu beachten.

http://www.mikrocontroller.net/attachment.php/285349/org.eclipse.cdt.avrgcc_1.0.16.zip

'''HINWEIS:''' Bitte die aktuelle Version benutzen. Folgende Warnung bezieht sich auf die älteren Versionen (vor Version 1.0.14).
'''WARNUNG:''' Bei mir funktionierten Timer-Interrupts mit dem Plugin nicht (die jedoch tadellos mit der WinAVR Makefile funktionierten). Vielleicht habe ich nur eine Option übersehen, seid aber auf der Hut. Wenn ihr Unregelmäßigkeiten bei IRQs feststellt, versucht's erstmal ohne das Eclipse-Plugin (bevor ihr stundenlang an eurem Code und euch selbst zweifelt :-) ).

== Projekt erstellen ==
[[Bild:NewProject.png]]

Wichtig ist, dass man '''AVR Cross Target Application''' auswählt

[[Bild:CreateProject.png]]

Beim nächsten Schritt kann man auswählen, was für Konfigurationen man will. In den meisten Fällen reicht es aus, wenn man nur '''Release''' auswählt.

[[Bild:SelectConfigurations.png]]

In diesem Schritt wählt man den Prozessor und die Taktfrequenz aus, wobei die Taktfrequenz in Hz angegeben werden muss

[[Bild:TargetHardwareProperties.png]]

== Erster Test ==
Die jeweiligen Alternativen beziehen sich auf die oben genannten verschiedenen Möglichkeiten.

=== Aufbau ===
Die folgenden Angaben beziehen sich auf ein sehr einfaches Entwicklungsboard von Pollin, welches aber auch einfach nachgebaut werden kann. Den Schaltplan gibt's [http://www.pollin.de/shop/downloads/D810022B.PDF als PDF hier].

==== Programm eintippen ====
(oder einfach von hier kopieren)
<pre>
#include <avr/io.h>

#define running 1

// Unterprogramm mit Zeitschleife fuer ATMega16 ohne Quarz
void delay_ms( unsigned int ms )
{
unsigned int i;
unsigned int j;

for ( i = ms; i; i-- )
{
for ( j = 51; j; j-- )
{
}
}
}

int main( void )
{
// PortD6 als Output konfigurieren
DDRD |= _BV(PD6);

// Hauptschleife des Programms
while ( running )
{
// LED einschalten, und dann warten
PORTD |= _BV(PD6);
delay_ms( 1000 );

// LED ausschalten, und dann warten
PORTD &= ~_BV(PD6);
delay_ms( 29000 );
}
}
</pre>

Um dass Programm zu kompilieren muss links im '''Project Explorer''' der Projektordner angeklickt werden.

[[Bild:MakeTarget.png]]

Eine Konfiguration fügt man mit '''Add''' hinzu. In neuen Fenster gibt man als '''Target Name''' einen Namen ein. Der Name wird später unter anderem für den Dateinamen der HEX-Datei verwendet.

[[Bild:MakeTargetOptions.png]]

Die Einstellungen mit '''Create''' bestätigen und das andere Fenster mit '''Cancel''' schliessen. Ändert man nun eine Datei und speichert sie ab, wird das Projekt automatisch kompiliert. Das kann übrigens über '''Project''' --> '''Build Automatically''' geändert werden, da es bei grossen Projekten nachteilig ist, wenn der da die ganze Zeit kompiliert. Ob das ganze funktioniert hat kann man überprüfen, indem man auf '''Console''' klickt. Wenn das Kompilieren erfolgreich war, sollte die Ausgabe etwa so aussehen:

<pre>
**** Build of configuration Release for project AVRTest ****

make
Building target: AVRTest.elf
Invoking: AVR C Linker
avr-gcc -Wl,-Map,AVRTest.map -mmcu=atmega8 -o"AVRTest.elf" ./main.o
Finished building target: AVRTest.elf

Invoking: AVR Create Extended Listing
avr-objdump -h -S AVRTest.elf >"AVRTest.lss"
Finished building: AVRTest.lss

Create Flash image (ihex format)
avr-objcopy -R .eeprom -O ihex AVRTest.elf "AVRTest.hex"
Finished building: AVRTest.hex

Create eeprom image (ihex format)
avr-objcopy -j .eeprom --no-change-warnings --change-section-lma .eeprom=0 -O ihex AVRTest.elf "AVRTest.eep"
Finished building: AVRTest.eep

Invoking: Print Size
avr-size --format=avr --mcu=atmega8 AVRTest.elf
AVR Memory Usage
----------------
Device: atmega8

Program: 108 bytes (1.3% Full)
(.text + .data + .bootloader)

Data: 0 bytes (0.0% Full)
(.data + .bss + .noinit)

Finished building: sizedummy
</pre>

== Projekteinstellungen ==
=== Allgemein ===
Die Einstellungen können unter '''Project''' --> '''Properties''' --> '''C/C++ Build''' --> '''Settings''' vorgenommen werden. Auch hier muss man zuerst das Projekt im '''Project Explorer''' erstmal anklicken.

[[Bild:ProjectProperties.png]]

=== Prozessor / Taktfrequenz ===
Den Prozessor oder die Taktfrequenz kann man hier verändern
'''Project''' --> '''Properties''' --> '''AVR''' --> '''Target Hardware'''

== Prozessor brennen ==
=== AVRDude ===
Den Prozessor kann man mit dem '''AVR''' Button in der Symbolleiste direkt aus Eclipse heraus mit AVRDude programmieren, dafür muss man aber gewisse Einstellungen vornehmen.

=== Programmierhardware auswählen ===
'''Project''' --> '''Properties''' --> '''AVR''' --> '''AVRDude''' Danach klickt man auf den Tab '''Programmer''' und dann auf '''New'''. In der Liste wählt man einen Programmer aus und nimmt gegebenen falls zusätzliche Einstellungen vor.

=== HEX-Datei auswählen ===
'''Project''' --> '''Properties''' --> '''AVR''' --> '''AVRDude''' Danach klickt man auf den Tab Flash/EEPROM. Eigentlich reicht es aus, '''from Build''' auszuwählen.

=== Fuse- / Lockbits ===
Zu den Fuse- bzw. Lockbits gibt es in den jeweiligen Tabs diverse Einstellmöglichkeiten.

== Debugging ==

Debuggen funktioniert mit Eclipse entweder mit '''avarice''' oder '''simulavr''', wobei ersteres zum OnDeviceDebugging dient und zweiteres einen Simulator darstellt. Zusätzlich ist '''avr-gdb''' notwendig, welches wie unter '''Installation unter Ubuntu''' beschrieben, installiert werden kann.
Einen Link zu einer Anleitung für das Debuggen mit Eclipse unter Windows findet ihr unten bei den [http://www.mikrocontroller.net/articles/AVR_Eclipse#Links Links].

=== simulavr ===
<pre>simulavr -g -p 1212 -d atmega16 -P simulavr-disp</pre>
startet den Simulator.

=== avarice ===
<pre>avarice -j /dev/ttyS0 -P atmega128 :1212</pre>
startet einen Server, der auf Port 1212 lauscht und das OnDeviceDebugging übernimmt.

=== Eclipseeinstellungen ===
Unter Eclipse muss ein neues Debug-Target erzeugt werden, was in den Projekteinstellungen unter ''Run/Debug-Settings'' funktioniert. Es muss ''C/C++ application'' ausgewählt werden und folgende Einstellungen müssen geändert werden:
* Debugger
** gdbserver auswählen
** GDB debugger: Pfad zu avr-gdb (/usr/local/avr/bin/avr-gdb)
** ''verbose console mode'' einschalten
* Connection
** TCP, localhost, port 1212 (siehe simulavr/avarice-Aufruf).

Unter Debugger muss für die Verwendung des Simulators Command-Datei mit folgendem Inhalt angegeben und daher auch erstellt werden:
<pre>
file link.elf
targ rem :1212
load
</pre>
link.elf ist die Datei, welche durch den Build erstellt wird. Dies muss daher angepasst werden.

Beim On Device Debugging muss keine Command-Datei angegeben werden.

=== Auslesen von IO-Registern ===
Wenn ''verbose console mode'' eingeschaltet ist, kann in diesem Konsolenfenster direkt mit avr-gdb kommuniziert werden. Dadurch können unter anderem die Register ausgelesen werden:
<pre>p/x *(char *)Adresse</pre>
gibt den Wert der Adresse als char aus.
<pre>p/t *(char *)Adresse</pre>
returniert den Binärwert.

Die Adresse setzt sich aus einer Startadresse und einem Offset zusammen, wobei diese sich im entsprechenden io-Header der Architektur befindet. Beispielweise setzt sich die Adresse für das UCSR0B-Register eines Atmega128 aus der Startadresse 0x800020 und dem Offset 0x0A zusammen.

Für oft verwendete Register empfiehlt es sich, diesen mittels
<pre>set $name=(char *)Adresse</pre>
einen Namen zuzuweisen. Diese könnte man in einer Datei speichern und diese als command-Datei beim Debugger angeben, wodurch man sich diese händischen Eingaben spart und mittels
<pre>p/x *$name</pre> bzw. <pre>display *$name</pre>
zugegreifen kann.

=== AVR Studio ===

Hinweise zum Debuggen mit [[AVR Studio]] (Windows) in einem Eclipse-Projekt gibt Marcel K. in http://www.mikrocontroller.net/topic/152059#1428733

= Links =
[http://www.torsten-horn.de/techdocs/java-eclipse.htm Erste Schritte mit Eclipse]

[http://avr-eclipse.sourceforge.net/wiki/index.php/Debugging Anleitung zum Debuggen mit Eclipse unter Windows]

[http://www.wiki.elektronik-projekt.de/mikrocontroller/avr/avr_tutorials 3 Tuts für Eclipse mit AVRs]

[http://www.it-gecko.de/avr-eclipse-falsche-autovervollstaendigung-syntaxpruefung-korrigieren.html AVR-Eclipse falsche Autovervollständigung/ Syntaxprüfung korrigieren]

= Weiteres =
Bei Problemen kann dieser [http://www.mikrocontroller.net/topic/79965#667525 Thread] verwendet werden, in den ich, wann immer es sich bei mir ausgeht, schauen werde.

Jeder ist aufgerufen hier weiterzumachen, wenn er mehr weiss, oder es besser gestalten kann.

[[Kategorie:AVR ]]