Table of Contents

Below is the start of translating the uServices definitions of seating capabilities to a technology neutral tabular format as agreed in our kick-off meeting on October 18th. Please take a look, iterate, comment and let me know if you have questions Paul Boyes

Agreed by Group:

Start a position D in architecture - see architecture diagram below
Safety considerations to be noted but not exhaustively

Terminology Alignment (WIP)

Seatting.pptx

Aligning on information types is critical.

Notes:

- Seating accounts for over 1/5th of VSS.yaml. This is due to the many facets of seating and the number of instances.
- Seat Configuration:
  - Vehicle.Cabin.SeatRowCount - number of rows - defaults to 2
  - Vehicle.Cabin.SeatPosCount - array of number of seats per row - defaults to 2,3 which is 2 in row 1 and 3 in row 2

- - Even though the default says only 2 seats in row 1, generated (yaml) it has Driver, Middle and Passenger
- Related:
  - Vehicle.VehicleIdentification.VehicleSeatingCapacity - provides seating capacity vehicle
  - Vehicle.Cabin.DriverPosition - driver left, middle or right

Seat Identity

Identifying a specific seat within a vehicle. This is based on location within the vehicle.

Information Type	Values (per GM uServices)	Ford	VSS Alignment / Mapping	Android Alignment / Mapping
Seat Seat identity for 3 rows with 3 seats per row, front to back (looking towards front of vehicle from within the vehicle)	row1_left	row1_driver or row1_passenger by region / config	Vehicle.Cabin.Seat.Row1.DriverSide or Vehicle.Cabin.Seat.Row1.PassengerSide Note: Driver seat typically has more functions than others. Typical ECUs are DriverSeatModule and PassengerSeat Module, that are picked up as is (SW content & interfaces) and moved from left to right of vehicle based on region). This is done to reduce variant complexity management and vehicle network & Interface configuration Vehicle.Cabin.Seat.DriverPosition sets the DriverSide in VSS. It is allows ['LEFT', 'MIDDLE', 'RIGHT'] . In uServices, it does not appear Driver Position or similar is spelled out. Decision: For Seating Capabilities, not how it is done internally to your organization, can we align around VSS Vehicle.Cabin.Seat? Stupid Question Erik Jaegervall bear with me : How does Vehicle.Cabin.SeatPosCount work with what is actually generated for vss.yaml (the instances) and/or how you use? For instance, in Cabin.vspec the default is SeatPosCount: datatype: uint8[] type: attribute default: [2, 3] Based on the Seat branch definition: Seat: type: branch instances: - Row[1,2] - ["DriverSide","Middle","PassengerSide"] The following instances are generated per row: Vehice.Cabin.Seat.Row1.DriverSide, Vehice.Cabin.Seat.Row1.Middle, Vehice.Cabin.Seat.Row1.PassengerSide It is implied or just well known that in this case you just don't use Middle? What if SeatPosition is [1,1] ... DriverSide and PassengerSide or the same? What if it is your instances are ["DriverSide","Middle1","Middle2"PassengerSide"] and your SeatPosition is [3,4]? I guess it is implied, industry knowledge or incumbent on the implementor to spell it out? Right? Comment from Erik Jaegervall 2024-12-18: In general - how to indicate whether a VSS signal or a seat instance actually exists is up to the implementation. It might be based on that you do changes to your in VSS (for example with `delete: true` attribute to remove specific instances), or it may handle it dynamically, like no ECU provide values for specific seat). In the latter case, the VSS spec just shows "valid paths", it does not say whether a specific feature or seat actually exist. The `SeatPosCount` signal is old. Once upon the time we actually had a numeric "pos" argument for seats, like Pos1, Pos2 and then you could possibly use it to know which seats that existed, but now it is more of guesswork. There have been discussions if the instance-part should be removed from the VSS-spec and especially from the full dot-notated paths, as that is rather deployment information. That "core" VSS should specify that there can be multiple seats, and possibly that row/pos are attributes that seat can have, but specifying the actual instances is rather for the implementation. That would be a bit similar to the Android zone concept.	TBD
	row1_center		Vehicle.Cabin.Seat.Row1.Middle
	row1_right	row1_driver or row1_passenger by region / config	Vehicle.Cabin.Seat.Row1.PassengerSide or Vehicle.Cabin.Seat.Row1.DriverSide
	row2_left		Vehicle.Cabin.Seat.Row2.DriverSide
	row2_center		Vehicle.Cabin.Seat.Row2.Middle
	row2_right		Vehicle.Cabin.Seat.Row2.PassengerSide
	row3_left		Vehicle.Cabin.Seat.Row3.DriverSide
	row3_center		Vehicle.Cabin.Seat.Row3.Middle
	row3_right		Vehicle.Cabin.Seat.Row3.PassengerSide

