ESP32-C5 Marauder WiGLE wardriving upload board

ESP32 Marauder WiGLE Auto-Upload: отправляйте логи вардрайвинга без ПК

PINGEQUA Lab · Инструкция · 6 мин чтения · Обновлено 2026-07-17

Старый цикл вардрайвинга заканчивался рутиной: вынуть microSD, найти компьютер, войти в WiGLE, вручную загрузить CSV. Автозагрузка ESP32 Marauder убирает этот последний шаг — устройство загружает данные само.

КороткоESP32 Marauder умеет отправлять логи вардрайвинга в WiGLE прямо с устройства — без компьютера, без извлечения карты. Вы кладёте свои учётные данные API WiGLE в два текстовых файла в корне SD-карты — wigle_api_name.txt и wigle_api_token.txt — подключаете Marauder к сети Wi-Fi через Join WiFi и запускаете отправку из меню. Устройство использует сохранённые учётные данные, чтобы отправить ваши логи wardrive_ прямо на wigle.net. Важная оговорка, прежде чем на это рассчитывать: функция была влита как PR #1359 2026-07-07, но она ещё не вошла в стабильный релиз — сегодня она поставляется только в nightly-сборках. На платах с нативным Wi-Fi, таких как Scout Lite, весь этот цикл проходит прямо на самой плате.

Что изменилось

Marauder всегда записывал логи вардрайвинга на SD-карту в формате WigleWifi CSV с префиксом имени файла wardrive_, готовые к отправке на wigle.net. Чего он не делал — так это не отправлял их: это оставалось на вас, позже, за компьютером. PR #1359 изменил это: теперь Marauder может подключаться к Wi-Fi и отправлять логи вардрайвинга напрямую в WiGLE — а также, отдельно, в WDGoWars, независимую стороннюю игру про вардрайвинг, которая принимает тот же формат WigleWifi CSV. Это одна из самых востребованных функций удобства в проекте.

Вам по-прежнему нужны три вещи: аккаунт WiGLE с учётными данными API, карта microSD (логи всё так же сначала записываются туда) и сеть Wi-Fi в зоне действия с доступом в интернет, чтобы плата могла достучаться до wigle.net. Автозагрузка заменяет ручной шаг — она не убирает ни SD-карту, ни аккаунт.

Пошагово: от вардрайвинга к WiGLE без компьютера

  1. Получите свои учётные данные API WiGLE. Войдите на wigle.net, откройте страницу Account и найдите свои API Name и API Token (WiGLE использует их для аутентифицированного доступа к API).
  2. Поместите два файла в корень SD-карты. Создайте wigle_api_name.txt, содержащий только ваш API Name, и wigle_api_token.txt, содержащий только ваш API Token — без лишнего текста, без кавычек. (Для WDGoWars — независимой, не связанной с WiGLE платформы, которая принимает тот же CSV — файл называется wdg_key.txt.)
  3. Занимайтесь вардрайвингом как обычно. Вставьте карту, запустите Wardrive в Marauder и езжайте или идите пешком. Логи сохраняются с префиксом wardrive_.
  4. Подключите Marauder к Wi-Fi. Выполните AP scan по Wi-Fi, затем используйте Join WiFi (или CLI-команду join), чтобы подключиться к сети. Учётные данные сохраняются и используются повторно, так что это нужно сделать только один раз для каждой сети.
  5. Запустите отправку. Начните отправку в WiGLE из меню. Marauder подключается, используя сохранённые учётные данные Wi-Fi и WiGLE, и отправляет логи; отправка выполняется в фоновом режиме. После обработки ваши сети засчитываются в статистику WiGLE.
Проверьте версию — прочтите перед прошивкой: PR #1359 был влит 2026-07-07T20:39:30Z, примерно на 18 часов позже, чем в тот же день был опубликован v1.13.0 — текущий стабильный релиз (2026-07-07T03:02:42Z). Это значит, что v1.13.0 не содержит автозагрузку, и стабильной версии v1.14.0 пока нет: сейчас функция существует только в nightly / предрелизных сборках v1_14_0_beta. Ролики сообщества с названием «1.14.0 Update» показывают именно эти nightly, а не опубликованную стабильную версию. Если вы хотите автозагрузку сегодня, вы выбираете nightly-сборку, прошиваемую через USB-C. На любой стабильной сборке по-прежнему работает ручной способ «вынуть карту и загрузить на wigle.net».

