16.5. Vehicle State Machine Adapter - VsmAdpr

• Overview

• Functions

• Ports

• Parameters

Id	VsmAdpr
Version	main
Title	Vehicle State Machine Adapter
System	Vehicle State
Document Type	Application Software Component Specification Preview

16.5.1. Overview

The Vehicle State Machine Adapter (VsmAdpr) is a software component responsible for adapting the vehicle state information and providing it to other components in the system. It processes inputs from various vehicle systems and determines the appropriate vehicle state based on the defined logic and conditions.

16.5.2. Functions

	Title	Description
1	Determine Vehicle State	Processes inputs from gear selector, doors, charging system, and other relevant components to determine the current vehicle state (Ready, Idle, Sleep, etc.).
2	Provide Allowed Gear States	Determines the allowed gear states based on the current vehicle state and conditions. Outputs the allowed gear states to the gear selector control.
3	Manage Gear Shift Inhibits	Generates gear shift inhibit signals based on various conditions such as open doors, extended ramp, connected charging plug, etc. Outputs the inhibit signals to restrict gear shifting under certain conditions.
4	Process Wake-up Commands	Handles wake-up commands from various sources (doors, charging system, user inputs, etc.) and triggers the appropriate state transitions in the Vehicle State Machine.
5	Manage Diagnostics	Activates and deactivates diagnostic trouble codes (DTCs) based on the detected faults or abnormal conditions related to the vehicle state and gear shifting.

16.5.3. Ports

	Id	Direction	Data Type	Dimensions	Unit	Description	Keywords
1	VsmActSt	Incoming	Enum: CmnenaVehSt	[1]			Vsm Actual State
2	GearShiftPosnAct	Incoming	Enum: CmnenaGearSt	[1]			Gear Shift Position Actual
3	GearShiftDmd	Incoming	Enum: CmnenaGearSt	[1]			Gear Shift Demand
4	AnyDoorOpen	Incoming	boolean	[1]			Any Door Open
5	RampOpen	Incoming	boolean	[1]			Ramp Open
6	VehSpd	Incoming	single	[1]	kmh		Vehicle Speed
7	VehSpdVld	Incoming	boolean	[1]			Vehicle Speed Valid
8	ChrgPlugCond	Incoming	boolean	[1]			Charging Plug Connected
9	GearShiftReq	Incoming	Enum: CmnenaGearSt	[1]			Gear Shift Request
10	GearShiftReqVld	Incoming	boolean	[1]			Gear Shift Request Valid
11	DoorOpenSt	Incoming	Enum: CmnenaClsrSt	[1]			Door Open State
12	DoorOpenStVld	Incoming	boolean	[1]			Door Open State Valid
13	BnntLtchSts	Incoming	Enum: CmnenaClsrSt	[1]			Bonnet Latch Status
14	BnntVld	Incoming	boolean	[1]			Bonnet Valid
15	BootLtchSts	Incoming	Enum: CmnenaClsrSt	[1]			Boot Latch Status
16	BootSts	Incoming	boolean	[1]			Boot Status
17	DrvHndlNfcPairSts	Incoming	boolean	[1]			Drive Handle Nfc Pair Status
18	DrvHndlTchSts	Incoming	Enum: CmnenaAcvnSt	[1]			Drive Handle Touch Status
19	DrvDoorIntOpenSwSts	Incoming	Enum: CmnenaAcvnSt	[1]			Drive Door Internal Open Software Status
20	DrvHndlVld	Incoming	boolean	[1]			Drive Handle Valid
21	PasHndlTchSts	Incoming	Enum: CmnenaAcvnSt	[1]			Passive Handle Touch Status
22	PassDoorIntOpenSwSts	Incoming	Enum: CmnenaAcvnSt	[1]			Passenger Door Internal Open Software Status
23	PasHndlVld	Incoming	boolean	[1]			Passive Handle Valid
24	AcDcPortHtchSt	Incoming	Enum: CmnenaClsrSt	[1]			Ac Dc Port Hatch State
25	ChPortVld	Incoming	boolean	[1]			Charge Port Valid
26	DrvWinCmd	Incoming	Enum: CmnenaClsrSt	[1]			Drive Window Command
27	DrvWinCmdVld	Incoming	boolean	[1]			Drive Window Command Valid
28	PasWinCmd	Incoming	Enum: CmnenaClsrSt	[1]			Passive Window Command
29	PasWinCmdVld	Incoming	boolean	[1]			Passive Window Command Valid
30	SteerWhlAg	Incoming	single	[1]	rad		Steering Wheel Angle
31	SteerWhlAgValSt	Incoming	Enum: CmnenaEveNotifSt	[1]			Steering Wheel Angle Value State
32	IsBreakPedalPushed	Incoming	boolean	[1]			Is Break Pedal Pushed
33	KeyRng	Incoming	Enum: CnloktlKeyRng	[1]			Key Range
34	KeyRngVld	Incoming	boolean	[1]			Key Range Valid
35	BatThermSysSysSt	Incoming	Enum: CmnenaThermSysSt	[1]			Battery Thermal System System State
36	PtcSysSt	Incoming	Enum: CmnenaPtCoolgSysSt	[1]			Ptc System State
37	BrkgPedlPosnSt	Incoming	boolean	[1]			Braking Pedal Position State
38	HzrdStInp	Incoming	Enum: CmnenaAcvnSt	[1]			Hazard State Input
39	AlrmIsTrigd	Incoming	Enum: CmnenaAcvnSt	[1]			Alarm Is Triggered
40	LvTopUpReq	Incoming	boolean	[1]			Lv Top Up Request
41	LvSysChrg	Incoming	boolean	[1]			Lv System Charging
42	LvAlertFlatBat	Incoming	Enum: CmnenaEveNotifSt	[1]			Lv Alert Flat Battery
43	DrvrSeatOccpd	Incoming	Enum: CmnenaAcvnSt	[1]			Driver Seat Occupied
44	PassSeatOccpd	Incoming	Enum: CmnenaAcvnSt	[1]			Passenger Seat Occupied
45	VsmAllwdSt	Outgoing	boolean	[1,6]			Vsm Allowed State
46	VsmPtnlSt	Outgoing	Enum: CmnenaGearSt	[1]			Vsm Potential State
47	GearShiftSt	Outgoing	Enum: CmnenaGearSt	[1]			Gear Shift State
48	GearShiftStVld	Outgoing	boolean	[1]			Gear Shift State Valid
49	Ig	Outgoing	boolean	[1]			Ignition
50	GearShiftPosnAcv	Outgoing	boolean	[1]			Gear Shift Position Active
51	GearShiftProhtd	Outgoing	boolean	[1]			Gear Shift Prohibited
52	ClsrIsChgd	Outgoing	boolean	[1]			Closure Is Changed
53	WakeVsmCmd	Outgoing	boolean	[1]			Wake Vsm Command
54	ThermCdnReq	Outgoing	boolean	[1]			Thermal Condition Request
55	BrkPedlVld	Outgoing	boolean	[1]			Brake Pedal Valid
56	HzrdReqOut	Outgoing	boolean	[1]			Hazard Request Output
57	ThermRdyToDrvAcv	Outgoing	boolean	[1]			Thermal Ready To Drive Active
58	AlrmAcv	Outgoing	boolean	[1]			Alarm Active
59	LvTopUpReqRqrd	Outgoing	boolean	[1]			Lv Top Up Request Required
60	LvSysChrgChrg	Outgoing	boolean	[1]			Lv System Charging Charging
61	LvAlertLoBatAlert	Outgoing	boolean	[1]			Lv Alert Low Battery Alert
62	SeatOccpd	Outgoing	boolean	[1]			Seat Occupied
63	Diagc	Outgoing	Bus: VsmadpDiagc	[-1]			Diagnostic

