Karten für LilyGo T-Deck Plus und andere Meshtastic UI Geräte einrichten

Das LILYGO T-Deck Plus Meshtastic ist ein Fertiggerät zum sofortigen Einsatz im Meshtastic-Netzwerk. Hier habe ich ein ausführliches Review über das Gerät geschrieben.

Im Auslieferungszustand zeigt einem das Gerät auf der Karten-Tab nur eine weiße Karte ohne alles an. Damit fällt die Orientierung natürlich ein wenig schwer.

Das Geheimnis ist: Man kann sogenannte Map-Tiles auf die µSD-Karte kopieren. Die Meshtastic UI schaut jedesmal auf der µSD-Karte nach einem Tile mit einer bestimmten Nummer, das zu den Geo-Koordinaten passt.

Map-Tiles oder Karten-Kachel sind kleine Bilddateien mit einem kleinen Ausschnitt einer Karte, zum Beispiel von OSM. Ein Algorithmus berechnet, welches Tile für die gerade anzuzeigenden Koordinaten das richtige ist und zeigt es dann an. Dabei gibt es mehrere Zoom-Stufen: von einer groben Globus-Ansicht bis hinunter auf Straßenebene, bei der einzelne Häuser erkennbar sind.

Dabei müssen wir im Hinterkopf behalten, dass es hier keine Vektor-Daten sind, sondern wirkliche kleine Bitmap-Dateien. Die brauchen natürlich mehr Speicherplatz und außerdem möchte man sie möglichst klein halten, am besten nur so groß, wie auf einen Bildschirm passt. Das ergibt dann unzählige Map-Tiles für ein großes Gebiet.

Man kann unmöglich alle Tiles der Welt auf einer einzelnen µSD-Karte unterbringen, also geht man einen Kompromiss ein und nimmt für die ganze Welt eine gewisse Zoom-Stufe bis auf Stadtteil-Ebene, dann europaweit die nächsten Zoom-Stufen bis auf Hauptstraßen-Niveau, dann vielleicht für Deutschland weitere Zoomstufen und dann wird man für sein Bundesland noch feiner und schließlich für den eigenen Wohnort geht man bis zur Maximal-Zoomstufe.

Heraus kommen Abertausende von kleinen Bilddateien in vielen Unterordnern, die stundenlang brauchen, um eine SD-Karte kopiert zu werden. Außerdem muss man sich die Bilddateien für eine bestimmte Region herunterladen, denn es sind auch nicht zu viele auf einmal zum Download zulässig.

Ich werde mir die Karten-Tiles so organisieren, wie ich das für mich brauche. Bei euch kann das je nach Wohnort natürlich anders ausschauen.

µSD-Karte einrichten

Ich empfehle eine schnelle µSD-Karte mit 64 GB Speicher für die Kartendaten. Ich habe gute Erfahrungen mit den µSD-Karten von SanDisk und Samsung gemacht.

Damit das T-Deck die µSD-Karte erkennt, empfiehlt es sich, sie mit exFAT zu formatieren. Dabei sollte die kleinste Einheit pro Zuordnungseinheit nehmen, die angeboten wird, in meinem Fall 4096 Bytes. Man muss nämlich wissen, das ganz viele Tiles einfach nur leeres Meer zeigen und dann gepackt nur 103 Bytes als PNG groß sind. Trotzdem benötigen sie mindestens eine ganze Zuordnungseinheit. Darum sparen kleine Zuordnungseinheiten hier richtig Speicherplatz auf der Karte.

Dann legen wir einen Ordner "maps" im Hauptverzeichnis an und darunter zum Beispiel ein Ordner OSM, falls wir unsere Karten von OSM beziehen wollen. Wir können mehrere Kartendienste anlegen und dann in der Meshtastic UI mit Lang-Klick auf das Faltkarten-Symbol umschalten.

Die Ordner-Struktur der Map-Tiles

