Skip to content

mod_ble

Authorized Use Only

Espilon is a security research and educational tool. Use it only on devices and networks you own or are explicitly authorized in writing to test.

Bluetooth Low Energy toolkit: passive scanning, advertisement flooding, and Apple Find My (AirTag-style) emulation. ESPM module using the BLE syscalls.

Field Value
Targets BLE-capable chips (ESP32-C6, ESP32-S3 v0.3+, ESP32-C3)

Chip compatibility

BLE is initialized on demand and is available only on BLE-capable chips. The ESP32 classic has no BLE; the ESP32-S3 v0.2 cannot use it (silicon errata). See supported boards.

Commands

Command Arguments Description
ble_scan [duration_s] Passive scan (default 10 s). Streams one line per device: MAC RSSI mfr_id "name".
ble_flood <swiftpair\|fastpair\|random> Cycle BLE advertisements to trigger pairing popups. swiftpair = Microsoft Swift Pair, fastpair = Google Fast Pair, random = random device names.
ble_flood_stop Stop the running flood.
ble_airtag [stop] Start (or stop) an Apple Offline Finding advertisement with a random 28-byte key; nearby iPhones relay it to the Find My network.

See also