4.7. Drivetrain System Faults Handling Manager - DtSysFltMgr

• Overview

• Functions

• Ports

• Parameters

• Calibration

Id	DtSysFltMgr
Version	0.3.3.1
Title	Drivetrain System Faults Handling Manager
System	Drivetrain
Document Type	Application Software Component Specification Preview

4.7.1. Overview

The Drivetrain System Fault Manager (DtSysFltMgr) monitors and manages faults related to the vehicle’s drivetrain system. It analyzes various input signals, such as vehicle speed, braking system status, gear selector status, and inverter warnings, etc. to determine the overall fault status and the corresponding reason. Based on the detected faults, the component can request torque limiting or axle shutdown, and provide diagnostic information for further analysis.

4.7.2. Functions

	Title	Description
1	Fault Status Determination	Determines the overall fault status (Normal, Minor, Major, Critical) of the drivetrain system based on the analysis of input signals.
2	Fault Reason Identification	Identifies the specific reason(s) for the detected fault(s), such as vehicle speed, braking system, gear selector, vehicle stability management system, accelerator pedal, high voltage power, inverter warnings, or inverter faults on any or all axles.
3	Torque Limiting Request	Requests torque limiting based on the detected fault status and reasons. The torque limit value is determined based on the fault severity (Major or Critical).
4	Axle Shutdown Request	Requests axle shutdown for individual axles (front or rear) based on the detected inverter faults on those axles.
5	Diagnostic Information	Provides diagnostic information, including the fault status and specific fault reasons, for further analysis and troubleshooting.

The Drivetrain System Fault Manager plays a crucial role in ensuring the safe and reliable operation of the vehicle’s drivetrain system by monitoring and responding to various fault conditions. It helps to mitigate the impact of faults by requesting appropriate actions, such as torque limiting or axle shutdown, and provides diagnostic information to aid in fault diagnosis and resolution.

4.7.3. Ports

	Id	Direction	Data Type	Dimensions	Unit	Description	Keywords
1	Ts	Incoming	single	[1]	sec		Ts
2	VehSpdVld	Incoming	boolean	[1]	inherit	Expected signal: Vehicle speed signal validity If signal is NA: mandatory. True	Vehicle Speed Valid
3	BrkgSysVld	Incoming	boolean	[1]	inherit	Expected signal: Braking system signal validity If signal is NA: mandatory. True	Braking System Valid
4	GearSelrVld	Incoming	boolean	[1]	inherit	Expected signal: Gear selector signal validity If signal is NA: mandatory. True	Gear Selector Valid
5	VsmSysVld	Incoming	boolean	[1]	inherit	Expected signal: Vehicle status signal validity If signal is NA: mandatory. True	Vsm System Valid
6	AccrPedlVld	Incoming	boolean	[1]	inherit	Expected signal: accelerator pedal signal validity If signal is NA: mandatory. True	Accelerator Pedal Valid
7	HvPwrVld	Incoming	boolean	[1]	inherit	Expected signal: Hv power signal validity If signal is NA: mandatory. True	Hv Power Valid
8	InvctlWarnFlg	Incoming	boolean	[1]	inherit	Expected signal: Any inverter warning (feebdack from inverter) If signal is NA: mandatory. True	Invctl Warning Flag
9	InvctlSysVld	Incoming	boolean	[4]	inherit	Expected signal: Inverter control system signal validity If signal is NA: mandatory. True	Invctl System Valid
10	DtfltmngDtLimpModReq	Outgoing	boolean	[1]	inherit		Dtfltmng Drivetrain Limp Mode Request
11	DtfltmngSftyTqLim	Outgoing	single	[1]	N*m		Dtfltmng Safety Torque Limit
12	DtfltmngSt	Outgoing	Enum: CmndrvDtSysFltSt	[1]	inherit		Dtfltmng State
13	DtfltmngDiag	Outgoing	Enum: CmndrvDtSysFltRsn	[4]	inherit		Dtfltmng Diagnosis
14	DtfltmngDtAxleShutDwn	Outgoing	boolean	[2]	inherit		Dtfltmng Drivetrain Axle Shut Down

4.7.4. Parameters

	Id	Data Type	Dimensions	Range	Unit	Description	Keywords