Darunter folgen auf der dritten Ebene Zahlen-Ordner, die die Zoom-Stufen bezeichnen. Je höher die Zoomstufe, desto kleiner sind die Tiles und je mehr gibt es im Ordner. Da sind sie wieder in Zahlen-Ordner der vierten Ebene einsortiert.

Die niedrigste Zoom-Stufe ist Null. Hier gibt es nur eine Datei in u:\maps\OSM\0\0\: die 0.png, die wie folgt aussieht:



Jede Zoom-Stufe zerteilt die vorhergehende in 4 Teile: oben links, oben rechts, unten links und unten rechts. Zoom-Stufe 1 besitzt die Unterordner 0 und 1 und darin jeweils 2 Kartenkacheln.

Auf Zoom-Stufe 7 sind es schon 128 Unterordner (0...127) mit je 128 Tiles (auch 0...127). Ich habe die Struktur für Zoom-Stufe 7 mal hier gelistet:



Man sieht also, dass die Anzahl der Map-Tiles pro Zoom-Stufe um das Vierfache ansteigt. Bei Zoom-Stufe 13 haben wir schon dann schon 2¹³, also 8192 Ordner mit je 8192 Bilddateien, was 67'108'864 Bilddateien macht. Bei Zoom-Stufe 13 hat ein Kartenausschnitt folgende Detailstufe:



Damit kann man schon mal ganz gut ausmachen, in welchem Stadtteil und Straßenzug eine Node liegt, wenn man ein wenig Ortskenntnis besitzt. Für das obige Beispiel ist das der Nürnberger Nordosten.

Man kann sich vorstellen dass 67 Millionen Dateien mit mindestens 4 KB (einige sind natürlich auch größer wie die oben gezeigte) schon allein 268 GigaBytes ausmachen und nicht mal mehr auf eine 256 GB-µSD-Karte passen. Wir dürfen Zoom-Stufe 13 und mehr also nur für Teile der Welt herunterladen und installieren.

Man muss also klug selektieren, was man wirklich braucht.

Selektion und Download der Kartendaten

Ich halte folgendes für einen guten Kompromiss. Als Kartendienst ist OSM meine Empfehlung. Denn OSM ist kostenlos, hat detaillierte Karten und wird laufend aktualisiert.

Die ganze Welt bis Zoom-Stufe 6

Unter https://github.com/meshtastic/device-ui/tree/master/maps findet man das Map Tile Starter-Kit.

Hier findet man die https://github.com/meshtastic/device-ui/blob/master/maps/osm.zip mit den Zoomstufen 0 bis 6 für die ganze Welt mit nur rund 25 MB Größe gezippt.

Damit hat man schon einmal einen groben, weltweiten Überblick, auf dem die großen Städte über ca. 50'000 Einwohner verzeichnet sind. Um einen Eindruck zu bekommen hier eine Karte auf Zoom-Stufe 6.

Mir ist Zoom-Stufe zu wenig, also bin ich ein wenig auf die Suche gegangen.

Die ganze Welt bis Zoom-Stufe 9

Während meiner Suche habe ich den Reddit Post Meshtastic 2.6 Map Tiles with higher zoom levels gefunden.

Hier gibt es die die ganze Welt bis Zoom-Stufe 9 als Zip-Datei mit 2 GB und rund 350'000 Tiles herunterzuladen.

Auch hier für den ersten Eindruck, wie nah dran das ist, eine Karte auf Zoom-Stufe 9. Für einen weltweiten Überblick ist das meiner Meinung völlig ausreichend.

Europa bis Zoom-Stufe 13

Für Deutschland hätte ich da aber schon gerne ein wenig mehr. Das hat unser Reddit-Poster leider nicht im Angebot, dafür aber ganz Europa bis Zoom-Level 13. Das Zip hat dann auch gleich mal 17.1 GB und 1.6 Mio Kartenteile, aber das passt noch auf unsere 64 GB-µSD-Karte drauf.

