How astommondal16/uwb-rtls--esp works
This repository provides ESP-IDF firmware for ESP32 UWB anchor/tag ranging, plus desktop and Android device-management clients. The firmware workflow provisions Wi-Fi, confirms device role and coordinates, synchronizes time, gathers sensor/ranging samples, and serves telemetry and control APIs; clients discover devices, visualize readings, and manage configuration. The graph preserves the documented setup, sensing, calibration, CIR, and localization capabilities. Some subsystem links rely on README statements because their implementation was not sampled.
Main entry points: main.c Startup supervisor · telemetry.c Telemetry API and queue · dashboard.py Desktop dashboard · localization_dashboard.py Localization dashboard
Components 20
Startup and setup
- Startup supervisor
main/main.c - Role and coordinates
components/telemetry/device_setup.c - BLE provisioning
components/ble_provisioning/ble_provisioning.c - Sensor coordinator
components/sensor_coordinator/sensor_coordinator.c
Sensing and ranging
- UWB ranging
components/uwb_ranging/uwb_ranging.c - DW1000 driver
components/dw1000/dw1000.c - MPU6050 driver
components/mpu6050/mpu6050.c - Battery monitor
components/battery_monitor/battery_monitor.c
Connectivity and telemetry
- Wi-Fi manager
components/wifi/wifi.c - Time synchronization
components/time_sync/time_sync.c - Device identity
components/device_identity/device_identity.c - Telemetry API and queue
components/telemetry/telemetry.c - Raw UWB encoding
components/telemetry/uwb_raw_json.c - Network discovery
components/telemetry/telemetry.c
Management clients
- Desktop dashboard
dashboard/dashboard.py - Localization dashboard
dashboard/localization_dashboard.py - CIR viewer
dashboard/cir_viewer.py - Android app
checkpoints/20261002-actions-order-before/MainActivity.kt
Other components
- Device operator
- Wi-Fi network
Connections 27
- Device operator → Startup supervisor: starts and configures
- Startup supervisor → Wi-Fi manager: connects through
- Wi-Fi manager → BLE provisioning: starts fallback provisioning
components/wifi/wifi.c - Device operator → BLE provisioning: requests setup
- Startup supervisor → Role and coordinates: initializes setup
main/main.c - Startup supervisor → Time synchronization: synchronizes time
- Startup supervisor → Sensor coordinator: coordinates sensor pauses
main/main.c - Startup supervisor → UWB ranging: starts ranging
- UWB ranging → DW1000 driver: drives radio
components/uwb_ranging/uwb_ranging.c - Startup supervisor → MPU6050 driver: initializes and reads
- Startup supervisor → Battery monitor: monitors voltage
- Startup supervisor → Telemetry API and queue: publishes samples
main/main.c - Telemetry API and queue → Raw UWB encoding: encodes raw data
components/telemetry/telemetry.c - Telemetry API and queue → Device identity: uses device identity
components/telemetry/telemetry.c - Telemetry API and queue → Network discovery: serves discovery
components/telemetry/telemetry.c - Wi-Fi manager → Wi-Fi network: joins
- Desktop dashboard → Telemetry API and queue: polls telemetry
dashboard/dashboard.py - Desktop dashboard → Time synchronization: requests clock sync
dashboard/dashboard.py - Desktop dashboard → Network discovery: discovers devices
dashboard/dashboard.py - Localization dashboard → Telemetry API and queue: fetches readings
dashboard/localization_dashboard.py - Localization dashboard → Network discovery: scans devices
dashboard/localization_dashboard.py - Localization dashboard → UWB ranging: solves from ranges
- Desktop dashboard → CIR viewer: opens CIR viewer
dashboard/cir_viewer.py - Android app → Telemetry API and queue: requests device API
- Android app → Role and coordinates: configures device
- Desktop dashboard → Role and coordinates: controls role and settings
dashboard/dashboard.py - Android app → Network discovery: finds devices
checkpoints/20261002-actions-order-before/MainActivity.kt