Seat Identity Illustrations

tbd

Seat Components

Seat components that are movable or controllable, electrically driven.

Information Type	Values	Illustration #	BMW	Ford	Volvo Cars	VSS Alignment / Mapping	Android Alignment / mapping
Seat Component Moveable Seating Component (Electrically Driven)	Complete seat	All	Added			Vehicle.Cabin.Seat is the complete seat definition. Vehicle.Cabin.Seat.Row1.DriverSide would be an instance.	SEAT_FORE_AFT SEAT_HEIGHT
	Lumbar Top Middle Lower	5 top =5a mid =5b lower =5c				Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.Lumbar - Adjustable lumbar support mechanisms in seats allow the user to change the seat back shape. Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.Lumbar.Height - mm - Height of lumbar support. Position is relative within available movable range of the lumbar support. 0 = Lowermost position supported. Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.Lumbar.Support - percent - lumbar support (in/out position). 0 = Innermost position. 100 = Outermost position.	SEAT_LUMBAR_VERTICAL SEAT_LUMBAR_FORE_AFT
	Cushion Side Bolster	12 right = 12a left = 12b		Right and Left Cushion (lower) bolsters	Inflaation level 0-100%		SEAT_CUSHION_SIDE_SUPPORT
	Backrest Side Bolster	11 right = 11a left = 11b		Right and Left Back (upper) bolsters	Inflation level 0-100%	Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.SideBolster - Backrest side bolster (lumbar side support) settings. Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.SideBolster.Support percent - Side bolster support. 0 = Minimum support (widest side bolster setting). 100 = Maximum support.	SEAT_LUMBAR_SIDE_SUPPORT
	Upper Shoulder (fwd/backward)	9
	Backrest (was Cushion Front)	10				Vehicle.Cabin.Seat.Row1.DriverSide.Backrest - Describes signals related to the backrest of the seat.
	Cushion Extension	13 Blue thing		Thigh Extension? see video	Either works
	Headrest	4				Vehicle.Cabin.Seat.Row1.DriverSide.Headrest - Headrest settings Vehicle.Cabin.Seat.Row1.DriverSide.Headrest.Height - mm Seat position on vehicle z-axis. Position is relative within available movable range of the seating. 0 = Lowermost position supported.
	Airbag					Vehicle.Cabin.Seat.Row1.DriverSide.Airbag Vehicle.Cabin.Seat.Row1.DriverSide.Airbag.IsDeployed - boolean - Airbag deployment status. True = Airbag deployed. False = Airbag not deployed. Vehicle.Cabin.Seat.Row1.PassengerSide.Airbag
	Neck Scarf (fan)	6
	Seat Belt (height)

Seat Component Illustrations (maintained on Miro)

Wiki Front Page > Capabilities Project - Seating Capabilities > image-2024-12-20_12-20-52.png

Bolsters and Bladders:

Wiki Front Page > Capabilities Project - Seating Capabilities > image-2024-12-20_12-21-12.png

Seat & Component Movements or Positions

Words describing control parameters or changeable properties related to movement or position.

