Navigation einrichten

Kartenanzeige und Routing sind zwei unabhängige Features, jeweils offline oder online konfigurierbar. Kombinier das frei nach Bedarf.

Zwei unabhängige Entscheidungen

Offline (lokal) Online (Internet)
Kartenanzeige Lokale .mbtiles-Datei Online-Kachel-Server
Routing Lokales Valhalla + Routing-Karten Remote-Valhalla-Server

Kartenanzeige

Die Karten-Einstellung steuert, welche Kachelquelle für die Darstellung benutzt wird. Ob du navigieren kannst, hängt davon nicht ab – das regelt das Routing (siehe unten).

Zwischen den Modi wechseln: Menü → EinstellungenKarte & NavigationKartentyp

Offline-Kartenkacheln

Die Offline-Anzeige nutzt eine lokale .mbtiles-Datei mit vorgerenderten Kacheln. Einmal installiert, braucht sie keine Internetverbindung mehr.

Eine Kacheldatei für deine Region besorgst du dir so:

Typische Dateigrößen: Stadt ~2–16 MB, einzelnes Bundesland ~20–140 MB, ganz Deutschland ~680 MB.

Zum Installieren legst du die Kacheldatei entweder in den Ordner maps/ auf dem Wechseldatenträger im Updatemodus (am einfachsten), oder kopierst sie per SSH als /data/maps/map.mbtiles auf das DBC. Der Pfad /data/maps/ ist der interne Pfad auf dem Roller und nur per SSH relevant – im Updatemodus siehst du nur den Ordner maps/ auf dem Wechseldatenträger.

Abdeckung
Vorgefertigte Kachelpakete decken aktuell alle 16 deutschen Bundesländer ab. Für andere Regionen erzeugst du dir Kacheln mit maptool aus einem beliebigen OpenStreetMap-Auszug.

Online-Kartenkacheln

Die Online-Anzeige lädt Kacheln beim Verschieben der Karte von einem Internet-Kachel-Server. Keine lokale Datei nötig, nur eine aktive Internetverbindung. Wird automatisch gewählt, wenn keine lokale Kacheldatei vorliegt und der Kartentyp auf Online steht.

Routing

Das Routing liefert Turn-by-Turn-Navigation. Es ist völlig unabhängig von der gewählten Kartenanzeige. Librescoot nutzt dafür die Valhalla-Engine.

Lokales (Offline-)Routing

Lokales Routing betreibt Valhalla direkt auf dem Dashboard-Rechner des Rollers. Dafür brauchst du Valhalla-Routing-Kacheln – ein anderer Datensatz als die .mbtiles-Datei für die Anzeige. Routing-Kacheln enthalten den Straßengraphen, mit dem Valhalla Routen berechnet.

Routing-Kacheln für deine Region bekommst du aus den Librescoot Valhalla Tiles Releases. .tar-Archive pro Bundesland gibt es für alle 16 deutschen Länder.

Typische Archivgrößen: kleine Stadtstaaten (Bremen, Hamburg, Saarland) ~20–60 MB, die meisten Flächenländer ~100–340 MB, Bayern ~910 MB. Das Updatemodus-Laufwerk ist auf 1 GB begrenzt, größere Anzeige- und Routing-Pakete passen also oft nicht gleichzeitig drauf – siehe Updatemodus-Guide.

Archiv auf den Roller übertragen. Am einfachsten per Updatemodus: *tiles.tar in den Ordner maps/ des Wechseldatenträgers legen, sicher auswerfen, der Roller installiert sie automatisch. Alternativ direkt per SSH als /data/valhalla/tiles.tar auf das DBC kopieren. Auf keinen Fall entpacken – Valhalla liest das Tar direkt über seine tile_extract-Einstellung. Sobald Valhalla läuft und Daten geladen hat, erscheint das Navigations-Menü am Dashboard automatisch.

Zwei verschiedene Pfade, dieselbe Datei
Im Updatemodus siehst du nur den Ordner maps/ auf dem Wechseldatenträger – um den Rest kümmert sich der Roller selbst. /data/valhalla/ ist der Pfad im internen Dateisystem des Rollers und nur per SSH relevant. Versuch nicht, /data/valhalla/ über den Updatemodus anzulegen, das funktioniert nicht.
Abdeckung
Vorgefertigte Routing-Kacheln decken aktuell alle 16 deutschen Bundesländer ab. Für andere Regionen baust du dir Valhalla-Kacheln aus einem OpenStreetMap-PBF-Auszug mit dem Standard-Valhalla-Build-Prozess.

Remote (Online-)Routing

Du kannst Librescoot so konfigurieren, dass es einen Remote-Valhalla-Server nutzt, statt lokal zu routen. Der Routing-Endpunkt steht standardmäßig auf lokal (localhost:8002), lässt sich aber mit lsc ändern:

lsc settings set dashboard.valhalla-url https://your-valhalla-server.example/

Aktuelle Einstellung anzeigen: lsc settings list.

Einstellungen unter „Karte & Navigation“

Der Rest von Menü → Einstellungen → Karte & Navigation betrifft die Darstellung der Karte und die Routen-Gewichtung. Die meisten Einträge entsprechen einem Settings-Key, „Kartenupdates“ steuert zwei; dieselben Werte lassen sich also auch mit lsc setzen.

