Arduino UNO Q vor einem Laptop mit Arduino App Lab und Terminal, cat /etc/os-release zeigt Debian 13 Trixie

Das Debian-Linux des Arduino UNO Q: SSH, Terminal & Co.

Der spannendste Teil des Arduino UNO Q ist für uns Raspberry-Pi-Bastler nicht der Mikrocontroller, sondern das, was daneben sitzt: ein vollwertiges Debian Linux auf dem Qualcomm-Prozessor. In diesem Artikel steigen wir in genau dieses System ein – ich zeige euch alle Wege in die Shell (SSH, ADB über USB und das Terminal in App Lab), wie ihr Dateien aufs Board bekommt, was ihr zur Systempflege wissen müsst und welche Spezialwerkzeuge Arduino mitliefert, die es auf keinem anderen Linux-Board gibt.

Der Artikel ist Teil unserer UNO-Q-Serie: Die Grundeinrichtung mit App Lab haben wir im Setup-Artikel erledigt, wie sich das Board insgesamt schlägt, lest ihr im großen Test gegen den Raspberry Pi 5. Alle Teile sammle ich in der Arduino-Kategorie.

Den UNO Q hat mir Arduino kostenlos als Testgerät zur Verfügung gestellt, auf den Inhalt hat das keinen Einfluss.

Kurz zusammengefasst: So kommt ihr auf das Linux des UNO Q

Auf dem Arduino UNO Q läuft ein vollständiges Debian 13 („Trixie“, arm64). In die Shell führen drei Wege: das eingebaute Terminal in Arduino App Lab, ADB über das USB-C-Kabel (adb shell, ganz ohne Netzwerk) und klassisches SSH über das WLAN mit ssh arduino@<boardname>.local. Der Benutzer heißt immer arduino; SSH aktiviert das Board automatisch bei der Ersteinrichtung.

Was auf dem UNO Q eigentlich läuft

Auf der Linux-Seite des UNO Q arbeitet ein echtes Debian 13 („Trixie“) für die arm64-Architektur – kein abgespecktes Embedded-System, sondern dieselbe Distribution mit denselben Paketquellen, die ihr von Servern und Desktops kennt. Arduino pflegt dafür sogar Upstream-Support im Linux-Kernel. Parallel dazu läuft der STM32-Mikrocontroller mit euren Sketches einfach weiter – die beiden Welten sind über eine interne Bridge verbunden, funken sich aber nicht gegenseitig dazwischen.

Wer vom Raspberry Pi kommt, fühlt sich sofort zu Hause – ein paar Konventionen sind aber anders, und die solltet ihr kennen, bevor ihr Tutorials vom Pi eins zu eins übertragt:

Raspberry PiArduino UNO Q
BetriebssystemRaspberry Pi OS (Debian-Derivat)Debian 13 „Trixie“ (pur, arm64)
Standard-Benutzerfrei wählbar (früher pi)immer arduino
System-Konfigurationraspi-configarduino-linux-config + App Lab
Boot-MediummicroSD / NVMe / USBfest verlöteter eMMC (16/32 GB)
OS installierenRaspberry Pi ImagerFlash-Funktion in App Lab
GPIO-Zugriffdirekt aus Linuxgehört primär dem Mikrocontroller

Der letzte Punkt ist der wichtigste: Beim Pi steuert ihr GPIO-Pins direkt aus Linux heraus, beim UNO Q sind die Pins Sache des STM32 – Linux redet über die interne RPC-Bridge mit ihm. Warum das für zeitkritische Aufgaben sogar ein Vorteil ist, haben wir im Testbericht nachgemessen.

Das braucht ihr

  • einen Arduino UNO Q, der die Ersteinrichtung mit App Lab durchlaufen hat (dabei werden WLAN, Boardname und das Linux-Passwort gesetzt)
  • ein USB-C-Datenkabel* für den ADB-Weg (reine Ladekabel funktionieren nicht)
  • für SSH: Rechner und Board im selben WLAN