Damit haben wir ganze Europa bis Zoom-Level 13. Auch hier für den ersten Eindruck, wie nah dran das ist eine Karte auf Zoom-Stufe 13. Hier ist auch der Kartenausschnitt aus dem Foto oben enthalten.

Allein diese 1.6 Mio Map-Tiles zu unzippen dauert etliche Stunden. Das liegt an den vielen kleinen Files, die zu kopieren sind. Es ist also Geduld angesagt.

Damit kann man dann aber durchaus schon etwas anfangen und viel näher dran braucht man es eigentlich auch nicht. Das einzelne Haus, wo sich ein Node befindet, ist eigentlich nicht so interessant.

Und ansonsten hat man ja noch die auf bestenfalls wenige Meter genauen Geo-Koordinaten, die man in Google Earth oder Google Maps oder OSM online nachschauen kann. Da kann man dann beliebig nah heranzoomen und auch die Satelliten-Karten anschauen, die dann häufig auch Objekte wie Funkmastern und Fernsehtürme zeigen.

Höhere Zoomstufen als 13

Wenn man es unterwegs super genau haben will, dann kann man runter bis Zoomstufe 17 gehen. Das sieht dann in etwa so aus. Hier ist die Karte so detailliert, dass man schon einzelne Hausnummern erkennen kann. Mehr ist wirklich nicht für unsere Zwecke nötig.

Aber allein schon Deutschland in Zoomstufe 14 (kein großer Vorteil gegenüber Zoomstufe 13) hat 244'666 MapTiles und verbraucht ca. 3.2 GB an Speicherplatz.

Wenn man unbedingt mehr als Zoomstufe 13 haben will, wird es komplizierter.

Download von einem Tile-Server

Hier kann man sich ein Script schreiben, dass die Tiles von einem Tile-Server wie dem von OSM selbst herunterlädt. Es ist aber tunlichst darauf zu achten, dass dabei die Map Tile Benutzungsbedingungen eingehalten werden. Denn wenn jeder ständig ständig große Mengen an MapTiles downloaden würde, dann würden die Server schnell in die Knie gehen. Darum werden auch IPs (oder Apps), die die Bedingungen nicht einhalten, von OSM ausgesperrt. Also besser seine Chance nicht vertun und den Dienst fair benutzen.

Darum sollte man beim Download von MapTiles langsam und behutsam vorgehen und zwischen den einzelnen Tiles eine kleine Pause einlegen. Und dann dauert der Download eines großen Gebietes wie Deutschland auf Zoom 14 viele Stunden lang.

Bei den OSM Map Tile Benutzungsbedingungen findet sich auch eine Liste alternativer OpenStreetMap-Kachel-Anbieter, die man nutzen sollte, um nicht nur OSM zu belasten.

Tiles selbst rendern

Der Direkt-Download von vielen Tausenden einzelnen MapTiles dauert lange und ist ineffektiv. Schneller geht es, wenn man sich Vektor-Tiles herunterlädt. Diese sind wesentlich kompakter. Und aus ihnen kann man sich dann die einzelnen Tiles selbst berechnen oder "rendern".

Dafür gibt es extra Programme. Einen Einstieg findet man im Reddit Post von oben. Das Ganze ist allerdings nicht ganz einfach und man muss sich ein bisschen einlesen. Das hier alles zu erklären, würde den Rahmen diesen Artikels sprengen.

Fertiges µSD-Karten-Image downloaden

Nachdem es doch eine Heidenarbeit ist und gefühlt tagelang dauert, bis man die MapTiles, die man braucht, zusammengesucht und dann das Ganze auf µSD-Karte kopiert hat - allein das dauert schon Stunden - ist mir eine Idee gekommen, wie ich euch das alles erleichtern kann.

