Skip to content

README.md

Latest commit

 

History

History
78 lines (56 loc) · 2.62 KB

README.md

File metadata and controls

78 lines (56 loc) · 2.62 KB

OpenSOVD Core

Standardized diagnostic communication for connected vehicles.

CI Coverage GHCR Chat License Good First Issues

Open-source implementation of the ISO 17978-3:2026 SOVD (Service-Oriented Vehicle Diagnostics) standard.

Quick Start

# Run the gateway with mock data
docker run -p 7690:7690 ghcr.io/eclipse-opensovd/opensovd-gateway --mock

# Verify it's running
curl -s http://127.0.0.1:7690/sovd/version-info | jq
{
  "sovd_info": [
    {
      "version": "1.1",
      "base_uri": "http://127.0.0.1:7690/sovd/v1",
      "vendor_info": {
        "version": "0.1.1",
        "name": "OpenSOVD"
      }
    }
  ]
}

Development

Prerequisites

  • Rust (version and components auto-configured via rust-toolchain.toml)
  • uv (optional) - Python package manager for running integration tests

Tip

Open the project in a Dev Container for a ready-to-use environment, or use devenv locally. See Development docs for details.

# Build
cargo build

# Run the gateway with mock data
cargo run -p opensovd-gateway -- --mock

For testing instructions, see the Testing guide.

Examples

See examples/ for usage samples.

Documentation

Contributing

See CONTRIBUTING.md for guidelines.

License

This project is licensed under the Apache License 2.0.