U23 2005/Fnordlicht quickstart howto

Dieses fnordlicht quickstart howto beschreibt die Schritte zur ersten Inbetriebnahme.

Benötigte Kabel

Folgende Kabel braucht ihr für die Inbetriebnahme

Fuer die Erstprogrammierung braucht ihr:

• Stromversorgung: zweipoliges Kabel mit 2.54mm Doppelbuchse.
• ISP-Kabel für den Parallelport (einfache Schaltung von [1] ):

ACHTUNG: Diese Schaltung trennt euren Parallelport nicht sauber vom fnordlicht, ergo wenn auf dem fnordlicht was nicht stimmt, koennt ihr eucht den Parallelport oder gleich das Mainboard brutzeln! Bitte bevor ihr das selber baut und euer fnordlicht damit programmiert, lasst uns den Programmer und das fnordlicht an einem alten Laptop ausprobieren!

Pin am ISP	Pin am AVR	Schutzwiderstand	Pin am Parallelport
1	+5v		(wird hier nicht benoetigt)
2	GND	--	GND (18)
3	SCK (19)	470 Ohm	Strobe (1)
4	MISO (18)	220 Ohm	Busy (11)
5	MOSI (17)	470 Ohm	D0 (2)
6	Reset (1)	--	Init (16)

Benötigte Software

Um dem fnordlicht Leben einzuhauchen bedarf es einiger Software. Die folgende Beschreibung bezieht sich auf die Verwendung von Linux. Diese ist kein Zwang; wir ermutigen jeden, auch Werkzeuge auf anderen Betriebsystemen zu benutzen. Folgende Softwarepakete sind zu besorgen:

• uisp: Micro In-System Programmer für Atmels AVR MCUs
  • Benötigt Kernel-Support für ppdev und parport; ist bei den meisten Distributionskerneln dabei,
• avra: Assembler für Atmel AVR Microcontroller
• avrdude: In-System-Programmer: Download/Upload/Ändern des Inhalts von ROM und EEPROM
• darcs: Versionskontrollsystem, mit dem die fnordlicht-Firmware verwaltet wird.
• ein beliebiges Terminalprogramm, z.b. minicom oder screen oder hyperterm

Ausserdem werden für das Übersetzen des Bootloaders benötigt:

• gcc-avr: Der GNU C Compiler (Crosscompiler für AVR).
• avr-libc: Standard C Bibliothek für Atmel AVR Entwicklung

Parallele Verbindung zum Atmel prüfen (ISP)

Bevor der Atmel das erste mal über den ISP am Parallelport mit Firmware programmiert werden kann, sollte die Verbindung funktionieren. Folgendes Kommando sollte die nachstehende Ausgabe erzeugen:

$ uisp -dprog=dapa --rd_fuses
Atmel AVR ATmega8 is found. 

Fuse Low Byte      = 0xe0
Fuse High Byte     = 0xd8
Fuse Extended Byte = 0xff  
Calibration Byte   = 0xaf  --  Read Only
Lock Bits          = 0xff
    BLB12 -> 1
    BLB11 -> 1
    BLB02 -> 1
    BLB01 -> 1
      LB2 -> 1
      LB1 -> 1

Ein beliebter Fehler sind mangelnde Schreibrechte für den Devicenode /dev/parport0.

fnordlicht Quelltext besorgen

Der fnordlicht Quelltext wird mit darcs verwaltet. Zuerst in ein passendes Verzeichnis erstellen und den Qelltext auschecken: repository url kommt bald

Prozessor für die Hardware einrichten

Zuerst muss der Mikrocontroller für seine Hardwareumgebung eingerichtet (die Fuse Bits gesetzt) werden. Dazu gibt es einen Eintrag im Makefile und wird durch folgendes Kommando erledigt:

$ make fuse
uisp -dprog=dapa --wr_fuse_h=d8
Atmel AVR ATmega8 is found.

Fuse High Byte set to 0xd8
uisp -dprog=dapa --wr_fuse_l=e0
Atmel AVR ATmega8 is found.

Fuse Low Byte set to 0xe0

Dokumentation zu diesem Vorgang findet sich im Datenblatt zum ATmega8 und in boot/readme im Quelltextverzeichnis.

Bootloader installieren

Im Gegensatz zur fnordlicht Firmware ist der Bootloader für den ATmega in C geschrieben. Der Bootloader muss erst übersetzt und dann via das parellele ISP-Kabel auf den Atmel geschrieben werden. Auch für diesen Vorgang gibt es einen Eintrag im Makefile. Voraussetzung für die Übertragung zum Atmel ist natürlich, dass das fnordlicht über das ISP-Kabel an den Rechner angeschlossen ist. Der Bootloader befindet sich im Verzeichnis boot, der folgende make-Befehl wird jedoch aus dem obersten Verzeichnis des Quelltexts ausgeführt:

make install-bootloader

Der Bootloader war ursprünglich der Atmel Butterfly - die hier benutzte Version wurde nachprogrammiert. Das Hochladen des Bootloaders ist der letzte Schritt, für den das parallele ISP-Kabel benötigt wird. Von nun an werden alle Schritte mit dem seriellen Kabel ausgeführt.

Firmware installieren

Die Firmware wird über die serielle Leitung zum fnordlicht übertragen.

Serielle Verbindung zum Atmel überprüfen

Das fnordlicht mit dem Rechner über das serielle Kabel verbinden und ein Terminalprogramm für 19200 Baud, (8N1, 8 Datenbit, keine Parität, 1 Stopbit) konfigurieren. Nun das Fnordlicht an eine passende Spannungsquelle (zwischen 12 und 16V) anschliessen. Energie! Solang der Atmel noch nicht programmiert ist und der Jumper PGM (bzw. PGSE) auf die Pins 1-2 gesetzt ist sollte der Atmel nun ununterbrochen die Zeichenkette "ba" (boot application) senden.

Jumper setzen (Programmiermodus)

Bevor Firmware über das serielle Kabel in den Atmel übertragen werden kann, muss dem Bootloader mitgeteilt werden, dass er nicht das Programm ausführen, sondern auf den Upload von Firmware warten soll. Dazu das Fnordlicht von der Spannungsquelle trennen und den Jumper PGM (bzw. PGSE) auf die Pins 2-3 setzen. Beim Einschalten meldet der Atmel über die serielle Schnittstelle "bp" (boot programming). Senden eines einzelnen Zeilenumbruches (Enter drücken) quittiert der Atmel mit "?" (unknown command).

Firmware übersetzen

Das folgende Target im Makefile übersetzt die fnordlicht Firmware:

make fnordlicht.hex

Firmware hochladen

Das folgende Target im Makefile überträgt die Firmware in den Flash-Speicher des Microcontrollers:

make install-fnordlicht SERIALDEV=/dev/ttyS0

SERIALDEV gibt die zu benutzende Schnittstelle an.

i²c Adresse im EEPROM setzen

Ist die i²c Adresse im EEPROM nicht gesetzt, wird das fnordlicht nach dem Einschalten dauerhaft rot leuchten. Die Standardadresse lässt sich mit folgendem Kommando setzen:

make install-eeprom SERIALDEV=/dev/ttyS0

SERIALDEV gibt die zu benutzende Schnittstelle an.

Einschalten!

Zunächst darauf achten, dass der Jumper auf die Position "1-2" gesetzt ist. (Probe: Atmel meldet beim Einschalten "ba" (boot application) über die serielle Verbindung). Nun einschalten - das fnordlicht führt das Programm aus.