How swarupcreates/speedtracerproject-bikecomputer works
SpeedTracer is an ESP32-S3 cycling computer that turns GPS and sensor readings into ride metrics, navigation views, and ride logs, with local controls and a Wi-Fi web companion. In the modular firmware, App initializes and updates the services and chooses what to render. The repository also contains a large integrated firmware implementation and sensor, route, and activity modules; their detailed runtime wiring is not fully visible in the excerpts, so those links are limited to documented capabilities or marked unverified.
Main entry points: App.cpp App Coordinator · StorageService.hpp MicroSD Storage · GPSService.hpp GPS and Sensor Service · WebService.hpp Web Companion
Components 22
Firmware Coordination
- App Coordinator
firmware/legacy_modular/App.cpp
Ride Telemetry
- Ride State
firmware/include/models/RideData.hpp - Ride Configuration
firmware/include/models/Config.hpp - GPS and Sensor Service
firmware/include/services/GPSService.hpp - GEPRC GPS Driver
firmware/include/Drivers/geprc.h
Rider Experience
- Button Input
firmware/include/services/InputService.hpp - Display Service
firmware/include/services/DisplayService.hpp - Dashboard Screen
firmware/include/ui/DashboardScreen.hpp - Map Screen
firmware/include/ui/MapScreen.hpp - Splash Screen
firmware/include/ui/SplashScreen.hpp - Quick Settings
firmware/src/quick_settings.h
Companion and Sensors
- Web Companion
firmware/include/services/WebService.hpp - BLE Sensor Support
firmware/src/ble_sensors.h
Navigation and Records
- Navigation State
firmware/include/models/NavState.hpp - MicroSD Storage
firmware/include/services/StorageService.hpp - Route Archive
firmware/src/route_archive.h - Activity Archive
firmware/src/activity_archive.h - FIT Activity Export
firmware/src/activity_fit.h
Other components
- Cyclist
- Phone Browser
- GPS Receiver
- BLE Sensors
Connections 29
- Cyclist → App Coordinator: operates
firmware/legacy_modular/App.cpp - App Coordinator → Display Service: initializes
firmware/legacy_modular/App.cpp - App Coordinator → Button Input: updates
firmware/legacy_modular/App.cpp - App Coordinator → GPS and Sensor Service: updates
firmware/legacy_modular/App.cpp - App Coordinator → Web Companion: updates
firmware/legacy_modular/App.cpp - App Coordinator → MicroSD Storage: loads route
firmware/legacy_modular/App.cpp - App Coordinator → Splash Screen: renders
firmware/legacy_modular/App.cpp - App Coordinator → Dashboard Screen: renders
firmware/legacy_modular/App.cpp - App Coordinator → Map Screen: renders
firmware/legacy_modular/App.cpp - App Coordinator → Ride State: updates
firmware/legacy_modular/App.cpp - App Coordinator → Ride Configuration: loads
firmware/legacy_modular/App.cpp - GPS and Sensor Service → GEPRC GPS Driver: uses
firmware/include/services/GPSService.hpp - GPS Receiver → GPS and Sensor Service: provides fixes
README.md - BLE Sensors → BLE Sensor Support: provides telemetry
README.md - Phone Browser → Web Companion: controls
README.md - Web Companion → Navigation State: sets destination
firmware/include/services/WebService.hpp - Web Companion → MicroSD Storage: uses
firmware/include/services/WebService.hpp - Web Companion → GPS and Sensor Service: uses
firmware/include/services/WebService.hpp - GPS and Sensor Service → MicroSD Storage: logs ride
firmware/include/services/GPSService.hpp - MicroSD Storage → Navigation State: loads route into
firmware/include/services/StorageService.hpp - Dashboard Screen → Display Service: draws on
firmware/include/ui/DashboardScreen.hpp - Dashboard Screen → GPS and Sensor Service: reads
firmware/include/ui/DashboardScreen.hpp - Map Screen → Display Service: draws on
firmware/include/ui/MapScreen.hpp - Map Screen → Navigation State: reads
firmware/include/ui/MapScreen.hpp - Cyclist → Quick Settings: adjusts
README.md - Quick Settings → BLE Sensor Support: manages
README.md - MicroSD Storage → Route Archive: stores routes
README.md - MicroSD Storage → Activity Archive: archives rides
README.md - Activity Archive → FIT Activity Export: exports activity
README.md