BLE Scout para LILYGO T-Dongle-S3

Firmware autónomo de inventario Bluetooth Low Energy para el LILYGO T-Dongle-S3 con pantalla. Al conectarlo, realiza un escaneo BLE pasivo, deduplica dispositivos, muestra un radar animado en la pantalla y guarda evidencias CSV y HTML en la tarjeta microSD. Al terminar levanta un panel web local para consultar y descargar los resultados desde un teléfono o una PC.

Problema que resuelve: levantar un inventario BLE pasivo con evidencia descargable sin depender de un portátil durante la observación. El dashboard se sirve en la red local del dispositivo; no es una demo pública accesible por Internet.

La galería técnica incluye las infografías completas y fotografías de la validación física.

Descarga rápida

Archivo	Cuándo usarlo	Dirección
BLE-Scout_v1.0.0_factory.bin	Instalación limpia o dispositivo con firmware distinto	0x0
BLE-Scout_v1.0.0_update.bin	Actualizar un T-Dongle-S3 que ya ejecuta USB Army Knife	0x10000
autorun.ds	Copiar en la raíz de la microSD	—

Consulta la instalación paso a paso antes de flashear.

Qué hace

• Ejecuta automáticamente un escaneo BLE pasivo de 45 segundos.
• Registra hasta 128 dispositivos BLE únicos por sesión.
• Conserva MAC, nombre anunciado, mejor RSSI, primera y última observación, número de apariciones, UUID de servicio y datos de fabricante.
• Ordena los resultados por intensidad de señal.
• Genera un reporte CSV para análisis y un reporte HTML listo para evidencias.
• Muestra en la pantalla un radar nativo, contador de dispositivos y progreso.
• Publica un dashboard móvil local con estado, memoria, errores y descargas.
• Permite repetir el escaneo BLE con una pulsación corta.
• Permite ejecutar un inventario Wi-Fi de 2.4 GHz con una pulsación larga.
• Conserva la interfaz avanzada de USB Army Knife en /advanced.html.

BLE Scout observa anuncios BLE; no necesita emparejarse ni conectarse a los dispositivos encontrados.

Flujo de uso

1. Insertar la microSD FAT32 con sd/autorun.ds en la raíz.

2. Conectar el dongle a una fuente USB o computadora.

3. Esperar el escaneo de 45 segundos. Durante este periodo el punto de acceso Wi-Fi permanece apagado para liberar la radio.

4. Al ver BLE DONE / SD SAVED y el LED verde, conectarse a:

   • SSID: iPhone14
   • Clave: password
   • Panel: http://4.3.2.1:8080/

5. Abrir o descargar los reportes desde el dashboard.

El texto Running después del escaneo es normal: el script sigue activo y está esperando la siguiente pulsación.

Controles físicos

El T-Dongle-S3 no tiene botón en la cara de la pantalla. Las acciones se realizan con el único botón trasero/BOOT, ubicado sobre la PCB y conectado a GPIO 0 (activo en bajo). Al encender normalmente, no debe mantenerse presionado.

Acción	Resultado
Pulsación corta del botón trasero	Nuevo escaneo BLE de 45 segundos
Pulsación larga del botón trasero	Inventario Wi-Fi 2.4 GHz de 20 segundos
Desconectar y conectar	Inicia nuevamente el flujo automático

El mismo botón cumple dos funciones según el momento: si se mantiene presionado mientras se conecta el USB, entra al cargador ROM para flashear; una vez iniciado BLE Scout, las pulsaciones corta y larga controlan las auditorías.

Panel web

 

Ruta	Función
http://4.3.2.1:8080/	Dashboard BLE Scout
http://4.3.2.1:8080/ble.html?v=2	Dashboard directo sin caché anterior
http://4.3.2.1:8080/advanced.html	Interfaz completa de USB Army Knife

El teléfono mostrará “Sin conexión a Internet”; es correcto porque se trata de una red local creada por el dongle.

Reportes

Cada sesión crea archivos independientes:

• /BLE_Scout_0001.csv
• /BLE_Scout_0001.html
• /BLE_Scout_0002.csv, etc.

La MAC puede ser privada o rotatoria y el RSSI es una estimación de proximidad, no una medición de distancia exacta. El radar es una representación visual de actividad; no determina dirección física ni posición.

Consulta la guía de operación e interpretación.

Compatibilidad

El binario publicado está compilado específicamente para:

• LILYGO T-Dongle-S3 con pantalla
• ESP32-S3
• Flash de 16 MB
• TFT 160 × 80
• microSD mediante SD_MMC
• único botón trasero/BOOT en GPIO 0 (activo en bajo) y LED APA102

No se debe usar el binario precompilado en T-Watch, Pocket Dongle, ESP32-S2, RP2040 u otras placas. El código puede portarse y recompilarse, pero esas variantes requieren adaptar pines, pantalla y almacenamiento. Consulta compatibilidad.

Construcción desde código

La carpeta source/overlay contiene todas las modificaciones aplicadas sobre USB Army Knife en el commit 59db1bab0ce06497023118211a4c073ec6f36453. Las instrucciones reproducibles están en source/README.md.

Estructura

BLE-Scout/
├── firmware/          Binarios factory y update + SHA-256
├── sd/autorun.ds      Automatización que se copia a la microSD
├── tools/             Flasheo y verificación para Windows
├── source/overlay/    Código modificado sobre USB Army Knife
└── docs/              Instalación, uso, compatibilidad, galería e imágenes

Créditos

BLE Scout se construyó sobre:

• USB Army Knife, por i-am-shodan.
• ESP32 Marauder.
• LILYGO T-Dongle-S3.

Proyecto publicado por RogerF5-Security. Licencia MIT.

Uso autorizado: opera el firmware solo en entornos controlados y auditorías con permiso. Gestiona MAC, nombres y reportes según el alcance y la política de conservación de evidencias.