Pflichtversuche mit dem Beagle Bone Black

1   Vorkenntnisse

1. Üben Sie das Arbeiten auf der Kommandozeile. Der typische Zugang zu einem Embedded Linux Rechner ist fast immer mit ssh auf der Kommandozeile -- ohne grafische Oberfläche. Sie können das sehr gut auf dem PC/Notebook simulieren, wenn Sie eine Linux Distribution ohne grafische Oberfläche installieren, auch gerne virtuell über VirtualBox, z.B. Debian 10 Server Image, 64bit, https://www.osboxes.org/debian.
2. Bereiten Sie den Hostrechner (d.h. Ihr PC/Notebook) zur Arbeit mit dem BBB vor (Terminalemulator z.B. picocom oder kermit, NFS, Crosscompiler, Netzwerkeinrichtung, ...)
3. Machen Sie sich mit den wichtigsten Bauteilen und Schnittstellen auf dem BBB vertraut.

2   Das BBB im Betrieb kennenlernen

Normalerweise sollte im eMMC Speicher ein lauffähiges Linux vorhanden sein. Früher war das ein Angstrom Linux, aktuell ist es ein Debian Linux. Falls das BBB nicht aus dem eMMC Speicher bootet, installieren Sie zunächst den eMMC Speicher neu (aktuell ist es ein Debian 10.3).

1. Lernen Sie den schematischen Aufbau des Boards kennen mit den wesentlichen Bausteinen, die darauf sind (Blockschaltbild).

2. Üben Sie häufig wiederkehrende Aufgaben

   1. Terminalprogramm mit serieller Schnittstelle verbinden (siehe den Abschnitt unten zur Konsole)
   2. Einloggen
   3. Bootmeldungen betrachten (dmesg)
   4. Welches Linux haben Sie? (Typ, Version)
   5. Useraccount mit adduser einrichten (nicht als Root arbeiten)
   6. Systemzeit setzen mit date und ntpdate

   7. Machen Sie sich mit systemd vertraut.

      Übersicht: https://www.linuxtrainingacademy.com/systemd-cheat-sheet

      • Viewing Systemd Information
      • Working with Services
      • Viewing Log Messages
      • Zeiteinstellungen mit timedatectl

   8. Netzwerkverbindung herstellen. Verschiedene Varianten ausprobieren:

      • mit USB Kabel
      • mit Kabel über eth Schnittstelle
      • mit WiFi, z.B. über einen USB WiFi Adapter. Ich kann den TPLINK TL-WN725N empfehlen.
   9. Gehen Sie mit ssh und http auf das Board.
   10. Dateien mit scp zwischen Host und Target übertragen
   11. Vom Target aus über den Hostrechner eine Netzwerkverbindung in das Internet herstellen (ip, iw, ifconfig, iwconfig, wpa_supplicant)
   12. System auf der Kommandozeile u.a. mit procfs erforschen (ls, ps, tree, cat, less, vi, uname, mount, df, du, fdisk, ...)

3. "Erforschen" Sie das Linux auf dem BBB über die ssh oder Konsolenverbindung:

   • Welches Linux wird verwendet?
   • Welche Prozesse (Dienste) laufen? Welche Aufgabe haben diese Prozesse?
   • Welche Pakete sind installiert?
   • Wie viel Platz belegt das Root Filesystem?

3   Flash Speicher

1. Wie behandelt man eine rohe SD Karte mit fdisk und mkfs.vfat bzw. mkfs.ext4, so dass man darauf ein bootfähiges Linux installieren kann?
2. Wie bootet man von der SD Karte?

3. Wie kann man den eMMC Speicher komplett neu mit einem Linux beschreiben? Vorher sollte man ein Backup des aktuellen eMMC Speicher machen!

   Tipp: Es geht mit einem "Flasher Image", das man unter https://beagleboard.org/latest-images bekommt.

4   Konsole

1. Schliessen Sie einen UART-zu-USB Adapter an der 6-poligen Pfostenleiste auf dem BBB an, so dass man die Konsole auf dem Hostrechner sehen kann. Das Terminalprogramm picocom starten mit

   picocom -b 115200 /dev/ttyUSB0

   (aufpassen: Manche Linux Distributionen verwenden nur 9600 Baud)

   Welchen Vorteil hat diese Konsole im Vergleich mit der ssh Verbindung über USB bzw. Netzwerkkabel?

5   Hostrechner

1. Mounten Sie das Homeverzeichnis des BBB mit sshfs auf dem Hostrechner.

2. Installieren Sie auf dem Hostrechner eine Cross-GCC Toolchain und kompilieren Sie ein kleines Demoprogramm. Übertragen Sie es mit scp auf das BBB und führen Sie es aus. Die einzelnen Programme des Cross-GCC haben den Präfix arm-linux-gnueabihf-.

   Auf Ubuntu und verwandten Linuxen gibt es das Paket gcc-arm-linux-gnueabi. Das ist der einfachste Weg um zu einer Toolchain zu kommen. Eine Alternative ist das "Crosstool-NG": http://crosstool-ng.github.io (so macht es Simmonds in MELP). Ein dritter Weg ist die "Linaro Toolchain", https://www.linaro.org/downloads.

   Falls Sie einen C Compiler auf dem BBB haben, kompilieren Sie das Programm auch nativ und testen Sie es.

