# collin80/savvycan architecture

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

- Interactive diagram: https://gitdiagram.com/collin80/savvycan
- Repository: https://github.com/collin80/savvycan

## Overview

SavvyCAN is a Qt desktop tool for capturing, loading, saving, and analyzing CAN traffic. The principal workflow is to acquire or load frames, collect them into the central frame model, and inspect, decode, visualize, or export them. Separate capabilities include DBC editing, protocol analysis, replay/transmission, and bus bridging. The graph reflects the README and indexed module references; unsampled implementations are represented only at supported paths, and uncertain internal links are omitted.

Main entry points: [`mainwindow.cpp`](https://github.com/collin80/savvycan/blob/master/mainwindow.cpp) (Main window), [`connections/canconmanager.cpp`](https://github.com/collin80/savvycan/blob/master/connections/canconmanager.cpp) (Connection manager), [`mqtt/qmqtt_client.cpp`](https://github.com/collin80/savvycan/blob/master/mqtt/qmqtt_client.cpp) (MQTT client), [`bus_protocols/uds_handler.cpp`](https://github.com/collin80/savvycan/blob/master/bus_protocols/uds_handler.cpp) (UDS diagnostics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and frames"]
  node_main["Main window<br/>[mainwindow.cpp]"]
  node_frame["Frame model<br/>[canframemodel.h]"]
  node_canframe["CAN frame types<br/>[can_structs.h]"]
end

subgraph group_io["Connections and files"]
  node_manager["Connection manager<br/>[canconmanager.cpp]"]
  node_connections["CAN connections<br/>[canconnection.cpp]"]
  node_formats["Frame file formats<br/>[framefileio.cpp]"]
end

subgraph group_analysis["Analysis and decoding"]
  node_dbc["DBC handling<br/>[dbchandler.cpp]"]
  node_dbc_edit["DBC editors<br/>[dbcmaineditor.cpp]"]
  node_frame_info["Frame analysis"]
  node_graphs["Graphing<br/>[graphingwindow.cpp]"]
  node_sniffer["Bus sniffer<br/>[snifferwindow.cpp]"]
  node_sniffer_model["Sniffer model<br/>[sniffermodel.cpp]"]
  node_isotp["ISO-TP handling<br/>[isotp_handler.cpp]"]
  node_uds["UDS diagnostics<br/>[uds_handler.cpp]"]
  node_compare["File comparison"]
end

subgraph group_tools["Traffic tools"]
  node_playback["Frame playback"]
  node_sender["Frame transmission"]
  node_bridge["CAN bridge"]
  node_fuzz["Frame fuzzing<br/>[fuzzingwindow.cpp]"]
end

subgraph group_mqtt["MQTT library"]
  node_mqtt_client["MQTT client<br/>[qmqtt_client.cpp]"]
  node_mqtt_private["MQTT client internals<br/>[qmqtt_client_p.cpp]"]
  node_mqtt_routes["MQTT routing"]
end

node_user(("CAN tool user"))
node_broker(("MQTT broker"))

node_user -->|"operates"| node_main
node_main -->|"manages frames"| node_frame
node_manager -->|"refreshes queues"| node_connections
node_manager -->|"collects frames"| node_canframe
node_main -.->|"manages connections"| node_manager
node_main -->|"loads and saves"| node_formats
node_main -->|"opens playback"| node_playback
node_main -->|"opens sender"| node_sender
node_main -->|"uses DBC data"| node_dbc
node_main -->|"opens editor"| node_dbc_edit
node_main -->|"opens analysis"| node_frame_info
node_main -->|"opens graphs"| node_graphs
node_main -->|"opens sniffer"| node_sniffer
node_sniffer -->|"uses model"| node_sniffer_model
node_main -->|"opens interpreter"| node_isotp
node_uds -->|"sends ISO-TP"| node_isotp
node_uds -->|"checks bus count"| node_manager
node_main -->|"opens bridge"| node_bridge
node_main -->|"opens fuzzing"| node_fuzz
node_main -->|"opens comparison"| node_compare
node_mqtt_client -->|"delegates client work"| node_mqtt_private
node_broker -.->|"exchanges messages"| node_mqtt_client
node_mqtt_routes -->|"subscribes to client"| node_mqtt_client

click node_main "https://github.com/collin80/savvycan/blob/master/mainwindow.cpp"
click node_frame "https://github.com/collin80/savvycan/blob/master/canframemodel.h"
click node_canframe "https://github.com/collin80/savvycan/blob/master/can_structs.h"
click node_manager "https://github.com/collin80/savvycan/blob/master/connections/canconmanager.cpp"
click node_connections "https://github.com/collin80/savvycan/blob/master/connections/canconnection.cpp"
click node_formats "https://github.com/collin80/savvycan/blob/master/framefileio.cpp"
click node_playback "https://github.com/collin80/savvycan/blob/master/frameplaybackobject.cpp"
click node_sender "https://github.com/collin80/savvycan/blob/master/framesenderobject.cpp"
click node_dbc "https://github.com/collin80/savvycan/blob/master/dbc/dbchandler.cpp"
click node_dbc_edit "https://github.com/collin80/savvycan/blob/master/dbc/dbcmaineditor.cpp"
click node_frame_info "https://github.com/collin80/savvycan/blob/master/re/frameinfowindow.cpp"
click node_graphs "https://github.com/collin80/savvycan/blob/master/re/graphingwindow.cpp"
click node_sniffer "https://github.com/collin80/savvycan/blob/master/re/sniffer/snifferwindow.cpp"
click node_sniffer_model "https://github.com/collin80/savvycan/blob/master/re/sniffer/sniffermodel.cpp"
click node_isotp "https://github.com/collin80/savvycan/blob/master/bus_protocols/isotp_handler.cpp"
click node_uds "https://github.com/collin80/savvycan/blob/master/bus_protocols/uds_handler.cpp"
click node_bridge "https://github.com/collin80/savvycan/blob/master/canbridgewindow.cpp"
click node_fuzz "https://github.com/collin80/savvycan/blob/master/re/fuzzingwindow.cpp"
click node_compare "https://github.com/collin80/savvycan/blob/master/re/filecomparatorwindow.cpp"
click node_mqtt_client "https://github.com/collin80/savvycan/blob/master/mqtt/qmqtt_client.cpp"
click node_mqtt_private "https://github.com/collin80/savvycan/blob/master/mqtt/qmqtt_client_p.cpp"
click node_mqtt_routes "https://github.com/collin80/savvycan/blob/master/mqtt/qmqtt_routesubscription.cpp"

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_main,node_frame,node_canframe,node_user toneBlue
class node_manager,node_connections,node_formats toneAmber
class node_dbc,node_dbc_edit,node_frame_info,node_graphs,node_sniffer,node_sniffer_model,node_isotp,node_uds,node_compare toneMint
class node_playback,node_sender,node_bridge,node_fuzz toneRose
class node_mqtt_client,node_mqtt_private,node_mqtt_routes,node_broker toneIndigo
```

## Components

### Application and frames

- [Main window](https://github.com/collin80/savvycan/blob/master/mainwindow.cpp): `mainwindow.cpp`
- [Frame model](https://github.com/collin80/savvycan/blob/master/canframemodel.h): `canframemodel.h`
- [CAN frame types](https://github.com/collin80/savvycan/blob/master/can_structs.h): `can_structs.h`

### Connections and files

- [Connection manager](https://github.com/collin80/savvycan/blob/master/connections/canconmanager.cpp): `connections/canconmanager.cpp`
- [CAN connections](https://github.com/collin80/savvycan/blob/master/connections/canconnection.cpp): `connections/canconnection.cpp`
- [Frame file formats](https://github.com/collin80/savvycan/blob/master/framefileio.cpp): `framefileio.cpp`

### Analysis and decoding

- [DBC handling](https://github.com/collin80/savvycan/blob/master/dbc/dbchandler.cpp): `dbc/dbchandler.cpp`
- [DBC editors](https://github.com/collin80/savvycan/blob/master/dbc/dbcmaineditor.cpp): `dbc/dbcmaineditor.cpp`
- [Frame analysis](https://github.com/collin80/savvycan/blob/master/re/frameinfowindow.cpp): `re/frameinfowindow.cpp`
- [Graphing](https://github.com/collin80/savvycan/blob/master/re/graphingwindow.cpp): `re/graphingwindow.cpp`
- [Bus sniffer](https://github.com/collin80/savvycan/blob/master/re/sniffer/snifferwindow.cpp): `re/sniffer/snifferwindow.cpp`
- [Sniffer model](https://github.com/collin80/savvycan/blob/master/re/sniffer/sniffermodel.cpp): `re/sniffer/sniffermodel.cpp`
- [ISO-TP handling](https://github.com/collin80/savvycan/blob/master/bus_protocols/isotp_handler.cpp): `bus_protocols/isotp_handler.cpp`
- [UDS diagnostics](https://github.com/collin80/savvycan/blob/master/bus_protocols/uds_handler.cpp): `bus_protocols/uds_handler.cpp`
- [File comparison](https://github.com/collin80/savvycan/blob/master/re/filecomparatorwindow.cpp): `re/filecomparatorwindow.cpp`

### Traffic tools

- [Frame playback](https://github.com/collin80/savvycan/blob/master/frameplaybackobject.cpp): `frameplaybackobject.cpp`
- [Frame transmission](https://github.com/collin80/savvycan/blob/master/framesenderobject.cpp): `framesenderobject.cpp`
- [CAN bridge](https://github.com/collin80/savvycan/blob/master/canbridgewindow.cpp): `canbridgewindow.cpp`
- [Frame fuzzing](https://github.com/collin80/savvycan/blob/master/re/fuzzingwindow.cpp): `re/fuzzingwindow.cpp`

### MQTT library

- [MQTT client](https://github.com/collin80/savvycan/blob/master/mqtt/qmqtt_client.cpp): `mqtt/qmqtt_client.cpp`
- [MQTT client internals](https://github.com/collin80/savvycan/blob/master/mqtt/qmqtt_client_p.cpp): `mqtt/qmqtt_client_p.cpp`
- [MQTT routing](https://github.com/collin80/savvycan/blob/master/mqtt/qmqtt_routesubscription.cpp): `mqtt/qmqtt_routesubscription.cpp`

### Other components

- **CAN tool user**
- **MQTT broker**

## Connections

- CAN tool user → Main window: operates
- Main window → Frame model: manages frames
- Connection manager → CAN connections: refreshes queues (evidence: `connections/canconmanager.cpp`)
- Connection manager → CAN frame types: collects frames (evidence: `connections/canconmanager.cpp`)
- Main window → Connection manager: manages connections
- Main window → Frame file formats: loads and saves
- Main window → Frame playback: opens playback
- Main window → Frame transmission: opens sender
- Main window → DBC handling: uses DBC data
- Main window → DBC editors: opens editor
- Main window → Frame analysis: opens analysis
- Main window → Graphing: opens graphs
- Main window → Bus sniffer: opens sniffer
- Bus sniffer → Sniffer model: uses model (evidence: `re/sniffer/snifferwindow.cpp`)
- Main window → ISO-TP handling: opens interpreter
- UDS diagnostics → ISO-TP handling: sends ISO-TP (evidence: `bus_protocols/uds_handler.cpp`)
- UDS diagnostics → Connection manager: checks bus count (evidence: `bus_protocols/uds_handler.cpp`)
- Main window → CAN bridge: opens bridge
- Main window → Frame fuzzing: opens fuzzing
- Main window → File comparison: opens comparison
- MQTT client → MQTT client internals: delegates client work (evidence: `mqtt/qmqtt_client.cpp`)
- MQTT broker → MQTT client: exchanges messages
- MQTT routing → MQTT client: subscribes to client (evidence: `mqtt/qmqtt_routesubscription.cpp`)
