ESP32-C5 Marauder WiGLE wardriving upload board

ESP32 Marauder WiGLE Auto-Upload: PCなしでワードライブログをアップロード

PINGEQUA Lab ・ ハウツー ・ 読了時間26分 ・ 更新日 2026-07-17

従来のウォードライビングの流れは、面倒な作業で終わっていた。microSDを取り出し、パソコンを探し、WiGLEにログインし、CSVを手動でアップロードする。ESP32 Marauderのオートアップロード機能は、その最後のステップをなくす——デバイスが代わりにアップロードしてくれる。

早わかりESP32 Marauderは、ワードライビングのログをデバイスから直接WiGLEへアップロードできる——PC不要、カードの抜き差しも不要。WiGLEのAPI認証情報をSDカードのルートにある2つのテキストファイル——wigle_api_name.txtとwigle_api_token.txt——に入れ、Join WiFiでMarauderをWi-Fiネットワークに接続し、メニューからアップロードを実行する。保存された認証情報を使って、wardrive_ログを直接wigle.netへ送信する。ただし、これを前提に計画する前に重要な注意点がある：この機能はPR #1359として2026-07-07にマージされたが、まだ安定版リリースには入っていない——現時点ではnightlyビルドでのみ提供されている。Scout LiteのようなWi-Fiネイティブなボードなら、この一連の流れがボード上だけで完結する。

何が変わったのか

Marauderは以前から、ワードライビングのログをwardrive_というファイル名プレフィックス付きのWigleWifi CSVとしてSDカードに書き込み、wigle.netへアップロードできる状態にしてきた。それがしていなかったのはアップロード自体で——それは後で、パソコンの前で、あなた自身がやることだった。PR #1359がそれを変えた。MarauderはいまやWi-Fiに接続し、ワードライビングのログを直接WiGLEへ——さらに別途、同じWigleWifi CSV形式を受け付ける独立したサードパーティ製ワードライビングゲームWDGoWarsへも送信できる。これはプロジェクトの中でも特に要望の多かった快適機能のひとつだ。

それでも必要なものが3つある。API認証情報を持つWiGLEアカウント、microSDカード（ログはまず最初にここへ書き込まれる）、そしてボードがwigle.netへ届くための、圏内でインターネットにつながるWi-Fiネットワークだ。オートアップロードは手動の手順を置き換えるだけで、SDカードもアカウントもなくすわけではない。

手順：パソコンなしでワードライビングからWiGLEへ

  1. WiGLEのAPI認証情報を取得する。wigle.netにログインし、Accountページを開いて、API NameとAPI Tokenを確認する（WiGLEは認証済みAPIアクセスにこれらを使う）。
  2. SDカードのルートに2つのファイルを置く。API Nameだけを書いたwigle_api_name.txtと、API Tokenだけを書いたwigle_api_token.txtを作成する——余計な文字や引用符は入れない。（同じCSVを受け付ける独立した無関係のプラットフォームWDGoWarsの場合、ファイル名はwdg_key.txtになる。）
  3. いつも通りワードライビングする。カードを挿入し、MarauderでWardriveを開始して、車や徒歩で移動する。ログはwardrive_プレフィックス付きで保存される。
  4. MarauderをWi-Fiに接続する。Wi-FiのAPスキャンを実行し、Join WiFi（またはCLIコマンドのjoin）でネットワークに接続する。認証情報は保存されて再利用されるので、ネットワークごとに一度だけ行えばよい。
  5. アップロードを実行する。メニューからWiGLEへのアップロードを開始する。Marauderは保存済みのWi-FiとWiGLEの認証情報を使って接続し、ログを送信する。アップロードはバックグラウンドで実行される。処理が終わると、あなたのネットワークはWiGLEの統計にカウントされる。
バージョンを確認する——フラッシュする前に読むこと。PR #1359は2026-07-07T20:39:30Zにマージされた。これは同日に公開されたv1.13.0（現在の安定版、2026-07-07T03:02:42Z）のおよそ18時間後だ。つまりv1.13.0にはオートアップロードは含まれておらず、安定版のv1.14.0はまだ存在しない——この機能は現時点ではnightly / v1_14_0_betaプレリリースビルドにのみ存在する。「1.14.0 Update」と題されたコミュニティ動画が見せているのはそれらのnightlyであり、公開された安定版ではない。いまオートアップロードを使いたいなら、USB-C経由でフラッシュするnightlyビルドを選ぶことになる。どの安定版でも、「カードを抜いてwigle.netでアップロードする」という手動の方法は引き続き使える。

これが活きる場面：すでにWi-Fiにつながっているボード

