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

  1. Öffne das Menü mit zwei kurzen Zügen am linken Bremshebel.
  2. Wähle EinstellungenSystemUpdatemodus ….

Ü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

  1. Ö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.
  2. Löse die Sicherungsschraube des Kabels mit einem Schlitz- oder PH1-Schraubendreher und ziehe das interne DBC-USB-Kabel vom MDB ab.
  3. Verbinde deinen Computer mit diesem Mini-B-Anschluss.
  4. Auf dem Computer erscheint ein Laufwerk.
  5. Kopiere die Dateien in den passenden Ordner (siehe unten).
  6. Wirf das Laufwerk sicher aus. Der Roller verarbeitet die Dateien; ein Firmware-Update löst anschließend einen Neustart aus.
  7. Beende den Updatemodus, trenne den Computer und stecke das interne DBC-USB-Kabel wieder ein. Sichere es anschließend wieder mit der Schraube.
Geöffneter Fußraum des Rollers mit dem MDB an seinem Einbauort

Das MDB sitzt im geöffneten Fußraum.

Internes DBC-USB-Kabel vom Mini-B-Anschluss des MDB abgezogen

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.

PfadVerwendung
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

Komprimierte Routing-Kacheln werden unterstützt.
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 reboot neu. 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:

PfadRichtungVerwendung
scripts/mdb.sh, scripts/dbc.shzum RollerShell-Skripte, die einmal auf dem jeweiligen Board ausgeführt werden
settings.tomlhin und zurückAktuelle Einstellungen zum Bearbeiten und anschließenden Einlesen
wireguard/hin und zurückWireGuard-Konfigurationen zum Bearbeiten und anschließenden Einlesen
radio-gaga/config.yamlhin und zurückKonfiguration für die radio-gaga-Telemetrie
uplink-service/config.yamlhin und zurückKonfiguration für uplink-service
onboot.shhin und zurückSkript, das der Roller bei jedem Start ausführt
diagnostics/mdb/, diagnostics/dbc/vom Rollerjournal.log und dmesg.log beider Boards, beim Aktivieren gesammelt
log-bundles/vom RollerMit lsc erstellte Protokollpakete zum Herunterladen
ums_log.txtvom RollerProtokoll 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.

← Navigation einrichten lsc-CLI-Referenz →