Embedded Systems 2 FAQ

2.1   Einloggen

VPN Verbindung zur Hochschule aufbauen

ssh <rzlogin>@rtlab-remote.informatik.hs-augsburg.de

In ~/.bashrc aufnehmen:

export PATH=/opt/openocd-dev/bin:/opt/gcc-arm-none-eabi-9-2020-q2-update/bin:$PATH
. /opt/py_venv3.8.3/bin/activate

Datei einlesen mit . ~/.bashrc. Nun sollte das Kommando estool zur Verfügung stehen.

2.2   Beispiel "starter" von gitlab holen und kompilieren

git clone ssh://git@gitlab.informatik.hs-augsburg.de:2222/es2/es2-nucl476/starter.git

Dazu muss vorher der öffentliche ssh Schlüssel in gitlab eingetragen worden sein.

In das Verzeichnis starter wechseln mit cd starter

Das Programm mit make kompilieren. Die Ausgabe sollte so ausschauen:

(py_venv3.8.3) hhoegl@gorilla:~/gorilla/starter$ make
[MKDIR] obj
mkdir -p obj
[CC] startup.c
arm-none-eabi-gcc -g3 -Wall -Wpedantic -Wextra -std=gnu99 -mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16  -c -o obj/startup.o Src/startup.c
[CC] osc.c
arm-none-eabi-gcc -g3 -Wall -Wpedantic -Wextra -std=gnu99 -mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16  -c -o obj/osc.o Src/osc.c
[CC] usart.c
arm-none-eabi-gcc -g3 -Wall -Wpedantic -Wextra -std=gnu99 -mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16  -c -o obj/usart.o Src/usart.c
[CC] itoa.c
arm-none-eabi-gcc -g3 -Wall -Wpedantic -Wextra -std=gnu99 -mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16  -c -o obj/itoa.o Src/itoa.c
[CC] main.c
arm-none-eabi-gcc -g3 -Wall -Wpedantic -Wextra -std=gnu99 -mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16  -c -o obj/main.o Src/main.c
arm-none-eabi-gcc  -TSTM32L476RG_FLASH.ld -Wl,-Map,main.map -nostdlib -mcpu=cortex-m4 -mthumb -mfloat-abi=hard -mfpu=fpv4-sp-d16 -nostartfiles -o main.elf obj/startup.o obj/osc.o obj/usart.o obj/itoa.o
obj/main.o
[SIZE] main.elf
arm-none-eabi-size main.elf
  text    data     bss     dec     hex filename
  1280       8    1572    2860     b2c main.elf
arm-none-eabi-objcopy -Obinary main.elf main.bin
arm-none-eabi-objdump -S main.elf > main.lst

2.3   Board mit estool verwalten

Prüfen

$ estool  --bs-check
Board server running
No board reserved

Reservieren

Die Boards werden durch die Zahlen 0, 1, 2, 3 gekennzeichnet. Das erste Board hat also die Id 0. Man kann nur ein Board zu einer Zeit reservieren.

$ estool --bs-reserve
Reserved board 0 for user hhoegl
Started Openocd (pid 2382)

Prüfen

$ estool --bs-check
Board server running
Board 0 reserved for user hhoegl
Openocd is running (pid=2382, telnet_port=4445 gdb_port=3334)
Usage time: 2/20 min
Board Access (use VPN!):
- Webcam (Video Stream): http://rtlab-remote.informatik.hs-augsburg.de:8091 (nur HTTP, kein HTTPS!)
- Saleae Logic (VNC): rtlab-remote.informatik.hs-augsburg.de:5901
- Nucleo serial port: /dev/rtlab/nucleo1_tty

Freigeben

$ estool --bs-free
Freeing board 0 for user hhoegl

Board zurücksetzen

$ estool --bs-erc reset

Eingänge einlesen

$ estool --bs-erc leds

Ausgänge setzen

$ estool --bs-erc buttons=8     # user button druecken (log. 0) ...
$ estool --bs-erc buttons=0     # ... und wieder loslassen (log. 1)

Ausgänge lesen

$ estool --bs-erc buttons

2.4   Programm flashen und ausführen

$ make flash

2.5   Serielle Schnittstelle

Die serielle Schnittstelle zum Ziel-Mikroprozessor wird über die Gerätedatei geöffnet, die beim Kommando --bs-check als "Nucleo serial port: ..." angezeigt wird. Wenn diese Gerätedatei z.B. /dev/rtlab/nucleo1_tty ist, dann kann man auf dem Server das Kommando

$ picocom -b 9600 /dev/rtlab/nucleo1_tty

verwenden. Die Zahl 9600 ist die Baudrate. Sie muss identisch sein mit der Baudrate, die auf dem Mikrocontroller programmiert wurde. Picocom beendet man mit Ctrl-A-X (Ctrl drücken, dann nacheinander A und X).

Es sind ausserdem die Programme minicom und putty installiert.

Es gibt noch eine zweite Möglichkeit: Dazu gibt man einfach estool --termemu ein. Das wird im Makefile beim Target make serial verwendet. In diesem Fall ist das Kommando in .estool/estool.yaml vorkonfiguriert. Der übliche Eintrag in dieser Datei ist:

termemu-command: [picocom, -b, '9600', --quiet, '{termemu_device}']

Den Platzhalter {termemu_device} füllt estool selber aus mit der aktuellen Gerätedatei zur seriellen Schnittstelle. Man kann dieses Kommando jederzeit ändern. Wichtig ist, dass man die korrekte Schreibweise (eckige Klammern, Komma) einhält.

2.6   Board über Webcam betrachten

VPN Verbindung zur Hochschule aufbauen.

Den Webcam-Videostrom betrachtet man z.B. mit vlc:

vlc http://rtlab-remote.informatik.hs-augsburg.de:8091 kein HTTPS!)

Hinweis: Der genaue URL wird von estool --bs-check ausgegeben, falls Board reserviert wurde.

2.7   GUI des Saleae Logikanalysators betrachen

Das Programm Logic läuft auf dem rtlab-remote Rechner.

Einen VNC Client installieren, z.B. Tiger-VNC oder Remmina.

Tiger VNC: apt install tigervnc-viewer tigervnc-common

VPN Verbindung zur Hochschule aufbauen

$ vncviewer rtlab-remote.informatik.hs-augsburg.de:5901

Als Passwort mypasswd eingeben.

Hinweis: IP-Nummer und Port wird von estool --bs-check ausgegeben, falls Board reserviert wurde.

2.8   Boardserver

Auf dem rtlab-remote Server läuft das Programm boardserver im Hintergrund, es erledigt alle Sachen die beim Reservieren und Freigeben der Boards nötig sind. Der Quelltext (Python) ist frei, siehe

https://gitlab.informatik.hs-augsburg.de/hhoegl/boardserver

Auch estool kann man sich ansehen, siehe

https://gitlab.informatik.hs-augsburg.de/hhoegl/estool

Für Verbesserungen und Fehlerberichte bin ich immer dankbar.