# robbertjv/dab-dconnect-active-driver-plus architecture

> Architecture diagram of the GitHub repository robbertjv/dab-dconnect-active-driver-plus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/robbertjv/dab-dconnect-active-driver-plus
- Repository: https://github.com/robbertjv/dab-dconnect-active-driver-plus

## Overview

This repository is an evidence-based reverse-engineering workspace for the DAB Active Driver Plus CAN protocol, not a conventional application. Its central workflow is to stimulate or observe CAN traffic, preserve captures and experiment results, analyze traces and frame patterns, then consolidate supported findings and open questions in the README. The scripts cover peer, service-family, hierarchy, gateway, and validation experiments. Several probe implementations are only indexed rather than excerpted, so their internal call relationships are not inferred; the README documents the protocol planes and the unresolved DConnect layer.

Main entry points: [`scripts/probing/dab_family_probe.py`](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/dab_family_probe.py) (Family probe), [`data/raw`](https://github.com/robbertjv/dab-dconnect-active-driver-plus/tree/main/data/raw) (Raw captures), [`data/results`](https://github.com/robbertjv/dab-dconnect-active-driver-plus/tree/main/data/results) (Experiment results), [`scripts/misc/PCANBasic.py`](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/misc/PCANBasic.py) (PCAN API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experiments["CAN experiments"]
  node_pcan["PCAN API<br/>[PCANBasic.py]"]
  node_familyprobe["Family probe"]
  node_sessionprobe["Session probe"]
  node_peerbase["Peer tests<br/>[pcan_peer_tests.py]"]
  node_peerchatbot["Peer simulator"]
  node_peerchatgpt["Peer experiments"]
  node_family_scan["Family scanning"]
  node_other_probes["Protocol probes"]
end

subgraph group_analysis["Trace analysis"]
  node_trc_analyze["TRC analysis"]
  node_can_analyze["CAN analysis<br/>[dab_can_analyse.py]"]
  node_event_audit["Event audit<br/>[trc_event_audit.py]"]
end

subgraph group_evidence["Evidence corpus"]
  node_raw_captures[("Raw captures")]
  node_results[("Experiment results")]
end

subgraph group_knowledge["Protocol knowledge"]
  node_knowledgebase["Protocol record<br/>[README.md]"]
  node_observations["Field observations"]
end

node_engineer(("Investigator"))
node_dut["DAB inverter"]
node_canbus(("CAN bus"))

node_engineer -.->|"runs probes"| node_familyprobe
node_engineer -.->|"runs probes"| node_sessionprobe
node_engineer -.->|"runs experiments"| node_peerbase
node_engineer -.->|"runs experiments"| node_peerchatbot
node_engineer -.->|"runs experiments"| node_peerchatgpt
node_familyprobe -->|"uses API"| node_pcan
node_peerbase -->|"uses API"| node_pcan
node_peerchatbot -->|"uses API"| node_pcan
node_peerchatgpt -->|"uses API"| node_pcan
node_familyprobe -.->|"probes families"| node_canbus
node_sessionprobe -.->|"sends frames"| node_canbus
node_peerbase -.->|"sends and captures"| node_canbus
node_peerchatbot -.->|"simulates peers"| node_canbus
node_peerchatgpt -.->|"tests peers"| node_canbus
node_dut -->|"transmits traffic"| node_canbus
node_canbus -.->|"recorded as"| node_raw_captures
node_raw_captures -->|"parsed from"| node_trc_analyze
node_raw_captures -->|"analyzed from"| node_can_analyze
node_raw_captures -.->|"audited from"| node_event_audit
node_familyprobe -->|"writes results"| node_results
node_sessionprobe -->|"writes results"| node_results
node_trc_analyze -.->|"exports summaries"| node_results
node_results -->|"supports findings"| node_knowledgebase
node_observations -->|"informs protocol model"| node_knowledgebase
node_engineer -->|"consults findings"| node_knowledgebase
node_other_probes -.->|"investigate protocol"| node_canbus
node_family_scan -.->|"scans families"| node_canbus

click node_pcan "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/misc/PCANBasic.py"
click node_familyprobe "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/dab_family_probe.py"
click node_sessionprobe "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/dab_can_session_probe.py"
click node_peerbase "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/pcan_peer_tests.py"
click node_peerchatbot "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/pcan_peer_tests_chatbot.py"
click node_peerchatgpt "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/pcan_peer_tests_chatgpt.py"
click node_family_scan "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/dab_family_scanner.py"
click node_other_probes "https://github.com/robbertjv/dab-dconnect-active-driver-plus/tree/main/scripts/probing"
click node_trc_analyze "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/analysis/trc_summarize_new.py"
click node_can_analyze "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/analysis/dab_can_analyse.py"
click node_event_audit "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/analysis/trc_event_audit.py"
click node_raw_captures "https://github.com/robbertjv/dab-dconnect-active-driver-plus/tree/main/data/raw"
click node_results "https://github.com/robbertjv/dab-dconnect-active-driver-plus/tree/main/data/results"
click node_knowledgebase "https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/README.md"
click node_observations "https://github.com/robbertjv/dab-dconnect-active-driver-plus/tree/main/data/observations"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_pcan,node_familyprobe,node_sessionprobe,node_peerbase,node_peerchatbot,node_peerchatgpt,node_family_scan,node_other_probes toneBlue
class node_trc_analyze,node_can_analyze,node_event_audit toneAmber
class node_raw_captures,node_results toneMint
class node_knowledgebase,node_observations toneRose
class node_engineer,node_dut,node_canbus toneIndigo
```

## Components

### CAN experiments

- [PCAN API](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/misc/PCANBasic.py): `scripts/misc/PCANBasic.py`
- [Family probe](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/dab_family_probe.py): `scripts/probing/dab_family_probe.py`
- [Session probe](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/dab_can_session_probe.py): `scripts/probing/dab_can_session_probe.py`
- [Peer tests](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/pcan_peer_tests.py): `scripts/probing/pcan_peer_tests.py`
- [Peer simulator](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/pcan_peer_tests_chatbot.py): `scripts/probing/pcan_peer_tests_chatbot.py`
- [Peer experiments](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/pcan_peer_tests_chatgpt.py): `scripts/probing/pcan_peer_tests_chatgpt.py`
- [Family scanning](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/probing/dab_family_scanner.py): `scripts/probing/dab_family_scanner.py`
- [Protocol probes](https://github.com/robbertjv/dab-dconnect-active-driver-plus/tree/main/scripts/probing): `scripts/probing`

### Trace analysis

- [TRC analysis](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/analysis/trc_summarize_new.py): `scripts/analysis/trc_summarize_new.py`
- [CAN analysis](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/analysis/dab_can_analyse.py): `scripts/analysis/dab_can_analyse.py`
- [Event audit](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/scripts/analysis/trc_event_audit.py): `scripts/analysis/trc_event_audit.py`

### Evidence corpus

- [Raw captures](https://github.com/robbertjv/dab-dconnect-active-driver-plus/tree/main/data/raw): `data/raw`
- [Experiment results](https://github.com/robbertjv/dab-dconnect-active-driver-plus/tree/main/data/results): `data/results`

### Protocol knowledge

- [Protocol record](https://github.com/robbertjv/dab-dconnect-active-driver-plus/blob/main/README.md): `README.md`
- [Field observations](https://github.com/robbertjv/dab-dconnect-active-driver-plus/tree/main/data/observations): `data/observations`

### Other components

- **Investigator**
- **DAB inverter**
- **CAN bus**

## Connections

- Investigator → Family probe: runs probes
- Investigator → Session probe: runs probes
- Investigator → Peer tests: runs experiments
- Investigator → Peer simulator: runs experiments
- Investigator → Peer experiments: runs experiments
- Family probe → PCAN API: uses API (evidence: `scripts/probing/dab_family_probe.py`)
- Peer tests → PCAN API: uses API (evidence: `scripts/probing/pcan_peer_tests.py`)
- Peer simulator → PCAN API: uses API (evidence: `scripts/probing/pcan_peer_tests_chatbot.py`)
- Peer experiments → PCAN API: uses API (evidence: `scripts/probing/pcan_peer_tests_chatgpt.py`)
- Family probe → CAN bus: probes families
- Session probe → CAN bus: sends frames
- Peer tests → CAN bus: sends and captures
- Peer simulator → CAN bus: simulates peers
- Peer experiments → CAN bus: tests peers
- DAB inverter → CAN bus: transmits traffic (evidence: `README.md`)
- CAN bus → Raw captures: recorded as
- Raw captures → TRC analysis: parsed from (evidence: `scripts/analysis/trc_summarize_new.py`)
- Raw captures → CAN analysis: analyzed from (evidence: `scripts/analysis/dab_can_analyse.py`)
- Raw captures → Event audit: audited from
- Family probe → Experiment results: writes results (evidence: `scripts/probing/dab_family_probe.py`)
- Session probe → Experiment results: writes results (evidence: `scripts/probing/dab_can_session_probe.py`)
- TRC analysis → Experiment results: exports summaries
- Experiment results → Protocol record: supports findings (evidence: `README.md`)
- Field observations → Protocol record: informs protocol model (evidence: `README.md`)
- Investigator → Protocol record: consults findings (evidence: `README.md`)
- Protocol probes → CAN bus: investigate protocol
- Family scanning → CAN bus: scans families
