52df6421be
WiFi & Bluetooth signal mapping tool for Raspberry Pi with: - WiFi scanning via iw command - Bluetooth Classic/BLE device discovery - RSSI-based distance estimation - OUI manufacturer lookup - Web dashboard with multiple views: - Radar view (polar plot) - 2D Map (Leaflet/OpenStreetMap) - 3D Map (MapLibre GL JS with building extrusion) - Floor-based device positioning - Live BT tracking mode (auto-starts on page load) - SQLite database for historical device tracking: - RSSI time-series history - Device statistics (avg/min/max) - Movement detection and velocity estimation - Activity patterns (hourly/daily) - New device alerts - Automatic data retention/cleanup - REST API for all functionality Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.8 KiB
2.8 KiB
RF Mapper Roadmap
Current Version: v0.3.0-dev
v0.1.0 - Core Scanning (COMPLETED)
- WiFi network scanning via
iw - Bluetooth device scanning (Classic + BLE)
- OUI manufacturer lookup
- Device class decoding
- Distance estimation (RSSI-based)
- JSON scan output
- CLI interface
- Basic configuration (YAML)
v0.2.0 - Web Dashboard (COMPLETED)
- Flask web server
- Radar visualization (canvas)
- 2D map view (Leaflet + OSM)
- Device cards with signal bars
- Manual scan trigger
- Auto-scan scheduling
- Bluetooth device identification
- GPS position configuration
v0.3.0 - 3D Visualization (IN PROGRESS)
- MapLibre GL JS integration
- 3D building extrusion
- Floor-based device positioning
- Floor selector UI
- Device floor assignment (popup)
- Custom distance override
- Live BT tracking mode
- Moving device detection (purple markers)
- Filter-aware scanning (WiFi/BT toggle)
- Reliable RSSI acquisition for movement tracking
- Position smoothing/averaging
- Device trails/history visualization
v0.4.0 - Multilateration & Positioning
- Multi-point scanning (move scanner, record positions)
- Trilateration algorithm for device positioning
- Heat map visualization
- Signal strength interpolation
- Calibration mode for distance estimation
- Reference point management
- Position confidence indicators
v0.5.0 - Persistence & History
- SQLite database for scan history
- Device tracking over time
- Historical signal strength graphs (UI)
- First seen / last seen timestamps
- Device naming/labeling
- Favorites/known devices
- Export to CSV/Excel
v0.6.0 - Alerts & Automation
- New device alerts
- Signal threshold alerts
- Webhook notifications
- Home Assistant integration (MQTT)
- Presence detection automation
- Device absence detection
- Scheduled reports
v1.0.0 - Production Ready
- Comprehensive test suite
- Performance optimization
- Docker container
- systemd service file
- Multi-user support
- Authentication (optional)
- Complete documentation
- PyPI package release
Future Ideas (v2.0+)
- Multiple scanner nodes (distributed scanning)
- Mesh network visualization
- Spectrum analyzer integration
- RTL-SDR support for wider RF
- Machine learning device classification
- Mobile app companion
- AR visualization mode
- Integration with Wireshark
- Packet capture correlation
Version History
| Version | Date | Highlights |
|---|---|---|
| v0.1.0 | 2026-01 | Initial CLI scanner |
| v0.2.0 | 2026-01 | Web dashboard |
| v0.3.0 | TBD | 3D visualization |