Die LEDs zum Leuchten bringen
Du hast alles installiert – Zeit fürs erste Programm. Klicke in der Arduino IDE auf „Datei“ → „Neu“ und ersetze den kurzen Quelltext, der schon darin steht, durch den folgenden. An ihm kannst du den Ablauf eines einfachen Programms gut nachvollziehen.
#define LEDR 5 // Beim Übersetzen wird aus jedem LEDR eine 5.
// Die rote LED hängt an Pin 5 des Prozessors.
#define LEDG 7 // Dasselbe für die grüne LED an Pin 7.
void setup() { // "setup()" läuft bei jedem Einschalten einmal.
// Funktionen stehen in geschweiften Klammern.
pinMode(LEDG, OUTPUT); // Pin LEDG als Ausgang: Er schaltet eine LED.
pinMode(LEDR, OUTPUT); // Pin LEDR ebenso.
digitalWrite(LEDR, LOW); // Schaltet die rote LED aus.
digitalWrite(LEDG, LOW); // Schaltet die grüne LED aus.
delay(1000); // 1 Sekunde (= 1000 ms) warten.
digitalWrite(LEDR, HIGH); // Schaltet die rote LED ein.
delay(1000); // 1 Sekunde (= 1000 ms) warten.
digitalWrite(LEDG, HIGH); // Schaltet die grüne LED ein.
}
void loop() { // Nach "setup()" wird "loop()" bis zum Ende aller
} // Tage wiederholt – es steht nur nichts darin.
Auf den PicoBoy übertragen
- Verbinde den PicoBoy per USB mit dem PC, falls noch nicht geschehen.
- Versetze ihn in den Bootloadermodus: Halte die Taste „BOOT“ gedrückt und drücke dabei kurz die Taste „RES“. Er erscheint nun als USB-Laufwerk im Explorer bzw. im Dateimanager.
- Klicke in der Arduino IDE auf den Pfeil-Knopf („Hochladen“) oben in der Werkzeugleiste und gib deinem Programm einen Namen deiner Wahl.
Nach einiger Zeit leuchten die LEDs nacheinander auf – das Programm läuft. Möchtest du den Ablauf noch einmal sehen, drücke kurz die Taste „RES“.
Achtung: Dein Programm ersetzt, was bisher auf dem PicoBoy lief, zum Beispiel die vorinstallierte Spielesammlung PicoPac oder MicroPython. Kaputt geht dabei nichts: Die Spielesammlung kannst du jederzeit neu aufspielen, die Datei liegt unter Links & Downloads. Hast du eigene Python-Programme auf dem Gerät, sichere sie vorher.
Tipp: Wähle einmal unter „Werkzeuge“ → „Port“ den Anschluss des PicoBoy aus. Dann kann die IDE ihn beim Hochladen selbst in den Bootloadermodus schicken, und du musst „BOOT“ und „RES“ nicht mehr jedes Mal drücken. Klappt das einmal nicht – etwa weil sich das laufende Programm aufgehängt hat –, nimm wieder den Weg über „BOOT“ + „RES“.

Sieh dir an, wie die LEDs nacheinander aufleuchten: Programme werden Zeile für Zeile (auch: sequenziell) abgearbeitet. Das lässt sich später ändern, wie du in den nächsten Kapiteln siehst.

