vissr

module

v0.0.0-...-ad53564 Latest Latest Go to latest Published: Mar 4, 2026 License: MPL-2.0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/covesa/vissr

Links

Open Source Insights

README ¶

vehicle-information-service-specification-reference-implementation (VISSR)

Maintainers

Ulf Björkengren - Ford Motor Company

Peter Winzell - Volvo Cars

COVESA VISS Reference Implementation - VISSR

This project provides a reference implementation of the released COVESA VISSv2.0 specification on the v2.0 branch, and an ongoing development of a reference implementation of the VISSv3.0 specification on the master branch.

Tutorial

A tutorial can be found here.

VISSv3.0 new features

Multiple tree support. The server can be configured to manage multiple trees that a client can access.
Server capabilities. A Server tree can be accessed by clients.
File transfer. Upload/download of files is available on Websocket.
Data compression. Request local path compression and Request relative timestamp compression is available on Websocket.
Protobuf encoding is available on Websocket.
gRPC support. This wa already available on an experimental level in VISSR @v2.0.
JSON scheme used to validate client requests.
Support for the VSS struct datatype.
Error responses due to JSON scheme errors contain a description generated by the JSON scheme validator.

Non-backwards compatible changes from VISSv2.0

The filter keyname "type" is changed to "variant".
The filter variants "static-metadata" and "dynamic-metadata" are replaced by the variant "metadata".
The "subscriptionId" parameter in unsubscribe response messages is deleted.
The error object keyword "message" is changed to "description".
The error:decription values are not normative any more.

VISSv2.0 features

HTTP/Websocket/MQTT(incl app-level protocol on top).
Get/Set/Subscribe/Unsubscribe methods (Subscribe/Unsubscribe not available over HTTP).
Filters supported are Timebased/Change/Range/Curvelog/Paths/Metadata (History currently inactivated).
Access control including RBAC support and policy document usage as per specification.
Consent support. The server may connect to an External Consent Framework and together realize consent functionality.

Non-spec features

Unix domain sockets is supported. Payload formats are identical to Websocket format. Socket file name is /var/tmp/vissv2/udsMgr.sock.
HTTP, Websocket, and gRPC can be configured to run with/without TLS.
gRCP is supported also by the v2.0 server implementation (not in v2.0 spec).
SwCs such as feeder and datastore are available to realize a complete tech stack from client to the vehicle "native" domain.
Tool for realizing a data mapping between the "VSS domain" and the vehicle "native" domain (e.g. between VSS and CAN data).

Quick start

Two shell scripts are available for a quick start of trying out the VISSR tech stack. System dependencies such as having a Go build system installed must first be fulfilled.

runtest.sh: This script builds and runs the server and the feederv3 simulating some signals, then it runs the testclient and displays its request messages and the associated response messages.
runstack.sh: This script builds and runs the server and the feederv3 simulating some signals, enabling any client implementation to connect to the server.

See the tutorial for more information.

Contributors

VISSR is an open standard and we invite anybody to contribute. Currently VISSR contains - among others - significant contributions from

Directories ¶

Path	Synopsis
client
client-1.0 command
client-1.0/compress_client command
client-1.0/csv_client command
client-1.0/filetransfer_client command
client-1.0/grpc_client command * * (C) 2023 Ford Motor Company * (C) 2023 Volvo Cars * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.	* * (C) 2023 Ford Motor Company * (C) 2023 Volvo Cars * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.
client-1.0/grpc_client/grpc_map_client command * * (C) 2023 Ford Motor Company * (C) 2023 Volvo Cars * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.	* * (C) 2023 Ford Motor Company * (C) 2023 Volvo Cars * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.
client-1.0/grpc_client/grpc_map_client/mapserver
client-1.0/mqtt_client command * * (C) 2021 Mitsubishi Electrics Automotive * (C) 2021 Geotab * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.	* * (C) 2021 Mitsubishi Electrics Automotive * (C) 2021 Geotab * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.
client-1.0/testClient command
feeder
feeder-evic command
feeder-evic/evicSim command
feeder-rl command
feeder-template/feederv1 command
feeder-template/feederv2 command
feeder-template/feederv3 command
feeder-template/feederv4 command
grpc_pb
server
agt_server command
vissv2server command
vissv2server/atServer/ecfSim command
vissv2server/grpcMgr * * (C) 2023 Ford Motor Company * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.	* * (C) 2023 Ford Motor Company * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.
vissv2server/httpMgr * * (C) 2022 Geotab * (C) 2019 Volvo Cars * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.	* * (C) 2022 Geotab * (C) 2019 Volvo Cars * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.
vissv2server/mqttMgr * * (C) 2022 Geotab * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.	* * (C) 2022 Geotab * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.
vissv2server/serviceMgr
vissv2server/serviceMgr/histctrlSim command
vissv2server/serviceMgr/redisInit command
vissv2server/serviceMgr/redisVinFeeder command
vissv2server/udsMgr * * (C) 2024 Ford Motor Company * (C) 2022 Geotab Inc * (C) 2019 Volvo Cars * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.	* * (C) 2024 Ford Motor Company * (C) 2022 Geotab Inc * (C) 2019 Volvo Cars * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.
vissv2server/wsMgr * * (C) 2024 Ford Motor Company * (C) 2022 Geotab Inc * (C) 2019 Volvo Cars * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.	* * (C) 2024 Ford Motor Company * (C) 2022 Geotab Inc * (C) 2019 Volvo Cars * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.
vissv2server/wsMgrFT * * (C) 2024 Ford Motor Company * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.	* * (C) 2024 Ford Motor Company * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.
tools
DomainConversionTool command
utils * * (C) 2023 Ford Motor Company * (C) 2021 Geotab * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.	* * (C) 2023 Ford Motor Company * (C) 2021 Geotab * * All files and artifacts in the repository at https://github.com/covesa/vissr * are licensed under the provisions of the license provided by the LICENSE file in this repository.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL