Changes with this release

Signal Updates

• Vehicle Motion Management Signals added
• New names related seat signals added, old kept for backward compatibility

What's Changed

• Prepare for next major release by @erikbosch in #783
• Separate doc-gen from general build by @erikbosch in #784
• Add Media.Played.Genre by @cws55 in #781
• Add RegExp pattern for VehicleIdentification.VIN property. by @Kostadin-Ivanov in #786
• Doc Update by @erikbosch in #788
• Add ConsumptionSinceLastRefuel by @CoffeeMoneyMakers in #787
• Add signals for Motion Management by @erikbosch in #785
• Doc Update by @erikbosch in #792
• Pr780 by @erikbosch in #793
• Fix 24.04 build by pinning Python version by @erikbosch in #794
• D3 now bypasses Observable Notebook framework by @Giaccomole in #801
• Clarify VSS expectations on read/write by @erikbosch in #796
• refactor: Unique names for the pattern {parent_banch_name}.{branch_name} by @jdacoello in #799
• Update pre-commit version by @erikbosch in #803
• Correction of typo in spec/Body/WiperSystem.vspec by @Herrmann-Alexander in #807
• Missing "s" in vehicle_signal_specification/docs-gen/content/rule_set… by @Herrmann-Alexander in #811
• Improve instance documentation by @erikbosch in #809
• VSS Extension Profile Documentation by @erikbosch in #817
• VISS documentation update by @UlfBj in #823
• Fix typo in build check by @erikbosch in #825
• Removing some recently added motion management signals. by @erikbosch in #831

New Contributors

• @cws55 made their first contribution in #781
• @Kostadin-Ivanov made their first contribution in #786
• @CoffeeMoneyMakers made their first contribution in #787
• @Giaccomole made their first contribution in #801
• @Herrmann-Alexander made their first contribution in #807

Full Changelog: v5.0...v5.1

Changes with this release

Signal Updates

• Vehicle Motion Management Signals added
• New names related seat signals added, old kept for backward compatibility

What's Changed

• Prepare for next major release by @erikbosch in #783
• Separate doc-gen from general build by @erikbosch in #784
• Add Media.Played.Genre by @cws55 in #781
• Add RegExp pattern for VehicleIdentification.VIN property. by @Kostadin-Ivanov in #786
• Doc Update by @erikbosch in #788
• Add ConsumptionSinceLastRefuel by @CoffeeMoneyMakers in #787
• Add signals for Motion Management by @erikbosch in #785
• Doc Update by @erikbosch in #792
• Pr780 by @erikbosch in #793
• Fix 24.04 build by pinning Python version by @erikbosch in #794
• D3 now bypasses Observable Notebook framework by @Giaccomole in #801
• Clarify VSS expectations on read/write by @erikbosch in #796
• refactor: Unique names for the pattern {parent_banch_name}.{branch_name} by @jdacoello in #799
• Update pre-commit version by @erikbosch in #803
• Correction of typo in spec/Body/WiperSystem.vspec by @Herrmann-Alexander in #807
• Missing "s" in vehicle_signal_specification/docs-gen/content/rule_set… by @Herrmann-Alexander in #811
• Improve instance documentation by @erikbosch in #809
• VSS Extension Profile Documentation by @erikbosch in #817
• VISS documentation update by @UlfBj in #823
• Fix typo in build check by @erikbosch in #825
• Removing some recently added motion management signals. by @erikbosch in #831

Full Changelog: v5.0...v5.1rc1

Changes with this release

Support for new pattern keyword

String types can now be restricted by a RegExp pattern.

Support for default for signals and properties using struct types.

Previously the documentation stated that default values could not be given for struct types.
That is now supported.

Other minor changes

Some signals added

What's Changed

