Willkommen beim SPiCboard!

Dieser Ordner beinhaltet neben der Bibliothek zum SPiCboard3 im Verzeichnis
	libspicboard/
auch noch

- die Dokumentation, aufrufbar via
	documentation.html
- den java-SPiCboard3 Simulator, startbar mit
	spicsim.bat
- die Atmel Studio 7 Projektvorlage
	SPiCboard_Project_Template.zip
- sowie ein kurzes Beispiel mit einem Atmel Studio 7 Projekt im Ordner
	beispiel/

Weitere Information sind auf
	https://www4.cs.fau.de/Lehre/WS17/V_GSPIC/Uebungen/doc/
zu finden!

------- Ein kurzer Crashkurs für die Benutzung auf dem eigenen Rechner -------

Bei der ersten Verwendung muss die Projektvorlage installiert werden:
Atmel Studio 7 starten und "File" - "Import" - "Project Template..." auswählen.
Im neuen Fenster bei "Select a project template" auf "..." klicken, in diesen
Ordner navigieren und die "SPiCboard_Project_Template" auswählen, anschliessend
auf "OK". Es sollte eine Meldung
	Project Template has been successfully imported.
erscheinen.

Nun kann zukünftig über "File" -> "New" -> "Project..." unsere Vorlage 
	SPiCboard Projekt
ausgewählt werden.

Der Name kann beliebig gewählt werden (wobei "aufgabe" und die jeweilige Aufga-
bennummer durchaus sinnvoll ist).
Als "Location" sollte am Heimrechner das aktuelle Verzeichnis (oder ein Unter-
ordner) gewählt werden, da die Projekte i.d.R. die "libspicboard" brauchen,
und diese im dann Verzeichnis gesucht werden.

Mit dem neuen Projekt wird auch eine "main.c" erstellt, welche bereits das
Grundgerüst vorgibt. Die Datei kann beliebig umbenannt werden (es empfiehlt
sich dazu den "Solution Explorer" über das Menü "View" einzublenden).

Im Ordner "beispiel" findet sich bereits ein Projekt mit einem (sehr kurzen)
Testprogramm, das auf der 7-Segement-Anzeige "ok" ausgibt.

Um ein Programm auf das SPiCboard zu übertragen, muss es zuerst angeschlossen
werden (Windows installiert ggf. die Treiber, was einige Minuten dauern kann),
danach muss es noch im Atmel Studio als Ziel konfiguriert werden.
Hierzu werden die "Properties..." über das Menü "Project" aufgerufen (letzter
Menüpunkt), dann bei "Tool" in "Selected debugger/programmer" das SPiCboard mit
der Bezeichnung "mEDBG ATML252304..." ausgewählt (das Ende entspricht der Seri-
ennummer, die auch auf der Rückseite des SPiCboards steht).
Die restlichen Optionen sollten nur von fortgeschrittenen Benutzern geändert 
werden.

Sollte eine Fehlermeldung wie 
	Failed to launch debug session with debugWIRE. This could be caused by reset line
	circuitry or disabled debugWIRE interface. Make sure that the reset line is free before
	continuing. Do you want to use SPI to enable the DWEN fuse?
erscheinen, du aber dein SPiCboard nicht mit Linux verwendet hast, so ist es
vermutlich die fehlende Konfiguration als Zielgerät - einfach "No" auswählen
und wie zuvor beschrieben durchführen.
