# dalathegreat/leaf_can_bus_messages architecture

> Architecture diagram of the GitHub repository dalathegreat/leaf_can_bus_messages, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dalathegreat/leaf_can_bus_messages
- Repository: https://github.com/dalathegreat/leaf_can_bus_messages

## Overview

This repository is a reference dataset for Nissan LEAF CAN messages, not a software runtime. Its main workflow is to select a model-appropriate DBC, open it in a compatible database editor, and use it to translate a passively recorded CAN log. It also documents active polling IDs separately, and includes the source spreadsheet. Relationships shown are limited to those described in the README; the data files themselves were not sampled.

Main entry points: [`AV-CAN.dbc`](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/AV-CAN.dbc) (AV CAN), [`CAR-can_AZE0.dbc`](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/CAR-can_AZE0.dbc) (AZE0 car CAN), [`EV-can_AZE0.dbc`](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/EV-can_AZE0.dbc) (AZE0 EV CAN), [`EV-can_ZE0.dbc`](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/EV-can_ZE0.dbc) (ZE0 EV CAN)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dbc["CAN databases"]
  node_av["AV CAN<br/>[AV-CAN.dbc]"]
  node_car_aze0["AZE0 car CAN<br/>[CAR-can_AZE0.dbc]"]
  node_ev_aze0["AZE0 EV CAN<br/>[EV-can_AZE0.dbc]"]
  node_ev_ze0["ZE0 EV CAN<br/>[EV-can_ZE0.dbc]"]
  node_ev_ze1["ZE1 EV CAN<br/>[EV-can_ZE1.dbc]"]
  node_qc["QC CAN<br/>[QC-CAN_ALL.dbc]"]
end

subgraph group_reference["Polling reference"]
  node_spreadsheet["Original spreadsheet<br/>[canmsgs.xlsx]"]
  node_polling["Polling IDs<br/>[README.md]"]
end

node_user(("Engineer"))
node_editor["DBC editor"]
node_log["CAN log"]
node_vehicle_ecu["Vehicle control unit"]

node_user -->|"uses"| node_editor
node_editor -->|"opens"| node_av
node_editor -->|"opens"| node_car_aze0
node_editor -->|"opens"| node_ev_aze0
node_editor -->|"opens"| node_ev_ze0
node_editor -->|"opens"| node_ev_ze1
node_editor -->|"opens"| node_qc
node_log -->|"translated by"| node_editor
node_user -->|"consults"| node_polling
node_user -->|"queries"| node_vehicle_ecu
node_vehicle_ecu -->|"responds"| node_user

click node_av "https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/AV-CAN.dbc"
click node_car_aze0 "https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/CAR-can_AZE0.dbc"
click node_ev_aze0 "https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/EV-can_AZE0.dbc"
click node_ev_ze0 "https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/EV-can_ZE0.dbc"
click node_ev_ze1 "https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/EV-can_ZE1.dbc"
click node_qc "https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/QC-CAN_ALL.dbc"
click node_spreadsheet "https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/canmsgs.xlsx"
click node_polling "https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/README.md"

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_av,node_car_aze0,node_ev_aze0,node_ev_ze0,node_ev_ze1,node_qc toneBlue
class node_spreadsheet,node_polling toneAmber
class node_user,node_editor,node_log,node_vehicle_ecu toneIndigo
```

## Components

### CAN databases

- [AV CAN](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/AV-CAN.dbc): `AV-CAN.dbc`
- [AZE0 car CAN](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/CAR-can_AZE0.dbc): `CAR-can_AZE0.dbc`
- [AZE0 EV CAN](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/EV-can_AZE0.dbc): `EV-can_AZE0.dbc`
- [ZE0 EV CAN](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/EV-can_ZE0.dbc): `EV-can_ZE0.dbc`
- [ZE1 EV CAN](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/EV-can_ZE1.dbc): `EV-can_ZE1.dbc`
- [QC CAN](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/QC-CAN_ALL.dbc): `QC-CAN_ALL.dbc`

### Polling reference

- [Original spreadsheet](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/canmsgs.xlsx): `canmsgs.xlsx`
- [Polling IDs](https://github.com/dalathegreat/leaf_can_bus_messages/blob/main/README.md): `README.md`

### Other components

- **Engineer**
- **DBC editor**
- **CAN log**
- **Vehicle control unit**

## Connections

- Engineer → DBC editor: uses (evidence: `README.md`)
- DBC editor → AV CAN: opens (evidence: `README.md`)
- DBC editor → AZE0 car CAN: opens (evidence: `README.md`)
- DBC editor → AZE0 EV CAN: opens (evidence: `README.md`)
- DBC editor → ZE0 EV CAN: opens (evidence: `README.md`)
- DBC editor → ZE1 EV CAN: opens (evidence: `README.md`)
- DBC editor → QC CAN: opens (evidence: `README.md`)
- CAN log → DBC editor: translated by (evidence: `README.md`)
- Engineer → Polling IDs: consults (evidence: `README.md`)
- Engineer → Vehicle control unit: queries (evidence: `README.md`)
- Vehicle control unit → Engineer: responds (evidence: `README.md`)
