How hieupeakday0109-ai/scann-the-device works
FieldWatch is a Windows desktop RF situational-awareness monitor. The user launches the Qt interface, which starts BLE scanning and periodically polls Wi-Fi; BLE advertisements are decoded and fed into alerting, storage, optional CoT broadcast, and a selected-device proximity radar. GPS supplies coordinates for observations. The README also documents GeoJSON/CSV reporting and CoT interoperability. The graph follows the sampled UI wiring and scanner/parser calls; unsampled implementation details are represented only where the README documents the capability.
Main entry points: main_window.py Monitoring UI · scanner.py BLE Scanner · gps_serial.py Serial NMEA GPS · main.py Application Entry
Components 14
Desktop Interface
- Application Entry
main.py - Monitoring UI
ui/main_window.py - Tactical Styling
ui/styles.py
RF & Location Sensing
- BLE Scanner
core/ble/scanner.py - Advertisement Decoder
core/ble/parsers.py - Native Wi-Fi Scanner
core/wifi/native_wifi.py - Serial NMEA GPS
core/location/gps_serial.py
Detection & Tracking
- Threat Detection
core/engine/alert_engine.py - Proximity Radar
core/engine/radar_tracker.py
Persistence & Interoperability
- Signal Store & Export
core/export/storage.py - CoT Broadcaster
core/export/cot_broadcaster.py
Other components
- Field Operator
- Windows Radio & Serial Devices
- WinTAK / ATAK
Connections 18
- Field Operator → Application Entry: launches
README.md - Application Entry → Monitoring UI: runs
main.py - Monitoring UI → Tactical Styling: applies stylesheet
ui/main_window.py - Monitoring UI → BLE Scanner: starts scanner
ui/main_window.py - BLE Scanner → Advertisement Decoder: decodes payload
core/ble/scanner.py - BLE Scanner → Monitoring UI: reports advertisements
ui/main_window.py - Monitoring UI → Native Wi-Fi Scanner: polls networks
ui/main_window.py - Monitoring UI → Serial NMEA GPS: reads coordinates
ui/main_window.py - Monitoring UI → Serial NMEA GPS: selects serial port
ui/main_window.py - Windows Radio & Serial Devices → BLE Scanner: provides radio data
README.md - Windows Radio & Serial Devices → Native Wi-Fi Scanner: provides radio data
README.md - Windows Radio & Serial Devices → Serial NMEA GPS: provides NMEA stream
README.md - Monitoring UI → Threat Detection: registers packets
ui/main_window.py - Monitoring UI → Proximity Radar: updates selected target
ui/main_window.py - Monitoring UI → Signal Store & Export: writes observations
ui/main_window.py - Monitoring UI → Signal Store & Export: requests exports
ui/main_window.py - Monitoring UI → CoT Broadcaster: broadcasts detected targets
ui/main_window.py - CoT Broadcaster → WinTAK / ATAK: sends CoT multicast
core/export/cot_broadcaster.py