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

Deauthentication Attack Notification & Guard Detection Utility Toolkit

ポケットの中のワイヤレスガーディアン。

作者: XsanLahci

これは何か

D.A.N.G.D.U.T. は、Wi-Fi の deauthentication 攻撃および disassociation 攻撃をリアルタイムで検出するために設計されたパッシブ型 Wireless Intrusion Detection System (WIDS) です。完全にパッシブに動作し、Wi-Fi 無線の送信・インジェクション・制御を一切行わないため、純粋な監視ツールとして機能します。

もともとは Flipper Zero 向けの外部モジュールとして設計されましたが、現在このプロジェクトはスタンドアロンハードウェアをサポートするよう進化し、独自の画面とインターフェースを備えたポケットサイズの専用デバイスで WIDS 体験を提供しています。

対応プラットフォーム:

1. M5 Cardputer ADV Stamp S3a (スタンドアロン)

2. ESP32-S3 Mini OLED (スタンドアロン)

3. Flipper Zero (ESP32-S2 WiFi Devboard 経由)

1. M5 Cardputer & ESP32-S3 Mini OLED (スタンドアロン版)

これらのバージョンは完全にスタンドアロンであり、動作に Flipper Zero を必要としません。強力な ESP32-S3 チップを活用して攻撃を監視し、UI を内蔵画面に直接描画します。

🌟 独自機能

• ローディングブート: よりスムーズで見栄えの良い起動体験を実現するカスタムローディングブートシーケンス。

• インタラクティブ操作 (Cardputer): Cardputer のキーボード/インターフェースを使って、Wi-Fi deauth 攻撃の監視をシームレスに開始・停止できます。

• 作者について: プロジェクトおよび作者の情報を表示する専用セクション。

• ライブ表示: ターゲット MAC、送信元 MAC、RSSI を OLED/Cardputer 画面に直接表示するリアルタイム攻撃アラート。

🛠️ インストール

1. Releases/Assets セクションから、お使いのデバイス用に事前コンパイルされたファームウェア (例: dangdut_esp32s3_cardputer.bin) をダウンロードします。

2. M5 Cardputer または ESP32-S3 Mini OLED を USB 経由でコンピュータに接続します。

3. Chrome または Edge ブラウザで Dangdut Web Flasher を開き、.bin ファイルを簡単に書き込みます。(あるいは、esptool.py や M5Burner など、お好みの ESP32 書き込みツールを使用することもできます)。

4. デバイスを再起動します。新しいローディング画面が表示され、すぐに監視を開始できます。

2. Flipper Zero 版 (.fap)

このバージョンは Flipper Zero アプリケーション (.fap) として動作し、接続された DANGDUT WiFi Devboard (ESP32-S2) から送信される UART ステータス行を読み取ることで、Flipper の画面にライブの攻撃検出ステータスを表示します。

フォルダ構成

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

要件

• 公式ファームウェア（または FAP 外部アプリと furi_hal_serial をサポートする互換カスタムファームウェア）を搭載した Flipper Zero。

• コンピュータにインストールされた ufbt（micro Flipper Build Tool）（pip install ufbt）。

• dangdut_esp32s2_flipper.ino を書き込んだ DANGDUT WiFi Devboard（ESP32-S2）。

ビルドとインストールの手順

1. このフォルダをコンピュータ上の任意の場所に配置します（例: ~/flipper-apps/dangdut_flipper_app/）。

2. このフォルダ内でターミナルを開き、ufbt を実行します。これにより dangdut_app.c がコンパイルされ、dist/ フォルダ内に .fap ファイルが生成されます。

3. Flipper Zero を USB で接続し、ufbt launch を実行します。これによりアプリがインストールされ、直接起動します。（あるいは、qFlipper を使って .fap を SD Card / apps / Tools / にコピーします。）

4. 書き込み済みの DANGDUT WiFi Devboard（ESP32-S2）を Flipper Zero の GPIO ヘッダーに接続します。

5. アプリを起動します。次のように表示されるはずです:

   • 最初の UART 行が届くまで "Waiting for devboard..."。

   • 通常状態では "SYSTEM SECURE"。

   • 攻撃中は "ATTACK DETECTED"（赤いバナーが点滅 + 赤色 LED、さらに MAC/RSSI 情報）。

操作

• BACK ボタン -> アプリを終了し、Flipper のメニューに戻ります。

プロトコルリファレンス（ESP32-S2 から Flipper UART）

ESP32-S2 ファームウェアの出力と一致している必要があります。行は改行で終端され、115200 baud で 1 秒に 1 回送信されます。

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

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

ハッピースキャニング！