Übertragen der Firmware auf den ct-Bot

Damit ein fertig compiliertes .hex-File vom PC über einen Programmieradapter auf den Mikrocontroller kommt, braucht man neben dem Adapter eine passende Programmiersoftware. Die Software avrdude wird im Rahmen der Toolchain mit installiert, siehe Installationsanleitung.

Auswahl möglicher Programmieradapter für den ct-Bot

Ein Programmieradapter verbindet den ISP-Port des Roboters mit dem PC. Über ihn kann man die Fuse-Bits setzen und die Firmware übertragen, auch wenn der Chip noch völlig leer ist.

mySmartUSB

• Anschluß an den PC: USB
• Software:
  • Windows: avrdude -c avr911 -P com3 -p m1284p -U flash:w:"ct-Bot.hex":i (Treiber liegt dem Programmer bei)
  • Linux: avrdude -c avr911 -P /dev/ttyUSB0 -p m1284p -U flash:w:"ct-Bot.hex":i
  • macOS: avrdude -c avr911 -P /dev/cu.SLAB_USBtoUART -p m1284p -U flash:w:"ct-Bot.hex":i (VCP-Treiber für CP2102 installieren, funktioniert nur bis macOS 10.15)

Arduino als In-System-Programmer

• Anschluß an den PC: USB
• Software:
  • Windows: avrdude -c avrisp -P COM5 -b 19200 -p m1284p -U flash:w:"ct-Bot.hex":i
  • Linux: avrdude -c avrisp -P /dev/ttyUSB0 -b 19200 -p m1284p -U flash:w:"ct-Bot.hex":i
  • macOS: avrdude -c avrisp -P /dev/cu.usbserial-1234 -b 19200 -p m1284p -U flash:w:"ct-Bot.hex":i

Atmel mkII

• Anschluß an den PC: USB (libusb muss installiert sein)

• Software: avrdude -c avrispmkII -P usb -p m1284p -U flash:w:"ct-Bot.hex":i

  Tip

  Unter Linux hilft es einmalig sudo chown :plugdev /YOUR_PATH_TO/avrdude auszuführen, um auch ohne root-Rechte programmieren zu können.

AVR Dragon

• Anschluß an den PC: USB (libusb muss installiert sein)
• Software: avrdude -c dragon_isp -P usb -p m1284p -U flash:w:"ct-Bot.hex":i

Raspberry Pi via SPI

Ein Raspberry Pi kann als vollwertiger Programmer verwendet werden, wenn der ATmega über SPI verbunden und ein GPIO-Pin des RPi am Reset-Pin des ATmega angeschlossen ist.

• Anschluß: SPI / GPIO
• Software:
  • Installation: siehe raspberry-pi-as-an-avr-programmer
  • Kommando: avrdude -c linuxspi -P /dev/spidev0.1 -p m1284p -U flash:w:"ct-Bot.hex":i -b 4000000

Bootloader

• Anschluß an den PC: USB-2-Bot, WLAN, LAN
• Software: avrdude, siehe Abschnitt Bootloader des ct-Bot

Übertragen des EEPROM-Abbildes mit avrdude

• Das vom Compiler erstelle EEPROM-Abbild auf den Bot übertragen: avrdude -P <siehe oben> -c <siehe oben> -p m1284p -U eeprom:w:"ct-Bot.eep":i
• Das EEPROM des Bots auslesen und in die Datei ct-Bot.eep schreiben: avrdude -P <siehe oben> -c <siehe oben> -p m1284p -U eeprom:r:"ct-Bot.eep":i

Setzen der Fuse-Bits

• ohne Bootloader, ATmega1284P: avrdude -P <siehe oben> -c <siehe oben> -p m1284p -U lfuse:w:0xF7:m -U hfuse:w:0xD1:m -U efuse:w:0xFF:m -v
• mit Bootloader, ATmega1284P: avrdude -P <siehe oben> -c <siehe oben> -p m1284p -U lfuse:w:0xF7:m -U hfuse:w:0xD4:m -U efuse:w:0xFF:m -v
• ohne Bootloader, ATmega32: avrdude -P <siehe oben> -c <siehe oben> -p m32 -U lfuse:w:0xFF:m -U hfuse:w:0xD1:m -v
• mit Bootloader, ATmega32: avrdude -P <siehe oben> -c <siehe oben> -p m32 -U lfuse:w:0xFF:m -U hfuse:w:0xD4:m -v
• ohne Bootloader, ATmega644: avrdude -P <siehe oben> -c <siehe oben> -p m644 -U lfuse:w:0xFF:m -U hfuse:w:0xD1:m -U efuse:w:0xFF:m -v
• mit Bootloader, ATmega644: avrdude -P <siehe oben> -c <siehe oben> -p m644 -U lfuse:w:0xFF:m -U hfuse:w:0xD4:m -U efuse:w:0xFF:m -v
• ohne Bootloader, ATmega644P: avrdude -P <siehe oben> -c <siehe oben> -p m644p -U lfuse:w:0xFF:m -U hfuse:w:0xD1:m -U efuse:w:0xFF:m -v
• mit Bootloader, ATmega644P: avrdude -P <siehe oben> -c <siehe oben> -p m644p -U lfuse:w:0xFF:m -U hfuse:w:0xD4:m -U efuse:w:0xFF:m -v