• Prepare for next major release by @erikbosch in #783
• Separate doc-gen from general build by @erikbosch in #784
• Add Media.Played.Genre by @cws55 in #781
• Add RegExp pattern for VehicleIdentification.VIN property. by @Kostadin-Ivanov in #786
• Doc Update by @erikbosch in #788
• Add ConsumptionSinceLastRefuel by @CoffeeMoneyMakers in #787
• Add signals for Motion Management by @erikbosch in #785
• Doc Update by @erikbosch in #792
• Pr780 by @erikbosch in #793
• Fix 24.04 build by pinning Python version by @erikbosch in #794
• D3 now bypasses Observable Notebook framework by @Giaccomole in #801
• Clarify VSS expectations on read/write by @erikbosch in #796
• refactor: Unique names for the pattern {parent_banch_name}.{branch_name} by @jdacoello in #799
• Update pre-commit version by @erikbosch in #803
• Correction of typo in spec/Body/WiperSystem.vspec by @Herrmann-Alexander in #807
• Missing "s" in vehicle_signal_specification/docs-gen/content/rule_set… by @Herrmann-Alexander in #811
• Improve instance documentation by @erikbosch in #809
• VSS Extension Profile Documentation by @erikbosch in #817
• VISS documentation update by @UlfBj in #823
• Fix typo in build check by @erikbosch in #825
• Removing some recently added motion management signals. by @erikbosch in #831

Full Changelog: v5.0...v5.1rc0

Changes with this release

Signal Updates

• Signals deprecated in 4.X versions removed
• Some signals added, but nothing significant compared to 4.2

UUID removed from release artifacts

VSS Release artifacts (VSS standard catalog in various formats) will no longer contain UUID information.
If you need artifacts with UUID you need to generate the artifact yourself.

Instructions:

1. Clone the repo and check out the tag you want, for example git checkout v5.0.
2. Update submodules, for example git submodule update --init.
3. Add --uuid as argument to the relevant command in Makefile.
4. Run generation, for example make csv.

OBD Branch deprecated

The Vehicle.OBD branch is now deprecated. The plan is to remove it in VSS 6.0.
The background is a decision that VSS standard catalog shall not contain a one-to-one representation of the OBD standard.
Instead, VSS standard catalog may contain corresponding information elsewhere. As an example, instead of
Vehicle.OBD.EngineSpeed (PID 0C), the VSS signal Vehicle.Powertrain.CombustionEngine.Speed can be used.
Note that not all signals in Vehicle.OBD have "duplicates", especially in the area of combustion engine control
(like Oxygen sensor lambda and voltage readings) VSS currently does not have any counterparts in other parts of the tree.

What to do if you as of today use signals from the OBD file:

• Check if any suitable replacement signal exist.
  Example: if you use Vehicle.OBD.Speed, consider using Vehicle.Speed instead.
• If not and the data may be of general interest; consider creating a pull request
  with a replacement signal.
  Example: VSS as of today only have Lambda information in OBD branch.
  If you need VSS signals for Lambda, consider creating new signals in
  Vehicle.Powertrain.CombustionEngine branch.
• If you really need the signals in this file and cannot replace them, then consider using the overlay file in the
  overlays directory from VSS 6.0 onwards.

Updated tool dependency

CLI updates

The vss-tools CLI has been refactored. Makefile in this repository updated.

Overlay Support

VSS-tools support for overlays have been improved. It is now in many cases not necessary to specify
type and datatype for items in the overlay if you are changing an existing item.

What's Changed