Mit * markierte Links sind Affiliate-Links, also Werbung. Kauft ihr darüber ein, erhalte ich eine Provision, der Preis bleibt für euch gleich. Als Amazon-Partner verdiene ich an qualifizierten Verkäufen. Mehr dazu

Falls ihr noch kein Board habt: Den UNO Q gibt es mit 4 GB* oder 2 GB*, als offizielles Bundle auch als UNO Q 4GB mit 45-W-Netzteil*.

Weg 0: Das Terminal direkt in App Lab

Der schnellste Weg für zwischendurch: Arduino App Lab bringt für verbundene Boards einen direkten Terminal-Zugriff mit – ihr klickt euch also einfach aus der gewohnten Oberfläche in die Shell, ohne irgendetwas zu installieren. Für kurze Kommandos ist das perfekt; sobald ihr aber ernsthaft im System arbeitet, Dateien kopiert oder das Board headless irgendwo im Regal liegt, wollt ihr einen der beiden „richtigen“ Wege.

Per USB verbunden reicht ein Klick auf das Terminal-Symbol unten links – ihr landet ohne weitere Anmeldung direkt als Benutzer arduino in der Shell:

Arduino App Lab Terminal-Fenster mit uname -a auf dem UNO Q, Terminal-Button unten links markiert
Ein Klick auf das Terminal-Symbol unten links öffnet die Shell des Boards – uname -a zeigt den aktuellen Kernel 6.16 auf arm64.

Das Ganze funktioniert sogar ohne USB-Kabel: Hängt das Board im WLAN, findet App Lab es im Network Mode automatisch. Beim ersten Terminal-Zugriff über das Netzwerk fragt App Lab dann einmalig nach den Linux-Zugangsdaten – und wenn ihr genau hinschaut, seht ihr im Terminal-Fenster, was dahintersteckt: eine ganz normale SSH-Anmeldung an der IP-Adresse des Boards. App Lab nimmt euch hier also nur das ab, was wir gleich selbst machen.

Arduino App Lab Startbildschirm zeigt den UNO Q im Network Mode mit WLAN-Symbol
Hängt das Board im WLAN, findet App Lab es auch ohne USB-Kabel – erkennbar am WLAN-Symbol an der Board-Karte.
Arduino App Lab Dialog Linux Credentials mit Benutzer arduino und Passwortfeld
Beim ersten Netzwerk-Zugriff fragt App Lab einmalig nach den Linux-Zugangsdaten – Benutzer arduino plus euer Passwort aus der Ersteinrichtung.
Arduino App Lab Terminal über WLAN mit SSH-Passwortabfrage an die IP-Adresse des UNO Q
Terminal über WLAN: Unter der Haube meldet sich App Lab per SSH an der IP-Adresse des Boards an.

Ein Praxis-Tipp aus meinem Test: Direkt nach dem WLAN-Setup tauchte das Board bei mir zunächst gar nicht im Network Mode auf. Die Lösung war unspektakulär – ein paar Minuten warten und App Lab einmal neu starten, danach stand die Board-Karte samt WLAN-Symbol da. Die mDNS-Erkennung im Netzwerk braucht manchmal schlicht einen Moment; erst danach lohnt die Fehlersuche.

Weg 1: ADB über USB-C – ohne Netzwerk in die Shell

ADB steht für Android Debug Bridge – ein Erbe des Qualcomm-Chips, dessen Werkzeugkette aus der Smartphone-Welt stammt. Keine Sorge: Auf dem UNO Q läuft kein Android, ADB ist hier einfach ein sehr bequemer Weg, über das USB-Kabel eine Shell zu öffnen. Der große Vorteil: Es funktioniert komplett ohne Netzwerk – ideal, wenn das WLAN zickt oder ihr das Board gerade erst aus der Schachtel geholt habt.

Auf dem Rechner braucht ihr die Google Platform Tools. Unter Windows reicht ein Befehl im Terminal:

winget install Google.PlatformTools

