How avybc/obdium works
OBDium is a desktop vehicle-diagnostics app: a user connects an ELM327 adapter (or selects local demo replay), then views live metrics, trouble codes, readiness results, graphs, and VIN details. The Tauri event bridge connects the web UI to Rust services; OBD communication and decoding feed domain-specific diagnostics, while VIN parsing queries the local VPIC SQLite database. The graph preserves documented product capabilities, but omits unverified event wiring and unsampled implementation details where the excerpts do not establish the relationship.
Main entry points: obd.rs ELM327 session · events.rs Event handlers · parser.rs VIN parser · features.js Diagnostic panels
Components 20
Desktop interface
- App interface
frontend/scripts/main.js - Diagnostic panels
frontend/scripts/features.js - Preferences
frontend/scripts/settings.js
Tauri integration
- Event handlers
backend/src/bridge/events.rs - Bridge state
backend/src/bridge/mod.rs - App runtime
backend/src/main.rs
OBD diagnostics
- ELM327 session
backend/src/obd.rs - OBD commands
backend/src/cmd.rs - Live PID metrics
backend/src/pid/engine.rs - PID domains
backend/src/pid/diagnostics.rs - Response decoding
backend/src/response.rs - Units and values
backend/src/scalar.rs - Trouble-code lookup
backend/src/dicts.rs - Demo replay
backend/src/replay.rs
VIN decoding
- VIN parser
backend/src/vin/parser.rs - VIN pattern matching
backend/src/vin/pattern.rs - Vehicle attributes
backend/src/vin/attributes.rs - VPIC database
backend/data/vpic.sqlite.xz
Other components
- Vehicle owner
- ELM327 adapter
Connections 19
- Vehicle owner → App interface: uses
README.md - App interface → Diagnostic panels: loads
frontend/scripts/main.js - Preferences → Diagnostic panels: connects via
frontend/scripts/settings.js - App runtime → Event handlers: registers handlers
backend/src/main.rs - Event handlers → Bridge state: uses state
backend/src/bridge/events.rs - Event handlers → ELM327 session: connects
backend/src/bridge/events.rs - ELM327 session → ELM327 adapter: communicates
README.md - ELM327 session → OBD commands: sends
backend/src/obd.rs - Live PID metrics → ELM327 session: queries
backend/src/pid/engine.rs - PID domains → ELM327 session: queries
- ELM327 session → Response decoding: decodes
backend/src/obd.rs - Live PID metrics → Units and values: returns values
backend/src/pid/engine.rs - ELM327 session → Demo replay: reads replay
backend/src/obd.rs - Diagnostic panels → Event handlers: requests diagnostics
- Event handlers → VIN parser: decodes VIN
backend/src/bridge/events.rs - VIN parser → VPIC database: queries
backend/src/vin/parser.rs - VIN parser → VIN pattern matching: matches patterns
backend/src/vin/parser.rs - VIN parser → Vehicle attributes: resolves attributes
backend/src/vin/mod.rs - Diagnostic panels → Trouble-code lookup: shows codes