avrdude in Eclipse einbinden

Siehe Verwendung von Eclipse.

Hinweise für Besitzer eines ATmega32 oder ATmega644(P) Mikrocontrollers

Die älteren Mikrocontroller ATmega32 und ATmega644(P) sind pinkompatibel zum neueren ATmega1284P, haben aber weniger Speicher und brauchen andere Fuse-Bits.

• Für den ATmega32 muss man jeweils -p m1284p durch -p m32 ersetzen.
• Für den ATmega644 muss man jeweils -p m1284p durch -p m644 ersetzen.
• Für den ATmega644P muss man jeweils -p m1284p durch -p m644p ersetzen.

Bootloader des ct-Bot

Wir haben den Bootloader von Martin Thomas mit in das ct-Bot-Projekt aufgenommen. Damit lässt sich die Firmware über eine serielle Verbindung (z.B. USB-2-Bot-Adapter oder WLAN) auf den Mikrocontroller übertragen.

Damit das klappt, muss bereits eine Firmware mit Bootloader im Controller sein. Dann kann dieser Bootloader eine neue Firmware in das Flash spielen, ohne dass man wieder einen der obigen Programmieradapter braucht. Um den Bootloader zu transferieren, kommt man aber nicht an einem echten Programmieradapter vorbei. Der Vorteil der Bootloader-Methode ist einerseits eine hohe Geschwindigkeit und andererseits klappt das sogar per WLAN.

Sobald alles eingerichtet ist, lädt der ct-Bot nach einem Reset nicht gleich die (selbsprogrammierte) Firmware sondern erst einmal den Bootloader. Dieser wartet 5 Sekunden lang, ob der PC ihm eine neue Firmware senden will. Ist das der Fall, speichert er sie im Flash des Controllers, ansonsten geht es weiter zum ganz normalen Code.

Installation des Bootloaders

Bevor man den Bootloader nutzen kann, muss er erst einmal selbst in den Flash. Dafür muss zunächst eine Firmware erzeugt werden, in der der Bootloader aktiviert ist. Sowohl für den ATmega32, ATmega644, ATmega644P und ATmega1284P ist der Bootloader bereits in den ct-Bot-Code integriert, aber erst einmal deaktiviert.

1. In der Datei ct-Bot.h den Schalter BOOTLOADER_AVAILABLE aktivieren.
2. Den Code neu übersetzen (in Eclipse durch speichern der geänderten Datei).
3. Das entstandene Hex-File ct-Bot.hex einmalig mit dem Programmieradapter der Wahl übertragen – genauso wie vorher ohne Bootloader (siehe oben).
4. Den Schalter BOOTLOADER_AVAILABLE wieder deaktivieren, der Bootloader muss nur einmal installiert werden.
5. Setzen der Fuse-Bits wie oben jeweils unter mit Bootloader beschrieben.

Firmware übertragen mit Bootloader und …

Ab jetzt wartet der Bot nach einem Reset 5 Sekunden auf eine eingehende Programmierverbindung. Nun kann man über eine RS-232- oder eine USB-2-Bot- oder eine LAN-/WLAN- (WiPort)-Verbindung den Mikrocontroller mit Daten befüllen.

Vorgehen

1. Verbindung zwischen Bot und PC herstellen (per USB-2-Bot, WLAN, LAN oder wie auch immer).
2. Am Bot Reset drücken.
3. Am PC avrdude anwerfen, um die Firmware zu übertragen.

… USB-2-Bot-Adapter

Zuerst muss der USB-2-Bot-Adapter per USB mit dem PC verbunden werden. Dann:

