Installable desktop program (CLI + Qt) for listen-only OBD/CAN sniff, decode, cluster-gap research, and Honda Civic8→Civic10 adaptation documentation.
Not a website · Not an ECU flash tool · LISTEN_ONLY by default
-blue.svg){kind=icon}
Disclaimer: Not affiliated with, endorsed by, or sponsored by Honda Motor Co., Ltd.
Honda®, the Honda logo, and related marks are trademarks and/or copyrighted works of Honda Motor Co., Ltd. All rights reserved.
OpenDashCAN does not claim ownership of those marks and does not redistribute official Honda trademark artwork in this repository. Seedocs/TRADEMARKS.md. This project does not claim cluster control / physical compatibility.
OpenDashCAN Desktop stays on your PC. It reads vehicle CAN somehow (USB adapter, listen-only Pi recorder, or offline log), decodes registered layouts, and surfaces VehicleState, ID rates, Phase‑4 cluster gaps, adaptation plans, wiring checklists, and research docs.
OBD/CAN sniff (LISTEN_ONLY) → registered decoder → VehicleState + ID rates + gaps
Offline research pipeline (EncodeMode.NO_OUTPUT by default):
Source Honda CAN → Decoder → VehicleState → ClusterEnvironment → Target Encoder → Donor Cluster
Reference adaptation: 2009 Civic (8th gen, R18 auto) → 10th-gen Civic digital cluster
(honda.civic.gen8.us.r18.auto → honda.civic.gen10.cluster.digital).
Donor vehicle protocol (2016+ Honda) is substantially documented from MIT commaai/opendbc (VEHICLE_PROTOCOL_DOCUMENTED). That is not cluster RX confirmation � donor gauge requirements, timing, and gateway behavior remain incomplete until captures and bench tests exist.
No real vehicle captures are in this repo yet � only labeled SYNTHETIC fixtures for software tests.
| Area | What you get |
|---|---|
| CLI | opendashcan � listen, plan, gaps, registry, DBC index, coverage |
| Qt desktop | Dark automotive UI � Live, Platform, Lookup, Gaps, Adaptation, Wiring, Research |
| Live listen | Virtual / capture replay / SocketCAN·PCAN·slcan � LISTEN ONLY � NO TRANSMIT banner |
| Boot splash | Honda-themed cluster ignition (not OpenDashCAN logo); trademark notice on splash/About; --no-splash / OPENDASHCAN_NO_SPLASH=1 |
| DBC | Import/index from public opendbc � never invents encodings; never auto-promotes to cluster RX |
| Cluster gaps | Phase 4 eight-axis gap report (DOCUMENTATION_ONLY) |
| Wiring | OBD tap pins, conceptual dual-bus (FUTURE/NO TX), harness switch checklist with confidence labels |
| Evidence | GitHub issue form � do not invent CAN data |
Platforms / clusters browser + platform detail
Live tab � virtual/offline listen, ID rates, decoded signals, LISTEN ONLY banner
Cluster gaps (Phase 4) � documentation-only axes
Adaptation plan Civic8 → Civic10
Honda-themed boot splash (trademark notice shown; official Honda assets not shipped in git)
Wiring tab � diagrams + harness checklist
Honda-themed boot splash � glow → ready (trademark notice; no official Honda assets in git)
Live tab playing synthetic capture (LISTEN_ONLY)
Regenerate assets:
python tools/round_brand_assets.py # rounded logo / banner PNGs
python tools/generate_wiring_diagrams.py
python tools/capture_gui_demo.py --with-splashPyPI: opendashcan · Release: v0.1.0
# From PyPI � full desktop (CLI + Qt + python-can)
pip install "opendashcan[desktop]"
# From a clone (editable)
pip install -e ".[desktop]"
# or:
pip install -e ".[gui,hw]"
opendashcan info
opendashcan-gui # splash → main window (Live tab ready)
opendashcan-gui --no-splash # skip boot animation
opendashcan-listen --virtualWindows: after install, opendashcan / opendashcan-gui are on your Python Scripts PATH. Optional launchers: scripts/windows/opendashcan.bat, scripts/windows/opendashcan-listen.bat.
opendashcan listen --virtual --vehicle honda.civic.gen10.us
opendashcan listen --capture captures/synthetic/idle_scenario.log
opendashcan listen --interface socketcan --channel can0 --bitrate 500000
opendashcan listen --interface pcan --channel PCAN_USBBUS1
opendashcan listen --interface slcan --channel COM3If python-can is missing, the CLI/GUI print a clear install hint; Virtual and Play file still work.
opendashcan registry vehicles
opendashcan plan honda.civic.gen8.us.r18.auto honda.civic.gen10.cluster.digital
opendashcan gaps honda.civic.gen10.cluster.digital
opendashcan build-adapter honda.civic.gen8.us.r18.auto honda.civic.gen10.cluster.digital --documentation-only
opendashcan coverage --write
opendashcan clusters
pytest tests/test_gui_smoke.pyEvidence-safe docs live under docs/wiring/. Diagrams: assets/wiring/.
| Doc | Topic |
|---|---|
| OBD listen tap | Pins 4/5/6/14/16 � AiM / Racelogic / Pi recorder |
| Bus roles | F-CAN / B-CAN / gateway conceptual (pin-level UNKNOWN) |
| Swap checklist | Power, GND, CAN, ignition, illumination, … |
OBD → adapter → OpenDashCAN Desktop (LISTEN_ONLY)
Conceptual dual-bus bridge � FUTURE / NO TX default
Harness interfaces with confidence labels
In the GUI: open the Wiring tab for the same diagrams + checklist, with links to hardware/can_recorder_rpi/.
Not OEM service instructions. Donor-cluster connector pinouts are UNKNOWN / REQUIRES_BENCH until measured.
Listen-only Raspberry Pi recorder design: hardware/can_recorder_rpi/README.md (candump → copy log → opendashcan listen --capture … or Live tab Play file).
Manufacturing (repo only � not in the Desktop app): partner note, production BOM/AVL, open CAD (schematic/PCB/harness/OpenSCAD), assembly + ICT/FCT, factory flash, labels � see hardware/MANUFACTURING_INDEX.md and hardware/can_recorder_rpi/manufacturing/.
- Default:
LinkMode.LISTEN_ONLY/EncodeMode.NO_OUTPUT - No fabricated CAN IDs, scales, checksums, or pinouts
- Vehicle-bus DBC facts stay
VEHICLE_PROTOCOL_DOCUMENTED� never auto-promoted toCLUSTER_RX_CONFIRMED - Synthetic fixtures are labeled
SYNTHETIC - GUI Live tab always shows LISTEN ONLY � NO TRANSMIT
See docs/safety.md.
| Level | Meaning |
|---|---|
VERIFIED / PHYSICALLY_VERIFIED |
Confirmed with cited sources |
DOCUMENTED / SUPPORTED_BY_MULTIPLE_SOURCES |
Public docs / opendbc agree |
COMMUNITY_REPORTED |
Forum / community only |
INFERRED |
Heuristic � needs confirmation |
UNKNOWN / REQUIRES_BENCH |
Default / needs measurement |
Submit verified evidence (do not invent CAN data):
issue form · guide · policy
opendashcan/ # Python package (CLI, registry, decode, GUI, hw listen)
opendashcan/gui/ # Qt desktop (Live, gaps, wiring, splash, …)
docs/wiring/ # Harness / OBD / swap checklist
hardware/ # Pi recorder + manufacturing package (not in PyPI wheel)
assets/ # Official logo, screenshots, demo GIFs, wiring PNGs
captures/synthetic/ # SYNTHETIC fixtures only
research/ # Evidence reports (DOCUMENTATION_ONLY)
See CONTRIBUTING.md. Prefer small, evidence-labeled PRs. Never invent encodings or claim cluster RX without captures/bench.
Source-available proprietary — evaluation under LICENSE; commercial / production use via COMMERCIAL.md. See LICENSE_TRANSITION_NOTICE.md and NOTICE.
This project is proprietary. Production use, redistribution, and commercial deployment require a written commercial license or completed acquisition. See LICENSE and ACQUISITION.md. Contact @theworker02.
Buyer-facing diligence materials live in docs/acquisition/. Commercial licensing contact path: COMMERCIAL.md.