How cis-c0/rfsentinel works
RF Sentinel is an Android receive-only surveillance and radio-awareness app. The main workflow is passive radio scanning, signature-based identification and tracking, then presenting device alerts and locations to the user. The tree and README also document navigation, camera awareness, external radio hardware, Sentinel Link sharing, and Android Auto. Edges rely on README statements and the SOURCE INDEX references; unsampled subsystem connections are omitted where callers are not evidenced.
Main entry points: ScanForegroundService.kt Scan service · MainActivity.kt Main screen · DeviceRegistry.kt Device registry · SettingsActivity.kt Settings
Components 20
Scanning and detection
- Scan service
app/src/main/java/com/rfsentinel/app/service/ScanForegroundService.kt - BLE scanning
app/src/main/java/com/rfsentinel/app/service/BleScanEngine.kt - WiFi scanning
app/src/main/java/com/rfsentinel/app/service/WifiScanEngine.kt - Signature engine
app/src/main/java/com/rfsentinel/app/detect/SignatureEngine.kt - Radio observations
app/src/main/java/com/rfsentinel/app/detect/Advert.kt
Device state
- Device registry
app/src/main/java/com/rfsentinel/app/service/DeviceRegistry.kt - App database
app/src/main/java/com/rfsentinel/app/data/AppDatabase.kt - Preferences
app/src/main/java/com/rfsentinel/app/util/Prefs.kt
Maps and navigation
- Camera awareness
app/src/main/java/com/rfsentinel/app/alpr/AlprStore.kt - Online alerts
app/src/main/java/com/rfsentinel/app/online/PoliceAircraft.kt - Navigation
app/src/main/java/com/rfsentinel/app/nav/NavigationService.kt - Map display
app/src/main/java/com/rfsentinel/app/ui/MapFragment.kt
Hardware and sharing
- SDR radio
app/src/main/java/com/rfsentinel/app/sdr/SdrRadio.kt - ESP hardware
app/src/main/java/com/rfsentinel/app/esp/EspReader.kt - USB adapters
app/src/main/java/com/rfsentinel/app/usb/UsbWifi.kt - Sentinel Link
app/src/main/java/com/rfsentinel/app/link/PhoneLink.kt
App experience
- Main screen
app/src/main/java/com/rfsentinel/app/MainActivity.kt - Android Auto
app/src/main/java/com/rfsentinel/app/car/RFSentinelCarAppService.kt - Settings
app/src/main/java/com/rfsentinel/app/settings/SettingsActivity.kt
Other components
- Phone user
Connections 19
- Phone user → Main screen: uses
README.md - Main screen → Scan service: starts scanning
app/src/main/java/com/rfsentinel/app/MainActivity.kt - Scan service → Radio observations: processes observations
app/src/main/java/com/rfsentinel/app/service/ScanForegroundService.kt - Scan service → Signature engine: classifies
app/src/main/java/com/rfsentinel/app/service/ScanForegroundService.kt - BLE scanning → Radio observations: normalizes
app/src/main/java/com/rfsentinel/app/service/BleScanEngine.kt - Scan service → Device registry: updates
app/src/main/java/com/rfsentinel/app/service/ScanForegroundService.kt - Device registry → App database: records history
- Scan service → Camera awareness: checks nearby cameras
app/src/main/java/com/rfsentinel/app/service/ScanForegroundService.kt - Main screen → Device registry: displays devices
app/src/main/java/com/rfsentinel/app/MainActivity.kt - Main screen → Settings: opens settings
app/src/main/java/com/rfsentinel/app/MainActivity.kt - Settings → Preferences: configures
app/src/main/java/com/rfsentinel/app/settings/SettingsActivity.kt - Main screen → Map display: shows map
- Scan service → Online alerts: monitors threats
- Phone user → Navigation: requests guidance
- Scan service → SDR radio: supports radio detection
- Scan service → ESP hardware: supports board input
- Scan service → USB adapters: supports adapters
- Scan service → Sentinel Link: shares observations
app/src/main/java/com/rfsentinel/app/service/ScanForegroundService.kt - Phone user → Android Auto: uses in vehicle