Unter macOS übernimmt das brew install android-platform-tools, unter Debian/Ubuntu sudo apt install android-sdk-platform-tools. Danach Board per USB-C anschließen und prüfen, ob es erkannt wird:

adb devices
adb shell

adb devices listet das Board mit seiner Seriennummer auf, adb shell öffnet dann die Shell – ihr landet direkt als Benutzer arduino im System. Mit exit geht es zurück auf den eigenen Rechner. Drei Stolpersteine solltet ihr kennen:

  • Geduld nach dem Anstecken: Es kann bis zu einer Minute dauern, bis das Board in adb devices auftaucht.
  • Passwort-Abfrage: Nur solange die Ersteinrichtung noch nicht durchlaufen ist, fragt adb shell nach einem Passwort – das lautet ab Werk arduino. Nach dem Setup gilt euer selbst vergebenes Linux-Passwort.
  • Linux-Rechner: Hier braucht es einmalig die udev-Regeln aus dem App-Lab-Paket (sudo ./post_install.sh), sonst blockiert das System den USB-Zugriff – das kennt ihr schon aus dem Setup-Artikel.

Weg 2: SSH über das WLAN – der Klassiker

Sobald das Board im WLAN hängt, geht es auch ganz ohne Kabel – mit demselben SSH, das ihr vom Raspberry Pi kennt. Das Schöne: Anders als beim Pi müsst ihr SSH nicht erst aktivieren. Die Ersteinrichtung in App Lab schaltet SSH automatisch frei, zusammen mit dem Network Mode, über den App Lab das Board im Netz findet. Der SSH-Client ist bei Windows 10/11, macOS und Linux ohnehin an Bord.

Zum Verbinden braucht ihr nur den Boardnamen aus der Ersteinrichtung und euer Linux-Passwort:

ssh arduino@<boardname>.local

Beim allerersten Verbinden bestätigt ihr den Host-Key mit yes, dann Passwort eingeben – fertig, ihr seid drin. Heißt euer Board also zum Beispiel unoq, lautet der Befehl ssh arduino@unoq.local.

SSH-Sitzung auf dem Arduino UNO Q mit cat /etc/os-release und Debian 13 Trixie
SSH-Login auf den UNO Q (hier mit PuTTY über die IP-Adresse): cat /etc/os-release bestätigt Debian 13 „Trixie“.

Wenn .local nicht funktioniert (mDNS-Probleme)

Die .local-Adresse funktioniert über mDNS – und das blockieren manche Netzwerke oder Router-Einstellungen. Wenn die Verbindung mit „Connection refused“ oder einem Timeout scheitert, verbindet euch stattdessen direkt über die IP-Adresse. Die findet ihr auf drei Wegen:

  • Über ADB: Per USB-Kabel adb shell öffnen und auf dem Board hostname -I ausführen – die erste Adresse ist eure.
  • Über die Fritzbox: Unter Heimnetz → Netzwerk taucht das Board mit seinem Namen auf, die IP steht direkt daneben. Dort könnt ihr ihm auch gleich „Immer die gleiche IP zuweisen“ spendieren – dann bleibt die Adresse dauerhaft gültig.
  • Über App Lab: Das Board taucht dort im Network Mode samt Netzwerk-Details auf.

Mit der IP lautet der Befehl dann zum Beispiel ssh arduino@192.168.178.42. Und noch ein Klassiker: Wenn ihr das Board irgendwann neu geflasht habt, verweigert SSH die Verbindung mit einer Host-Key-Warnung („REMOTE HOST IDENTIFICATION HAS CHANGED“). Dann den alten Schlüssel einmal löschen:

ssh-keygen -R <boardname>.local

Dateien übertragen mit scp

Für den Dateitransfer nutzt ihr scp – das läuft über dieselbe SSH-Verbindung und ist bei den SSH-Clients automatisch dabei. Wichtig: Die Befehle führt ihr auf eurem Rechner aus, nicht in der SSH-Sitzung auf dem Board. Eine Datei zum Board schieben und wieder abholen sieht so aus:

