[[PageOutline]]

= Programmierung =
== Software Installation Windows ==
* Gehe auf die Homepage http://arduino.cc/en/Main/Software [[BR]] * Lade dir in dem Abschnitt Download die Software fuer Windows herrunter. Zum Zeitpunkt des Girlsdays 2010 war die Version arduino-0018.zip aktuell. [[BR]] * Entpacke die herruntergeladene Datei (arduino-0018.zip) [[BR]] * Gehe in das entpackte Verzeichniss arduino-0018 und doppelklick auf arduino.exe [[BR]] * die Arduino Entwicklungsumgebung sollte jetzt gestartet sein

Weitere Information findest du auf der Homepage http://arduino.cc/en/Guide/Windows

== Software Installation Linux (Ubuntu 9.10) ==
* Oeffne ein Terminal (Anwendungen -> Zubehoer -> Terminal) * kopiere folgenden Befehl und fuehre ihn aus

{{{
    sudo apt-get install sun-java6-jre sun-java6-bin sun-java6-jdk sun-java6-fonts sun-java6-plugin gcc-avr avr-libc
}}}
* Als naechstes muesst du Ubuntu's Braille Unterstuetzung deinstallieren, da es sonst zu Konflikten mit der Arduino Entwicklungsumgebung kommen kann

{{{
    sudo apt-get remove brltty
}}}
* Jetzt muessen wir noch die zu benutzende Java Version einstellen. Mit dem folgendem Befehl wird eine Liste der installierten Java Versionen angezeigt. Waehle hier die Jave Version 'java-6-sun' aus.

{{{
    sudo update-alternatives --config java
}}}
* Gehe auf die Homepage http://arduino.cc/en/Main/Software [[BR]] * Lade dir in dem Abschnitt Download die Software fuer Linux herrunter. Zum Zeitpunkt des Girlsdays 2010 war die Version arduino-0018.tgz aktuell. [[BR]] * Entpacke die herruntergeladene Datei (arduino-0018.tgz) [[BR]] * Gehe in das entpackte Verzeichniss arduino-0018 [[BR]] * starte die Arduino Entwicklungsumgebung mit

{{{
    ./arduino
}}}
* die Arduino Entwicklungsumgebung sollte jetzt gestartet sein.

Weitere Information findest du auf der Homepage http://www.arduino.cc/playground/Learning/Linux

== Software Installation Mac OS X ==
Bitte den Anweisungen auf der Homepage http://arduino.cc/en/Guide/MacOSX folgen :).