Information Type	Definition	Values	BMW	Ford	GM	VSS Alignment / Mapping	Android Alignment / Mapping	Notes
Direction	Direction of seat or component movement	Forward - toward the front of the vehicle		fore	depends on the component		Applied by seat or component like: SEAT_FORE_AFT SEAT_LUMBAR_FORE_AFT	Is Fold a direction? Team agreed it is a capability
		Backward - toward the back of the vehicle		aft	depends on the component
		Up - toward the roof of the vehicle			depends on the component	Applied by Seat or Component like: Vehicle.Cabin.Seat.Row1.DriverSide.Height Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.Lumbar.Height Vehicle.Cabin.Seat.Row1.DriverSide.Headrest.Height	Applied by seat or component like: SEAT_HEIGHT SEAT_LUMBAR_VERTICAL
		Down - toward the bottom of the vehicle			depends on the component
		Inflate - fill with air		increase	depends on the component	Applied by inflatable Component like: Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.Lumbar.Support percent - lumbar support (in/out position). 0 = Innermost position. 100 = Outermost position. Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.SideBolster.Support percent - Side bolster support. 0 = Minimum support (widest side bolster setting). 100 = Maximum support.
		Deflate - remove air		decrease	depends on the component
		Tilt / Recline (angles)		angles	depends on the component	Applied by Component like: Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.Recline - degrees - Seat z-axis depends on seat tilt. This means that movement of backrest due to seat tilting will not affect Backrest.Recline as long as the angle between Seating and Backrest are constant. Absolute recline relative to vehicle z-axis can be calculated as Tilt + Backrest.Recline. Vehicle.Cabin.Seat.Row1.DriverSide.Headrest.Angle - degrees - Headrest angle, relative to backrest, 0 degrees if parallel to backrest, Positive degrees = tilted forward.
		Swivel
Position	position on horizontal plane (x-axis) or vertical plane (z-axis) of seat or component		Needs Clarification. Percent of total? clicks? x, y, z axis values?	Should height be separate? Is y-axis needed?		Vehicle.Cabin.Seat.Row1.DriverSide.Position - Seat position on vehicle x-axis. mm - Position is relative to the frontmost position supported by the seat. 0 = Frontmost position supported. Vehicle.Cabin.Seat.Row1.DriverSide.Height - mm - Seat position on vehicle z-axis. Position is relative within available movable range of the seating. 0 = Lowermost position supported.	AI: align what position means
Tilt Angle		tilt angle of seat or component (also known as recline)	duplicate to Tilt / Recline (angles)	duplicate to Tilt / Recline (angles) under "direction" above		Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.Recline - degrees - Seat z-axis depends on seat tilt. This means that movement of backrest due to seat tilting will not affect Backrest.Recline as long as the angle between Seating and Backrest are constant. Absolute recline relative to vehicle z-axis can be calculated as Tilt + Backrest.Recline. Vehicle.Cabin.Seat.Row1.DriverSide.Headrest.Angle - degrees - Headrest angle, relative to backrest, 0 degrees if parallel to backrest, Positive degrees = tilted forward.

Seat Heating and Cooling

Words describing control parameters or changeable properties related to seat heating and cooling.

Information Type	Definition	Values	Illustration #	BMW	Ford	GM	Volvo Cars	VSS Mapping	Android Alignment / mapping	Notes
Temperature								-100 = max cooling 100 = max heating 0 = off
~~Temperature Controlled Element Mode~~		On		~~added~~	~~Is "On" covered by heat, cool, or vent?~~
		~~Off~~
		~~Cool~~
		~~Vent~~
		~~Heat~~
Fan Speed		Off		~~delete covered by Seat temp mode~~	~~Concur with comment from BMW~~
		Auto
		Level 1
		Level 2
		Level 3
		Level 4		~~added~~
		Level 5

Seat Massage

Information Type	Definition	Values	BMW	Ford	Volvo Cars	VSS Alignment / Mapping
Massage Capability	Is the seat capable of providing massage.	yes/no or true/false	we need a general discover mechanism		Overlaps with with Seat Massage Type
Massage Status		On/Off			Overlaps with Seat Massage Type	Vehicle.Cabin.Seat.Row1.DriverSide.Switch.Massage - Switches for SingleSeat.Massage. Vehicle.Cabin.Seat.Row1.DriverSide.Switch.Massage.IsDecreaseEngaged - Decrease massage level switch engaged (SingleSeat.Massage). Vehicle.Cabin.Seat.Row1.DriverSide.Switch.Massage.IsIncreaseEngaged - Increase massage level switch engaged (SingleSeat.Massage).
Massage Types	Available massage types for a specific seat, including none.	Values will vary by OEM, therefore, need a capability to determine types per seat.		Massage Patterns
Seat Massage Type		Off Roll Knead Anti Fatigue Pulse Stretch Lumbar Shoulder Wave Relief Glide		Need discovery capability as will vary by seat.
Massage Intensity		Intensity of massage	??		1-5?	Vehicle.Cabin.Seat.Row1.PassengerSide.Massage - Seat massage level. 0 = off. 100 = max massage.

Seat Haptics

