How rsiniavski/obd-app works
OBD App is a BMW E90/E91 diagnostic dashboard with Kivy and terminal interfaces. Its main workflow selects an emulator or vehicle connection, reads telemetry and diagnostic trouble codes, then presents live values and supports refreshing or clearing DTCs. The README also documents configurable metric widgets, desktop serial and Android Bluetooth connections, and both internal and TCP emulation. The GUI excerpt is partial, so links from its screens to connection and reader services rely on indexed imports and documented behavior; unsampled internals are not inferred.
Main entry points: main_app.py Kivy dashboard · connection.py Connection manager · reader.py Telemetry and DTC reader · main.py Terminal dashboard
Components 16
User interfaces
- Kivy dashboard
gui/main_app.py - Metric cards
gui/main_app.py - Dashboard, DTC, settings
gui/ui_layout.kv - Terminal dashboard
main.py - UI and connection settings
settings.json
Diagnostic services
- Metric catalog and limits
config.py - Telemetry and DTC reader
app/reader.py
Connections
- Connection manager
app/connection.py - Desktop OBD adapter
app/connection.py - Android Bluetooth adapter
app/android_bt.py - TCP OBD client
app/connection.py
Emulation
- Internal telemetry mock
app/reader.py - TCP ELM327 server
emulator/server.py - OBD mock engine
emulator/mock_data.py
Other components
- Driver
- ELM327 / vehicle
Connections 21
- Driver → Kivy dashboard: uses
README.md - Driver → Terminal dashboard: uses
README.md - Kivy dashboard → Dashboard, DTC, settings: presents
README.md - Kivy dashboard → Telemetry and DTC reader: reads diagnostics
gui/main_app.py - Kivy dashboard → Connection manager: opens connection
gui/main_app.py - Kivy dashboard → Metric cards: renders
gui/main_app.py - Metric cards → Metric catalog and limits: uses limits
gui/main_app.py - Kivy dashboard → UI and connection settings: loads and saves
README.md - Dashboard, DTC, settings → Kivy dashboard: defines screens
README.md - Terminal dashboard → Connection manager: opens connection
main.py - Terminal dashboard → Telemetry and DTC reader: reads and controls
main.py - Telemetry and DTC reader → Metric catalog and limits: uses metrics
app/reader.py - Telemetry and DTC reader → Internal telemetry mock: generates telemetry
app/reader.py - Connection manager → Android Bluetooth adapter: creates adapter
app/connection.py - Android Bluetooth adapter → ELM327 / vehicle: sends OBD commands
app/android_bt.py - Connection manager → Desktop OBD adapter: connects via serial
README.md - Desktop OBD adapter → ELM327 / vehicle: communicates
README.md - Connection manager → TCP OBD client: configures socket
app/connection.py - TCP OBD client → TCP ELM327 server: sends OBD requests
README.md - TCP ELM327 server → OBD mock engine: processes commands
emulator/server.py - Driver → TCP ELM327 server: starts emulator
README.md