scp messwerte.py arduino@<boardname>.local:/home/arduino/
scp arduino@<boardname>.local:/home/arduino/log.txt .

Ganze Ordner nehmt ihr mit scp -rp mit (rekursiv, Zeitstempel und Rechte bleiben erhalten). Ein Ziel solltet ihr dabei kennen: Im Home-Verzeichnis liegt der Ordner ~/ArduinoApps/ – dort speichert App Lab jedes eurer Projekte in einem eigenen Unterordner. Wer seine Apps sichern oder von Hand bearbeiten will, ist hier richtig.

Weg 3: Monitor dran – der UNO Q als Mini-Rechner

Der Vollständigkeit halber: Mit einem USB-C-Dock mit Power Delivery – etwa dem offiziellen Arduino-Dock* (ca. 23 €) – wird der UNO Q zum eigenständigen Single-Board-Computer mit Debian-Desktop – Monitor, Tastatur, Maus dran und das Terminal läuft direkt auf dem Board. Für die tägliche Arbeit am System ist das aber der umständlichste Weg, und Arduino empfiehlt dafür die 4-GB-Variante. Für ganz harte Fälle gibt es zusätzlich eine Debug-UART-Schnittstelle auf der Platine, über die ihr schon die Boot-Meldungen seht, bevor SSH überhaupt verfügbar ist – das braucht ihr im Alltag nicht, es ist aber gut zu wissen, dass es die Hintertür gibt.

Debian in Schuss halten

Da auf dem UNO Q ein normales Debian läuft, gilt die gewohnte Systempflege – Updates holt ihr wie beim Pi mit apt (die Arduino-eigenen Komponenten aktualisiert zusätzlich App Lab über seine Update-Funktion):

sudo apt update && sudo apt full-upgrade

Genauso funktionieren die üblichen Bordmittel: htop zeigt euch, was die vier A53-Kerne und der RAM gerade treiben (spannend, während parallel eine App-Lab-App läuft), df -h behält den eMMC-Speicher im Auge – bei 16 GB in der kleinen Variante ist der schneller voll, als man denkt. Das WLAN verwaltet NetworkManager, mit nmcli device seht ihr den Verbindungsstatus.

Und wie beim Pi mit seiner SD-Karte gilt auch hier: nicht einfach den Stecker ziehen. Der eMMC verzeiht zwar viel, aber fahrt das System vorher mit sudo halt herunter und wartet 10–15 Sekunden, bevor ihr den Strom trennt – die grüne Power-LED leuchtet dabei weiter, das ist normal. Ein sudo shutdown -h now wie beim Pi fährt Debian zwar ebenfalls sauber herunter, startet den UNO Q danach aber automatisch neu.

Die Arduino-Spezialwerkzeuge: app-cli und linux-config

Jetzt zum Teil, den es nur auf dem UNO Q gibt. Arduino liefert zwei Kommandozeilen-Werkzeuge mit, die das Board von einem gewöhnlichen Debian-Rechner unterscheiden. Das erste ist arduino-app-cli – damit steuert ihr eure App-Lab-Apps komplett ohne die Desktop-Anwendung, also auch headless per SSH:

arduino-app-cli app list
arduino-app-cli app start examples:blink
arduino-app-cli app stop examples:blink
arduino-app-cli system network-mode status

Damit wird das Board zum autarken Projektrechner: App per SSH starten, ausloggen, läuft. Über system network-mode enable lässt sich auch der Netzwerkmodus (und damit SSH) nachträglich aktivieren, falls ihr die Ersteinrichtung mal übersprungen habt. Das zweite Werkzeug ist sudo arduino-linux-config – Arduinos Antwort auf raspi-config, allerdings ohne Menü-Oberfläche. Aktuell konfiguriert ihr darüber vor allem Erweiterungs-Boards wie den Media Carrier samt Kameras und Displays; dazu bald mehr in einem eigenen Artikel der Serie.

Finger weg von diesen beiden Dingen

