Navigation einrichten

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ü → Einstellungen → Karte & Navigation → Kartentyp

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:

• Librescoot OSM Tiles Releases, vorgepackte regionale Auszüge, für das Roller-Display optimiert
• Oder selbst mit maptool erzeugen

Typische Dateigrößen reichen von etwa 9 MB (Bremen) bis etwa 540 MB (Niederlande); die meisten Bundesländer liegen zwischen 50 MB und 420 MB. Berlin und Brandenburg teilen sich eine Datei, ein Deutschland-Gesamtpaket gibt es nicht – du lädst eine Datei pro Region.

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.

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. Es gibt .tar-Archive pro Region, jeweils mit einer komprimierten .tar.zst-Variante daneben.

Typische Archivgrößen: Bremen ~13 MB, Hamburg ~30 MB, Saarland ~31 MB, die meisten Flächenländer ~100–520 MB, Bayern ~725 MB, die Niederlande ~545 MB. Das komprimierte .tar.zst ist meist etwa ein Drittel des unkomprimierten Archivs – Bayern schrumpft auf ~236 MB, die Niederlande auf ~175 MB. Der Roller lädt bevorzugt die komprimierte Form, wenn eine Release sie anbietet, und der Updatemodus akzeptiert beide. Das Updatemodus-Laufwerk ist auf 1 GB begrenzt, manche Kombinationen aus Anzeige- und Routing-Paketen brauchen also weiterhin zwei Sitzungen – siehe Updatemodus-Guide.

Archiv auf den Roller übertragen. Am einfachsten per Updatemodus: das Archiv (*tiles.tar oder *tiles.tar.zst) in den Ordner maps/ des Wechseldatenträgers legen, sicher auswerfen, der Roller installiert es automatisch. Ein komprimiertes Archiv wird auf dem Roller zuerst entpackt. 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.

Mehrere Offline-Regionen

Eine bestehende Installation mit /data/maps/map.mbtiles und einer regulären Datei /data/valhalla/tiles.tar nutzt weiter diese einzelne Region und ihre bisherigen Kartenupdates. Für den automatischen Regionswechsel installierst du passende Dateien tiles_<slug>.mbtiles und valhalla_tiles_<slug>.tar und richtest tiles.tar als symbolischen Link auf ein benanntes Routing-Archiv ein. Sichere das vorhandene Archiv vorher unter seinem richtigen Regionsnamen. Das Dashboard wählt anhand der GPS-Position und startet Valhalla beim Wechsel neu.

Im Updatemodus werden zwei oder mehr benannte Anzeigekarten als regionale Pakete installiert. Für nur ein Paar legst du zusätzlich eine leere Datei maps/regional-packs auf das USB-Laufwerk; ohne sie bleibt das bisherige Verhalten für einzelne Regionen erhalten. Bei einer Neuinstallation wird der Link automatisch angelegt. Eine bestehende reguläre tiles.tar-Datei muss ausdrücklich migriert werden. Der integrierte Karten-Updater bleibt für einzelne Regionen; regionale Pakete werden über USB aktualisiert. Routen über Regionsgrenzen hinweg sind nicht möglich.

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.

• 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"