== Programmieren des Arduino ==
Um den !BristleBot zu programmieren, werden zwei Software Komponenten benoetigt. Zum einen zwei Dateien die als Software Bibliothek von der Arduino Entwicklungsumgebung benoetigt wird, und zum anderen das Programm zur Steuerung des Roboters, dass du waehrend des Girlsdays auf den Roboter geladen hast. Dazu fuehre bitte folgende Schritte aus:

 1. Gehe in das Arduino Verzeichnis, in das du die Arduino Entwicklungsumgebung entpackt hast. Dort findest du ein Unterverzeichnis mit dem Namen '''libraries'''. In diesem Verzeichnis erstellst du ein neues Verzeichnis mit den Name '''!BristleBot'''.
 1. Nun lade die zwei Dateien [https://svn.mpia.de/trac/gulli/GirlsDay/browser/software/BristleBot/BristleBot.h BristleBot.h] (https://svn.mpia.de/trac/gulli/GirlsDay/browser/software/BristleBot/BristleBot.h) und [https://svn.mpia.de/trac/gulli/GirlsDay/browser/software/BristleBot/BristleBot.cpp BrisleBot.cpp] (https://svn.mpia.de/trac/gulli/GirlsDay/browser/software/BristleBot/BristleBot.cpp) herunter und speichert diese im neu angelegten Verzeichnis '''!BristleBot. '''Auf der Downloadseite findest du ganz unten eine Link, um die Datei herunter zu laden'''! '''
 1. Jetzt erstelle bitte eine Verzeichnis '''Girlsday''' das du auch spaeter wieder findest, aber nicht unterhalb des Arduino Verzeichnisses und speicher die Datei [https://svn.mpia.de/trac/gulli/GirlsDay/browser/software/Girlsday/Girlsday.pde GirlsDay.pde] (https://svn.mpia.de/trac/gulli/GirlsDay/browser/software/Girlsday/Girlsday.pde) dort. Diese Datei beinhaltet das Program, welches den Roboter steuert und auf den Roboter hochgeladen wird.

Das wars! Nun hast du alles was an Software benoetigt wird.

== Entwicklungsumgebung Arduino ==
'''Benoetigtes Zubehoer''' [[BR]]  Zum Programmieren des !BristleBots wird ein USB Kabel [http://www.pollin.de/shop/dt/NDA2ODcyOTk-/Computer_und_Zubehoer/Hardware/Kabel_Stecker_Adapter/USB2_0_Anschlusskabel_A_zu_Mini_B_B5_.html www.pollin.de Bestellnummer: 721 395] mit einem USB Adapter [http://www.watterott.com/de/FTDI-Basic-Breakout-5V www.watterott.com Art.Nr.: 2008438] benoetigt. [[BR]] [[Image(USBKabel.jpg, 200)]] [[Image(FTDI.jpg, 200)]] [[BR]]

'''Anschliessen des !BristelBots mit dem PC''' [[BR]]  Verbinde das USB Kabel mit dem USB Adapter und schliesse es an deinem PC an. Stecke jetzt den Adapter an die !BristleBot Platine so wie es auf dem Bild zu sehen ist (Die Bauteile des Adapters und der !BristleBot Platine muessen von oben zu sehen sein).

[[Image(VerbundenMitBristleBot.jpg, 70%)]]

'''Oeffnen des !BristleBot Beispielprogramms''' [[BR]] Um das Beispielprogramm zu oeffnen klicke auf File > !BristleBot > !BristleBot.

'''Waehle deine Arduino Version aus''' [[BR]]  Bevor du dein !BristleBot programmieren kannst must du in der Entwicklungsumgebung dein benutzten Arduino Chip einstellen. Waehle unter Tools > Boards > Arduino NG or older w/ ATmega8 aus.

'''Waehle die serielle Schnittstelle aus''' [[BR]] Wenn der BristleBot mit dem PC verbunden ist, dann wird unter Tools > Serial Port die benutzte Schnittstelle angezeigt. Falls mehrere Shcnittstellen angezeigt werden, kann man denBristleBots vom PC trennen. In dem Menue Tools > Serial Port wird nun die vom !BristleBot verwendete Schnittstelle nciht mehr angezeigt. Verbinde nun den PC mit dem !BristleBot wieder und waehle die verwendete Schnittstelle aus.

'''Programmieren des !BristleBots''' [[BR]] Jetzt kannst du deinen !BristleBot programmieren, indem du einfach auf den Upload Knopf drueckst. Warte ein paar Sekunden bis das blinken der RX und der TX LEDs auf dem USB Adapter aufhoert zu blinken. Wenn das Hochladen des Programms erfolgreich war, siehst du die Nachricht "Done uploading" in der Statusbar.

[[Image(UploadButton.png)]]

Ein paar Sekunden nach dem Hochladen faengt der !BristleBot an zu fahren. Herzlichen Glueckwunsch fuer dein erstes Arduinoprogramm.

Weitere Informationen findest du auf der deutschsprachige Homepage http://www.freeduino.de/books/arduino-tutorial-lady-ada oder auf der englischsprachigen Herstellerseite http://arduino.cc/en/Guide/Windows.

== Justieren ==
Wenn du deinen Roboter fertig programmiert hast, kann es passieren, dass der Roboter nicht ganz so toll faehrt wie am Girlsday. Nun kannst du deinen Roboter noch etwas tunen indem du entweder den Batteriepack etwas nach vorne schiebst. [[BR]]

[[Image(Batteriepack.JPG, 70%)]] [[BR]]

Wenn er immer noch dahin gekrochen kommt wie eine achtzig jaehrige Grossmutter, dann kannst du versuchen die Schauben unter den Buersten, entweder lockerer oder fester zu drehen. Erfahrungsgemaess sollten die Buersten sehr locker, fast schon schlapperig, an der Bodenplatte haengen. [[BR]]

[[Image(Screw.jpg)]] [[BR]]