USB-Dateiübertragung (Updatemodus)
Im Updatemodus erscheint dein Roller am Computer als USB-Laufwerk. Kopiere die Dateien in den passenden Ordner, wirf das Laufwerk sicher aus, und der Roller verarbeitet sie automatisch.
Updatemodus aktivieren
Du kannst den Updatemodus am Display oder über die Kommandozeile starten.
Am Display
- Öffne das Menü mit zwei kurzen Zügen am linken Bremshebel.
- Wähle Einstellungen → System → Updatemodus ….
Über die Kommandozeile
lsc usb ums
Um wieder in den normalen Netzwerkmodus zu wechseln:
lsc usb normal
Updatemodus verlassen
Halte den linken Bremshebel drei Sekunden lang. Während der Vorbereitung zeigt das Display dafür Abbrechen; sobald das Laufwerk bereitsteht, heißt die Aktion Beenden.
- Während der Vorbereitung: Der Wechsel wird abgebrochen, bevor der USB-Anschluss umgeschaltet wird. Die Netzwerkverbindung bleibt bestehen.
- Wenn das Laufwerk aktiv ist: Der Roller schaltet den USB-Anschluss zurück in den Netzwerkmodus und verarbeitet die Dateien auf dem Laufwerk – genauso wie nach dem sicheren Auswerfen. Wirf das Laufwerk deshalb zuerst am Computer aus, damit alle Dateien vollständig geschrieben sind.
Andere Gesten beenden den Updatemodus nicht. Die rechte Bremse und der Sitzbankschalter werden absichtlich ignoriert, damit eine versehentliche Eingabe keine Übertragung unterbricht. Auch lsc usb normal beendet den Modus.
Dateien übertragen
- Öffne den Fußraum mit einem PH2-Kreuzschlitz- oder H4-Inbusschlüssel, um an das MDB zu gelangen. Sein Mini-B-Anschluss ist normalerweise mit dem internen DBC-USB-Kabel belegt.
- Löse die Sicherungsschraube des Kabels mit einem Schlitz- oder PH1-Schraubendreher und ziehe das interne DBC-USB-Kabel vom MDB ab.
- Verbinde deinen Computer mit diesem Mini-B-Anschluss.
- Auf dem Computer erscheint ein Laufwerk.
- Kopiere die Dateien in den passenden Ordner (siehe unten).
- Wirf das Laufwerk sicher aus. Der Roller verarbeitet die Dateien; ein Firmware-Update löst anschließend einen Neustart aus.
- Beende den Updatemodus, trenne den Computer und stecke das interne DBC-USB-Kabel wieder ein. Sichere es anschließend wieder mit der Schraube.
Das MDB sitzt im geöffneten Fußraum.
Ziehe das interne DBC-USB-Kabel ab, um den Mini-B-Anschluss freizugeben.
Nach der Verarbeitung wird das Laufwerk geleert; nur ums_log.txt bleibt erhalten. Die nächste Sitzung beginnt daher mit einem leeren Laufwerk.
Ordner auf dem Laufwerk
Der Roller legt diese Ordner beim Start des Updatemodus an. Ein leerer Ordner ist normal und kein Fehler.
| Pfad | Verwendung |
|---|---|
system-update/ | Firmware-Artefakte (.mender oder .delta) |
maps/ | Kartenanzeige- und Valhalla-Routing-Kacheln |
Kartenanzeige
Kopiere eine .mbtiles-Datei in maps/. Der Roller verwendet sie anschließend als Quelle für die Offline-Karte.
Vorgefertigte Karten findest du in den Librescoot OSM Tiles Releases.
Valhalla-Routing-Kacheln
Nutze vorzugsweise ein
.tar.zst-Release: Es verringert Download und USB-Übertragung, und der Roller entpackt es automatisch.
Kopiere das heruntergeladene Archiv unverändert in maps/. Der Roller akzeptiert Dateinamen, die auf tiles.tar oder tiles.tar.zst enden, etwa valhalla_tiles_<region>.tar.zst.
Vorgefertigte Routing-Kacheln findest du in den Librescoot Valhalla Tiles Releases.
Firmware-Updates
Kopiere .mender- oder .delta-Artefakte in system-update/, um Firmware ohne SIM-Karte zu installieren. Nur Firmware-Updates lösen einen Neustart aus; andere Änderungen werden durch den Neustart des jeweiligen Dienstes übernommen.
Fehlersuche
- Das Laufwerk erscheint nicht: Prüfe, ob der Roller im Updatemodus ist – am Display oder mit
lsc usb status. Versuche außerdem ein anderes USB-Kabel. - Dateien werden nach dem Auswerfen nicht übernommen: Prüfe, ob du das Laufwerk sicher ausgeworfen und nicht nur das Kabel abgezogen hast. Erst das Auswerfen löst die Verarbeitung aus.
- Der Roller startet nicht neu: Verbinde USB erneut und wirf das Laufwerk noch einmal aus, oder starte den Roller mit
lsc power rebootneu. Ein USB-Firmware-Update kannst du von Anfang an wiederholen. - Falscher Kanal oder falsche Kartenregion installiert: Der Roller übernimmt genau die kopierten Dateien. Ein Firmware-Artefakt aus einem anderen Release-Kanal wechselt auch in diesen Kanal. Lade die Artefakte oder Kacheln für den gewünschten Kanal und die gewünschte Region herunter und führe eine weitere Updatemodus-Sitzung durch.
Technischer Hintergrund für Wartung
Dieser Abschnitt richtet sich an Administratoren und Personen, die den Roller warten. Für den normalen Betrieb brauchst du ihn nicht.
Der ums-service auf dem MDB verwaltet den Updatemodus. Er schaltet den USB-Anschluss vom Netzwerkmodus (USB-Ethernet) in den USB-Mass-Storage-Modus und stellt eine eMMC-Partition als Wechsellaufwerk bereit. Beim Auswerfen erkennt der Dienst das Ereignis und verarbeitet die Bereiche in fester Reihenfolge: Einstellungen, WireGuard, radio-gaga, uplink-service, onboot.sh, Firmware-Updates, Karten und Skripte. Die Schritte sind unabhängig voneinander; ein Fehler in einem Schritt hält die übrigen nicht an. ums_log.txt protokolliert das Ergebnis jedes Schritts.
Neben den beiden Ordnern für Fahrer gibt es diese weiteren Dateien und Ordner:
| Pfad | Richtung | Verwendung |
|---|---|---|
scripts/mdb.sh, scripts/dbc.sh | zum Roller | Shell-Skripte, die einmal auf dem jeweiligen Board ausgeführt werden |
settings.toml | hin und zurück | Aktuelle Einstellungen zum Bearbeiten und anschließenden Einlesen |
wireguard/ | hin und zurück | WireGuard-Konfigurationen zum Bearbeiten und anschließenden Einlesen |
radio-gaga/config.yaml | hin und zurück | Konfiguration für die radio-gaga-Telemetrie |
uplink-service/config.yaml | hin und zurück | Konfiguration für uplink-service |
onboot.sh | hin und zurück | Skript, das der Roller bei jedem Start ausführt |
diagnostics/mdb/, diagnostics/dbc/ | vom Roller | journal.log und dmesg.log beider Boards, beim Aktivieren gesammelt |
log-bundles/ | vom Roller | Mit lsc erstellte Protokollpakete zum Herunterladen |
ums_log.txt | vom Roller | Protokoll der Verarbeitung; wird beim Verlassen geschrieben und beim Leeren des Laufwerks beibehalten |
Hin und zurück bedeutet: Beim Start legt der Roller die aktuelle Datei auf dem Laufwerk ab und liest sie beim Verlassen wieder ein. Bearbeite diese Datei direkt, statt eine neue anzulegen. Ohne Änderung bleibt die Konfiguration unverändert.
Konfiguration
Änderungen an settings.toml oder Dateien unter wireguard/ starten librescoot-settings neu. Änderungen an radio-gaga/config.yaml starten radio-gaga neu; Änderungen an uplink-service/config.yaml starten librescoot-uplink neu. Unveränderte Dateien lösen keinen Neustart aus.
Skripte
Die Skripte mdb.sh und dbc.sh unter scripts/ werden jeweils einmal auf dem Board ausgeführt, das ihr Name angibt. Aktionen für das DBC werden übersprungen, wenn das DBC nicht erreichbar ist.
Skripte laufen als root
Es gibt weder eine Sandbox noch eine Signaturprüfung. Lege dort nur Skripte ab, die du selbst geschrieben hast oder deren Quelle du vertraust.