• Changing version to 5.0-dev by @erikbosch in #648
• Change datatype for HVAC temeprature by @SebastianSchildt in #637
• Makefile cleanup by @erikbosch in #652
• Fix instance documentation by @erikbosch in #644
• Update vss-tools submodule by @erikbosch in #655
• Adding signals for width and turn diameter by @erikbosch in #657
• Refactoring of PR 660 by @erikbosch in #672
• Support negative torque for combustion engine by @ppb2020 in #673
• Change copyright headers by @erikbosch in #643
• Update pre-commit config file by @sadikkuzu in #684
• Updating submodule dependency by @erikbosch in #687
• Align Temperature Signals by @erikbosch in #676
• Align usage of the word type. by @erikbosch in #688
• added Auto signal by @UmangSharmaMobis in #681
• Refactoring unit file by @erikbosch in #669
• Fix quantity documentation by @erikbosch in #691
• Fix a typo in the license documentation by @violinyanev in #693
• feat: Add decibels as unit. by @jdacoello in #692
• Release Preparations by @erikbosch in #696
• Include noexpand in mandatory builds by @erikbosch in #698
• Cherry-pick updated changelog from 4.1 by @erikbosch in #708
• Updating build actions by @erikbosch in #709
• Updating vss-tools and adapting Makefile by @erikbosch in #712
• Update flake8 dependency by @erikbosch in #713
• Deprecating OBD-branch by @erikbosch in #701
• Add battery precondition signals by @erikbosch in #703
• Refactor Makefile for binary by @erikbosch in #720
• Add gitattributes to get better statistics by @erikbosch in #722
• Update documentation by @erikbosch in #716
• Improving unit documentation by @erikbosch in #717
• Document proposed Type tree name by @erikbosch in #719
• Exclude UUID from release artifacts by @erikbosch in #721
• Update pre-commit version by @erikbosch in #728
• Feature/structure engine fluids by @kowend in #710
• Add wheel angular speed by @erikbosch in #726
• Introduce TimeInUse signal for ElectricMotor by @JonathanForce in #725
• Enforce strict check in CI by @erikbosch in #730
• Add screen mirroring in Infotainment.vspec by @spshin3 in #737
• Add head and eye position signals for driver by @erikbosch in #731
• Minor touchups to text files. by @erikbosch in #742
• Add workflow dispatch by @erikbosch in #748
• Add rad/s by @erikbosch in #746
• Update overlay example and tool dependency by @erikbosch in #747
• Update documentation by @erikbosch in #752
• New unit Lux and illuminance quantity by @mikehaller in #750
• Fixed inconsistent units.yaml by @sschleemilch in #758
• Integrate new CLI by @erikbosch in #756
• Changing hugo theme to relearn by @erikbosch in #757
• Update standards.md by @binbowang1987 in #764
• feat: Allow the specification of multiple charging ports. by @jdacoello in #755
• Add check that catalog can be represented in correct CSV file by @erikbosch in #761
• Sync docs with vss-tools rework by @sschleemilch in #766
• Add documentation for delete argument by @erikbosch in #763
• Submodule update and CI extension by @erikbosch in #772
• Fixing copy/paste error in torque definition by @erikbosch in #773
• Remove deprecated signals as prep for v5.0 by @erikbosch in #776
• Fix IsFlapOpen by @erikbosch in #777
• Remove submodule (version 2) by @erikbosch in #778
• 5.0rc0 preparation by @erikbosch in #779
• Release 5.0 by @erikbosch in #782

Full Changelog: v4.2...v5.0

Changes with this release

Signal Updates

• Signals deprecated in 4.X versions removed
• Some signals added, but nothing significant compared to 4.2

UUID removed from release artifacts

VSS Release artifacts (VSS standard catalog in various formats) will no longer contain UUID information.
If you need artifacts with UUID you need to generate the artifact yourself.

Instructions:

1. Clone the repo and check out the tag you want, for example git checkout v5.0.
2. Update submodules, for example git submodule update --init.
3. Add --uuid as argument to the relevant command in Makefile.
4. Run generation, for example make csv.

OBD Branch deprecated

The Vehicle.OBD branch is now deprecated. The plan is to remove it in VSS 6.0.
The background is a decision that VSS standard catalog shall not contain a one-to-one representation of the OBD standard.
Instead, VSS standard catalog may contain corresponding information elsewhere. As an example, instead of
Vehicle.OBD.EngineSpeed (PID 0C), the VSS signal Vehicle.Powertrain.CombustionEngine.Speed can be used.
Note that not all signals in Vehicle.OBD have "duplicates", especially in the area of combustion engine control
(like Oxygen sensor lambda and voltage readings) VSS currently does not have any counterparts in other parts of the tree.

What to do if you as of today use signals from the OBD file:

• Check if any suitable replacement signal exist.
  Example: if you use Vehicle.OBD.Speed, consider using Vehicle.Speed instead.
