How alveeerahman/opencarmind works
OpenCarMind is ESP32-based OBD-II logging and dashboard firmware, with an optional desktop companion for setup and session import. The main workflow is adapter connection, vehicle-data acquisition, on-device inference and drive logging, then local viewing or transfer to the desktop app. The graph preserves the documented R.E.V/E.V models, diagnostics, EdgeOS scheduling and safety, battery/radio services, and board UI. Firmware relationships beyond the excerpts are limited to README-documented flows; desktop USB authentication and network receiving are evidenced in source excerpts.
Main entry points: elm327.c OBD polling · sdlog.c Drive sessions · board.rs USB board client · ml_infer.cpp On-device inference
Components 23
Vehicle data
- Adapter connection
main/obd_ble.c - OBD polling
main/elm327.c - Live dashboard
main/econ.c - Drive sessions
main/sdlog.c - NAND drive store
main/nand_store.c
Models and diagnostics
- On-device inference
main/ml_infer.cpp - R.E.V learning
main/rev_task.c - Fault analysis
main/fault_engine.c - Battery AI services
main/ai_svc.c
EdgeOS platform
- Deadline scheduler
main/os.c - Model admission
main/os_core.c - Safety controls
main/stop_core.c - Wi-Fi sync
main/wifi_sync.c - Authenticated USB door
main/usb_door.c
Board experience
- Health app
main/health_view.c - Board UI
main/mosaico_display.c - Touch apps
main/mosaico_apps.c
Desktop companion
- Desktop interface
desktop/app/ui/app.js - USB board client
desktop/app/src-tauri/src/board.rs - Session receiver
desktop/app/src-tauri/src/receiver.rs
Other components
- Driver
- Bluetooth OBD adapter
- Owner computer
Connections 23
- Driver → Bluetooth OBD adapter: drives with
README.md - Bluetooth OBD adapter → Adapter connection: connects over Bluetooth
README.md - Adapter connection → OBD polling: provides vehicle link
README.md - OBD polling → Live dashboard: feeds dashboard
README.md - OBD polling → Drive sessions: records data
README.md - OBD polling → On-device inference: feeds model
README.md - On-device inference → Drive sessions: logs model output
README.md - R.E.V learning → On-device inference: updates model
README.md - Drive sessions → NAND drive store: stores sessions
README.md - OBD polling → Fault analysis: analyzes trouble codes
README.md - Battery AI services → Health app: reports battery health
README.md - Deadline scheduler → Model admission: admits model jobs
README.md - Deadline scheduler → Safety controls: steps down workload
README.md - Wi-Fi sync → Owner computer: syncs sessions
README.md - Driver → Board UI: uses touch UI
README.md - Touch apps → Board UI: renders apps
main/mosaico_apps.c - Driver → Desktop interface: configures board
README.md - Desktop interface → USB board client: invokes board actions
- USB board client → Authenticated USB door: authenticates and transfers
desktop/app/src-tauri/src/board.rs - Authenticated USB door → Drive sessions: exports session files
README.md - USB board client → Owner computer: imports sessions
desktop/app/src-tauri/src/board.rs - Wi-Fi sync → Session receiver: uploads sessions
README.md - Session receiver → Owner computer: stores per-board files
desktop/app/src-tauri/src/receiver.rs