Где это особенно полезно: плата, уже подключённая к Wi-Fi

Загвоздка автозагрузки в том, что что-то должно уметь работать с Wi-Fi. На вардрайвинг-комплекте ESP32 сам является Wi-Fi-модулем — поэтому он может и сканировать, и, когда вы закончили, подключиться к сети и отправить данные. На Scout Lite ESP32-C5, который выполняет ваше двухдиапазонное сканирование, — тот же модуль, что и отправляет данные, поэтому весь цикл (скан → GPS-метка → отправка) проходит на одной плате через USB-C, а microSD хранит лог. Если вы используете отдельную плату ESP32 для вардрайвинга, та же функция работает, если на этой плате установлена версия Marauder, которая включает автозагрузку — сегодня это означает nightly-сборку. Новичок в этом процессе? Начните с полного гайда по вардрайвингу.

Если отправка не удаётся

Симптом Вероятная причина Решение
«Auth failed» / отклонено Неверный API Name/Token Скопируйте заново из аккаунта wigle.net в оба txt-файла, без лишних символов
Не подключается Не подключено к Wi-Fi (STA) Выполните AP scan, затем Join WiFi к сети с доступом в интернет
Ничего не отправляется На карте нет логов wardrive_ Убедитесь, что вардрайвинг действительно был выполнен и CSV находится в корне SD
Повторно отправляются дубликаты Файл переименован Marauder определяет файлы по имени и размеру; сохраняйте исходные имена

Scout Lite — сканирование, метки, отправка — всё на плате

ESP32-C5 с двухдиапазонным Wi-Fi 6 + встроенный GPS L86-M33 + microSD, с предустановленным Marauder. Тот же модуль, что занимается вардрайвингом, может подключиться к Wi-Fi и отправить ваши логи в WiGLE — без компьютера в цепочке.

Купить Scout Lite GPS-модуль

Часто задаваемые вопросы

Какая прошивка нужна для автозагрузки в WiGLE?
Сборка, которая включает PR #1359, влитый 2026-07-07. Это ещё не стабильный релиз: v1.13.0, текущая стабильная версия, была опубликована за несколько часов до влития и не содержит его, а стабильной версии v1.14.0 не существует. Сегодня функция поставляется только в nightly-сборках. На стабильных сборках по-прежнему работает ручная отправка с извлечением SD-карты.
Куда помещать учётные данные API WiGLE?
В два обычных текстовых файла в корне SD-карты: wigle_api_name.txt (ваш API Name) и wigle_api_token.txt (ваш API Token), каждый содержит только это значение. Оба значения можно получить на странице аккаунта WiGLE.
Нужны ли по-прежнему карта microSD и аккаунт WiGLE?
Да, нужны оба. Логи по-прежнему сначала записываются на SD-карту, а для отправки нужны учётные данные API аккаунта WiGLE. Автозагрузка убирает только ручной шаг с компьютером.
Как плата выходит в сеть для отправки?
ESP32 подключается к сети Wi-Fi в режиме станции (STA). Выполните AP scan, затем используйте 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 существует только как nightly-предрелизные сборки согласно API релизов (github.com); вики ESP32Marauder Wardrive — префикс wardrive_ / wigle.net (github.com); API WiGLE (api.wigle.net); WDGoWars (wdgwars.pl) — независимая сторонняя платформа, принимающая WigleWifi CSV. Характеристики Scout Lite — по данным листинга PINGEQUA. Версии актуальны на 2026-07-17.

Только для авторизованных сетевых исследований, аудита безопасности и электронного образования. Сканируйте или проверяйте только те сети, которыми вы владеете или на тестирование которых у вас есть явное разрешение. При отправке данных соблюдайте условия использования WiGLE. Конечные пользователи несут ответственность за соблюдение местного законодательства.

Вернуться к блогу