• Linux oder macOS: avrdude -p m1284p -c avr109 -P /dev/ttyUSB0 -u -b 115200 -U flash:w:ct-Bot.hex:i
• Windows: avrdude -p m1284p -c avr109 -P com3 -u -b 115200 -U flash:w:"ct-Bot.hex":i

… (W)LAN

Zuerst muss die (W)LAN-Erweiterung des ct-Bot funktionieren und ins eigene Netz eingebunden sein. Außerdem sollten die Einstellungen des WiPort passend gesetzt sein. Dann:

• Unter Linux oder macOS: avrdude -p m1284p -c avr109 -P net:192.168.x.y:10002 -u -U flash:w:"ct-Bot.hex":i
• Windows: Die Option -P net ist in avrdude für Windows derzeit nicht implementiert. Hier bleibt deshalb nur die Möglichkeit, den Wiport mit dem Lantronix-Tool auf einen virtuellen Com-Port zu mappen und dann wie über USB den Bootloader anzusprechen – nicht getestet.

Einstellungen des WiPort

• Wenn man den WiPort verwendet, muss man den Channel 2 (Serial Settings) auf 115200 Baud (muss zu UART_BAUD in include/bot-local.h passen) (8N1) stellen. Außerdem sollte man unter Flush Mode sowohl für den Input als auch den Output Buffer jeweils die beiden Optionen With Active Connect und With Passive Connect aktivieren.
• Achtung auch der WiPort braucht ein wenig Zeit zum Booten, es kannn also sein, dass er nicht gleich nach dem Power-on reagiert.

• WiPort Einstellungen für Bootloader:

  

Probleme mit dem Bootloader

Problem

Wenn ich versuche Firmware mit avrdude und Bootloader zu übertragen, meldet avrdude nur:

avrdude: error: buffered memory access not supported. Maybe it isn't a butterfly/AVR109 but a AVR910 device?

Erklärung

avrdude schickt dem Bootloader zuerst ein Start-Kommando und erwartet daraufhin vom Bootloader eine Antwort, mit der sich dieser identifiziert. Antwortet der Bootloader jedoch nicht, weil er gar nicht aktiv ist oder weil er das Start-Kommando nicht empfangen hat, wird nach 5 Sekunden der ct-Bot-Steuercode aktiv und der sendet in der Default-Einstellung regelmäßig alle Sensordaten über die serielle Schnittstelle raus. Das erste dieser Datenpakete empfängt dann avrdude statt der Antwort vom Bootloader und interpretiert es falsch - das Paket stimmt natürlich nicht mit der Bootloader-Identifizierung überein. avrdude rechnet aber nicht mit ct-Bot-Kommandos und unterbreitet daher den wenig hilfreichen Tipp, es könnte sich womöglich um einen Tippfehler beim Kommandozeilenparameter für den Programmer-Typ handeln.

Mögliche Ursachen

1. Es wurde vergessen, den Reset-Knopf am ct-Bot zu drücken.
2. Nach dem Setzen der Fuse-Bits keinen Power-On-Reset ausgeführt: in diesem Fall den ct-Bot einmal aus- und wieder einschalten.
3. Der Bootloader startet nicht beim Reboot des ct-Bots: In diesem Fall überprüfen, ob das Display erst 5 Sekunden nach dem Einschalten des Bots die Sensorwerte anzeigt. Ist dies der Fall, ist der Bootloader wirklich installiert. Die Startverzögerung ist die Zeit, in der der Bootloader auf ein Programmier-Kommando wartet, danach startet dann die ct-Bot-Software.
4. Falsche Reihenfolge beim Flashversuch: zuerst den Reset-Knopf des ct-Bots drücken und dann innerhalb von 5 Sekunden den avrdude-Aufruf durchführen. Best practice:
   • Reset-Knopf am ct-Bot drücken und halten.
   • Das Flash-Kommando starten und daraufhin den Reset-Knopf loslassen.
5. Serielle Verbindung in Empfangsrichtung (vom Bot aus gesehen) gestört: wenn der ct-Bot keine Daten vom PC empfangen kann, funktioniert der Bootloader nicht, die Verbindung zum ct-Sim jedoch grundsätzlich trotzdem. Ob die Empfangsrichtung gestört ist, lässt sich leicht überprüfen, indem man vom ct-Sim aus die Fernbedienung benutzt oder einen RemoteCall startet - reagiert der ct-Bot entsprechend, ist auch die serielle Verbindung in beide Richtungen in Ordnung.

---

Autoren: anonybot, Benjamin Benz, Timo Sandmann | Stand: 11.01.2023