COVESA / COVESA/data-expert-group

VSS add-on coordination (mapping)

Open
#11 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
1
Forks
1
PR merge metrics
No merged PRs in 30d

Description

_This is a topic originating from the Porto AMM_

There are multiple initiatives using VSS syntax to add extended attributes. Two examples are KUKSA.val (map DBC to VSS) and COVESA AASIG (map Android VHAL to/from VSS). There is a possibility that a platform/project need to use multiple mappings, and then it is important that there are no name conflicts.

COVESA could address this by:

- Providing guidelines, for example that all attributes are to be added under a single "namespace"
- Maintain a list of already taken/used "namespaces".
- Possibly "host" some "namespace" definitions, i.e. the definition of sub-attributes and syntax for them

With this, inspired by the two examples below, it would be possible to include multiple mappings in the same tree (after applying overlays), like:
```

Vehicle.Chassis.SteeringWheel.Angle:
datatype: int16
type: sensor
dbc:
signal: SteeringAngle129
interval_ms: 100
transform:
math: "floor(x+0.5)"
vhal:
aospId: VehicleProperty::PERF_VEHICLE_SPEED
aospArea: VehicleArea::GLOBAL
multiplier: 0.27777777777777777777 # (divide by 3.6)
offset: 0.0
```

**Existing examples:**

https://github.com/COVESA/vss-tools/blob/code_generation/contrib/vspec2aaproperties/vspec2prop_mapping.yml

```
Vehicle.Speed:
#convertFloatLinear
aospId: VehicleProperty::PERF_VEHICLE_SPEED
aospArea: VehicleArea::GLOBAL
multiplier: 0.27777777777777777777 # (divide by 3.6)
offset: 0.0
```

https://github.com/eclipse/kuksa.val.feeders/blob/main/dbc2val/mapping/mapping.md
https://github.com/eclipse/kuksa.val.feeders/blob/main/dbc2val/mapping/vss_3.1.1/dbc_overlay.vspec

```
Vehicle.Chassis.SteeringWheel.Angle:
datatype: int16
type: sensor
dbc:
signal: SteeringAngle129
interval_ms: 100
transform:
math: "floor(x+0.5)"
```

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the proposed namespace guidelines and the existing mapping examples in contrib/vspec2aaproperties/vspec2prop_mapping.yml, dbc2val/mapping/mapping.md, and dbc_overlay.vspec. Review how the DBC and VHAL mappings use extended attributes, then define an agreed namespace approach and a maintained list or hosting location for namespace definitions.

Written by the indexing model from the issue text.

Assessment

Tech stack
android
Domain
documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.