Possible additions to address Android VHAL signals

spec/Body/Body.vspec

@@ -16,6 +16,7 @@ BodyType:
   description: Body type code as defined by ISO 3779.
 
 RefuelPosition:
+  deprecation: V3.1 replaced by Vehicle.Powertrain.TractionBattery.Charging.ChargePortPosition and Vehicle.Powertrain.FuelSystem.RefuelPosition
   datatype: string
   type: attribute
   allowed: ['FRONT_LEFT', 'FRONT_RIGHT', 'MIDDLE_LEFT', 'MIDDLE_RIGHT', 'REAR_LEFT', 'REAR_RIGHT']
@@ -198,7 +199,7 @@ Lights.Beam:
 
 Lights.Running:
   type: branch
-  description: Running lights.
+  description: Daytime running lights (DRL).
 #include StaticLights.vspec Lights.Running
 
 Lights.Backup:

spec/Body/ExteriorMirrors.vspec

@@ -26,6 +26,11 @@ Pan:
   max: 100
   description: Mirror pan as a percent. 0 = Center Position. 100 = Fully Left Position. -100 = Fully Right Position.
 
+IsFolded:
+  datatype: boolean
+  type: actuator
+  description: Indicates if mirrors are folded.
+
 IsHeatingOn:
   datatype: boolean
   type: actuator

spec/Cabin/HVAC.vspec

@@ -18,15 +18,27 @@ Station:
   description: HVAC for single station in the vehicle
 #include SingleHVACStation.vspec Station
 
+
+IsHVACActivated:
+  datatype: boolean
+  type: actuator
+  description: Is HVAC system on. When false fans and air conditioning is deactivated.
+
 IsRecirculationActive:
   datatype: boolean
   type: actuator
   description: Is recirculation active.
+
+IsAutoRecirculationActive:
+  datatype: boolean
+  type: actuator
+  description: Indicates if system automatically shall change to recirculation mode if incoming air quality is low.
 
 IsFrontDefrosterActive:
   datatype: boolean
   type: actuator
   description: Is front defroster active.
+  comment: This signal refer to or control both electric defroster (if existing) and fan-based defroster.
 
 IsRearDefrosterActive:
   datatype: boolean
@@ -38,8 +50,24 @@ IsAirConditioningActive:
   type: actuator
   description: Is Air conditioning active.
 
+IsAirConditioningMaxOn:
+  datatype: boolean
+  type: actuator
+  description: Indicates if air condition system is in max mode.
+               In max mode the VAC system shall try to cool the vehicle as much and fast as possible.
+
 AmbientAirTemperature:
   datatype: float
   type: sensor
   unit: celsius
   description: Ambient air temperature inside the vehicle.
+
+IsIndividualMode:
+  datatype: boolean
+  type: actuator
+  description: Indicates if individual mode is on.
+               True = changing fan speed and temperature for one HVAC station change it only for that station.
+               False = changing fan speed and temperature on master HVAC station shall change it for all HVAC stations.
+  comment: The master HVAC station is typically the HVAC station controlled by the driver.
+           A vehicle may automatically change to IsIndividualMode=True if someone change temperature or fan speed on other HVAC stations.
+           IsIndividualMode=True is sometimes referred to as dual mode. IsIndividualMode=False is sometimes referred to as synchronized mode. 

spec/Cabin/Infotainment.vspec

@@ -134,6 +134,12 @@ HMI.TimeFormat:
   allowed: ['HR_12', 'HR_24']
   description: Time format used in the current HMI
 
+HMI.SpeedUnit:
+  datatype: string
+  type: actuator
+  allowed: ['METER_PER_SECOND', 'MILES_PER_HOUR', 'KILOMETERS_PER_HOUR']
+  description: Speed unit used in the current HMI
+
 HMI.DistanceUnit:
   datatype: string
   type: actuator
@@ -158,6 +164,14 @@ HMI.EVEconomyUnits:
   allowed: ['MILES_PER_KILOWATT_HOUR', 'KILOMETERS_PER_KILOWATT_HOUR', 'KILOWATT_HOURS_PER_100_MILES', 'KILOWATT_HOURS_PER_100_KILOMETERS', 'WATT_HOURS_PER_MILE', 'WATT_HOURS_PER_KILOMETER']
   description: EV fuel economy unit used in the current HMI
 
+HMI.EVEnergyUnits:
+  datatype: string
+  type: actuator
+  allowed: ['WATT_HOURS','AMPERE_HOURS', 'KILOWATT_HOURS']
+  description: EV energy unit used in the current HMI
+  comment: Ampere hours is by definition not an energy unit, but can be used as a measurement of energy
+           if the voltage, like nominal voltage of the battery, is known.
+
 HMI.TemperatureUnit:
   datatype: string
   type: actuator

spec/Cabin/InteriorLights.vspec

@@ -18,12 +18,12 @@ IsGloveBoxOn:
 IsTrunkOn:
   datatype: boolean
   type: actuator