6   U-Boot

1. Stoppen Sie den Bootvorgang in der Konsole, so dass Sie auf dem U-Boot Prompt landen.

   • Wie sieht man die U-Boot Umgebungsvariablen an?
   • Booten Sie auf dem U-Boot Prompt vom eMMC Speicher.
   • Booten Sie auf dem U-Boot Prompt von der MicroSD Karte.
   • Booten Sie auf dem U-Boot Prompt über das Netzwerk mit tftp oder nfs.
2. Kompilieren Sie den U-Boot Bootloader aus den aktuellen git Quellen und Updaten Sie ihn auf dem Board.

7   Schnittstellen

1. Einfache I/O Demo mit Taster und LED:

   1. GPIO ueber sysfs einlesen (polling/interrupt) und ausgeben
   2. Tastendruck wird als Event ueber sysfs erkannt und schaltet LED ein und aus

   3. Ein Demo-Geraetetreiber faengt den Tastendruck als Interrupt ab und schaltet die LED ein- und aus.

      Lit.: http://derekmolloy.ie/writing-a-linux-kernel-module-part-1-introduction

   GPIOs werden in Molloy, Kap. 6 behandelt.

2. Machen Sie ein einfaches Programm zum Ansteuern der seriellen Schnittstelle in C/C++ und Python. Sie sollten die Schnittstelle öffnen, ein paar Zeichen schreiben und danach lesen, am Ende wieder schliessen. Man sollte den Code mit einer simplen Verbindung zwischen dem TX- (senden) und RX-Signal testen können.

   Hilfreich sind folgende Texte:

   • http://tldp.org/HOWTO/Serial-Programming-HOWTO
   • https://pythonhosted.org/pyserial

   Der UART wird in Molloy, Kap. 8 behandelt.

3. Machen Sie sich mit den Bussen I2C und SPI vertraut. Beide werden in Molloy, Kap. 8 behandelt.

   Auch 1-Wire Bus wäre eine gute Wahl an Hand des Temperatursensors DS18B20.

   Ein Tutorial von vielen im Netz zu 1-Wire: http://www.bonebrews.com/temperature-monitoring-with-the-ds18b20-on-a-beaglebone-black/

8   Build-Umgebungen

Das ist ungefähr der Inhalt von Simmonds MELP, ch. 6 "Selecting a Build System".

1. Bauen Sie ein Root-Filesystem mit Kernel und U-Boot aus den folgenden Distributionen:

   • Buildroot
   • Yoctoproject

   Installieren Sie es auf einer MicroSD-Karte und testen Sie es auf dem BBB. Es soll auch der Bootloader U-Boot und die Cross-Toolchain dabei entstehen.

2. Aufgaben mit dem Kernel in der Bau-Umgebung

   • Konfigurieren
   • Vorhandene Treiber aktivieren/deaktivieren
   • Eigenen (Dummy) Treiber einbauen
   • Updaten auf eine andere Kernel Version

3. Aufgaben mit dem Root Filesystem in der Bau-Umgebung

   • Pakete aktivieren/deaktivieren
   • Eigene Pakete einbauen

9   Programmieraufgaben

Diese Aufgaben sollen als "Vorübung" zum Projekt verstanden werden (siehe ElinuxProjekt).

10   Tipps für die Kommandozeile

tty        tty21      tty35      tty49      tty62      ttyS12     ttyS26
tty0       tty22      tty36      tty5       tty63      ttyS13     ttyS27
tty1       tty23      tty37      tty50      tty7       ttyS14     ttyS28
tty10      tty24      tty38      tty51      tty8       ttyS15     ttyS29
tty11      tty25      tty39      tty52      tty9       ttyS16     ttyS3
tty12      tty26      tty4       tty53      ttyACM0    ttyS17     ttyS30
tty13      tty27      tty40      tty54      ttyACM1    ttyS18     ttyS31
tty14      tty28      tty41      tty55      ttyACM2    ttyS19     ttyS4
tty15      tty29      tty42      tty56      ttyACM3    ttyS2      ttyS5
tty16      tty3       tty43      tty57      ttyACM4    ttyS20     ttyS6
tty17      tty30      tty44      tty58      ttyprintk  ttyS21     ttyS7
tty18      tty31      tty45      tty59      ttyS0      ttyS22     ttyS8
tty19      tty32      tty46      tty6       ttyS1      ttyS23     ttyS9
tty2       tty33      tty47      tty60      ttyS10     ttyS24     ttyUSB0
tty20      tty34      tty48      tty61      ttyS11     ttyS25

Bus 003 Device 010: ID 1d6b:0104 Linux Foundation Multifunction Composite Gadget

Bus 003 Device 011: ID 0403:6001 Future Technology Devices International, Ltd FT232 Serial (UART) IC

udevadm info -q property -n /dev/ttyACM4

picocom -b 115200 /dev/ttyUSB0    # Konsolen-UART (USB Kabel von FTDIChip)
picocom -b 115200 /dev/ttyACM4    # USB Anschluss des BBB

$ lsblk
...
sdd      8:48   1   3,7G  0 disk
├─sdd1   8:49   1   100M  0 part /media/hhoegl/BOOT
└─sdd2   8:50   1   3,6G  0 part /media/hhoegl/ROOT
...