How mikhail-ramirez/spartn works
SPARTN is a distributed drone-detection system: microphone towers feed audio to a Raspberry Pi, which estimates location and classifies audio, then sends live results to an Android tablet over TCP. The README also describes RF sensing and tablet visualization; those branches are represented without implying that the sampled main loop integrates them. The main-loop excerpt is partial, so only its visible recorder, classification, transmission, and logging calls are shown; RF wiring and Android internals were not inspected.
Main entry points: main.py Pi Main Loop · java Android Tablet App · logger.py Measurement Logger · tower_config.py Tower Configuration
Components 16
Pi Coordination
- Pi Main Loop
src/main.py - System Settings
config/settings.py - Measurement Logger
src/utils/logger.py - Measurement Logs
data - Tower Configuration
src/communications/tower_config.py
Audio Detection
- Audio Recorder
src/sensors/audio_recorder.py - Microphone Array
- Audio Localization
src/processing/trilateration.py - Audio Classifier
src/processing/ai_classification.py
RF Sensing
- HackRF Sweep
src/sensors/HackRF/hsLS.py - Wi-Fi Scanner
src/sensors/droneWifiScan
Tablet Interface
- Tablet TCP Sender
src/communications/tablet_comm.py - Android Tablet App
android_app/app/src/main/java
Other components
- Operator
- HackRF Device
- Nearby Wi-Fi
Connections 15
- Operator → Android Tablet App: views detections
- Android Tablet App → Tower Configuration: sends configuration
- Tower Configuration → Pi Main Loop: configures tower
- System Settings → Pi Main Loop: provides settings
- Pi Main Loop → Audio Recorder: updates buffers
- Microphone Array → Audio Recorder: audio input
- Pi Main Loop → Audio Localization: analyzes audio
- Pi Main Loop → Audio Classifier: classifies sample
- Pi Main Loop → Tablet TCP Sender: sends results
- Tablet TCP Sender → Android Tablet App: TCP updates
- Pi Main Loop → Measurement Logger: logs measurements
- Measurement Logger → Measurement Logs: writes logs
- HackRF Device → HackRF Sweep: RF measurements
- HackRF Sweep → Android Tablet App: sweep data
- Nearby Wi-Fi → Wi-Fi Scanner: scan results