# eclipse-opensovd/classic-diagnostic-adapter architecture

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

- Interactive diagram: https://gitdiagram.com/eclipse-opensovd/classic-diagnostic-adapter
- Repository: https://github.com/eclipse-opensovd/classic-diagnostic-adapter

## Overview

Classic Diagnostic Adapter (CDA) bridges SOVD vehicle-diagnostic requests to legacy ECU diagnostics. The principal flow exposes REST resources, resolves them against MDD diagnostic descriptions, encodes UDS requests, and communicates with ECUs over DoIP; CAN transport is also present. Internal layers cover diagnostic lookup and payload handling, database loading, and transport. The README documents the translation and MDD-based mapping; subsystem links beyond those documented relationships are omitted because the sampled source does not show their wiring.

Main entry points: [`cda-sovd/src/sovd.rs`](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-sovd/src/sovd.rs) (SOVD REST), [`cda-core/src/diag_kernel.rs`](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel.rs) (Diagnostic Kernel), [`cda-core/src/diag_kernel/ecumanager.rs`](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/ecumanager.rs) (ECU Manager), [`cda-core/src/diag_kernel/operations.rs`](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/operations.rs) (Diagnostic Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["SOVD API"]
  node_api["SOVD REST<br/>[sovd.rs]"]
  node_api_apps["SOVD Apps<br/>[apps.rs]"]
  node_api_components["ECU Resources<br/>[ecu.rs]"]
  node_api_functions["Functional Groups"]
end

subgraph group_diagnostics["Diagnostic Kernel"]
  node_kernel["Diagnostic Kernel<br/>[diag_kernel.rs]"]
  node_ecu_manager["ECU Manager<br/>[ecumanager.rs]"]
  node_service_lookup["Service Lookup<br/>[service_lookup.rs]"]
  node_operations_core["Diagnostic Operations<br/>[operations.rs]"]
  node_decode["Payload Decode<br/>[payload_decode.rs]"]
  node_encode["Payload Encode<br/>[payload_encode.rs]"]
  node_schema["Diagnostic Schema<br/>[schema.rs]"]
  node_state["ECU State<br/>[state.rs]"]
end

subgraph group_database["Diagnostic Data"]
  node_database[("Diagnostic Database<br/>[storage.rs]")]
  node_database_builder["Database Builder"]
end

subgraph group_transport["ECU Transport"]
  node_uds["UDS Services<br/>[lib.rs]"]
  node_doip["DoIP Transport<br/>[ecu_connection.rs]"]
  node_can["CAN Gateway<br/>[gateway.rs]"]
end

subgraph group_operations["Runtime Services"]
  node_storage[("Local Storage<br/>[local_storage.rs]")]
  node_runtime_update["Runtime Updates<br/>[lib.rs]"]
  node_comm_management["Communication Lifecycle<br/>[controller.rs]"]
end

node_client(("SOVD Client"))
node_mdd["MDD Files"]
node_ecu(("Vehicle ECUs"))

node_client -->|"sends requests"| node_api
node_api -->|"routes resources"| node_api_apps
node_api -.->|"serves components"| node_api_components
node_api -.->|"serves groups"| node_api_functions
node_api -.->|"resolves diagnostics"| node_kernel
node_mdd -->|"provides descriptions"| node_database
node_database -->|"supplies definitions"| node_service_lookup
node_kernel -->|"manages ECUs"| node_ecu_manager
node_ecu_manager -->|"looks up services"| node_service_lookup
node_kernel -.->|"executes diagnostics"| node_operations_core
node_operations_core -.->|"encodes requests"| node_encode
node_decode -.->|"decodes responses"| node_kernel
node_uds -->|"sends UDS"| node_doip
node_doip -->|"communicates with"| node_ecu
node_can -.->|"communicates with"| node_ecu
node_runtime_update -.->|"stores updates"| node_storage
node_comm_management -.->|"controls lifecycle"| node_uds

click node_api "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-sovd/src/sovd.rs"
click node_api_apps "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-sovd/src/sovd/apps.rs"
click node_api_components "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-sovd/src/sovd/components/ecu.rs"
click node_api_functions "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-sovd/src/sovd/functions/functional_groups.rs"
click node_kernel "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel.rs"
click node_ecu_manager "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/ecumanager.rs"
click node_service_lookup "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/service_lookup.rs"
click node_operations_core "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/operations.rs"
click node_decode "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/payload_decode.rs"
click node_encode "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/payload_encode.rs"
click node_schema "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/schema.rs"
click node_state "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/state.rs"
click node_database "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-database/src/storage.rs"
click node_database_builder "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-database/src/datatypes/database_builder.rs"
click node_uds "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-comm-uds/src/lib.rs"
click node_doip "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-comm-doip/src/ecu_connection.rs"
click node_can "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-comm-can/src/gateway.rs"
click node_storage "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-storage/src/local_storage.rs"
click node_runtime_update "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-plugin-runtime-update/src/lib.rs"
click node_comm_management "https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-plugin-communication-management/src/lifecycle/controller.rs"

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_api,node_api_apps,node_api_components,node_api_functions,node_client toneBlue
class node_kernel,node_ecu_manager,node_service_lookup,node_operations_core,node_decode,node_encode,node_schema,node_state toneAmber
class node_database,node_database_builder toneMint
class node_uds,node_doip,node_can toneRose
class node_storage,node_runtime_update,node_comm_management,node_mdd,node_ecu toneIndigo
```

## Components

### SOVD API

- [SOVD REST](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-sovd/src/sovd.rs): `cda-sovd/src/sovd.rs`
- [SOVD Apps](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-sovd/src/sovd/apps.rs): `cda-sovd/src/sovd/apps.rs`
- [ECU Resources](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-sovd/src/sovd/components/ecu.rs): `cda-sovd/src/sovd/components/ecu.rs`
- [Functional Groups](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-sovd/src/sovd/functions/functional_groups.rs): `cda-sovd/src/sovd/functions/functional_groups.rs`

### Diagnostic Kernel

- [Diagnostic Kernel](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel.rs): `cda-core/src/diag_kernel.rs`
- [ECU Manager](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/ecumanager.rs): `cda-core/src/diag_kernel/ecumanager.rs`
- [Service Lookup](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/service_lookup.rs): `cda-core/src/diag_kernel/service_lookup.rs`
- [Diagnostic Operations](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/operations.rs): `cda-core/src/diag_kernel/operations.rs`
- [Payload Decode](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/payload_decode.rs): `cda-core/src/diag_kernel/payload_decode.rs`
- [Payload Encode](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/payload_encode.rs): `cda-core/src/diag_kernel/payload_encode.rs`
- [Diagnostic Schema](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/schema.rs): `cda-core/src/diag_kernel/schema.rs`
- [ECU State](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-core/src/diag_kernel/state.rs): `cda-core/src/diag_kernel/state.rs`

### Diagnostic Data

- [Diagnostic Database](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-database/src/storage.rs): `cda-database/src/storage.rs`
- [Database Builder](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-database/src/datatypes/database_builder.rs): `cda-database/src/datatypes/database_builder.rs`

### ECU Transport

- [UDS Services](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-comm-uds/src/lib.rs): `cda-comm-uds/src/lib.rs`
- [DoIP Transport](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-comm-doip/src/ecu_connection.rs): `cda-comm-doip/src/ecu_connection.rs`
- [CAN Gateway](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-comm-can/src/gateway.rs): `cda-comm-can/src/gateway.rs`

### Runtime Services

- [Local Storage](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-storage/src/local_storage.rs): `cda-storage/src/local_storage.rs`
- [Runtime Updates](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-plugin-runtime-update/src/lib.rs): `cda-plugin-runtime-update/src/lib.rs`
- [Communication Lifecycle](https://github.com/eclipse-opensovd/classic-diagnostic-adapter/blob/main/cda-plugin-communication-management/src/lifecycle/controller.rs): `cda-plugin-communication-management/src/lifecycle/controller.rs`

### Other components

- **SOVD Client**
- **MDD Files**
- **Vehicle ECUs**

## Connections

- SOVD Client → SOVD REST: sends requests (evidence: `README.md`)
- SOVD REST → SOVD Apps: routes resources (evidence: `cda-sovd/src/sovd/apps.rs`)
- SOVD REST → ECU Resources: serves components
- SOVD REST → Functional Groups: serves groups
- SOVD REST → Diagnostic Kernel: resolves diagnostics
- MDD Files → Diagnostic Database: provides descriptions (evidence: `README.md`)
- Diagnostic Database → Service Lookup: supplies definitions (evidence: `README.md`)
- Diagnostic Kernel → ECU Manager: manages ECUs (evidence: `cda-core/src/diag_kernel.rs`)
- ECU Manager → Service Lookup: looks up services (evidence: `cda-core/src/diag_kernel/ecumanager.rs`)
- Diagnostic Kernel → Diagnostic Operations: executes diagnostics (evidence: `cda-core/src/diag_kernel.rs`)
- Diagnostic Operations → Payload Encode: encodes requests
- Payload Decode → Diagnostic Kernel: decodes responses (evidence: `cda-core/src/diag_kernel.rs`)
- UDS Services → DoIP Transport: sends UDS (evidence: `README.md`)
- DoIP Transport → Vehicle ECUs: communicates with (evidence: `README.md`)
- CAN Gateway → Vehicle ECUs: communicates with
- Runtime Updates → Local Storage: stores updates
- Communication Lifecycle → UDS Services: controls lifecycle