-  description: Is trunk light light on
+  description: Is trunk light on
 
 IsDomeOn:
   datatype: boolean
   type: actuator
-  description: Is central dome light light on
+  description: Is central dome light on
 
 AmbientLight:
   datatype: uint8

spec/Cabin/SingleDoor.vspec

@@ -20,6 +20,16 @@ IsLocked:
   description: Is door locked or unlocked. True = Locked. False = Unlocked.
 
 
+Position:
+  datatype: uint8
+  type: sensor
+  min: 0
+  max: 100
+  unit: percent
+  description: Door position. 0 = Fully closed 100 = Fully opened.
+
+#include SingleSliderSwitch.vspec
+
 #
 # Window description
 #

spec/Cabin/SingleHVACStation.vspec

@@ -29,3 +29,10 @@ AirDistribution:
   type: actuator
   allowed: ['UP', 'MIDDLE', 'DOWN']
   description: Direction of airstream
+
+
+IsAutoMode:
+  datatype: boolean
+  type: actuator
+  description: Indicates if auto mode is on.
+               In auto mode fan speed and air distribution may change without user action.

spec/Cabin/SingleSeat.vspec

@@ -24,6 +24,7 @@
 # z-axis is the axis going up/down on the vehicle
 #
 
+
 IsOccupied:
   datatype: boolean
   type: sensor
@@ -43,6 +44,14 @@ IsBelted:
   type: sensor
   description: Is the belt engaged.
 
+SeatBeltHeight:
+  datatype: uint16
+  type: actuator
+  min: 0
+  unit: mm
+  description: Seat belt position on vehicle z-axis. Position is relative within available movable range of the seat belt.
+               0 = Lowermost position supported.
+
 Heating:
   datatype: int8
   type: actuator
@@ -51,6 +60,13 @@ Heating:
   unit: percent
   description: Seat cooling / heating. 0 = off. -100 = max cold. +100 = max heat.
 
+Ventilation:
+  datatype: uint8
+  type: actuator
+  max: 100
+  unit: percent
+  description: Seat ventilation. 0 = off. 100 = max ventilation.
+
 Massage:
   datatype: uint8
   type: actuator
@@ -192,6 +208,16 @@ Switch.IsCoolerEngaged:
   type: actuator
   description: Cooler switch for Seat heater (SingleSeat.Heating).
 
+Switch.IsMoreVentilationEngaged:
+  datatype: boolean
+  type: actuator
+  description: Switch to increase seat ventilation (SingleSeat.Ventilation).
+
+Switch.IsLessVentilationEngaged:
+  datatype: boolean
+  type: actuator
+  description: Switch to decrease seat ventilation (SingleSeat.Ventilation).
+
 Switch.IsForwardEngaged:
   datatype: boolean
   type: actuator
@@ -326,3 +352,21 @@ Switch.Massage.IsDecreaseEngaged:
   type: actuator
   description: Decrease massage level switch engaged (SingleSeat.Massage).
 
+
+
+SeatMemory:
+  type: branch
+  description: Data to control seat memory.
+
+SeatMemory.Select:
+  datatype: uint8
+  type: actuator
+  description: Specifies that saved settings from seat memory shall be used. 0 indicates that saved settings are not used.
+  comment: Number of seat memories available is vehicle dependent
+
+SeatMemory.Set:
+  datatype: uint8
+  type: actuator
+  description: Requests the vehicle to save current seat settings in the specified seat memory.
+               0 is reserved and indicates that nothing shall be saved.
+  comment: Number of seat memories available is vehicle dependent.

spec/Chassis/Chassis.vspec

@@ -18,6 +18,7 @@ Wheelbase:
   description: Overall wheel base, in mm.
 
 Track:
+  deprecation: V3.1 moved to Axle.Track
   datatype: uint16
   type: attribute
   default: 0
@@ -60,7 +61,20 @@ Axle.WheelWidth:
   unit: inch
   description: Width of wheels (rims without tires), in inches, as per ETRTO / TRA standard.
 
+Axle.Track:
+  datatype: uint16
+  type: attribute
+  default: 0
+  unit: mm
+  description: Overall track width at wheel center, as defined by SAE J1100-2009 W102.
 
+Axle.SteeringAngle:
+  datatype: float
+  type: sensor
+  unit: degrees
+  description: Single track two-axle model steering angle.
+               Angle according to ISO 8855. Positive = degrees to the left. Negative = degrees to the right.
+  comment: Single track two-axle model steering angle refers to the angle that a centrally mounted wheel would have.
 #
 # Tire attributes
 #
@@ -110,6 +124,10 @@ ParkingBrake.IsEngaged:
   type: actuator
   description: Parking brake status. True = Parking Brake is Engaged. False = Parking Brake is not Engaged.
 
+ParkingBrake.IsAutoApplyEnabled:
+  datatype: boolean
+  type: actuator
+  description: Indicates if parking brake will be automatically engaged when the vehicle engine is turned off.
 
 #
 # Steering Wheel