Haptics are seat or component vibrations used to alert the driver or provide feedback. Used by ADAS.

Information Type	Definition	Values	Illustration #	BMW	Ford	GM	Volvo Cars	VSS Alignment / Mapping	Android Alignment / Mapping
Delay Between Pulses						internal calibration at the moment, based on the requestor
Haptic Pulses

Seat Occupancy and Safety

Information Type	Values	BMW	Volvo Cars	VSS Alignment / Mapping
Seat Occupancy Status	Unknown			Vehicle.Cabin.Seat.Row1.Middle.IsOccupied - boolean - is or is not occupied. No Unkown.
	Occupied
	Empty
Seat Occupant ID		??	What is this?	Vehicle.Cabin.Seat.Row1.DriverSide.Occupant.Identifier - v5.0 use data from Vehicle.Occupant...Identifier. Identifier attributes based on OAuth 2.0. Vehicle.Cabin.Seat.Row1.DriverSide.Occupant.Identifier.Subject v5.0 - use data from Vehicle.Occupant...Identifier. Subject for the authentication of the occupant e.g. UserID 7331677.
Child seat	Installed (true/false)	added
Seat Belt Status	Fastened			Vehicle.Cabin.Seat.Row1.PassengerSide.IsBelted - boolean - is or is not belted/fastened Related: Vehicle.Cabin.Seat.Row1.PassengerSide.SeatBeltHeight - Seat belt position on vehicle z-axis. Position is relative within available movable range of the seat belt. 0 = Lowermost position supported.
Seat Belt Status	Unfastened

Other Seat Information

Information Type	Definition	Values	Illustration #	BMW	Ford	GM	Volvo Cars	VSS Alignment / Mapping	Android Alignment / Mapping	Notes
Side of Seat	Side of a specific Seat	Right Left		duplicate to "SEATS"
Seat Switch								Seat Switch Signals - e.g. Vehicle.Cabin.Seat.Row1.DriverSide.Switch.Backrest.IsReclineBackwardEngaged See spec and generated schema for details

Seat Capability Alignment (WIP)

Column Definitions

- Capability: A concise name for the capability
- Description: A brief description of the capability and what it does and enables
- Inputs: What data (must align with VSS) is required by the capability
- Outputs: What data (must align with VSS) is output by the capability
- Dependencies: Other capabilities, processes, or systems the capability depends on
- Assumptions/Constraints: Any assumptions or limitations that should be considered
- Considerations: Including safety, security, performance, regulations, diagnostics…
- Location in Architecture: For context where does it sit in an architecture

General questions regarding API invocation:

- Can we use "actuate with commands, report with signals" as a general strategy?
- Do we use transaction IDs to tie commands to output signals/results?

Seat Movement and Position

Capability	Description	Inputs	Outputs	Dependencies	Assumptions /Constraints	VSS Examples / Mapping	Android Examples / Mapping	Notes
Movement & Position - Control
Move Seat Incrementally	Move the identified seat in the specified direction. When a user commands a seat in a certain direction, it will incrementally move in that direction.	seat direction	status		One request/trigger moves one increment.	N/A
Move Seat to Specified Position	Set the seat position for the identified seat. This is entire seat position forward, back, up down.	seat position	status			Vehicle.Cabin.Seat.Row1.DriverSide.Position Seat position on vehicle x-axis. mm - Position is relative to the frontmost position supported by the seat. 0 = Frontmost position supported. Vehicle.Cabin.Seat.Row1.DriverSide.Height mm - Seat position on vehicle z-axis. Position is relative within available movable range of the seating. 0 = Lowermost position supported.		What is the position definition? ISO 8895 What is status? Position Status.
Move Seat Component Incrementally	Move the identified seat and component in the specified direction. When a user commands a seat component in a certain direction, it will incrementally move in that direction until the user ceases their request.	seat component direction	status			N/A		Different classes of comportment? Certain directions apply to different components? Need to enumerate the components? Component type?
Set Seat Component Position Per Seat	Set the seat component position for the identified seat. This is position of the component only.	seat seat component position angle	status			Applied by Component and Direction like: Vehicle.Cabin.Seat.Row1.DriverSide.Headrest.Height Vehicle.Cabin.Seat.Row1.DriverSide.Headrest.Angle Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.Recline Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.Lumbar.Height Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.Lumbar.Support percent - lumbar support (in/out position). 0 = Innermost position. 100 = Outermost position. Vehicle.Cabin.Seat.Row1.DriverSide.Backrest.SideBolster.Support percent - Side bolster support. 0 = Minimum support (widest side bolster setting). 100 = Maximum support.
Store Seat Position	Stores current seat and component positions	seat Seat Occupant ID				N/A
Recall Seat Position	Recall seat and component positions	seat seat occupant ID				N/A
Fold Headrest	Fold or unfold headrest	Seat Fold or unfold						Align with move seat compontent?
Fold Seat	Fold or unfold seat	Seat Fold or unfold						Align with move seat component
Movement & Position - Status / Data
Get Seat Position Per Seat	Get the seat position for the identified seat. This is entire seat position.	seat position	status
Get Seat Component Position Per Seat	Get the seat component position for the identified seat. This is position of the component only.	seat seat component position angle	status
Get Seat Ids / Locations	Provides the list of seats available in "this" Vehicle	none	Array of: seat location (like row1_left, row1_center, etc) Is_Present (true/false)

