Skip to content

Commit f51bf7f

Browse files
committed
Add signals for Motion Management
Signed-off-by: Erik Jaegervall <[email protected]>
1 parent c6e2ea8 commit f51bf7f

File tree

12 files changed

+602
-0
lines changed

12 files changed

+602
-0
lines changed

docs-gen/content/_index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,5 +14,6 @@ about what the specification is all about, what's in and out and how to quickly
1414
* [Governance](/vehicle_signal_specification/governance/) </br> Introduction to VSS governance model and change log.
1515
* [Rule Set](/vehicle_signal_specification/rule_set/) </br> Get familiar with the rule set behind the
1616
specification, the structure, the format and concepts.
17+
* [VSS Catalog](/vehicle_signal_specification/catalog/) </br> Information on content and design decisions related to the VSS catalog.
1718
* [License](/vehicle_signal_specification/license/) </br> Information on the VSS license.
1819
* [Ecosystem](/vehicle_signal_specification/ecosystem/) How to use the specification? Check out the existing tools and standards to transform or make use of VSS.

docs-gen/content/catalog/_index.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
title: VSS Catalog
3+
weight: 25
4+
chapter: true
5+
---
6+
7+
# VSS Catalog
8+
9+
The source for the COVESA VSS Catalog can be found in `*.vspec` files in the [COVESA VSS Repository](https://github.com/COVESA/vehicle_signal_specification).
10+
Released versions of the catalog in various formats can be found at [release artifacts](https://github.com/COVESA/vehicle_signal_specification/releases).
11+
12+
Each signal in the VSS catalog has a `description` field and they may have a `comment` field. In some cases that is not sufficient to explain the rationale for the signal and how it is intended to be used. This section of the VSS documentation gives additional information on selected signal.
13+
14+
## VSS Catalog Concepts
15+
16+
* [Vehicle Motion Management](/vehicle_signal_specification/catalog/vehicle_motion_management) Information on the VSS concept for motion management.
Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
---
2+
title: "Vehicle Motion Management"
3+
date: 2019-08-04T12:46:30+02:00
4+
weight: 7
5+
---
6+
7+
## Introduction
8+
9+
In modern vehicles multiple electronic controlled systems are interacting to realize the overall vehicle motion in all physical directions.
10+
Typically, the driver gives input e.g. using the steering wheel and the accelerator and brake pedals, but additional vehicle functions may have also requests towards the motion actuators.
11+
One example is that a traction control system may want to limit the performance due to slippery road conditions or that the emergency braking system requests braking.
12+
13+
A number of signals have been added to VSS related to powertrain (eAxle), steering and braking.
14+
These signals may be used to define actuator interfaces to support a highly flexible functional deployment on different electronic control units.
15+
Vehicle motion functions like driver brake request, cooperative regenerative braking and traction control system may request target values for longitudinal control on vehicle, axle and wheel level.
16+
Therefore, generic interface signals for the braking systems are introduced which support an arbitration of the requested target values by minimum and maximum values.
17+
The signal definitions for powertrain and steering are based on state-of-the art interfaces which are widely used in the automotive industry.
18+
VSS does not specify the implementation of the interface signals and the arbitration cascade, but possible examples are given below.
19+
20+
21+
## Definitions and Assumptions
22+
23+
If nothing else is specified, the following definitions and assumptions apply
24+
25+
26+
* The specified data types are chosen based on state-of-the art interfaces for vehicle internal communication between chassis ECUs.
27+
All datatypes int/uint may represent decimal numbers, therefore additional computational methods could be specified in upcoming VSS releases.
28+
29+
* Main guiding units for vehicle motion brake control:
30+
* Vehicle level: Force requests
31+
* Axle level: Torque requests
32+
* Wheel level: Torque requests, omega limits (wheel-spin velocity according to ISO 8855)
33+
34+
Brake forces on vehicle level are defined by the sum of all wheel forces that control the vehicle along the driving path.
35+
Brake torques on axle level are defined as the sum of torques on all wheels on that axle.
36+
Brake torques and omega limits on wheel level are defined for each individual wheel of the vehicle.
37+
38+
* Signal orientation brake system:
39+
Requests are positive in desired path direction of the vehicle.
40+
The desired path direction is defined by the intended driving selection (P,R,D,N).
41+
This means that a positive value indicates acceleration, a negative value deceleration with respect to the intended driving selection.
42+
* Omega limits for brake system defined as relative to actual driving direction. This means that omega is never negative.
43+
* Torque and Force distribution signals (between front/rear axle or left/right wheel) are based on the assumption that all wheels/axles exercise torque in the same direction, i.e. a single axle/wheel cannot fulfil more than 100% of the total request.
44+
45+
* Signal orientation steering system:
46+
Requests are defined according to ISO 8855.
47+
For steering related signals, a positive request on the front axle unless otherwise stated yields to steer the vehicle to the left.
48+
49+
* Signal orientation eAxle system:
50+
Requests are defined according to ISO 8855.
51+
This means that a positive torque yields to a force in vehicle forward direction and a negative torque yields to a force in backward direction.
52+
Omega limits for eAxle system defined according. Positive sign for rotation in forward direction, negative sign for rotation in backward direction.
53+
So the sign of current omega of a eAxle indicated the current driving direction.
54+
55+
* All signals are defined in an automotive safety context, i.e. ISO 26262 has to be considered while using specified signals in vehicle applications.
56+
57+
-----------------------
58+
59+
## Sensors vs. Actuators
60+
61+
The type `actuator` is selected to define that the signal may be used as a "request" by vehicle systems/services towards the actuator.
62+
The type `sensor` is selected for signals that are processed by the actuator and may be used as actuator feedback towards the requesting vehicle systems/services.
63+
64+
## Braking System
65+
The defined braking signals are the main signals for interacting between vehicle motion features and the braking system including the arbitration of longitudinal vehicle requests.
66+
The interface signals are specified on vehicle-, axle- and wheel-level and the arbitration concept supports a flexible integration of vehicle motion features on different ECUs.
67+
The arbitration of multiple vehicle motion features can result in a sophisticated arbitration logic to ensure the vehicle stability and driver safety, which is not part of VSS signal catalogue.
68+
However, the specified vehicle signals shall support different arbitration logics.
69+
The following section shows some hypothetical examples for arbitration.
70+
71+
### Example 1 - vehicle force requests (`Vehicle.MotionManagement.Brake.VehicleForceMaximum`)
72+
Driver request via brake pedal -2000N.
73+
Advanced driving assistance system for automated emergency brake has a request of -3000N.
74+
As a result, a vehicle force of -3000N would be applied, to ensure maximum deceleration.
75+
76+
## Example 2 distribution request (`Vehicle.MotionManagement.Brake.VehicleForceDistributionFrontMinimum`/ `Maximum`)
77+
78+
Vehicle force request of -3000N of example 1.
79+
80+
A vehicle energy function requests a AxlePercentRangeDistributionFrontMaximum of 100% to be most energy efficient.
81+
The vehicle stability function could limit this distribution of 20% < x < 80% due to the current driving situation.
82+
As a result, only 80% axle distribution would be arbitrated, e.g. -600N force (braking) on rear axle and -2400N force (braking) on front axle.
83+
84+
85+
## Powertrain System (Electrical Axle)
86+
87+
A vehicle may have an arbitrary number of electrical axles. Rotational speed and torque for an electrical axle refer to the axle coming out of the electrical axle unit.
88+
There may be a transmission/gearbox between the electrical axle and the actual wheels served by the electrical axle.
89+
90+
There are two operation modes of an eAxle: torque control or speed control.
91+
92+
### Torque Control
93+
A torque request (e.g. 50Nm) is realized by the eAxle. In addition, limit for the rotational speed can be defined, e.g. -5000 rpm ... +5000 rpm. These limits are useful to avoid too high wheelspin when the vehicle is on a slippery road. This mode is used most of the time, when the eAxle is active.
94+
95+
### Speed Control
96+
A rotational speed request (e.g., 1000rpm) is realized by the eAxle. This mode is useful for low speed till standstill, because so the vehicle can be controlled easier to a standstill, especially on a rough road.
97+
98+
## Steering System
99+
100+
The defined steering signals are the main signals for interacting between vehicle motion features and the steering system on the front axle and are widely used in automotive industry.
101+
These signals are specified in a generic way to support various steering systems like electric power steering as well as Steer-by-Wire. Therefore, not all signals must necessarily be available/applicable.
102+
The signal specification supports requests on steering wheel (torque and angle) and the steering rack position which is linked to the steered wheels of the vehicle.
103+
The signal requests are further divided in "offset" and "target" signals, where an offset value is used additive to the functionality of the steering system and a "target" value is used as absolute external set-point for steering actuation.
104+
The different requests are controlled by dedicated "mode" signals for enabling and disabling the steering requests.
105+
106+
Examples: Driving in a left curve and applying external requests to steering system.
107+
Based on the stationary driving without external request (config 1) the principle effects of the different steering interface signals are explained for each interface signal exlusively (config 2...6).
108+
Depending on the concrete use case a combination of parallel requested interface signals is applicable.
109+
110+
Config | Current.SteeringWheelTorque (Torque Applied by Driver) | Current.SteeringWheelAngle | Current.RackPositionFrontAxle | Result/Comment
111+
-------------------------------------------------------------------------|--------------------------------------------------------|-----------------------------|--------------------------------|----
112+
`1`: Regular turn - No external request | 3 Nm | 20 degree | 4 mm | "Steering support" (e.g. power steering) require driver to apply 3 Nm to continue turning with same radius.
113+
`2`. Lane Assist Intervention - `SteeringWheelTorqueOffsetTarget = 2 Nm` | 5 Nm* | 20 degree | 4 mm | Driver torque needs to be increased to continue turning with same radius
114+
`3`. Torque Target Changed - `SteeringWheelTorqueTarget = 2 Nm` | 2 Nm* | 20 degree | 4 mm | Required driver torque set to 2 Nm (e.g. external steering feel for steer by wire), offset ignored.
115+
`4`. Autonomuos Driving - `SteeringWheelAngleTarget = 0 deg` | ---** | 0 degree | 4 mm | Steering wheel set to 0 deg (e.g. automated driving with steer by wire and fixed steering wheel)
116+
`5`. Stability intervention - `RackPositionOffsetFrontAxleTarget = 3 mm` | 3 Nm | 20 degree | 7 mm | Rack position increased by 3mm (e.g. vehicle stability intervention with steer by wire)
117+
`6`. Autonomuous Driving - `RackPositionFrontAxleTarget = 3 mm` | ---** | 0 degree | 3 mm | Rack position set to 3 mm (e.g. automated driving), offset ignored
118+
119+
`*` Assumption is that driver is holding the steering wheel at the same position as without external request
120+
121+
`**` Steering wheel torque depending on driver input. Target request may be ignored if driver is applying torque (driver override).

spec/Vehicle/MotionManagement.vspec

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# Copyright (c) 2024 Contributors to COVESA
2+
#
3+
# This program and the accompanying materials are made available under the
4+
# terms of the Mozilla Public License 2.0 which is available at
5+
# https://www.mozilla.org/en-US/MPL/2.0/
6+
#
7+
# SPDX-License-Identifier: MPL-2.0
8+
9+
# Motion Management concerns how steering, electrical axles and steering can be managed to
10+
# control vehicle motion like accelaration adn deacceleration and assuring that the vehicle move
11+
# in the wanted direction
12+
#
13+
# Please see vehicle_motion_management.md in documentation for more information
14+
15+
MotionManagement:
16+
type: branch
17+
description: Motion Management Information.
18+
19+
MotionManagement.ElectricAxle:
20+
type: branch
21+
instances:
22+
- Row[1,2]
23+
description: MotionManagement for a specific electric axle.
24+
#include MotionManagement/ElectricAxle.vspec MotionManagement.ElectricAxle
25+
26+
MotionManagement.Brake:
27+
type: branch
28+
description: MotionManagement related to braking (both frictions brakes and contribution from electric axles).
29+
#include MotionManagement/Brake.vspec MotionManagement.Brake
30+
31+
MotionManagement.Steering:
32+
type: branch
33+
description: MotionManagement related to steering.
34+
#include MotionManagement/Steering.vspec MotionManagement.Steering
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# Copyright (c) 2024 Contributors to COVESA
2+
#
3+
# This program and the accompanying materials are made available under the
4+
# terms of the Mozilla Public License 2.0 which is available at
5+
# https://www.mozilla.org/en-US/MPL/2.0/
6+
#
7+
# SPDX-License-Identifier: MPL-2.0
8+
9+
# See vehicle_motion_management.md for more info
10+
11+
VehicleForceMaximum:
12+
type: actuator
13+
datatype: int16
14+
unit: N
15+
max: 0
16+
description: Maximum longitudinal brake force request (FxWhlSum).
17+
Sum of all tyre longitudinal forces. Brake Force < 0N.
18+
19+
VehicleForceElectricMinimumArbitrated:
20+
type: sensor
21+
datatype: int16
22+
max: 0
23+
unit: N
24+
description: Brake system internally calculated regenerative force limit at vehicle level for eAxle actuation. Brake Force < 0N.
25+
26+
VehicleForceElectric:
27+
type: actuator
28+
datatype: int16
29+
max: 0
30+
unit: N
31+
description: Regenerative brake force request (FxWhlSum). Sum of all tyre longitudinal forces. Brake Force < 0N.
32+
33+
VehicleForceDistributionFrontMaximum:
34+
type: actuator
35+
datatype: uint16
36+
unit: percent
37+
min: 0
38+
max: 100
39+
description: Maximum distribution range request of FxWhlSum to front axle.
40+
0% = Complete longitudinal brake force shall be shifted to rear axle.
41+
50% = At most 50% shall be shifted to front axle.
42+
100% = Complete longitudinal brake force may be shifted to front axle.
43+
44+
VehicleForceDistributionFrontMinimum:
45+
type: actuator
46+
datatype: uint16
47+
unit: percent
48+
min: 0
49+
max: 100
50+
description: Minimum distribution range request of FxWhlSum to front axle.
51+
0% = Complete longitudinal brake force may be shifted to rear axle.
52+
50% = At least 50% shall be shifted to front axle.
53+
100% = Complete longitudinal brake force shall be shifted to front axle.
54+
55+
Axle:
56+
type: branch
57+
instances:
58+
- Row[1,2]
59+
description: MotionManagement for brake actuation for a specific electric axle.
60+
#include Brake/Axle.vspec Axle
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Copyright (c) 2024 Contributors to COVESA
2+
#
3+
# This program and the accompanying materials are made available under the
4+
# terms of the Mozilla Public License 2.0 which is available at
5+
# https://www.mozilla.org/en-US/MPL/2.0/
6+
#
7+
# SPDX-License-Identifier: MPL-2.0
8+
9+
TorqueElectricMinimum:
10+
type: actuator
11+
datatype: int16
12+
max: 0.0
13+
unit: Nm
14+
description: Limit for regenerative brake torque at given axle. Brake Torque < 0Nm.
15+
16+
TorqueFrictionDifferenceMaximum:
17+
type: actuator
18+
datatype: uint16
19+
unit: Nm
20+
description: Maximum absolute wheel torque difference between left and right wheel for friction brake.
21+
22+
TorqueDistributionFrictionRightMaximum:
23+
type: actuator
24+
datatype: uint16
25+
unit: percent
26+
min: 0
27+
max: 100
28+
description: Maximum distribution range of the friction brake request on the axle to the right wheel.
29+
0% = Complete friction torque shall be shifted to the left wheel.
30+
50% = At most 50% friction torque may be shifted to the right wheel.
31+
100% = Complete friction torque may be shifted to the right wheel.
32+
33+
TorqueDistributionFrictionRightMinimum:
34+
type: actuator
35+
datatype: uint16
36+
unit: percent
37+
min: 0
38+
max: 100
39+
description: Minimum distribution range of the friction brake request on the axle to the right wheel.
40+
0% = Complete friction torque may be shifted to the left wheel.
41+
50% = At least 50% friction torque shall be shifted to the right wheel.
42+
100% = Complete friction torque shall be shifted to the right wheel.
43+
44+
Wheel:
45+
type: branch
46+
instances: ["Left","Right"]
47+
description: MotionManagement signals for a specific wheel.
48+
#include Axle/Wheel.vspec Wheel
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Copyright (c) 2024 Contributors to COVESA
2+
#
3+
# This program and the accompanying materials are made available under the
4+
# terms of the Mozilla Public License 2.0 which is available at
5+
# https://www.mozilla.org/en-US/MPL/2.0/
6+
#
7+
# SPDX-License-Identifier: MPL-2.0
8+
9+
# See vehicle_motion_management.md for more info
10+
11+
Torque:
12+
datatype: int16
13+
max: 0
14+
unit: Nm
15+
type: sensor
16+
description: Estimated friction brake torque. Brake Torque < 0Nm.
17+
18+
TorqueArbitrated:
19+
datatype: int16
20+
max: 0
21+
unit: Nm
22+
type: sensor
23+
description: Brake system internally calculated friction brake torque target. Brake Torque < 0Nm.
24+
25+
TorqueFrictionMaximum:
26+
type: actuator
27+
datatype: int16
28+
max: 0
29+
unit: Nm
30+
description: Maximum wheel torque request for friction brake. Brake Torque < 0Nm.
31+
32+
TorqueFrictionMinimum:
33+
type: actuator
34+
datatype: int16
35+
max: 0
36+
unit: Nm
37+
description: Minimum wheel torque request for friction brake. Brake Torque < 0Nm.
38+
39+
OmegaUpper:
40+
type: actuator
41+
datatype: uint16
42+
unit: rad/s
43+
description: Upper wheel speed limit request controlled by friction brake. ISO 8855 wheel-spin velocity.
44+
45+
OmegaLower:
46+
type: actuator
47+
datatype: uint16
48+
unit: rad/s
49+
description: Lower wheel speed limit request controlled by friction brake. ISO 8855 wheel-spin velocity.

0 commit comments

Comments
 (0)