Mikrocontroller.net - Benutzerbeiträge [de]

AVRDUDE

2011-01-24T14:06:11Z

Vorbeigeschlendert: /* neuere AVRs hinzufügen */

== 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].

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===
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.

=== 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 letzen 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>

== 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
* 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://myavr.de/myForum/viewtopic.php?t=1913 mysmartusb AVR910-Devcodes] für moderne AVRs (Firmware 2.3). Kann zur Anpassung von AVRDUDE in avrdude.conf verwendet werden.
* [http://www.soft-land.de/index.php?page=avrburner AVRBurner] Ponyprog ähnliche Oberfläche für AVRDUDE.
* [http://www.microstar.ir/download/SinaProg.zip SinaProg] SinaProg - avrdude GUI mit AVR Fuse Calculator.

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

AVR-GCC

2011-01-24T13:47:19Z

Vorbeigeschlendert: /* Linux/Unix */ toolchain bauen mit femtoos-script

AVR-GCC ist ein kostenloser [[C]]-Cross-[[Compiler]] für [[AVR]]-[[Mikrocontroller]].

AVR-GCC kann von der Leistungsfähigkeit her mit kommerziellen [[Compiler]]n gut mithalten. Sogar C++-Programme sind möglich, in der aktuellen Fassung wird C++ jedoch nur eingeschränkt unterstützt (Stand 6/2007).

== Bestandteile ==

Die Toolchain (Werkzeugsammlung) besteht aus mehreren Kommandozeilen-Programmen, die sich auf einfache Weise in einen Editor oder eine Entwicklungsumgebung einbinden lassen (typischerweise als Aufrufe von make mit Parameter, vgl. [[AVR-GCC-Tutorial]]).

Die Bestandteile im einzelnen:
* Binutils: Assembler, Linker und weitere Hilfsprogramme.
* GCC: Der eigentliche C(++)-Compiler.
* AVR-LIBC: Die C-Standardbibliothek mit AVR-spezifischen Headerdateien und Funktionen.
* ([[AVRDUDE]]: universelle AVR-Programmiersoftware, kein eigentlicher Teil der Toolchain, aber oft verwendet)

== Installation ==

=== Linux/Unix ===

Wenn keine aktuelle AVR-GCC-Version als Paket für die verwendete Distribution zur Verfügung steht, dann können sich [[Unix]]/[[Linux]]-Nutzer den Sourcecode herunterladen und selbst kompilieren. Schritt-für-Schritt-Anleitungen gibt es [http://www.nongnu.org/avr-libc/user-manual/install_tools.html hier] und [http://www.roboternetz.de/wissen/index.php/Avr-gcc_und_avrdude_installieren hier].

Das [http://www.femtoos.org FemtoOS]-Paket beinhaltet Scripte zum automatischen Herunterladen und Bauen einer aktuellen AVR-GCC Version.

Empfehlenswert ist auch [http://cdk4avr.sf.net CDK4AVR], das die entsprechenden tools als einfach installierbare Linux-Pakete bereitstellt (distributionsunabhängig als .tar.gz). Leider ist das Projekt schon etwas älter, im [http://www.mikrocontroller.net/topic/130972 Forum] findet sich ein Beitrag, aktuellere Sourcen mit den entsprechenden Patches zu versehen und zu kompilieren. Patches zu den Binutils und GCC Sourcen sind unumgänglich, da die offiziellen Sourcen aufgrund des Umfangs an Prozessortargets den aktuellsten Entwicklungen hinterherhinken und damit bereits bekannte Fehler eventuell noch nicht behoben sind. Weitere Tipps zur AVR Programmierung unter Linux stehen im Artikel [[AVR und Linux]].

=== Mac OS X ===
Die beste fertige Toolchain ist das [http://www.obdev.at/crosspack/ Crosspack]. Dieses enthält auch die avr-libc, avrdude und avarice. Leider gab es bei Mac OS 10.5.6 eine tiefgreifende Änderung beim fork()-Systemcall, der bewirkt, dass avarice mit JTAGICE mkII und Dragon nicht funktioniert. Geräte mit Serial-USB-Konvertern (AVRISP clones etc) funktionieren dagegen problemlos.

Wer die Toolchain von Hand bauen möchte kann das natürlich auch tun, dazu einfach den unter "Linux/Unix" verlinkten Anleitungen folgen. Unter [[Mac OS X]] muss man dazu zuerst die [http://developer.apple.com/Tools/ Apple Developer Tools] installieren.

Teile der Toolchain (avr-libc und avrdude) kann man mit dem Paketsystem [http://www.macports.org/ MacPorts] installieren. Die Compiler-Toolchain kann man dann installieren, indem man folgenden Befehl im Terminal eingibt:

sudo port install avr-libc

Das Programmiertool avrdude bekommt man genauso:

sudo port install avrdude

Weblinks:

* [http://tinkerlog.com/2007/09/29/programming-avr-with-a-macbook/ Programming AVR with a MacBook] (engl.)
* [http://www.ladyada.net/library/avrdevtut/setup-mac.html AVR Tutorial from Lady Ada] (engl.)
* [http://www.obdev.at/crosspack/ Crosspack]
* [http://www.digithink.com/OSX-AVR OSX-AVR (nicht mehr aktuell)]
* [http://www.definefalsetrue.com/index.php/Mac-OS-X/bootfeedx.html BootFeedX Bootloaderfrontend]

=== Windows ===

Für MS-Windows gibt es das fertig kompilierte Softwarepaket [[WinAVR]].

== Entwicklungsumgebungen ==

Win32:
* [[AVR-Studio]]: ab Version 4.12 mit WinAVR-Unterstützung, integrierter Simulator, Debugger, rudimentäre Projektverwaltung
* Programmers-Notepad: wird bei [[WinAVR]] mitgeliefert, ein guter Editor mit einer rudimentären Projektverwaltung
* [http://www.myavr.info/download/benutzerhandbuch_sisy_avr.pdf SiSy-AVR]: ein CASE-Tool mit WinAVR-Unterstützung, das eine Entwicklungsumgebung bereitstellt.

Platformunabhängig:
* [http://www.eclipse.org/ Eclipse] mit CDT und dem [http://avr-eclipse.sourceforge.net/index.html AVR Eclipse Plugin]
* [[Code::Blocks]]: vielseitige, freie Entwicklungsumgebung für Windows und Linux
* [http://www.netbeans.org/ Netbeans] in der C++ - Version mit [[WinAVR]] oder [[avr-gcc]] als Toolchain

== Bibliotheken / Libraries ==

Die [http://www.nongnu.org/avr-libc/ avr-libc] ist die gebräuchliche "Laufzeitbibliothek" zum avr-gcc C-Compiler, welche den Zugriff auf die AVR-Hardware erheblich erleichtert. Die offizielle Dokumentation zur avr-libc mit vielen Hinweisen auch zum Compiler avr-gcc und verschiedener Tools (z. B. [[AVRDUDE]]) findet man [http://www.nongnu.org/avr-libc/user-manual/index.html hier].

Auch die [http://hubbard.engr.scu.edu/embedded/avr/avrlib/ Procyon AVRlib] enthält nützlichen Code z. B. für UART, LCD,.... Bei der Procyon AVRlib ist die Lizenz zu beachten (in Kurzform: man muss dritten auf Verlangen den gesamten Quellcode der Firmware zur Verfügung stellen, falls Teile der Procyon Bibliothek genutzt werden).

Zum Zugriff auf interne Funktionen oder externe Peripherie existieren einige fertige Komponenten. Z.B. "Projects"-Bereich von [http://www.avrfreaks.net/ avrfreaks.net] (Anmeldung erforderlich (kostenlos)).

Die Erstellung eigener Bibliotheken ist im Artikel [[Libraries]] erklärt.

== Tipps & Tricks ==

Eine (hoffentlich wachsende) Liste mit einigen Hinweisen:

* Keine "antiken" Versionen verwenden. Für MS-Windows-Nutzer: aktuelles WinAVR installieren. Für Linux/Unix-Nutzer: letzte stabile Version selbst kompilieren oder aus "Distribution-Packages" installieren (z. B. [http://cdk4avr.sourceforge.net/ cdk4avr]).

* Bei Problemen zuerst in die '''[http://www.nongnu.org/avr-libc/user-manual/index.html Anleitung] der avr-libc''' schauen. Insbesondere die FAQ lesen.

* Sicherstellen, dass der MCU-Parameter (zum Compiler/Linker, meist im Makefile defniert) mit dem Zielprozessor übereinstimmt.

* [[AVR-GCC-Tutorial]] in diesem Wiki lesen.

* Im Zweifel '''nicht INTERRUPT(...) sondern SIGNAL(...)''' nutzen. In neueren Versionen der avr-libc wurde '''ISR''' als Ersatz für SIGNAL eingeführt und sollte genutzt werden (SIGNAL und INTERRUPT werden langfristig entfallen). Darauf achten, dass die Vektor- bzw. Signal-Namen ("Parameter") zu ISR bzw. SIGNAL (und INTERRUPT wenn denn unbedingt erforderlich) richtig geschrieben sind. Die Namen sind in der in der entsprechenden Header-Datei (ioxxx.h) für den Controller und der avr-libc-Dokumenation aufgelistet. Im Zweifel den erzeugten Interrupt-Vektor im Assembler-Listing prüfen, es darf '''kein''' SIG_''xxx'' oder xxx_vect mehr zu sehen sein, sondern _vector_''N'' (wobei ''N'' eine Zahl ist). Neuere Versionen der avr-gcc zeigen eine Warnung, falls etwas falsch geschrieben wurde, ältere Versionen nicht.

* '''Zugriff auf Daten(-Tabellen) im Programmspeicher''' (Flash) erfolgt über Program-Space-Funktionen (pgm_read*). Lediglich die Definition einer Variablen/eines Feldes mit dem PROGMEM Attribut zu versehen, reicht (im Gegensatz zu Codevision, IAR, Imagecraft) nicht aus.

* Nicht alle AVRs werden vollständig von der avr-libc bzw. dem Compiler unterstützt. Bei Problemen hilft oft ein Blick in den erzeugten Assembler-Code. Die Anzahl der unterstützen Controller steigt jedoch mit Version zu Version von binutils, avr-libc und avrdude. Evtl. reicht einfach ein Update auf neuere Software-Versionen (z. B. im jeweils aktuellen WinAVR-Packet).

* '''inp(), outp(), sbi() und cbi()''' werden in der aktuellen Bibliotheksversion nicht offiziell unterstützt (man muss eine spezielle Header-Datei einbinden(deprected.h). Es wird schon seit längerem empfohlen, diese Makros nicht mehr zu nutzen. Einige Anleitungen sind in diesem Punkt veraltet. Mit halbwegs aktuellen avr-gcc/avr-libc-Versionen kann einfach z. B. DDRB=0xfe bzw. foo=PINB geschrieben werden. Mit PORTB |= _BV(1) setzt man PORTB.1, mit PORTB &= ~_BV(1) löscht man es wieder, mit PORTB ^= _BV(1) kann man es umschalten (_BV(x) entspricht dabei (1<<x)). Die ersten beiden Varianten erzeugen bei eingeschalteter Optimierung und passenden Parametern (wie hier im Beispiel Register im "unteren" Speicherbereich) die SBI bzw. CBI Prozessorbefehle.

* Mit dem Tool '''avr-nm''' erhält man eine Übersicht über die Platzausnutzung in der erzeugten ELF-Datei bzw. dem damit gefüllten AVR. Das Tool wird per Kommandozeile mit
::<pre>avr-nm --size-sort --print-size <name of your ELF file></pre>
:aufgerufen. Alle Symbole mit einem "T" (globale Funktionen), "t" (statische Funktionen) und letztlich auch mit einem "D" oder "d" (globale bzw. statische Daten, die haben ihre Initialisierungswerte im ROM) betreffen das FLASH-ROM. "B" und "b" brauchen ausschließlich RAM (werden beim Start mit 0 initialisiert). Die erste Spalte ist die Adresse des Symbols, die zweite ist die Größe (beides hexadezimal). (nach [http://www.mikrocontroller.net/topic/59960#467920 Forenbeitrag] von Jörg Wunsch)

* Mit dem Tool '''avr-size''' erhält man eine Übersicht über den Platzbedarf in den text, data und bss Sektionen innerhalb der ELF Binärdatei. Die Sektionen text und data benötigen Platz im FLASH-ROM und die Sektionen data und bss benötigen zur Laufzeit Platz im SRAM.

== Siehe auch ==
* [[AVR-GCC-Tutorial]]
* [[AVR-GCC-Codeoptimierung]]
* [[GCC: unbenutzte Funktionen entfernen]]
* [http://www.roboternetz.de/wissen/index.php/Avr-gcc/Interna AVR-GCC Interna]

== Weblinks ==
* [http://winavr.sourceforge.net/install_config_WinAVR.pdf Tutorial von C. O'Flynn und E. Weddington] Einstieg in die Nutzung des avr-gcc unter MS-Windows mit WinAVR (englisch)
* [http://www.linuxfocus.org/Deutsch/November2004/article352.shtml AVR-GCC und Linux]
* [http://www.mikrocontroller.net/forum/list-2-1.html GCC-Forum auf mikrocontroller.net]

[[Category:AVR]]
[[Category:Compiler]]
[[Kategorie:avr-gcc| ]]