1	DtfltmngFltEffCfg	uint8	[1,9]	Min: 0, Max: 3		Drivetrain System Fault Effects Configuration. Fault Indices: [VehSpd, BrkgSys, GearSelr, Vsm, AccrPedl, HvPwr, InvWarn, InvAnyAxle, InvAllAxles ] Fault Values: [0 - NoEffect, 1 - Minor, 2 - Major, 3 - Critical]	Dtfltmng Fault Efficiency Configuration
2	DtfltmngFltEffDly	single	[1,9]	Min: 0, Max: 60	sec	Drivetrain System Fault Effect Delays. Fault Indices: [VehSpd, BrkgSys, GearSelr, Vsm, AccrPedl, HvPwr, InvWarn, InvAnyAxle, InvAllAxles ]	Dtfltmng Fault Efficiency Delay
3	DtfltmngTqLimFltCrit	single	[1,1]	Min: 0, Max: 10000	N*m	Safety Torque Limit for Critical Fault case	Dtfltmng Torque Limit Fault Critical
4	DtfltmngTqLimFltPrim	single	[1,1]	Min: 0, Max: 10000	N*m	Safety Torque Limit for Major Fault case	Dtfltmng Torque Limit Fault Primary
5	DtfltmngDtAxleId	uint8	[1,2]	Min: 1, Max: 2		Drivetrain System Axle ID vector: 1- Front, 2 - Rear.	Dtfltmng Drivetrain Axle Identifier
6	DtfltmngDtAxleCfg	uint8	[1,4]	Min: 1, Max: 2		Drivetrain System Axle Configuration (Wheel-Axle) for wheels: 1 - FR, 2- FL, 3 - RL, 4 - RR	Dtfltmng Drivetrain Axle Configuration
7	DtfltmngAxleShutDwnDly	single	[1,1]	Min: 0, Max: 60	sec	Drivetrain Axle Shutdown Delay	Dtfltmng Axle Shut Down Delay
8	DtfltmngTqCtlMaxDrvVehTq	single	[1,1]	Min: 0, Max: 10000	N*m	Maximum vehicle drive torque	Dtfltmng Torque Control Maximum Drive Vehicle Torque

4.7.5. Calibration

DtSysFltMgr must be set up according to the drivetrain configuration in order for it to monitor and manage faults related to the drivetrain system.
Based on the detected faults, the component can request torque limits or axle shutdown, and provide diagnostic information for further analysis.

4.7.5.1. Step 1 - Define drivetrain architecture

Set DtfltmngDtAxleCfg and DtfltmngDtAxleId according to the powetrain setup (motor location).
For instance DtfltmngDtAxleId identifies the axle allocation, where Front = 1; Rear = 2;
DtfltmngDtAxleCfg then identifies the motors on the axle, e.g. [1,1,2,2] to identify the configuration for [FR,FL,RR,RL].

4.7.5.2. Step 2 - Provide drivetrain system fault effect delays

Set DtfltmngFltEffDly as the drivetrain system fault effect activation delays. This is the time delay for which a fault must be present before its flag will actually be raised. It is an array with size [1x9] corresponding to the indices below. Default 1 seconds for each index.
Fault Indices: [VehSpd, BrkgSys, GearSelr, Vsm, AccrPedl, HvPwr, InvWarn, InvAnyAxle, InvAllAxles]

4.7.5.3. Step 3 - Provide axle sub-system fault effect delay

Set DtfltmngAxleShutDwnDly as the fault effect delay for axle shutdown. Default 0.2 seconds.
This will provide a delay before the fault flag is actually raised.

4.7.5.4. Step 4 - Provide drivetrain system fault effects configuration.

Specify ```DtfltmngFltEffCfg`` as the impact of the fault` for each of the following indices:
[VehSpd, BrkgSys, GearSelr, Vsm, AccrPedl, HvPwr, InvWarn, InvAnyAxle, InvAllAxles]

Available fault Values:
0 - NoEffect
1 - Minor
2 - Major
3 - Critical

4.7.5.5. Step 4 - Provide limits once faults are detected

Set DtfltmngTqLimFltPrim (Nm) as safety torque limit for major fault case.
Set DtfltmngTqLimFltCrit (Nm) as safety torque limit for critical fault case.
Set the maximum vehicle drive torque DtfltmngTqCtlMaxDrvVehTq(N*m) for no fault detected.

4.7.5.6. Notes

None