velocitas-sdk 0.15.0.dev0

A Python SDK for Vehicle app

Vehicle App Python Sdk

The Vehicle App SDK reduces the effort required to implement Vehicle Apps by using the Velocitas development model for the Python programming language. To create a Vehicle App, please use our Vehicle App Template which uses this sdk.

This includes the following packages:

• velocitas_sdk.vehicle_app - Vehicle App abstraction
• velocitas_sdk.model - Vehicle Model ontology
• velocitas_sdk.config - Vehicle App configuration
• velocitas_sdk.base - Base classes for middleware abstraction
• velocitas_sdk.native - Native middleware definition
• velocitas_sdk.vdb - Vehicle Data Broker integration
• velocitas_sdk.test - Integration test support
• velocitas_sdk.util - Logging and other utilities

Status

Note: The Vehicle App Python SDK is currently under active development in alpha phase.

Prerequisites

• Python 3.10 or later is required to use this package.

Install the package

Install the Vehicle App Python SDK with pip:

pip install git+https://github.com/eclipse-velocitas/vehicle-app-python-sdk.git@<version>

Documentation

• Velocitas Development Model: Learn more about the Velocitas programming model and the SDK
• Velocitas Tutorials: Learn how to get started, including setting up the development environment, creating a Vehicle Model as well as developing and deploying a Vehicle App.

Python Vehicle App SDK Examples

These examples demonstrate how to use the Python Vehicle App SDK:

Example	Description
Array Datatype	Shows a Vehicle Data Broker query that returns an array data point.
Atomic Set	Shows how to set the values of multiple datapoint actuators in one "atomic" step.
DataPoint Set	Shows how to set the value of the datapoint actuator value API.
Dog Mode	Dog-Mode App that demonstrates MQTT communication and invocation of a Vehicle Service over gRPC, the app also subscribes for vehicle data points and sets the cabin temperature.
Dynamic Rule	Create a Vehicle Data Broker rule with the fluent query methods.
Static Rule	Create a Vehicle Data Broker rule with the subscribe_to_data_point annotation.
VDB Queries	Demonstrates various aspects of creating Vehicle Data Broker queries.
Seat Adjuster	Seat-Adjuster App that demonstrates MQTT communication and seat control via actuator data points. :point_right: This example can only be run from the Vehicle App Template. :point_left:

All examples (except the Seat Adjuster) can be run via

cd examples
./run-app.sh -a <example-folder-name>

By default the examples are started using the native middleware. Dapr middleware support was recently removed.

Contribution

• GitHub Issues
• Mailing List
• Contribution