• If not and the data may be of general interest; consider creating a pull request
  with a replacement signal.
  Example: VSS as of today only have Lambda information in OBD branch.
  If you need VSS signals for Lambda, consider creating new signals in
  Vehicle.Powertrain.CombustionEngine branch.
• If you really need the signals in this file and cannot replace them, then consider using the overlay file in the
  overlays directory from VSS 6.0 onwards.

Updated tool dependency

CLI updates

The vss-tools CLI has been refactored. Makefile in this repository updated.

Overlay Support

VSS-tools support for overlays have been improved. It is now in many cases not necessary to specify
type and datatype for items in the overlay if you are changing an existing item.

What's Changed

• Changing version to 5.0-dev by @erikbosch in #648
• Change datatype for HVAC temeprature by @SebastianSchildt in #637
• Makefile cleanup by @erikbosch in #652
• Fix instance documentation by @erikbosch in #644
• Update vss-tools submodule by @erikbosch in #655
• Adding signals for width and turn diameter by @erikbosch in #657
• Refactoring of PR 660 by @erikbosch in #672
• Support negative torque for combustion engine by @ppb2020 in #673
• Change copyright headers by @erikbosch in #643
• Update pre-commit config file by @sadikkuzu in #684
• Updating submodule dependency by @erikbosch in #687
• Align Temperature Signals by @erikbosch in #676
• Align usage of the word type. by @erikbosch in #688
• added Auto signal by @UmangSharmaMobis in #681
• Refactoring unit file by @erikbosch in #669
• Fix quantity documentation by @erikbosch in #691
• Fix a typo in the license documentation by @violinyanev in #693
• feat: Add decibels as unit. by @jdacoello in #692
• Release Preparations by @erikbosch in #696
• Include noexpand in mandatory builds by @erikbosch in #698
• Cherry-pick updated changelog from 4.1 by @erikbosch in #708
• Updating build actions by @erikbosch in #709
• Updating vss-tools and adapting Makefile by @erikbosch in #712
• Update flake8 dependency by @erikbosch in #713
• Deprecating OBD-branch by @erikbosch in #701
• Add battery precondition signals by @erikbosch in #703
• Refactor Makefile for binary by @erikbosch in #720
• Add gitattributes to get better statistics by @erikbosch in #722
• Update documentation by @erikbosch in #716
• Improving unit documentation by @erikbosch in #717
• Document proposed Type tree name by @erikbosch in #719
• Exclude UUID from release artifacts by @erikbosch in #721
• Update pre-commit version by @erikbosch in #728
• Feature/structure engine fluids by @kowend in #710
• Add wheel angular speed by @erikbosch in #726
• Introduce TimeInUse signal for ElectricMotor by @JonathanForce in #725
• Enforce strict check in CI by @erikbosch in #730
• Add screen mirroring in Infotainment.vspec by @spshin3 in #737
• Add head and eye position signals for driver by @erikbosch in #731
• Minor touchups to text files. by @erikbosch in #742
• Add workflow dispatch by @erikbosch in #748
• Add rad/s by @erikbosch in #746
• Update overlay example and tool dependency by @erikbosch in #747
• Update documentation by @erikbosch in #752
• New unit Lux and illuminance quantity by @mikehaller in #750
• Fixed inconsistent units.yaml by @sschleemilch in #758
• Integrate new CLI by @erikbosch in #756
• Changing hugo theme to relearn by @erikbosch in #757
• Update standards.md by @binbowang1987 in #764
• feat: Allow the specification of multiple charging ports. by @jdacoello in #755
• Add check that catalog can be represented in correct CSV file by @erikbosch in #761
• Sync docs with vss-tools rework by @sschleemilch in #766
• Add documentation for delete argument by @erikbosch in #763
• Submodule update and CI extension by @erikbosch in #772
• Fixing copy/paste error in torque definition by @erikbosch in #773
• Remove deprecated signals as prep for v5.0 by @erikbosch in #776
• Fix IsFlapOpen by @erikbosch in #777
• Remove submodule (version 2) by @erikbosch in #778
• 5.0rc0 preparation by @erikbosch in #779

Full Changelog: v4.2...v5.0rc0

Changes with this release

New signals

New signals in the following areas