Seat Movement Illustrations:

A Wiki Front Page > Capabilities Project - Seating Capabilities > image-2024-11-22_9-27-7-1.png (Seat Height or Seat Up/Down)

B Wiki Front Page > Capabilities Project - Seating Capabilities > image-2024-11-22_9-27-14-1.png Seat Forward/Backward

C Wiki Front Page > Capabilities Project - Seating Capabilities > image-2024-11-22_9-27-36-1.png Seat Recline

D Wiki Front Page > Capabilities Project - Seating Capabilities > image-2024-11-22_9-26-53-1.png Cushion Extension

E Wiki Front Page > Capabilities Project - Seating Capabilities > image-2024-11-22_9-27-22-1.png Cushion Tilt

F Wiki Front Page > Capabilities Project - Seating Capabilities > image-2024-11-22_9-28-1-1.png Headrest Height or Headrest Fwd/Backward

Seat Heating and Cooling

Capability	Description	Inputs	Outputs	Dependencies	Assumptions /Constraints	VSS Examples / Mapping	Android Examples / Mapping	Notes
Heating & Cooling - Control
TBD

Seat Heating & Cooling - Status / Data
Get Seat Heating Per Seat	Get the heating mode and level for the identified seat	seat	seat seat temperature mode seat temperature level
Get Seat Component Heating Per Seat	Get the heating mode and level for the identified seat and component	seat seat component	seat seat component seat temperature mode seat temperature level

Seat Massage

Capability	Description	Inputs	Outputs	Dependencies	Assumptions /Constraints	VSS Examples / Mapping	Android Examples / Mapping	Notes
Massage - Control Per Seat
Set Seat Massage Per Seat	Set the massage type and intensity for the identified seat	seat seat massage type massage intensity	status					It will be difficult to agree on massage types / patterns. So added a capability to determine what massage types or patterns are available per set.

Massage - Status / Data Per Seat
Get Seat Massage Per Seat	Get the massage type and intensity for the identified seat	seat	seat massage type massage intensity
Get Massage Status	identifies if massage is on or off for specific set(s)	seat (or all)?	seat massage status
Get Seat Massage Capability	identifies if seats support massage	seat (or all)?	seat massage capability
Get Seat Massage Types (Patterns)	Provides a list of available massage types for a specific seat. May be none.	seat	list of available massage patterns					Need to consider in what format? Bounded array of string values?

Seat Haptics

Capability	Description	Inputs	Outputs	Dependencies	Assumptions /Constraints	VSS Examples / Mapping	Android Examples / Mapping	Notes
Haptics - Control
Activate Haptics	Activate seat haptic notification for driver's seat	seat (driver only) side (left right both) delay between pulses pulses						What is a haptic seat? Where does it fit? Use use case to help define.
Haptics - Status / Data

Seat Occupancy and Safety

Capability	Description	Inputs	Outputs	Dependencies	Assumptions /Constraints	VSS Examples / Mapping	Android Examples / Mapping	Notes
Seat Occupant Safety - Status / Data Per Seat
Get Seat Occupant Safety Per Seat	Get the occupant safety status for the identified seat	seat	seat seat occupancy status seat belt status
Get Child Seat Status	Allows user to determine if a Child Seat is installed	seat	seat Is child Seat Installed

Zonal Architecture for Reference