@@ -119,21 +137,21 @@ SteeringWheel:
   description: Steering wheel signals
 
 SteeringWheel.Angle:
-  datatype: int16
+  datatype: float
   type: sensor
   unit: degrees
   description: Steering wheel angle. Positive = degrees to the left. Negative = degrees to the right.
 
 SteeringWheel.Tilt:
-  datatype: uint8
+  datatype: float
   type: actuator
   min: 0
   max: 100
   unit: percent
   description: Steering wheel column tilt. 0 = Lowest position. 100 = Highest position.
 
 SteeringWheel.Extension:
-  datatype: uint8
+  datatype: float
   type: actuator
   min: 0
   max: 100
@@ -146,6 +164,15 @@ SteeringWheel.Position:
   default: 'FRONT_LEFT'
   allowed: ['FRONT_LEFT', 'FRONT_RIGHT']
   description: Position of the steering wheel on the left or right side of the vehicle.
+
+
+SteeringWheel.Heating:
+  datatype: uint8
+  type: actuator
+  min: 0
+  max: 100
+  unit: percent
+  description: Steering wheel heating. 0 = Heating off. 100 = Maximum heating.
 
 #
 # Accelerator

spec/Chassis/Wheel.vspec

@@ -70,4 +70,32 @@ Speed:
   datatype: float
   type: sensor
   unit: km/h
-  description: Rotational speed of a vehicle's wheel.
+  description: Rotational speed of a vehicle's wheel, 
+  comment: The value refers to average speed during the interval specified by SpeedMeasurementInterval.
+
+#
+# TODO: Discuss if this will vary on wheel basis, or if it always is the same for all wheels.
+#
+SpeedMeasurementInterval:
+  datatype: float
+  type: sensor
+  unit: s
+  description: Interval used for calculating wheel speed.
+  comment: The interval may vary depending on vehicle state.
+
+# Wheel Ticks for now considered less prioritized, unclear if actually needed for VSS use cases
+
+WheelTicks:
+  datatype: int32
+  type: sensor
+  description: Counter for wheel ticks. Counter increase when wheel rotates forward and decrease when wheel rotates backward.
+               Counter is reset when vehicle is powered on.
+  comment: Wheel tick value can be negative, for example if the vehicle after being powered on starts driving backward.
+           Theoretically the value may wrap around but it will unlikely happen in reality as an int32 with typical 
+           WheelTicksPerRotation (<100) and tire circumference ( about 2 cm per tick) can handle about 40000 km before wrap around.
+
+WheelTicksPerRotation:
+  datatype: uint16
+  type: attribute
+  description: Number of ticks registered for one rotation of the wheel
+

spec/Powertrain/Battery.vspec

@@ -219,6 +219,12 @@ Charging.ChargePortFlap:
   allowed: ['OPEN', 'CLOSED']
   description: Status of the charge port cover, can potentially be controlled manually.
 
+ChargePortPosition:
+  datatype: string
+  type: attribute
+  allowed: ['FRONT_LEFT', 'FRONT_RIGHT', 'MIDDLE_LEFT', 'MIDDLE_RIGHT', 'REAR_LEFT', 'REAR_RIGHT', 'FRONT', 'REAR']
+  description: Location of the charge port
+
 Charging.IsChargingCableConnected:
   datatype: boolean
   type: sensor

spec/Powertrain/FuelSystem.vspec

@@ -27,6 +27,18 @@ SupportedFuel:
                with additional suffix for octane (RON) where relevant.
   comment: RON 95 is sometimes referred to as Super, RON 98 as Super Plus.
 
+
+RefuelPosition:
+  datatype: string
+  type: attribute
+  allowed: ['FRONT_LEFT', 'FRONT_RIGHT', 'MIDDLE_LEFT', 'MIDDLE_RIGHT', 'REAR_LEFT', 'REAR_RIGHT', 'FRONT', 'REAR']
+  description: Location of the fuel cap.
+
+IsFuelDoorOpen:
+  datatype: boolean
+  type: actuator
+  description: Status of the fuel door.
+
 HybridType:
   datatype: string
   type: attribute

spec/Vehicle/Vehicle.vspec

@@ -346,11 +346,21 @@ Height:
 Width:
   datatype: uint16
   type: attribute
-  default: 0
   unit: mm
-  description: Overall vehicle width.
+  description: Overall vehicle width excluding mirrors, as defined by SAE J1100-2009 W103.
+
+WidthIncludingMirrors:
+  datatype: uint16
+  type: attribute
+  unit: mm
+  description: Overall vehicle width including mirrors, as defined by SAE J1100-2009 W144.
 
 
+TurnDiameter:
+  datatype: uint16
+  type: attribute
+  unit: mm
+  description: Minimum turn diameter, as defined by SAE J1100-2009 D102.
 #
 # Trailer
 #