# eclipse-sdv-blueprints/commercial-sdv-stack architecture

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

- Interactive diagram: https://gitdiagram.com/eclipse-sdv-blueprints/commercial-sdv-stack
- Repository: https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack

## Overview

This repository combines a vehicle-use-case blueprint with three runtime areas: a diagnostic ECU simulator, Python tooling that generates ODX diagnostic descriptions, and Rust uServices for powertrain control, fleet management, and vehicle-property publication. The principal configuration workflow cycles powertrain modes from the fleet-management service through the powertrain controller to a SOVD/CDA endpoint and the simulated ECU. The README also documents an OTA firmware-update flow, but its Symphony and ECU-updater components are not present in this tree. Some subsystem links below rely on README descriptions because their implementations are unsampled.

Main entry points: [`odx/generate.py`](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/generate.py) (ODX Builder), [`ecu-sim/src/main/kotlin/ecu/EcuState.kt`](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/EcuState.kt) (Simulated ECU), [`odx/helper.py`](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/helper.py) (ODX Helpers), [`uservices/fms/src/main.rs`](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/fms/src/main.rs) (Fleet Management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vehicle["Vehicle Services"]
  node_fms["Fleet Management<br/>[main.rs]"]
  node_powertrain["Mode Controller<br/>[main.rs]"]
  node_properties["Vehicle Properties<br/>[main.rs]"]
  node_databroker["Databroker Adapter"]
end

subgraph group_simulator["ECU Simulator"]
  node_ecu["Simulated ECU<br/>[EcuState.kt]"]
  node_ecu_dispatch["Diagnostic Dispatch<br/>[EcuFunctions.kt]"]
  node_ecu_diag["Diagnostic Services"]
  node_ecu_dtc["DTC Services"]
  node_ecu_flash["Flash Services"]
  node_ecu_auth["Authentication"]
  node_ecu_security["Security Access"]
  node_ecu_session["Session Services"]
  node_ecu_reset["Reset Services"]
  node_ecu_web["Simulator Web API<br/>[WebserverRoutes.kt]"]
  node_jwt_routes["JWT Mock Routes"]
  node_jwt_mock["JWT Mock Server"]
end

subgraph group_odx["ODX Generation"]
  node_odx_generator["ODX Builder<br/>[generate.py]"]
  node_odx_shared["Common Diagnostic Data<br/>[shared.py]"]
  node_odx_sessions["Session Definitions<br/>[sessions.py]"]
  node_odx_auth["Authentication Definitions<br/>[authentication.py]"]
  node_odx_reset["Reset Definitions<br/>[reset.py]"]
  node_odx_security["Security Definitions<br/>[security_access.py]"]
  node_odx_transfer["Transfer Definitions<br/>[transferdata.py]"]
  node_odx_comparams["Communication Parameters<br/>[comparams.py]"]
  node_odx_metadata["ODX Metadata<br/>[metadata.py]"]
  node_odx_helper["ODX Helpers<br/>[helper.py]"]
end

subgraph group_common["Shared Types"]
  node_shared_types["uService Types<br/>[lib.rs]"]
end

node_cda["SOVD / CDA"]
node_fleet_operator(("Fleet Manager"))
node_vehicle_databroker[("Vehicle Databroker")]

node_fleet_operator -->|"cycles modes"| node_fms
node_fms -->|"invokes mode RPC"| node_powertrain
node_powertrain -->|"updates SOVD entity"| node_cda
node_cda -->|"invokes UDS write"| node_ecu
node_databroker -->|"reads attributes"| node_vehicle_databroker
node_properties -->|"fetches values"| node_databroker
node_properties -.->|"publishes properties"| node_fms
node_fms -->|"uses mode types"| node_shared_types
node_powertrain -.->|"uses mode types"| node_shared_types
node_ecu_dispatch -->|"uses ECU state"| node_ecu
node_ecu_diag -.->|"uses ECU state"| node_ecu
node_ecu_dtc -.->|"uses DTC state"| node_ecu
node_ecu_flash -.->|"uses ECU state"| node_ecu
node_ecu_auth -.->|"uses ECU state"| node_ecu
node_ecu_security -.->|"uses security state"| node_ecu
node_ecu_session -.->|"uses session state"| node_ecu
node_ecu_reset -.->|"uses ECU state"| node_ecu
node_jwt_routes -->|"generates token response"| node_jwt_mock
node_odx_generator -->|"builds common data"| node_odx_shared
node_odx_generator -->|"adds sessions"| node_odx_sessions
node_odx_generator -->|"adds authentication"| node_odx_auth
node_odx_generator -->|"adds reset services"| node_odx_reset
node_odx_generator -->|"adds security access"| node_odx_security
node_odx_generator -->|"adds transfer services"| node_odx_transfer
node_odx_generator -->|"uses parameters"| node_odx_comparams
node_odx_generator -->|"uses metadata"| node_odx_metadata
node_odx_generator -->|"uses helpers"| node_odx_helper
node_odx_auth -->|"uses helpers"| node_odx_helper
node_odx_shared -->|"uses helpers"| node_odx_helper
node_odx_sessions -->|"uses helpers"| node_odx_helper
node_odx_security -.->|"uses helpers"| node_odx_helper
node_odx_transfer -.->|"uses helpers"| node_odx_helper
node_odx_reset -.->|"uses helpers"| node_odx_helper
node_odx_comparams -.->|"uses helpers"| node_odx_helper
node_odx_metadata -.->|"uses helpers"| node_odx_helper

click node_fms "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/fms/src/main.rs"
click node_powertrain "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/powertrain/src/main.rs"
click node_properties "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/vehicle-properties/src/main.rs"
click node_databroker "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/vehicle-properties/src/databroker_client.rs"
click node_ecu "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/EcuState.kt"
click node_ecu_dispatch "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/EcuFunctions.kt"
click node_ecu_diag "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/DiagnosticFunctionalities.kt"
click node_ecu_dtc "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/DtcFunctionalities.kt"
click node_ecu_flash "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/FlashFunctionalities.kt"
click node_ecu_auth "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/AuthenticationFunctionalities.kt"
click node_ecu_security "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/SecurityFunctionalities.kt"
click node_ecu_session "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/SessionFunctionalities.kt"
click node_ecu_reset "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/ResetFunctionalities.kt"
click node_ecu_web "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/webserver/WebserverRoutes.kt"
click node_jwt_routes "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/webserver/token/JwtAuthServerRoutes.kt"
click node_jwt_mock "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/webserver/token/JwtAuthServerMock.kt"
click node_odx_generator "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/generate.py"
click node_odx_shared "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/shared.py"
click node_odx_sessions "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/sessions.py"
click node_odx_auth "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/authentication.py"
click node_odx_reset "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/reset.py"
click node_odx_security "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/security_access.py"
click node_odx_transfer "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/transferdata.py"
click node_odx_comparams "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/comparams.py"
click node_odx_metadata "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/metadata.py"
click node_odx_helper "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/helper.py"
click node_shared_types "https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/common/src/lib.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_fms,node_powertrain,node_properties,node_databroker toneBlue
class node_ecu,node_ecu_dispatch,node_ecu_diag,node_ecu_dtc,node_ecu_flash,node_ecu_auth,node_ecu_security,node_ecu_session,node_ecu_reset,node_ecu_web,node_jwt_routes,node_jwt_mock,node_vehicle_databroker toneAmber
class node_odx_generator,node_odx_shared,node_odx_sessions,node_odx_auth,node_odx_reset,node_odx_security,node_odx_transfer,node_odx_comparams,node_odx_metadata,node_odx_helper toneMint
class node_shared_types toneRose
class node_cda,node_fleet_operator toneIndigo
```

## Components

### Vehicle Services

- [Fleet Management](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/fms/src/main.rs): `uservices/fms/src/main.rs`
- [Mode Controller](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/powertrain/src/main.rs): `uservices/powertrain/src/main.rs`
- [Vehicle Properties](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/vehicle-properties/src/main.rs): `uservices/vehicle-properties/src/main.rs`
- [Databroker Adapter](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/vehicle-properties/src/databroker_client.rs): `uservices/vehicle-properties/src/databroker_client.rs`

### ECU Simulator

- [Simulated ECU](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/EcuState.kt): `ecu-sim/src/main/kotlin/ecu/EcuState.kt`
- [Diagnostic Dispatch](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/EcuFunctions.kt): `ecu-sim/src/main/kotlin/ecu/EcuFunctions.kt`
- [Diagnostic Services](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/DiagnosticFunctionalities.kt): `ecu-sim/src/main/kotlin/ecu/DiagnosticFunctionalities.kt`
- [DTC Services](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/DtcFunctionalities.kt): `ecu-sim/src/main/kotlin/ecu/DtcFunctionalities.kt`
- [Flash Services](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/FlashFunctionalities.kt): `ecu-sim/src/main/kotlin/ecu/FlashFunctionalities.kt`
- [Authentication](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/AuthenticationFunctionalities.kt): `ecu-sim/src/main/kotlin/ecu/AuthenticationFunctionalities.kt`
- [Security Access](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/SecurityFunctionalities.kt): `ecu-sim/src/main/kotlin/ecu/SecurityFunctionalities.kt`
- [Session Services](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/SessionFunctionalities.kt): `ecu-sim/src/main/kotlin/ecu/SessionFunctionalities.kt`
- [Reset Services](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/ecu/ResetFunctionalities.kt): `ecu-sim/src/main/kotlin/ecu/ResetFunctionalities.kt`
- [Simulator Web API](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/webserver/WebserverRoutes.kt): `ecu-sim/src/main/kotlin/webserver/WebserverRoutes.kt`
- [JWT Mock Routes](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/webserver/token/JwtAuthServerRoutes.kt): `ecu-sim/src/main/kotlin/webserver/token/JwtAuthServerRoutes.kt`
- [JWT Mock Server](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/ecu-sim/src/main/kotlin/webserver/token/JwtAuthServerMock.kt): `ecu-sim/src/main/kotlin/webserver/token/JwtAuthServerMock.kt`

### ODX Generation

- [ODX Builder](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/generate.py): `odx/generate.py`
- [Common Diagnostic Data](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/shared.py): `odx/shared.py`
- [Session Definitions](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/sessions.py): `odx/sessions.py`
- [Authentication Definitions](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/authentication.py): `odx/authentication.py`
- [Reset Definitions](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/reset.py): `odx/reset.py`
- [Security Definitions](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/security_access.py): `odx/security_access.py`
- [Transfer Definitions](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/transferdata.py): `odx/transferdata.py`
- [Communication Parameters](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/comparams.py): `odx/comparams.py`
- [ODX Metadata](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/metadata.py): `odx/metadata.py`
- [ODX Helpers](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/odx/helper.py): `odx/helper.py`

### Shared Types

- [uService Types](https://github.com/eclipse-sdv-blueprints/commercial-sdv-stack/blob/main/uservices/common/src/lib.rs): `uservices/common/src/lib.rs`

### Other components

- **SOVD / CDA**
- **Fleet Manager**
- **Vehicle Databroker**

## Connections

- Fleet Manager → Fleet Management: cycles modes (evidence: `README.md`)
- Fleet Management → Mode Controller: invokes mode RPC (evidence: `uservices/fms/src/main.rs`)
- Mode Controller → SOVD / CDA: updates SOVD entity (evidence: `README.md`)
- SOVD / CDA → Simulated ECU: invokes UDS write (evidence: `README.md`)
- Databroker Adapter → Vehicle Databroker: reads attributes (evidence: `uservices/vehicle-properties/src/databroker_client.rs`)
- Vehicle Properties → Databroker Adapter: fetches values (evidence: `uservices/vehicle-properties/src/main.rs`)
- Vehicle Properties → Fleet Management: publishes properties
- Fleet Management → uService Types: uses mode types (evidence: `uservices/fms/src/main.rs`)
- Mode Controller → uService Types: uses mode types
- Diagnostic Dispatch → Simulated ECU: uses ECU state (evidence: `ecu-sim/src/main/kotlin/ecu/EcuFunctions.kt`)
- Diagnostic Services → Simulated ECU: uses ECU state
- DTC Services → Simulated ECU: uses DTC state
- Flash Services → Simulated ECU: uses ECU state
- Authentication → Simulated ECU: uses ECU state
- Security Access → Simulated ECU: uses security state
- Session Services → Simulated ECU: uses session state
- Reset Services → Simulated ECU: uses ECU state
- JWT Mock Routes → JWT Mock Server: generates token response (evidence: `ecu-sim/src/main/kotlin/webserver/token/JwtAuthServerRoutes.kt`)
- ODX Builder → Common Diagnostic Data: builds common data (evidence: `odx/generate.py`)
- ODX Builder → Session Definitions: adds sessions (evidence: `odx/generate.py`)
- ODX Builder → Authentication Definitions: adds authentication (evidence: `odx/generate.py`)
- ODX Builder → Reset Definitions: adds reset services (evidence: `odx/generate.py`)
- ODX Builder → Security Definitions: adds security access (evidence: `odx/generate.py`)
- ODX Builder → Transfer Definitions: adds transfer services (evidence: `odx/generate.py`)
- ODX Builder → Communication Parameters: uses parameters (evidence: `odx/generate.py`)
- ODX Builder → ODX Metadata: uses metadata (evidence: `odx/generate.py`)
- ODX Builder → ODX Helpers: uses helpers (evidence: `odx/generate.py`)
- Authentication Definitions → ODX Helpers: uses helpers (evidence: `odx/authentication.py`)
- Common Diagnostic Data → ODX Helpers: uses helpers (evidence: `odx/shared.py`)
- Session Definitions → ODX Helpers: uses helpers (evidence: `odx/sessions.py`)
- Security Definitions → ODX Helpers: uses helpers (evidence: `odx/security_access.py`)
- Transfer Definitions → ODX Helpers: uses helpers (evidence: `odx/transferdata.py`)
- Reset Definitions → ODX Helpers: uses helpers (evidence: `odx/reset.py`)
- Communication Parameters → ODX Helpers: uses helpers (evidence: `odx/comparams.py`)
- ODX Metadata → ODX Helpers: uses helpers (evidence: `odx/metadata.py`)