MenüeintragWerte (Standard zuerst)Settings-Key
Kartenansicht3D, 2Ddashboard.map.view-mode
AusrichtungFahrtrichtung, Nordendashboard.map.north-oriented
RouteSchnellste, Kürzestedashboard.route-preference
Kopfsteinpflaster meidenMittel, Aus, Niedrig, Hochdashboard.avoid-cobblestone
KartenupdatesAus, Benachrichtigen, Herunterladendashboard.maps.check-for-updates + dashboard.maps.auto-download
KartentypOffline, Onlinedashboard.map.type
Navigations-RoutingOffline, Onlinedashboard.valhalla-url
  • Ausrichtung erscheint nur, solange die Kartenansicht auf 2D steht. Die 3D-Kamera folgt immer der Fahrtrichtung.
  • Kopfsteinpflaster meiden ist ein Umwegbudget und kein hartes Verbot: „Niedrig“ investiert höchstens die Fahrzeit, die der holprige Abschnitt selbst gekostet hätte, „Mittel“ das Vierfache, „Hoch“ das Achtfache. „Aus“ schaltet das Meiden vollständig ab: Das Display sendet ausdrücklich eine Null statt die Option wegzulassen, sodass der Router-Standard (der so schwer wiegt wie „Mittel“) gar nicht erst greift. Dafür braucht es Routing-Kacheln, die Kopfsteinpflaster kennzeichnen; ältere Kacheln ignorieren die Einstellung. Der Eintrag ist ausgeblendet, solange die Route auf „Kürzeste“ steht (die rechnet allein nach Distanz) und solange das Routing gegen das öffentliche Online-Valhalla läuft, das mit Standard-Kosten arbeitet.
  • Kartenupdates ist ein Eintrag, der zwei Keys steuert. „Benachrichtigen“ schaltet die Prüfung ein und den automatischen Download aus, „Herunterladen“ beides ein. Die automatische Prüfung läuft höchstens wöchentlich und erst, wenn das Modem eine Verbindung meldet. Auf Updates prüfen darunter fragt sofort nach und zeigt, wie lange die letzte Prüfung her ist; diese Zeile erscheint nur, wenn Karten installiert sind.
  • Offline-Karten aus den aktuellen Kachelpaketen bringen Straßennamen mit. Beide Beschriftungs-Layer setzen bei Zoomstufe 12 ein: Hauptstraßen sind ab da beschriftet, Nebenstraßen bleiben bis Zoomstufe 16,5 vollständig transparent und sind erst ab Zoomstufe 17 voll deckend. Eine Kacheldatei ohne Straßenbeschriftungs-Layer bleibt namenlos.

Dateien per USB übertragen (Updatemodus)

Der Updatemodus stellt ein virtuelles Laufwerk auf deinem Rechner bereit (über USB-Mass-Storage). Kartendateien draufkopieren, auswerfen, der Roller übernimmt die Installation automatisch. Details im Updatemodus-Guide.

Kurzversion: Updatemodus über Einstellungen → System → Update-Modus aktivieren, USB verbinden, .mbtiles und/oder *tiles.tar in den Ordner maps/ kopieren und sicher auswerfen.

Prüfen, ob alles funktioniert

Nach der Übertragung bestätige kurz, dass die Navigation aktiv ist, bevor du losfährst:

  1. Menü öffnen (doppelt auf die linke Bremse tippen). Wenn Navigation einrichten nicht mehr aufgelistet ist, ist deine Konfiguration komplett
  2. Wenn doch, tippe darauf, um zu sehen, welche Komponente noch fehlt (Routing-Engine, Offline-Anzeigekarten oder beides)
  3. Unter Menü → Info → Karten zeigt der Roller die installierten Offline-Karten und Routing-Daten mit Abdeckung und Alter

Für eine tiefere Prüfung per SSH: Der SSH-Abschnitt unten zeigt dieselbe Verbindung, mit der du prüfst, ob Valhalla läuft und Kacheln geladen hat.

SSH-Transfer (für Fortgeschrittene)

Mit SSH-Zugang kannst du Dateien auch ohne Updatemodus direkt übertragen. Das DBC (Dashboard Computer, unter 192.168.7.2) ist nur per Jump-Host über das MDB erreichbar:

ssh -J root@<mdb-ip> root@192.168.7.2

Dieselbe Verbindung hilft bei der Diagnose eines halb fertigen Setups. So prüfst du, dass Valhalla läuft und Kacheln geladen hat:

systemctl status valhalla
curl -s http://localhost:8002/status | python3 -m json.tool

Ein gesundes Valhalla antwortet mit {"version": "...", "tileset_last_modified": ...}. Gibt es einen Fehler, hat Valhalla keine Kacheln geladen – prüf, ob /data/valhalla/tiles.tar existiert. Die installierte Anzeige-Karte liegt als map.mbtiles in /data/maps/.

Anzeige-Kacheln

  1. .mbtiles-Datei auf das DBC kopieren:
    scp -J root@<mdb-ip> tiles_berlin.mbtiles root@192.168.7.2:/data/maps/map.mbtiles
  2. Auf dem DBC scootui-qt neu starten, damit die neue Datei geladen wird:
    ssh -J root@<mdb-ip> root@192.168.7.2 "systemctl restart scootui-qt"

Valhalla-Routing-Kacheln

Valhalla liest das .tar-Archiv direkt – nicht entpacken. Einfach als /data/valhalla/tiles.tar ablegen.

  1. Auf dem DBC das Zielverzeichnis anlegen:
    ssh -J root@<mdb-ip> root@192.168.7.2 "mkdir -p /data/valhalla"
  2. Archiv direkt an seinen Zielort kopieren:
    scp -J root@<mdb-ip> valhalla_tiles_berlin.tar root@192.168.7.2:/data/valhalla/tiles.tar
  3. Valhalla neu starten:
    ssh -J root@<mdb-ip> root@192.168.7.2 "systemctl restart valhalla"

← Installation USB-Dateiübertragung →