Ich habe aus meiner fertig eingerichteten µSD-Karte ein Image gezogen. Das ist ein ein komplettes Abbild meiner 64GB-µSD-Karte. Das müsst ihr downloaden und dann mit einem Tool wie SDImager oder Etcher auf eine leere 64GB-µSD-Karte schreiben, zusagen klonen.

Wie man die Image-Tools benutzt, habe ich bereits einmal im Artikel Raspi Zero W - Ersteinrichtung für WLAN und SSH im Abschnitt Image laden und flashen genau erklärt. Hier ist es genau das selbe.

Glaubt mir, das Klonen mit Etcher und Co. geht hundertmal schneller als einzelne MapTile-Zips heruntenzuladen und zu entpacken. Hier ein grober Überblick über den µSD-Karteninhalt: Über 2 Millionen Einzeldateien zu kopieren bzw. zu entpacken, dauert gefühlt ewig. Das Image zu schreiben ist in einer Viertel- bis ganzen Stunden erledigt, je nach Geschwindigkeit der µSD-Karte. Denn das Betriebssystem muss dabei nicht um die ganze Verzeichnisstruktur mitpflegen, sondern schreibt sie sozusagen "in einem Rutsch runter".

Wie man sieht, ist noch ein Platz auf der µSD-Karte für eure eigenen zusätzlichen MapTiles, wenn ihr das Image geschrieben habt.

Logischerweise sind diejenigen MapTiles vorhanden, die ich für mich persönlich am besten gebrauchen kann. Aber ich glaube, für meine Leserschaft aus Deutschland ist das schon mal ein sehr brauchbarer Grundstock. Den meisten dürfte das vollkommen genügen:

Zoomstufe	Gebiet	Quelle
0 bis 9	Planet Erde	OxedOSM World
bis 13	Europa	OxedOSM Europe
bis 14	Deutschland	OSM
bis 15	Mittelfranken	OSM
bis 17	Nürnberg	OSM

Für die Kartendaten gilt die Open Data Commons Open Database-Lizenz (ODbL) der OpenStreetMap Stiftung (OSMF). Näheres unter dem Link und in der folgenden README.txt, die sich dann auch auf der µSD-Karte wiederfindet.

README.txt auf der µSD-Karte (klicken, um diesen Abschnitt auf- und zuzuklappen)

