AVRDUDE

2012-08-14T19:08:43Z

84.147.32.209: /* Beschreibung */

== Beschreibung ==
AVRDUDE (http://www.nongnu.org/avrdude/) ist *DIE* 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" http://sourceforge.net/apps/trac/libusb-win32/wiki

# 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]]

Mikrocontroller.net - Benutzerbeiträge [de]

AVRDUDE