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

Deauthentication Attack Notification & Guard Detection Utility Toolkit

Il guardiano wireless nella tua tasca.

Autore: XsanLahci

Di cosa si tratta

D.A.N.G.D.U.T. è un sistema passivo di rilevamento delle intrusioni wireless (WIDS) progettato per rilevare in tempo reale gli attacchi Wi-Fi di deautenticazione e disassociazione. Opera in modo completamente passivo: non trasmette, non inietta e non controlla la radio Wi-Fi, garantendo di rimanere un puro strumento di monitoraggio.

Originariamente concepito come modulo esterno per il Flipper Zero, il progetto si è ora evoluto per supportare hardware standalone, portando l'esperienza WIDS su dispositivi dedicati tascabili con schermi e interfacce propri.

Piattaforme supportate:

1. M5 Cardputer ADV Stamp S3a (Standalone)

2. ESP32-S3 Mini OLED (Standalone)

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

1. M5 Cardputer & ESP32-S3 Mini OLED (versioni standalone)

Queste versioni sono completamente standalone e non richiedono un Flipper Zero per funzionare. Sfruttano il potente chip ESP32-S3 per monitorare gli attacchi e visualizzare l'interfaccia direttamente sui propri schermi integrati.

🌟 Funzionalità esclusive

• Loading Boot: sequenza di avvio personalizzata per un'esperienza di avvio più fluida e visivamente accattivante.

• Controllo interattivo (Cardputer): avvia e arresta senza problemi il monitoraggio degli attacchi Wi-Fi deauth direttamente tramite la tastiera/interfaccia del Cardputer.

• Informazioni sull'autore: una sezione dedicata per visualizzare le informazioni sul progetto e sull'autore.

• Visualizzazione live: avvisi di attacco in tempo reale che mostrano il MAC di destinazione, il MAC del mittente e l'RSSI direttamente sullo schermo OLED/Cardputer.

🛠️ Installazione

1. Scarica il firmware precompilato per il tuo dispositivo specifico dalla sezione Releases/Assets (ad es. dangdut_esp32s3_cardputer.bin).

2. Collega il tuo M5 Cardputer o ESP32-S3 Mini OLED al computer tramite USB.

3. Apri il Dangdut Web Flasher nel tuo browser Chrome o Edge per flashare facilmente il file .bin. (In alternativa, puoi usare il tuo strumento di flashing ESP32 preferito come esptool.py o M5Burner).

4. Riavvia il dispositivo. Vedrai la nuova schermata di caricamento e potrai iniziare subito il monitoraggio.

2. Versione Flipper Zero (.fap)

Questa versione funziona come applicazione per Flipper Zero (.fap) che visualizza lo stato di rilevamento degli attacchi in tempo reale sullo schermo del Flipper leggendo le righe di stato UART inviate da una DANGDUT WiFi Devboard (ESP32-S2) collegata.

Struttura delle cartelle

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

Requisiti

• Flipper Zero con firmware ufficiale (o firmware personalizzato compatibile che supporti le app esterne FAP e furi_hal_serial).

• ufbt (micro Flipper Build Tool) installato sul tuo computer (pip install ufbt).

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

Passaggi di compilazione e installazione

1. Posiziona questa cartella in un punto qualsiasi del tuo computer (ad es. ~/flipper-apps/dangdut_flipper_app/).

2. Apri un terminale all'interno di questa cartella ed esegui: ufbt. Questo compila dangdut_app.c in un file .fap nella cartella dist/.

3. Collega il tuo Flipper Zero via USB, poi esegui: ufbt launch. Questo installa e avvia direttamente l'app. (In alternativa, copia il file .fap in SD Card / apps / Tools / usando qFlipper).

4. Collega la DANGDUT WiFi Devboard (ESP32-S2) con firmware installato all'header GPIO del Flipper Zero.

5. Avvia l'app. Dovresti vedere:

   • "Waiting for devboard..." finché non arriva la prima riga UART.

   • "SYSTEM SECURE" in condizioni normali.

   • "ATTACK DETECTED" (banner rosso lampeggiante + LED rosso, oltre alle informazioni MAC/RSSI) durante un attacco.

Comandi

• Pulsante BACK -> esce dall'app e torna al menu del Flipper.

Riferimento del protocollo (da ESP32-S2 a Flipper UART)

Deve corrispondere all'output del firmware ESP32-S2. Le righe terminano con un newline e vengono inviate una volta al secondo a 115200 baud.

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

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

Buona scansione!