MapTiles für Meshtastic UI auf LilyGo T-Deck Meshtastic, Elecrow CrowPanel Meshtastic und ähnliche Geräte mit uSD-Kartenslot. Zusammengestellt am 2025-09-10 von Doc Cool (https://cool-web.de) Weitere Infos unter https://cool-web.de/esp8266-esp32/lilygo-t-deck-plus-lora-meshtastic-karten-kacheln-map-tiles.htm Zusammenstellung mit Fokus auf Nürnberg / Mittelfranken: Zoomstufe | Gebiet | Quelle ----------+-----------------+---------------- 0 bis 9 | Planet Erde | OxedOSM World bis 13 | Europa | OxedOSM Europe bis 14 | Deutschland | OSM bis 15 | Mittelfranken | OSM bis 17 | Nürnberg | OSM Empfohlener Datenträger: uSD-Karte, 64 GByte, exFAT formatiert mit 4096 Bytes pro Zuordnungseinheit. Alle Kartendaten und MapTiles von OpenStreetMap (OSM) https://www.openstreetmap.org/copyright OpenStreetMap-Lizenzierung: OpenStreetMap ist ein offener Datensatz, lizenziert unter der Open Data Commons Open Database-Lizenz (ODbL) der OpenStreetMap Stiftung (OSMF). Zusammengefasst: Es steht dir frei, unsere Daten zu kopieren, weiterzugeben, zu übermitteln sowie anzupassen, sofern du OpenStreetMap und seine Mitwirkenden als Quelle angibst. Für den Fall, dass du auf Basis unserer Daten Anpassungen vornimmst oder sie als Grundlage für weitere Bearbeitungen verwendest, kannst du das Ergebnis auch nur unter derselben Lizenz weitergeben. Der vollständige Lizenztext bei Open Data Commons erläutert deine Rechte und Pflichten. Zusammengestellt aus verschiedenen Quellen: OxedOSM (siehe https://www.reddit.com/r/meshtastic/comments/1j1chem/meshtastic_26_map_tiles_with_higher_zoom_levels/) OSM MapTile-Server (siehe https://wiki.openstreetmap.org/wiki/DE:Tile_usage_policy)

Das Image selbst ist (ebenfalls) logischerweise 64 GB groß bzw. genauer gesagt so groß wie meine µSD-Karte, nämlich 58.5 GiB bzw. 62'914'560'000 Bytes. Die Hersteller reden die Zahlen ja immer ein bisschen schön. Das ist schon eine Menge herunterzuladen. Ich habe euch deshalb das Image noch einmal gezippt. Mit dem Trick, alle leeren Sektoren mit binären Nullen zu beschreiben, konnte ich so die Zip-Datei auf 22 GiB reduzieren.

Das allerdings ist zu viel für meinen kleinen Webserver. Darum habe ich mich entschlossen, das Image per BitTorrent zu verteilen. Ihr braucht also einen BitTorrent-Client wie qBittorrent.

Bitte seid so fair, und seedet das Torrent noch ein Weile, nachdem ihr das Image komplett heruntergeladen habt, damit es sich verteilt. Sonst dauert der Download sehr lange, wenn nur mein PC als Quelle fungiert, wenn er denn angeschaltet ist. Außerdem kann ich natürlich nicht meinen gesamten Internet-Upstream zur Verfügung stellen. Wenn aber alle fair sind, gibt es genügend Seeder und das Image sollte sich blitzschnell herunterladen lassen. Also soweit eure Download-Internet-Verbindung das zulässt.

Eine kleine Warnung an die BitTorrent-Anfänger: Lasst euch nicht in Versuchung führen und fangt an, BitTorrent illegal zu benutzen und damit Filme, Musik oder Spiele herunterzuladen. Denn ihr seid während des Downloads eines Files auch gleichzeitig Anbieter und verteilt die entsprechende Datei (bzw. deren Stücke) mit. Das wird in Deutschland als Urheberrechtsverletzung gewertet. Auch wenn ihr meint, dass euch das Urheberrecht am Allerwertesten vorbei gehen kann, seid gewarnt: BitTorrent ist nicht anonym. Überall geiern Abmahnanwälte mit automatischer Scan-Software, die nur darauf warten, eure IP abgreifen zu können und euch eine Abmahnung samt Unterlassungserklärung und deftiger Kostennote (mit einem dreistelligen bis niedrigen vierstelligen Euro-Betrag) zu schicken. Das ist inzwischen ein echtes Business geworden. Quasi eine Gelddruckmaschine für so manch windigen Advokaten. Also lasst es bleiben!

Hier der BitTorrent-Link zum Start des Downloads:

OSM-MapTiles-Nuernberg.zip.torrent

Viel Spaß damit. Und bitte seht von Anfragen wie "Kannst du mir auch noch meine Stadt mit in das Images packen, bitte?" ab. Dafür habe ich keine Zeit. Das müsst ihr schon selbst machen. Anleitung siehe oben.

Videos

Mein allererster Eindruck der LILYGO T-Deck (und T-Echo), als ich es das erste Mal sehe. Beim Auspacken beim Mailbag-Video #137:

Hier habe ich mir den T-Deck genauer angeschaut und gezeigt, wie sich das Standalone-Gerät in der Bedienung so macht. Außerdem vergleiche ich es mit dem T-Echo und zeige die Problemlösung für kaputte Kommunikation wegen geändertem Private Key:

Und in diesem Video schraube ich den T-Deck auf, schaue mir die Innereien an, zeige meinen 3D-gedruckten Halter und baue den Reset-Taster aus:

Quellen, Literaturverweise und weiterführende Links