How soyboitech/beacons works
Beacons is a passive surveillance-device detector spanning embedded firmware and iOS/Android clients. The main flow is board radio scanning and signature recognition, then detection logging and encrypted Bluetooth delivery to a phone for live viewing, history, maps, alerts, and optional user-initiated contribution. Firmware also supports signed updates and, on Mesh-Detect, Meshtastic alerts. The graph reflects documented and indexed relationships; unsampled app screens and firmware stages are represented only where README or tree evidence supports them.
Main entry points: acab_ble_service.cpp Encrypted BLE link · main.cpp Mesh runtime · Views iOS app views · BLEManager.swift iOS BLE manager
Components 21
Detector firmware
- Radio scanning
firmware/lib/acab_core/acab_scanner.cpp - Detection signatures
firmware/lib/acab_core - Detection records
firmware/lib/acab_core/detection.h - Offline log
firmware/lib/acab_core/det_log.cpp - Encrypted BLE link
firmware/lib/acab_core/acab_ble_service.cpp - Beacon runtime
firmware/src/beacon-board/main.cpp - Mesh runtime
firmware/src/mesh-detect/main.cpp
Mobile apps
- iOS BLE manager
ios/Beacons/BLE/BLEManager.swift - Detection model
ios/Beacons/Models/Detection.swift - iOS app views
ios/Beacons/Views - Map and ALPR
ios/Beacons/Views/MapTabView.swift - Android app entry
android/app/src/main/java/tech/acab/app/MainActivity.kt - Android BLE manager
android/app/src/main/java/tech/acab/app/ble/AcabBleManager.kt - Android app screens
android/app/src/main/java/tech/acab/app/ui - Device controls
android/app/src/main/java/tech/acab/app/ui/DeviceScreen.kt
Firmware updates
- iOS update flows
ios/Beacons/BLE/BLEManager+OTA.swift - Android DFU
android/app/src/main/java/tech/acab/app/ble/NrfDfuCoordinator.kt
Mesh alerts
- Meshtastic transport
firmware/src/mesh-detect/mesh_link.cpp
Other components
- Board user
- Phone user
- Meshtastic node
Connections 27
- Beacon runtime → Radio scanning: starts scanning
firmware/src/beacon-board/main.cpp - Mesh runtime → Radio scanning: starts scanning
firmware/src/mesh-detect/main.cpp - Radio scanning → Detection signatures: matches broadcasts
- Detection signatures → Detection records: creates detections
firmware/lib/acab_core/acab_ble_service.h - Beacon runtime → Encrypted BLE link: starts link
firmware/src/beacon-board/main.cpp - Mesh runtime → Encrypted BLE link: starts link
firmware/src/mesh-detect/main.cpp - Encrypted BLE link → Offline log: replays history
- Encrypted BLE link → Detection records: notifies detections
- Mesh runtime → Meshtastic transport: sends alerts
firmware/src/mesh-detect/main.cpp - Meshtastic transport → Meshtastic node: transmits alerts
- Phone user → iOS app views: uses
- Phone user → Android app entry: uses
- iOS BLE manager → Encrypted BLE link: exchanges data
- Android BLE manager → Encrypted BLE link: exchanges data
- iOS BLE manager → Detection model: ingests sightings
ios/Beacons/BLE/BLEManager.swift - iOS BLE manager → iOS app views: provides app state
- iOS app views → Map and ALPR: shows mapped detections
- Android app entry → Android BLE manager: initializes manager
android/app/src/main/java/tech/acab/app/MainActivity.kt - Android app entry → Android app screens: hosts app
android/app/src/main/java/tech/acab/app/MainActivity.kt - Android app screens → Device controls: shows controls
- Android BLE manager → Encrypted BLE link: exchanges data
- iOS app views → iOS update flows: requests updates
- Device controls → Android DFU: requests updates
- iOS update flows → Encrypted BLE link: updates board
- Android DFU → Encrypted BLE link: updates board
- Board user → Beacon runtime: operates board
- Board user → Mesh runtime: operates board