ESP32-C5 Marauder WiGLE wardriving upload board

ESP32 Marauder WiGLE Auto-Upload: Wardrive-Logs ohne PC hochladen

PINGEQUA Lab · Anleitung · 6 Min. Lesezeit · Aktualisiert 2026-07-17

Der alte Wardrive-Ablauf endete mit einer lästigen Pflicht: microSD herausnehmen, einen Computer suchen, sich bei WiGLE einloggen, die CSV manuell hochladen. Der Auto-Upload von ESP32 Marauder eliminiert diesen letzten Schritt — das Gerät lädt für dich hoch.

KurzantwortESP32 Marauder kann Wardrive-Logs direkt vom Gerät aus zu WiGLE hochladen — kein PC, keine Karte mehr herausnehmen. Du legst deine WiGLE-API-Zugangsdaten in zwei Textdateien im Root-Verzeichnis der SD-Karte ab — wigle_api_name.txt und wigle_api_token.txt — verbindest den Marauder über Join WiFi mit einem Wi-Fi-Netzwerk und startest den Upload über das Menü. Er nutzt die gespeicherten Zugangsdaten, um deine wardrive_-Logs direkt zu wigle.net hochzuladen. Ein wichtiger Vorbehalt, bevor du damit planst: Die Funktion wurde am 2026-07-07 als PR #1359 gemergt, ist aber noch nicht in einem stabilen Release — derzeit gibt es sie nur in Nightly-Builds. Auf einem Wi-Fi-nativen Board wie dem Scout Lite läuft der gesamte Ablauf direkt auf dem Board selbst.

Was sich geändert hat

Marauder hat Wardrive-Logs schon immer als WigleWifi-CSV mit dem Dateinamen-Präfix wardrive_ auf die SD-Karte geschrieben, bereit zum Hochladen auf wigle.net. Was er nicht getan hat, war sie hochzuladen — das musstest du später selbst, an einem Computer, erledigen. PR #1359 hat das geändert: Marauder kann sich jetzt mit Wi-Fi verbinden und Wardrive-Logs direkt zu WiGLE hochladen — und, separat, zu WDGoWars, einem unabhängigen Drittanbieter-Wardriving-Spiel, das dasselbe WigleWifi-CSV-Format akzeptiert. Es ist eines der am häufigsten gewünschten Komfort-Features des Projekts.

Du brauchst weiterhin drei Dinge: ein WiGLE-Konto mit API-Zugangsdaten, eine microSD-Karte (die Logs werden weiterhin zuerst dort geschrieben) und ein Wi-Fi-Netzwerk in Reichweite mit Internetzugang, damit das Board wigle.net erreichen kann. Auto-Upload ersetzt den manuellen Schritt — es entfernt weder die SD-Karte noch das Konto.

Schritt für Schritt: Wardrive zu WiGLE, ohne Computer

  1. Hol dir deine WiGLE-API-Zugangsdaten. Melde dich bei wigle.net an, öffne deine Account-Seite und such deinen API Name und API Token (WiGLE nutzt diese für authentifizierten API-Zugriff).
  2. Leg zwei Dateien im Root der SD-Karte ab. Erstelle wigle_api_name.txt mit ausschließlich deinem API Name als Inhalt und wigle_api_token.txt mit ausschließlich deinem API Token als Inhalt — kein Zusatztext, keine Anführungszeichen. (Für WDGoWars — eine separate, nicht verbundene Plattform, die dasselbe CSV akzeptiert — heißt die Datei wdg_key.txt.)
  3. Wardrive wie gewohnt. Karte einlegen, Wardrive in Marauder starten und losfahren/-laufen. Logs werden mit dem Präfix wardrive_ gespeichert.
  4. Verbinde den Marauder mit Wi-Fi. Führe einen Wi-Fi-AP-Scan aus und nutze dann Join WiFi (oder den CLI-Befehl join), um dich mit einem Netzwerk zu verbinden. Die Zugangsdaten werden gespeichert und wiederverwendet, du machst das also nur einmal pro Netzwerk.
  5. Upload starten. Starte den WiGLE-Upload über das Menü. Marauder verbindet sich mit deinen gespeicherten Wi-Fi- und WiGLE-Zugangsdaten und lädt die Logs hoch; der Upload läuft im Hintergrund. Deine Netzwerke zählen nach der Verarbeitung zu deiner WiGLE-Statistik.
Versionscheck — lies das, bevor du flashst: PR #1359 wurde am 2026-07-07T20:39:30Z gemergt, rund 18 Stunden nach der Veröffentlichung von v1.13.0 — dem aktuellen stabilen Release — am selben Tag (2026-07-07T03:02:42Z). Das bedeutet: v1.13.0 enthält keinen Auto-Upload, und es gibt noch kein stabiles v1.14.0 — die Funktion existiert derzeit nur in Nightly- / v1_14_0_beta-Prerelease-Builds. Community-Videos mit dem Titel "1.14.0 Update" zeigen diese Nightlies, nicht eine veröffentlichte stabile Version. Wenn du Auto-Upload heute nutzen willst, entscheidest du dich für einen Nightly-Build, der über USB-C geflasht wird. Auf jedem stabilen Build funktioniert der manuelle Weg "Karte herausnehmen und bei wigle.net hochladen" weiterhin.

Wo das wirklich glänzt: ein Board, das schon auf Wi-Fi ist

