firmwarebeginner
Oui-Spy Detector: BLE Device Scanner
Standalone BLE scanning firmware for the Oui-Spy that detects targeted Bluetooth devices by MAC address or manufacturer OUI prefix with audio/visual alerts, web portal configuration, and persistent device history.
Boards:esp32-s3
Firmware:arduinoplatformio
Use Cases:Ble Security ResearchSurveillance Detection
Oui-Spy Detector: BLE Device Scanner
The Oui-Spy Detector is the core BLE scanning firmware for the Oui-Spy board, enabling real-time detection and tracking of Bluetooth Low Energy devices by MAC address or manufacturer OUI (Organizationally Unique Identifier).
Features
Detection
- OUI prefix filtering for device manufacturers
- Full MAC address matching
- Persistent configuration storage with automatic timeout handling
- Stores up to 100 detected devices in non-volatile storage
- Auto-saves device data every 60 seconds
Alerts
- Audio alerts: ascending beeps on readiness, triple beeps on detection
- NeoPixel LED synchronized visual animations
- Pink breathing LED during scanning; blue-pink-purple flashes on detection
Privacy and Security
- MAC address randomization at startup for operational privacy
- Burn-in mode that permanently locks configuration for deployment
- Requires flash erase to unlock locked devices
Web Interface
- Configuration portal at 192.168.4.1
- Custom device naming
- Target watchlist management
- Detection history review
Dependencies
- NimBLE-Arduino
- ESP Async WebServer
- Adafruit NeoPixel