Beim Aufräumen im System zwei Ausnahmen beachten: Der Systemdienst arduino-router ist die Brücke zwischen Linux und dem Mikrocontroller – wer ihn abschaltet, kappt die Verbindung zu den Sketches. Und die Docker-Container, die euch docker ps womöglich anzeigt, gehören zu App Lab (darin laufen die Bricks) – nicht löschen, auch wenn sie Speicherplatz kosten.

Ein Minimum an Sicherheit

Zwei Handgriffe lohnen sich bei jedem Board, das dauerhaft im Netz hängt: Falls euer Linux-Passwort aus der Ersteinrichtung eher pragmatisch gewählt war, ändert es mit passwd. Und wer sich das Passwort-Tippen sparen will, hinterlegt seinen SSH-Schlüssel – unter Windows kopiert ihr dazu den Inhalt eurer id_ed25519.pub in die Datei ~/.ssh/authorized_keys auf dem Board, unter macOS/Linux erledigt das ssh-copy-id arduino@<boardname>.local in einem Rutsch. Wer tiefer einsteigen will: Arduino hat einen eigenen Security-Hardening-Guide für den UNO Q veröffentlicht.

Wie es weitergeht

Damit habt ihr das Fundament für alles, was auf der Linux-Seite des UNO Q noch kommt: Shell-Zugriff auf drei Wegen, Dateitransfer, Systempflege und die Arduino-eigenen Werkzeuge. In den nächsten Teilen der Serie nehmen wir uns App Lab und die Bricks im Detail vor und schauen uns den Media Carrier mit Kamera und Display an – und genau auf dem Wissen aus diesem Artikel bauen auch Projekte wie ein kleiner Heimserver auf dem UNO Q auf. Alle Artikel findet ihr in der Arduino-Kategorie. Viel Spaß beim Ausprobieren!

Häufige Fragen zum Linux des Arduino UNO Q

Welches Linux läuft auf dem Arduino UNO Q?

Ein vollständiges Debian 13 („Trixie“) für die arm64-Architektur – keine abgespeckte Sonderdistribution. Arduino pflegt Upstream-Support im Linux-Kernel; die Paketquellen sind die normalen Debian-Repositories. Neu flashen lässt sich das System über die Flash-Funktion von Arduino App Lab.

Wie aktiviere ich SSH auf dem UNO Q?

Gar nicht – die Ersteinrichtung in Arduino App Lab schaltet SSH automatisch frei. Danach verbindet ihr euch mit ssh arduino@<boardname>.local und dem Linux-Passwort aus dem Setup. Wurde die Einrichtung übersprungen, lässt sich der Netzwerkmodus per USB nachrüsten: adb shell öffnen und arduino-app-cli system network-mode enable ausführen.

Wie lauten Benutzername und Standard-Passwort des UNO Q?

Der Linux-Benutzer heißt immer arduino. Ab Werk – also nur solange die Ersteinrichtung noch nicht durchlaufen ist – lautet das Passwort ebenfalls arduino. Bei der Einrichtung vergebt ihr ein eigenes Passwort, das ihr jederzeit mit dem Befehl passwd ändern könnt.

Kann ich den UNO Q ohne App Lab nutzen?

Ja. Über SSH oder ADB arbeitet ihr direkt im Debian-System, und mit dem mitgelieferten Werkzeug arduino-app-cli startet und stoppt ihr eure Apps auch headless von der Kommandozeile (zum Beispiel arduino-app-cli app start examples:blink). App Lab braucht ihr vor allem für die Ersteinrichtung, Updates und das Flashen des Systems.

Läuft ein Linux-Desktop auf dem UNO Q?

Ja, im Single-Board-Computer-Modus: Über ein USB-C-Dock mit Power Delivery schließt ihr Monitor, Tastatur und Maus an und arbeitet direkt auf dem Debian-Desktop des Boards. Arduino empfiehlt dafür die Variante mit 4 GB RAM – mit 2 GB wird der Desktop zäh.

Ähnliche Beiträge