• Engine Coolant and Engine Oil
• Wheel Angular Speed
• Screen Mirroring
• Head Position and Eye Gaze
• TimeInUse for electrical motors
• Battery Precondition

Struct support in vspec2ddsidl

The vspec2ddsidl tool now supports structs

Jsonschema tool added

A new tool vspec2jsonschema has been added

Id generator tool added

A new tool vspec2id has been added. It can be used to generate and maintain unique identifiers for signals.

Unit files and quantity files

A new syntax has been introduced for unit files. The old syntax is still supported.
Domains have now been renamed to Quantities.
In addition to this a quantity file format has been defined, and the tool will inform
if units refer to a quantity that has not been defined an information message will be printed.

Full Changelog: v4.1...v4.2

Changes with this release

New signals

New signals in the following areas

• Engine Coolant and Engine Oil
• Wheel Angular Speed
• Screen Mirroring
• Head Position and Eye Gaze
• TimeInUse for electrical motors
• Battery Precondition

Struct support in vspec2ddsidl

The vspec2ddsidl tool now supports structs

Jsonschema tool added

A new tool vspec2jsonschema has been added

Id generator tool added

A new tool vspec2id has been added. It can be used to generate and maintain unique identifiers for signals.

Unit files and quantity files

A new syntax has been introduced for unit files. The old syntax is still supported.
Domains have now been renamed to Quantities.
In addition to this a quantity file format has been defined, and the tool will inform
if units refer to a quantity that has not been defined an information message will be printed.

Full Changelog: v4.1...v4.2rc0

Changes with this release

Unit file syntax updated, Quantity file introduced

A new syntax for unit files is introduced. Old syntax still supported.
It is also possible to define quantity files, and a default quantity file (quantities.yaml)
has been added

New signals

Some signal have been added.

Updated tool dependency

A new version of vss-tools is used, with support for static IDs and jsonschema.

What's Changed

• Changing master to 4.1-dev by @erikbosch in #594
• Changing VERSION by @erikbosch in #603
• Add FontSize property to HMI branch and GuidanceVoice property to Navigation branch by @wonsuk73 in #581
• Renaming Battery.vspec by @erikbosch in #606
• Rework Ecosystem section by @SebastianSchildt in #611
• Updating actions/checkout by @erikbosch in #618
• Introduce Time Remaining Signals by @JonathanForce in #610
• Improving documentation on how to use Makefile by @erikbosch in #604
• Remove DCO workflow by @erikbosch in #620
• Adding more unit information by @erikbosch in #615
• Adding additional signals to TractionBattery branch by @erikbosch in #601
• Identification extension (LicensePlate and VehicleExteriorColor) by @jakubdrabik in #619
• More EV charging data by @erikbosch in #621
• Split fuel/charge port location signal by @erikbosch in #614
• Add MapScaleMode to Navigation branch by @wonsuk73 in #622
• Change description of Lights.Running by @erikbosch in #623
• Add additional mirror signals by @erikbosch in #624
• Add SeatBeltHeight by @erikbosch in #629
• Bump JamesIves/github-pages-deploy-action to 4.4.3 by @erikbosch in #645
• Add door position by @erikbosch in #625
• Add SteeringWheel.Heating by @erikbosch in #630
• Update units.yaml by @vrraikar in #640
• Cherry-picking minor changes from master to 4.X by @erikbosch in #654
• Merging chnages to 4.X as 4.1 preparation by @erikbosch in #697

Full Changelog: v4.0...v4.1

Changes with this release

Unit file syntax updated, Quantity file introduced

A new syntax for unit files is introduced. Old syntax still supported.
It is also possible to define quantity files, and a default quantity file (quantities.yaml)
has been added

New signals

Some signal have been added.

Updated tool dependency

A new version of vss-tools is used, with support for static IDs and jsonschema.

What's Changed