Anmerkungen
- Die Zeichenfolge „//“ leitet einen Kommentar ein: Alles, was in derselben Zeile dahinter steht, wird beim Übersetzen ignoriert und dient nur der Erläuterung.
- „#define“ ist sinnvoll, um sogenannte „magic numbers“ zu vermeiden – also Zahlen, deren Sinn sich im Quelltext nicht erkennen lässt.
digitalWrite(LEDR, HIGH)liest sich besser alsdigitalWrite(5, HIGH). - Beachte die Semikolons „;“. Sie beenden jeden Befehl.
pinMode()legt fest, ob ein Pin etwas ausgibt (OUTPUT) oder einliest (INPUT). Einen Ausgang schaltest du dann mitdigitalWrite():HIGHlegt Spannung an den Pin und die LED leuchtet,LOWnimmt die Spannung weg.- Der Inhalt jeder Funktion – z. B.
setup()oderloop()– beginnt mit einer geschweiften Klammer „{“ und endet mit „}“. Die Anzahl der öffnenden und schließenden Klammern muss daher immer gleich sein. - Jedes Arduino-Programm braucht genau ein
setup()und einloop()– auch wenn eines davon leer bleibt.
Wenn eine Fehlermeldung erscheint
Findet die IDE beim Übersetzen einen Fehler, bricht sie ab und zeigt unten im Ausgabefenster rote Meldungen. Auf den PicoBoy wird dann nichts übertragen. Die Meldungen sind englisch und nennen die Zeile, in der die IDE gestolpert ist. Lies immer die erste Meldung zuerst, die weiteren sind oft nur Folgen davon. Diese drei begegnen dir am häufigsten:
expected ';' before 'digitalWrite'– Ein Semikolon fehlt, und zwar am Ende der Zeile davor. Die IDE bemerkt das erst beim nächsten Befehl.'ledr' was not declared in this scope– Der Name ist unbekannt, meist wegen eines Tippfehlers. C++ unterscheidet Groß- und Kleinschreibung:ledrundLEDRsind zwei verschiedene Namen, undpinmode()gibt es nicht, nurpinMode().expected '}' at end of input– Eine schließende geschweifte Klammer fehlt. Zähle die Klammern nach.
Was gehört in setup(), was in loop()?
Das Programm oben läuft einmal durch und bleibt dann stehen, weil loop() leer ist. Als Faustregel gilt: Was nur einmal passieren muss, zum Beispiel das Einrichten der Pins, steht in setup(). Was sich wiederholen soll, steht in loop(). So blinkt die grüne LED, bis du den PicoBoy ausschaltest:
#define LEDG 7
void setup() {
pinMode(LEDG, OUTPUT); // einmal am Anfang: Pin als Ausgang einrichten
}
void loop() {
digitalWrite(LEDG, HIGH); // LED ein
delay(500); // eine halbe Sekunde warten
digitalWrite(LEDG, LOW); // LED aus
delay(500); // warten, dann beginnt loop() von vorn
}
Das zweite delay(500) ist wichtig. Ohne diese Zeile beginnt loop() direkt nach dem Ausschalten wieder von vorn. Die LED wäre dann nur einen winzigen Moment aus, und für dich sähe es so aus, als würde sie durchgehend leuchten.
Übung
Programmiere eine Verkehrsampel. Die Ampelphasen werden in dieser Reihenfolge durchlaufen:
- Grün
- Gelb
- Rot
- Rot und Gelb gleichzeitig
- Grün
Hinweis: Die gelbe LED ist an Pin 6 des Prozessors angeschlossen.
Du brauchst also ein weiteres #define und ein weiteres pinMode(). Zwischen je zwei Phasen gehört ein delay(), sonst siehst du nur die letzte Phase. Schalte außerdem in jeder Phase die LEDs der vorigen Phase wieder aus. Soll die Ampel immer weiterlaufen, schreibst du die Phasen in loop().
Das Display
Natürlich hast du den PicoBoy nicht nur, um ein paar LEDs blinken zu lassen. Probiere das nächste Programm aus und sieh dir die Displayfunktionen an.
Wichtig ist dabei das Prinzip: Du zeichnest nicht direkt auf das Display, sondern in einen Zwischenspeicher im Prozessor (den „Buffer“). Erst sendBuffer() überträgt diesen Speicher auf das Display. clearBuffer() leert ihn wieder.
#include <U8g2lib.h>
#include <SPI.h>
// Das "Objekt" u8g2 erzeugen. Es repräsentiert das Display.
// U8G2_R0 bestimmt die Drehung (0°). Es gibt auch U8G2_R1 bis R3.
// 10, 8 und 9 sind die Anschlüsse des Displays. Die lässt du unverändert.
U8G2_SH1106_128X64_NONAME_F_4W_HW_SPI u8g2(U8G2_R0, 10, 8, 9);
void setup(void) {
u8g2.begin(); // Displayfunktionen starten
// Weitere Schriftarten: https://github.com/olikraus/u8g2/wiki/fntlistall
u8g2.setFont(u8g2_font_mystery_quest_32_tr);
u8g2.clearBuffer(); // Displayspeicher leeren
u8g2.drawStr(31, 40, "Hallo"); // "Hallo" an Position (31, 40) schreiben
u8g2.sendBuffer(); // Displayspeicher anzeigen
delay(1000); // 1 Sekunde warten
u8g2.clearBuffer(); // Displayspeicher leeren
u8g2.drawStr(34, 40, "Welt"); // "Welt" an Position (34, 40) schreiben
u8g2.sendBuffer(); // Displayspeicher anzeigen
delay(1000); // 1 Sekunde warten
u8g2.drawLine(0, 0, 127, 63); // Linie von (0,0) nach (127,63) zeichnen
u8g2.drawLine(0, 63, 127, 0); // Linie von (0,63) nach (127,0) zeichnen
u8g2.sendBuffer(); // Displayspeicher anzeigen
}
void loop() {} // Tut nichts, aber das für immer.
Die ersten Zeilen brauchst du in jedem Programm, das das Display benutzt. #include bindet eine Bibliothek ein, also fertigen Code, den du nicht selbst schreiben musst: U8g2lib.h enthält die Grafikbefehle, SPI.h die Datenverbindung zum Display. Der lange Name danach beschreibt genau dieses Display: SH1106 ist der Controller, 128X64 die Auflösung, und das F steht für einen Zwischenspeicher, der das ganze Bild fasst. Diese Zeile musst du dir nicht merken, sie steht fertig in der Vorlage.
Alle Grafikbefehle beginnen mit u8g2., denn sie gehören zu dem Objekt, das diese Zeile anlegt. Der Punkt bedeutet also: Befehl des Displays.
Wie das erste Beispielprogramm wird auch dieses Zeile für Zeile ausgeführt. Dabei werden Displaykoordinaten verwendet, ähnlich einem Koordinatensystem, wie du es aus dem Matheunterricht kennst. Der Punkt (0, 0) liegt oben links, (127, 63) unten rechts – das Display ist 128 Pixel breit und 64 Pixel hoch, gezählt wird ab 0.
Neben den bisher verwendeten Befehlen gibt es weitere Grafikbefehle, unter anderem diese:
u8g2.drawPixel(120, 32); // Einzelner Punkt bei (120,32) u8g2.drawFrame(35, 40, 20, 20); // Leeres Rechteck 20x20 ab (35,40) u8g2.drawBox(10, 10, 20, 20); // Gefülltes Rechteck 20x20 ab (10,10) u8g2.drawCircle(64, 32, 10); // Leerer Kreis um (64,32), Radius 10 u8g2.drawDisc(84, 32, 10); // Gefüllter Kreis um (84,32), Radius 10 u8g2.drawEllipse(80, 15, 20, 6); // Ellipse um (80,15), Radien 20 und 6 u8g2.drawFilledEllipse(80, 55, 20, 6); // Ebenso, aber gefüllt, um (80,55)
Beachte den Unterschied: Bei Rechtecken gibst du die obere linke Ecke und dann Breite und Höhe an, bei Kreisen und Ellipsen den Mittelpunkt und dann den Radius bzw. die beiden Radien.
Noch ein Detail zur Schrift: Bei drawStr() ist die y-Koordinate die Grundlinie der Buchstaben, nicht deren Oberkante. Ein Text bei y = 40 reicht also nach oben über diese Linie hinaus.
Vor dem ersten drawStr() muss mit setFont() eine Schriftart eingestellt sein. Die Schrift aus dem Beispiel kennt keine Umlaute und kein ß, denn die Endung _tr im Namen steht für einen eingeschränkten Zeichenvorrat. Brauchst du Umlaute, nimm eine Schrift mit der Endung _tf und den Befehl drawUTF8():
u8g2.setFont(u8g2_font_6x10_tf); // Schrift mit Umlauten u8g2.drawUTF8(0, 20, "Schöne Grüße"); // drawUTF8() statt drawStr()
Eine vollständige Übersicht über die Grafikbefehle findest du in der U8g2-Referenz.
Übung
Schreibe ein Programm, das aus einem Rechteck und Linien das „Haus vom Nikolaus“ auf das Display zeichnet!

