ESP32-C5 Marauder WiGLE wardriving upload board

ESP32 Marauder WiGLE Auto-Upload: sube registros de wardriving sin PC

PINGEQUA Lab · Guía práctica · 6 min de lectura · Actualizado 2026-07-17

El viejo ciclo de wardriving terminaba con una tarea pesada: sacar la microSD, buscar una computadora, iniciar sesión en WiGLE y subir el CSV a mano. El auto-upload de ESP32 Marauder elimina ese último paso: el dispositivo sube los datos por ti.

Respuesta rápidaESP32 Marauder puede subir los registros de wardriving a WiGLE directamente desde el dispositivo — sin computadora, sin sacar la tarjeta. Colocas tus credenciales de la API de WiGLE en dos archivos de texto en la raíz de la tarjeta SD — wigle_api_name.txt y wigle_api_token.txt — conectas el Marauder a una red Wi-Fi con Join WiFi y activas la subida desde el menú. Usa las credenciales guardadas para enviar tus registros wardrive_ directamente a wigle.net. Una advertencia antes de que cuentes con ello: la función se fusionó como PR #1359 el 2026-07-07, pero todavía no está en una versión estable — hoy solo llega en compilaciones nightly. En una placa Wi-Fi nativa como Scout Lite, todo ese ciclo ocurre en la propia placa.

Qué cambió

Marauder siempre ha escrito los registros de wardriving en la tarjeta SD como CSV WigleWifi, con el prefijo de archivo wardrive_, listos para subir a wigle.net. Lo que no hacía era subirlos — eso quedaba en tus manos, después, en una computadora. PR #1359 cambió eso: Marauder ahora puede conectarse a Wi-Fi y enviar los registros de wardriving directamente a WiGLE — y, por separado, a WDGoWars, un juego de wardriving independiente de terceros que acepta el mismo formato CSV WigleWifi. Es una de las funciones de comodidad más solicitadas del proyecto.

Aún necesitas tres cosas: una cuenta de WiGLE con credenciales de API, una tarjeta microSD (los registros se siguen escribiendo ahí primero) y una red Wi-Fi al alcance con acceso a internet para que la placa pueda llegar a wigle.net. El auto-upload sustituye el paso manual — no elimina la tarjeta SD ni la cuenta.

Paso a paso: de wardriving a WiGLE, sin computadora

  1. Consigue tus credenciales de la API de WiGLE. Inicia sesión en wigle.net, abre tu página de Account y busca tu API Name y tu API Token (WiGLE los usa para el acceso autenticado a la API).
  2. Coloca dos archivos en la raíz de la tarjeta SD. Crea wigle_api_name.txt con únicamente tu API Name, y wigle_api_token.txt con únicamente tu API Token — sin texto adicional, sin comillas. (Para WDGoWars — una plataforma independiente y sin afiliación que acepta el mismo CSV — el archivo es wdg_key.txt.)
  3. Haz wardriving como siempre. Inserta la tarjeta, inicia Wardrive en Marauder y conduce o camina. Los registros se guardan con el prefijo wardrive_.
  4. Conecta el Marauder a Wi-Fi. Ejecuta un AP scan de Wi-Fi y luego usa Join WiFi (o el comando CLI join) para conectarte a una red. Las credenciales se guardan y se reutilizan, así que solo lo haces una vez por red.
  5. Activa la subida. Inicia la subida a WiGLE desde el menú. Marauder se conecta usando tus credenciales guardadas de Wi-Fi y WiGLE y envía los registros; la subida corre en segundo plano. Tus redes cuentan para tus estadísticas de WiGLE después del procesamiento.
Verifica la versión — léelo antes de flashear: el PR #1359 se fusionó el 2026-07-07T20:39:30Z, unas 18 horas después de que se publicara v1.13.0 — la versión estable actual — ese mismo día (2026-07-07T03:02:42Z). Eso significa que v1.13.0 no incluye el auto-upload, y todavía no existe una v1.14.0 estable: por ahora la función solo existe en compilaciones nightly / prelanzamiento v1_14_0_beta. Los vídeos de la comunidad titulados "1.14.0 Update" muestran esas nightly, no una versión estable publicada. Si quieres el auto-upload hoy, estás optando por una compilación nightly, flasheada por USB-C. En cualquier versión estable, el método manual de "sacar la tarjeta y subir en wigle.net" sigue funcionando.

Dónde brilla esto: una placa que ya está en Wi-Fi