オートアップロードの難点は、何かがWi-Fiと通信できなければならないことだ。ワードライビング用のリグでは、ESP32自体がWi-Fi無線モジュールなので、スキャンもできれば、終わったあとにネットワークに参加してアップロードすることもできる。Scout Liteでは、デュアルバンドスキャンを担うESP32-C5がアップロードも行う同じ無線モジュールだ——だから一連の流れ（スキャン→GPSタグ付け→アップロード）が、microSDがログを保持したまま、USB-C経由の1枚のボード上で完結する。別のESP32ワードライビングボードを使っている場合も、そのボードがオートアップロードを含むMarauderビルド——現時点ではnightlyを意味する——であれば同じ機能が使える。このワークフローが初めてなら、完全なワードライビングガイドから始めるとよい。

アップロードが失敗する場合

症状 考えられる原因 対処法
「Auth failed」/拒否される API Name/Tokenが間違っている wigle.netのAccountから2つのtxtファイルへ余計な文字を入れずにコピーし直す
接続できない Wi-Fi（STA）に未接続 APスキャンを実行し、インターネットにつながるネットワークへJoin WiFiする
何もアップロードされない カードにwardrive_ログがない 実際にワードライビングを行い、CSVがSDのルートにあるか確認する
重複が再アップロードされる ファイル名が変更された Marauderはファイル名+サイズで識別するので、元の名前のまま保つ

Scout Lite — スキャンもタグ付けもアップロードも、すべてオンボードで

ESP32-C5デュアルバンドWi-Fi 6 + 内蔵L86-M33 GPS + microSD、Marauderプリフラッシュ済み。ワードライビングを行うのと同じ無線モジュールがWi-Fiに参加し、ログをWiGLEへ送信できる——PCはループに入らない。

Scout Liteを購入する GPSモジュール

よくある質問

WiGLEのオートアップロードにはどのファームウェアが必要？
PR #1359を含むビルド。PR #1359は2026-07-07にマージされた。これはまだ安定版リリースではない：現在の安定版であるv1.13.0はマージの数時間前に公開されており、これを含まない。そして安定版のv1.14.0は存在しない。現時点でこの機能はnightlyビルドでのみ提供される。安定版では、SDカードを抜いて行う手動アップロードが引き続き使える。
WiGLEのAPI認証情報はどこに置く？
SDカードのルートにある2つのプレーンテキストファイルに置く。wigle_api_name.txt（API Name）とwigle_api_token.txt（API Token）で、それぞれその値だけを書く。どちらもWiGLEのAccountページから取得できる。
microSDカードとWiGLEアカウントはまだ必要？
どちらも必要。ログはまずSDカードに書き込まれ、アップロードにはWiGLEアカウントのAPI認証情報が必要になる。オートアップロードがなくすのは、手動でパソコンを使うステップだけだ。
アップロードのためにボードはどうやってオンラインになる？
ESP32はステーション（STA）モードでWi-Fiネットワークに参加する。APスキャンを実行し、Join WiFi（またはCLIコマンドのjoin）を使う。認証情報は保存され、以降のアップロードでも再利用される。
同じファイルが二重にアップロードされることはある？
Marauderはファイル名とサイズでアップロードを管理するので、同じログを再アップロードすることはない。ファイル名を変更すると新しいファイルとして扱われるので、元のwardrive_名を保つこと。

出典:justcallmekoko/ESP32Marauder PR #1359「Enable direct upload to WDGWars and WiGLE」、2026-07-07T20:39:30Zにマージ（github.com）——SD設定ファイルwigle_api_name.txt/wigle_api_token.txt/wdg_key.txtとJoin WiFiフロー;ESP32Marauderリリースv1.13.0、2026-07-07T03:02:42Z公開（github.com）——現在の安定版で、このマージより前;v1.14.0はreleases APIによればnightlyプレリリースビルドとしてのみ存在する（github.com）;ESP32Marauder Wardrive wiki——wardrive_プレフィックス/wigle.net（github.com）;WiGLE API（api.wigle.net）;WDGoWars（wdgwars.pl）——WigleWifi CSVを受け付ける独立したサードパーティ製プラットフォーム。Scout Liteの仕様はPINGEQUAの商品情報による。バージョンは2026-07-17時点。

本記事は、許可されたネットワーク調査、セキュリティ監査、電子工作教育の目的に限る。自分が所有する、または明示的にテストを許可されたネットワークのみをスキャン・評価すること。アップロード時はWiGLEの利用規約に従うこと。エンドユーザーは現地の法令を遵守する責任を負う。

ブログに戻る