D.A.N.G.D.U.T.

Kit de Herramientas de Utilidad para Detección y Notificación de Ataques de Desautenticación

Guardián Inalámbrico en Tu Bolsillo.

Autor: XsanLahci

Qué es esto

D.A.N.G.D.U.T. es un Sistema de Detección de Intrusiones Inalámbricas (WIDS) pasivo diseñado para detectar ataques de desautenticación y desasociación Wi-Fi en tiempo real. Opera de forma completamente pasiva—no transmite, inyecta ni controla la radio Wi-Fi, lo que garantiza que siga siendo una herramienta de monitoreo pura.

Originalmente diseñado como un módulo externo para el Flipper Zero, el proyecto ha evolucionado ahora para soportar hardware independiente, llevando la experiencia WIDS a dispositivos dedicados de tamaño bolsillo con sus propias pantallas e interfaces.

Plataformas Compatibles:

1. M5 Cardputer ADV Stamp S3a (Independiente)

2. ESP32-S3 Mini OLED (Independiente)

3. Flipper Zero (mediante ESP32-S2 WiFi Devboard)

1. M5 Cardputer y ESP32-S3 Mini OLED (Versiones Independientes)

Estas versiones son totalmente independientes y no requieren un Flipper Zero para funcionar. Aprovechan el potente chip ESP32-S3 para monitorear ataques y renderizar la interfaz de usuario directamente en sus pantallas integradas.

🌟 Características Exclusivas

• Arranque con Carga: Secuencia de arranque con carga personalizada para una experiencia de inicio más fluida y visualmente atractiva.

• Control Interactivo (Cardputer): Inicia y detén sin problemas el monitoreo de ataques de desautenticación Wi-Fi directamente usando el teclado/interfaz del Cardputer.

• Acerca del Autor: Una sección dedicada para ver información del proyecto y del autor.

• Pantalla en Vivo: Alertas de ataques en tiempo real que muestran la MAC objetivo, la MAC del remitente y el RSSI directamente en la pantalla OLED/Cardputer.

🛠️ Instalación

1. Descarga el firmware precompilado para tu dispositivo específico desde la sección Releases/Assets (por ejemplo, dangdut_esp32s3_cardputer.bin).

2. Conecta tu M5 Cardputer o ESP32-S3 Mini OLED a tu computadora mediante USB.

3. Abre el Dangdut Web Flasher en tu navegador Chrome o Edge para flashear el archivo .bin fácilmente. (Alternativamente, puedes usar tu herramienta de flasheo ESP32 preferida como esptool.py o M5Burner).

4. Reinicia el dispositivo. Verás la nueva pantalla de carga y podrás comenzar a monitorear de inmediato.

2. Versión para Flipper Zero (.fap)

Esta versión funciona como una aplicación de Flipper Zero (.fap) que muestra el estado de detección de ataques en vivo en la pantalla del Flipper leyendo las líneas de estado UART enviadas desde un DANGDUT WiFi Devboard conectado (ESP32-S2).

Estructura de Carpetas

dangdut_flipper_app/
  application.fam      - app manifest (name, entry point, category)
  dangdut_app.c        - main app source (UART read + screen rendering)
  images/              - icon assets folder (add dangdut.png, 10x10 px, 1-bit)
  README.md            - this file

Requisitos

• Flipper Zero con firmware oficial (o firmware personalizado compatible que soporte aplicaciones externas FAP y furi_hal_serial).

• ufbt (micro Flipper Build Tool) instalado en tu computadora (pip install ufbt).

• DANGDUT WiFi Devboard (ESP32-S2) flasheada con dangdut_esp32s2_flipper.ino.

Pasos de compilación e instalación

1. Coloca esta carpeta en cualquier lugar de tu computadora (por ejemplo, ~/flipper-apps/dangdut_flipper_app/).

2. Abre una terminal dentro de esta carpeta y ejecuta: ufbt. Esto compila dangdut_app.c en un archivo .fap dentro de la carpeta dist/.

3. Conecta tu Flipper Zero por USB y luego ejecuta: ufbt launch. Esto instala y lanza la aplicación directamente. (Alternativamente, copia el .fap a SD Card / apps / Tools / usando qFlipper).

4. Conecta la DANGDUT WiFi Devboard (ESP32-S2) flasheada en el encabezado GPIO del Flipper Zero.

5. Lanza la aplicación. Deberías ver:

   • "Waiting for devboard..." hasta que llegue la primera línea UART.

   • "SYSTEM SECURE" en estado normal.

   • "ATTACK DETECTED" (banner rojo parpadeante + LED rojo, además de información de MAC/RSSI) durante un ataque.

Controles

• Botón BACK -> sale de la aplicación y regresa al menú del Flipper.

Referencia del protocolo (ESP32-S2 a Flipper UART)

Debe coincidir con la salida del firmware del ESP32-S2. Las líneas terminan en salto de línea y se envían una vez por segundo a 115200 baudios.

• SAFE|<total_packets>|<packets_per_sec>|<channel>

• ATTACK|<total_packets>|<packets_per_sec>|<channel>|<target_mac>|<sender_mac>|<rssi>

¡Feliz escaneo!