El detalle del auto-upload es que algo tiene que hablar con Wi-Fi. En un equipo de wardriving, el ESP32 es el radio Wi-Fi — así que puede tanto escanear como, cuando termines, unirse a una red y subir los datos. En Scout Lite, el ESP32-C5 que hace tu escaneo dual-band es el mismo radio que sube los datos — así que todo el ciclo (escanear → etiquetar con GPS → subir) vive en una sola placa por USB-C, con la microSD guardando el registro. Si usas una placa ESP32 de wardriving separada, la misma función funciona siempre que esa placa tenga una versión de Marauder que incluya el auto-upload — hoy eso significa una nightly. ¿Nuevo en este flujo de trabajo? Empieza con la guía completa de wardriving.

Si la subida falla

Síntoma Causa probable Solución
"Auth failed" / rechazado API Name/Token incorrecto Vuelve a copiar desde tu cuenta de wigle.net a los dos archivos txt, sin caracteres adicionales
No se conecta No está unido a Wi-Fi (STA) Haz un AP scan y luego usa Join WiFi para conectarte a una red con internet
No sube nada No hay registros wardrive_ en la tarjeta Confirma que realmente hiciste wardriving y que el CSV está en la raíz de la SD
Vuelve a subir duplicados Archivo renombrado Marauder identifica por nombre de archivo + tamaño; conserva los nombres originales

Scout Lite — escanea, etiqueta y sube, todo integrado

ESP32-C5 Wi-Fi 6 dual-band + GPS L86-M33 integrado + microSD, con Marauder preinstalado. El mismo radio que hace wardriving puede unirse a Wi-Fi y enviar tus registros a WiGLE — sin computadora de por medio.

Consigue Scout Lite Módulo GPS

Preguntas frecuentes

¿Qué firmware necesito para el auto-upload de WiGLE?
Una compilación que incluya el PR #1359, que se fusionó el 2026-07-07. Eso todavía no es una versión estable: la v1.13.0, la versión estable actual, se publicó unas horas antes de la fusión y no lo incluye, y no existe una v1.14.0 estable. Hoy la función solo llega en compilaciones nightly. En las versiones estables, la subida manual sacando la tarjeta SD sigue funcionando.
¿Dónde coloco las credenciales de la API de WiGLE?
En dos archivos de texto plano en la raíz de la tarjeta SD: wigle_api_name.txt (tu API Name) y wigle_api_token.txt (tu API Token), cada uno con solo ese valor. Consigue ambos en tu página de cuenta de WiGLE.
¿Sigo necesitando una tarjeta microSD y una cuenta de WiGLE?
Sí, ambas cosas. Los registros se siguen escribiendo primero en la tarjeta SD, y la subida requiere las credenciales de API de una cuenta de WiGLE. El auto-upload solo elimina el paso manual con computadora.
¿Cómo se conecta la placa a internet para subir los datos?
El ESP32 se une a una red Wi-Fi en modo estación (STA). Ejecuta un AP scan y luego usa Join WiFi (o el comando CLI join); las credenciales se guardan y se reutilizan para futuras subidas.
¿Va a subir el mismo archivo dos veces?
Marauder rastrea las subidas por nombre de archivo y tamaño, así que evita volver a subir el mismo registro. Renombrar un archivo hace que parezca nuevo, así que conserva los nombres wardrive_ originales.

Fuentes: justcallmekoko/ESP32Marauder PR #1359 "Enable direct upload to WDGWars and WiGLE", fusionado 2026-07-07T20:39:30Z (github.com) — archivos de configuración SD wigle_api_name.txt/wigle_api_token.txt/wdg_key.txt y el flujo de Join WiFi; versión v1.13.0 de ESP32Marauder, publicada 2026-07-07T03:02:42Z (github.com) — estable actual, anterior a esa fusión; v1.14.0 solo existe como compilaciones nightly de prelanzamiento según la API de releases (github.com). wiki de Wardrive de ESP32Marauder — prefijo wardrive_ / wigle.net (github.com); API de WiGLE (api.wigle.net); WDGoWars (wdgwars.pl) — plataforma independiente de terceros que acepta CSV WigleWifi. Especificaciones de Scout Lite según el listado de PINGEQUA. Versiones vigentes a 2026-07-17.

Solo para investigación autorizada de redes, auditoría de seguridad y educación en electrónica. Escanea o evalúa únicamente redes que sean tuyas o para las que tengas permiso explícito. Sigue los términos de WiGLE al subir datos. Los usuarios finales son responsables de cumplir con la ley local.

Regresar al blog