justin/obdash
1
0
Fork 0
Code Issues 5 Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Scaffold obdcore (headless acquisition core) + ARCHITECTURE.md

Browse Source 
Foundation for the PySide6 + pyqtgraph Windows GUI, shared with the terminal
tool. Pure data/IO -- no Qt, no curses.

obdcore/
  link.py      ElmLink   -- ELM327 serial (Mode-01/22, ATRV, DTC read/clear)
  mock.py      MockLink  -- synthetic crank for tests + GUI dev (no truck)
  registry.py  PidRegistry (verified Ford 6.0 PIDs + confidence) + DtcDatabase
  scheduler.py PollScheduler -- prioritized round-robin polling, dead-PID park,
               derived channels; tick() is fake-clock test-drivable
  store.py     TimeSeriesStore (ring buffers + min/max) + CsvRecorder/replay

Design centers on the ELM327 bandwidth limit (~7-15 reads/sec): the active
view subscribes PIDs at chosen rates; acquisition runs off the UI thread;
the GUI only reads the store. FICM_M (09D0) promoted to verified after the
2026-06-30 on-truck crank read (48.0V, intermittent).

tests/test_obdcore.py: decoders vs real truck bytes, crank ramp + peak,
derived BOOST, dead-PID park/revive, record/replay roundtrip -- all pass.

ARCHITECTURE.md: layers, data model, GUI plan, 6.0 stock-PID limits
(no EGT/oil-PSI), feature backlog, P0-P5 roadmap.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016yT89n4zR4qbrySoSiEyZs
This commit is contained in:
Justin Paul
2026-06-30 13:41:24 -04:00
parent 6eb449f354
commit 6bee9c0d7f
8 changed files with 939 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
obdcore/__init__.py
+20
View File
@@ -0,0 +1,20 @@
"""obdcore -- headless OBD-II acquisition core for the ford-obd project.
Layered, GUI-agnostic foundation shared by the terminal tool and the
forthcoming PySide6 + pyqtgraph Windows app:
link.py ElmLink -- ELM327 serial transport (+ MockLink in mock.py)
registry.py PidRegistry -- verified Ford 6.0 PID table + DTC database
scheduler.py PollScheduler -- prioritized round-robin polling engine
store.py TimeSeriesStore -- ring buffers, min/max, record/replay
See ARCHITECTURE.md for the full design and roadmap.
"""
from .registry import PidRegistry, DtcDatabase, Pid, Dtc, PRESETS
from .store import TimeSeriesStore, CsvRecorder, replay_csv
from .scheduler import PollScheduler
__all__ = [
"PidRegistry", "DtcDatabase", "Pid", "Dtc", "PRESETS",
"TimeSeriesStore", "CsvRecorder", "replay_csv", "PollScheduler",
]