Entwicklung eines Mikrocontroller-Systems zur passiven WLAN-Signalanalyse bei polizeilichen Durchsuchungsmaßnahmen
  • Typst 47.4%
  • Dart 41.8%
  • TeX 4.5%
  • Rust 3.3%
  • Rich Text Format 2.5%
  • Other 0.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-09-03 11:13:17 +00:00
.forgejo/workflows Publishing commit after cleanup 2026-09-03 11:53:43 +02:00
defense Publishing commit after cleanup 2026-09-03 11:53:43 +02:00
firmware Publishing commit after cleanup 2026-09-03 11:53:43 +02:00
mobile Publishing commit after cleanup 2026-09-03 11:53:43 +02:00
paper chore: update compiled paper [skip ci] 2026-09-03 11:13:17 +00:00
.gitignore Publishing commit after cleanup 2026-09-03 11:53:43 +02:00
CITATION.bib updated citation.bib 2026-09-03 13:12:43 +02:00
LICENSE Publishing commit after cleanup 2026-09-03 11:53:43 +02:00
README.md updated citation.bib 2026-09-03 13:12:43 +02:00

Wallbreaker License: AGPL v3

Passive Wi-Fi signal analysis for locating active WLAN-capable devices. An ESP32-C5 captures 802.11 frames in monitor mode (2.4/5 GHz) and streams source MAC, destination MAC and RSSI over BLE to a mobile app.

Repository layout

firmware/    Rust no_std firmware for the ESP32-C5 (sniffing, BLE GATT server)
mobile/      Flutter app (BLE client, RSSI graph, haptic feedback, OUI lookup)
paper/       Bachelor thesis source (Typst)
defense/     Defense presentation source (Typst)

Building

Firmware

cd firmware
cargo build --release

Flash and monitor:

cargo run --release

Requires the espflash runner (see .cargo/config.toml) and a toolchain with the riscv32imac-unknown-none-elf target, as pinned in rust-toolchain.toml.

Mobile app

cd mobile
flutter run

The app targets iOS and Android. It connects to the sensor via BLE, displays the RSSI history, provides haptic guidance, and resolves MAC addresses to vendors from the bundled OUI database.

License

GNU AGPL v3. See LICENSE.

Citing

See CITATION.bib.