Files
rf-mapper/ROADMAP.md
User 0e99232582 Switch to bleak for reliable BLE scanning with RSSI
- Replace hcitool-based BT scanning with bleak Python library
- Bleak provides reliable RSSI values via D-Bus/BlueZ
- BLE scan now finds devices that hcitool missed
- Update project docs to reflect resolved BT RSSI blocker
- Add bleak>=0.21.0 to dependencies

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-01 00:17:47 +01:00

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 (bleak)
  • 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