Der Haken bei Auto-Upload ist, dass irgendetwas mit Wi-Fi sprechen muss. Bei einem Wardriving-Setup ist der ESP32 das Wi-Fi-Funkmodul — er kann also sowohl scannen als auch, wenn du fertig bist, einem Netzwerk beitreten und hochladen. Beim Scout Lite ist der ESP32-C5, der dein Dual-Band-Scanning erledigt, dasselbe Funkmodul, das auch hochlädt — der gesamte Ablauf (Scan → GPS-Tag → Upload) läuft also über USB-C auf einem einzigen Board, wobei die microSD das Log speichert. Wenn du ein separates ESP32-Wardriving-Board nutzt, funktioniert dasselbe Feature genauso, solange dieses Board einen Marauder-Build hat, der Auto-Upload enthält — derzeit bedeutet das einen Nightly-Build. Neu beim Thema? Starte mit dem vollständigen Wardriving-Guide.

Wenn der Upload fehlschlägt

Symptom Wahrscheinliche Ursache Lösung
"Auth failed" / abgelehnt Falscher API Name/Token Aus dem wigle.net-Account erneut in die beiden txt-Dateien kopieren, keine zusätzlichen Zeichen
Keine Verbindung Nicht mit Wi-Fi verbunden (STA) Einen AP-Scan durchführen, dann per Join WiFi mit einem Netzwerk mit Internetzugang verbinden
Nichts wird hochgeladen Keine wardrive_-Logs auf der Karte Prüfen, ob tatsächlich gewardrivet wurde und die CSV im Root der SD-Karte liegt
Duplikate werden erneut hochgeladen Datei umbenannt Marauder erkennt anhand von Dateiname + Größe; Originalnamen beibehalten

Scout Lite — scannen, taggen, hochladen, alles on-board

ESP32-C5 Dual-Band-Wi-Fi 6 + integriertes L86-M33-GPS + microSD, vorinstalliertes Marauder. Dasselbe Funkmodul, das wardrivet, kann sich mit Wi-Fi verbinden und deine Logs zu WiGLE hochladen — kein PC im Spiel.

Scout Lite holen GPS-Modul

FAQ

Welche Firmware brauche ich für den WiGLE-Auto-Upload?
Ein Build, der PR #1359 enthält, der am 2026-07-07 gemergt wurde. Das ist noch kein stabiles Release: v1.13.0, die aktuelle stabile Version, wurde Stunden vor dem Merge veröffentlicht und enthält ihn nicht, und es gibt kein stabiles v1.14.0. Derzeit gibt es die Funktion nur in Nightly-Builds. Auf stabilen Builds funktioniert der manuelle Upload durch Herausnehmen der SD-Karte weiterhin.
Wo trage ich die WiGLE-API-Zugangsdaten ein?
In zwei einfachen Textdateien im Root der SD-Karte: wigle_api_name.txt (dein API Name) und wigle_api_token.txt (dein API Token), jede nur mit diesem einen Wert. Beide findest du auf deiner WiGLE-Account-Seite.
Brauche ich weiterhin eine microSD-Karte und ein WiGLE-Konto?
Ja, beides. Logs werden weiterhin zuerst auf die SD-Karte geschrieben, und für den Upload sind die API-Zugangsdaten eines WiGLE-Kontos erforderlich. Auto-Upload entfernt nur den manuellen Computer-Schritt.
Wie kommt das Board zum Hochladen online?
Der ESP32 verbindet sich im Station-Modus (STA) mit einem Wi-Fi-Netzwerk. Führe einen AP-Scan aus und nutze dann Join WiFi (oder den CLI-Befehl join); die Zugangsdaten werden gespeichert und für künftige Uploads wiederverwendet.
Wird dieselbe Datei zweimal hochgeladen?
Marauder verfolgt Uploads anhand von Dateiname und Größe und vermeidet so, dasselbe Log erneut hochzuladen. Durch Umbenennen einer Datei wirkt sie neu, behalte also die ursprünglichen wardrive_-Namen bei.

Quellen: justcallmekoko/ESP32Marauder PR #1359 "Enable direct upload to WDGWars and WiGLE", gemergt 2026-07-07T20:39:30Z (github.com) — SD-Konfigurationsdateien wigle_api_name.txt/wigle_api_token.txt/wdg_key.txt und Join-WiFi-Ablauf; ESP32Marauder-Release v1.13.0, veröffentlicht 2026-07-07T03:02:42Z (github.com) — aktuelle stabile Version, älter als dieser Merge; v1.14.0 existiert laut Releases-API nur als Nightly-Prerelease-Builds (github.com). ESP32Marauder-Wardrive-Wiki — Präfix wardrive_ / wigle.net (github.com); WiGLE-API (api.wigle.net); WDGoWars (wdgwars.pl) — unabhängige Drittanbieter-Plattform, die WigleWifi-CSV akzeptiert. Spezifikationen von Scout Lite laut PINGEQUA Listing. Versionsstand: 2026-07-17.

Nur für autorisierte Netzwerkforschung, Sicherheitsaudits und elektronische Bildung. Scanne oder untersuche ausschließlich Netzwerke, die dir gehören oder für die du ausdrücklich eine Testerlaubnis hast. Halte dich beim Hochladen an die Nutzungsbedingungen von WiGLE. Endnutzer sind für die Einhaltung der örtlichen Gesetze selbst verantwortlich.

Zurück zum Blog