16.5.4. Parameters

	Id	Data Type	Dimensions	Range	Unit	Description	Keywords
1	VsmadpAutoParkDoorOpenCdnEna	boolean	[1,1]	Min: 0, Max: 1		Enable automatic Park engagement on Door Open Condition (continuous)	Vsmadp Auto Park Door Open Condition Enable
2	VsmadpAutoParkDoorOpenEveEna	boolean	[1,1]	Min: 0, Max: 1		Enable automatic Park engagement on Door Open Event (Door changed to Open)	Vsmadp Auto Park Door Open Event Enable
3	VsmadpChrgPlugInhEna	boolean	[1,1]	Min: 0, Max: 1		Enable Drive/Reverse Restriction for Charging Plug condition	Vsmadp Charging Plug Inhibition Enable
4	VsmadpChrgPlugNeutAllwdEna	boolean	[1,1]	Min: 0, Max: 1		1 - Enable N gear selection during charging, 0 - Allow only P gear during charging	Vsmadp Charging Plug Neutral Allowed Enable
5	VsmadpDoorOpenInhEna	boolean	[1,1]	Min: 0, Max: 1		Enable Drive/Reverse Restriction (Inhibit) for Door Open condition	Vsmadp Door Open Inhibition Enable
6	VsmadpDoorOpenWarnEna	boolean	[1,1]	Min: 0, Max: 1		Enable diagnostic for HMI warning on Door Open condition	Vsmadp Door Open Warning Enable
7	VsmadpNotAvlStAllwd	boolean	[1,1]	Min: 0, Max: 1		1 - if VSM == NA then VSM suggest Neutral_NoAction and allow Neutral, else if VSM == NA then VSM suggest Park and deny Neutral	Vsmadp Not Available State Allowed
8	VsmadpGearShiftRstTiout	single	[1,1]	Min: 0, Max: 60	sec	VSM Gear Inbinited Diagnostics reset timeout	Vsmadp Gear Shift Reset Timeout
9	VsmadpRampExtdInhEna	boolean	[1,1]	Min: 0, Max: 1		Enable Drive/Reverse Restriction (Inhibit) for Ramp Extended condition	Vsmadp Ramp Extended Inhibition Enable
10	VsmadpVehSpdCompThd	single	[1,1]	Min: 0, Max: 5	km/h	Vehicle Speed Zero comparison Threshold	Vsmadp Vehicle Speed Comparison Threshold