• Changing master to 4.1-dev by @erikbosch in #594
• Changing VERSION by @erikbosch in #603
• Add FontSize property to HMI branch and GuidanceVoice property to Navigation branch by @wonsuk73 in #581
• Renaming Battery.vspec by @erikbosch in #606
• Rework Ecosystem section by @SebastianSchildt in #611
• Updating actions/checkout by @erikbosch in #618
• Introduce Time Remaining Signals by @JonathanForce in #610
• Improving documentation on how to use Makefile by @erikbosch in #604
• Remove DCO workflow by @erikbosch in #620
• Adding more unit information by @erikbosch in #615
• Adding additional signals to TractionBattery branch by @erikbosch in #601
• Identification extension (LicensePlate and VehicleExteriorColor) by @jakubdrabik in #619
• More EV charging data by @erikbosch in #621
• Split fuel/charge port location signal by @erikbosch in #614
• Add MapScaleMode to Navigation branch by @wonsuk73 in #622
• Change description of Lights.Running by @erikbosch in #623
• Add additional mirror signals by @erikbosch in #624
• Add SeatBeltHeight by @erikbosch in #629
• Bump JamesIves/github-pages-deploy-action to 4.4.3 by @erikbosch in #645
• Add door position by @erikbosch in #625
• Add SteeringWheel.Heating by @erikbosch in #630
• Update units.yaml by @vrraikar in #640
• Cherry-picking minor changes from master to 4.X by @erikbosch in #654
• Merging chnages to 4.X as 4.1 preparation by @erikbosch in #697

Full Changelog: v4.0...v4.1rc0

Major Changes with this release:

Struct Support (Official)

The VSS-syntax now supports structs.
Note however that not all exporters in VSS-tools 4.0 support structs yet.

Change of instance handling for seats, doors, mirrors and other branches.

Previously many signals used position for instance, where position 1 meant the leftmost item.
This caused problems for some use-cases where it was more practical to reference to a door by its relative position,
like the "DriverSide" door, as you then can describe wanted behavior in the same way for both LHD and RHD vehicles.
By that reason instance handling has for some signal been changed to use ["DriverSide","Middle","PassengerSide"].

Actuator and Sensor Attributes

The attributes sensor and actuator, deprecated from VSS 3.1,
have been removed from the VSS syntax.

See VSS CHANGELOG and VSS-Tools CHANGELOG for more information. For complete list of commits see below.

What's Changed

• Update version to 4.0-develop by @erikbosch in #554
• Add description to brake lights by @erikbosch in #559
• DOCS UPDATE: Add additional notes on name resolution of structs by @kkoppolu1 in #560
• Add auto apply for parking brake by @erikbosch in #557
• Adding new sensors to powertrain battery and fuel system. by @adobekan in #536
• Making Window Positon and ChildLock an Actuator by @SebastianSchildt in #549
• Add battery cell voltage information by @erikbosch in #555
• Update allowed.md by @neil-rti in #565
• Update instance description of Seat, Door, HVAC, Light and Mirror by @adobekan in #538
• Move track to axle by @erikbosch in #556
• Adding DCO check by @erikbosch in #568
• Clarify that VSS is case sensitive. by @erikbosch in #569
• Add pre-commit hook by @erikbosch in #571
• Update makefile and submodule by @erikbosch in #578
• Add DMS support by @pmundt in #573
• Union of PR 540 and PR546 by @erikbosch in #587
• Driver/steering position issues by @nickrbb in #582
• Add missing units to various signals by @nickrbb in #583
• Added IsScreenAlwaysOn, LastActionTime and DisplayOffTime Signals by @UmangSharmaMobis in #585
• Removal of deprecated signals from VSS v3.1 by @nickrbb in #589
• Miscellaneous editorial only corrections by @nickrbb in #590
• VSS 4.0 preparations by @erikbosch in #592
• Minor changes to documentation by @erikbosch in #593
• Correct unit documentation by @erikbosch in #597
• Checking Markdown links by @erikbosch in #602
• VSS 4.0: Verify that ddsidl is correct by @erikbosch in #596
• Update submodule version by @erikbosch in #605
• Clarify that root for types must be a branch by @erikbosch in #609
• Updating to VSS-tools 4.0 by @erikbosch in #612
• Update vss-tools by @erikbosch in #613

Full Changelog: v3.1.1...v4.0