13.7. Battery Thermal System State Machine - BatThermSysStMac

Id

BatThermSysStMac

Title

Battery Thermal System State Machine

System

Thermal

Document Type

Application Software Component Specification Preview

13.7.1. Overview

The Battery Thermal System State Machine component controls the thermal management of the high voltage battery pack. It monitors battery temperatures and coolant conditions to determine the appropriate thermal state (heating, cooling or passive) and control the battery thermal management actuators accordingly to maintain the battery within the optimal temperature range.

13.7.2. Functions

Title

Description

1

Determine Battery Thermal State

Monitors battery module temperatures and coolant conditions to determine if the battery requires heating, cooling or can remain in a passive state. Transitions between thermal states based on defined temperature thresholds.

2

Control Thermal Actuators

Commands the battery coolant pump, refrigerant compressor, coolant heater, and coolant flow valves based on the current thermal state to provide heating or cooling to the battery as needed.

13.7.3. Ports

Id

Direction

Data Type

Dimensions

Unit

1

BTSCoolantSupplyTemperature

Incoming

single

[-1]

inherit

2

BTSCoolantPressure

Incoming

single

[-1]

inherit

3

LowestAverageMDTemp

Incoming

int16

[-1]

inherit

4

HighestAverageMDTemp

Incoming

int16

[-1]

inherit

5

MetaDCDC1Temperature

Incoming

int16

[-1]

inherit

6

MetaOBCTemperature

Incoming

int16

[-1]

inherit

7

BattPackTHRData

Incoming

Bus: CAN_BattPackTHRData_t

[-1]

inherit

8

BTSCoolantPumpFault

Incoming

boolean

[-1]

inherit

9

CoolingFanFault

Incoming

boolean

[-1]

inherit

10

CoolantValveChillerFault

Incoming

boolean

[-1]

inherit

11

CoolantValveHeaterFault

Incoming

boolean

[-1]

inherit

12

CoolantValveRadiatorFault

Incoming

boolean

[-1]

inherit

13

CoolantValveRadBypFault

Incoming

boolean

[-1]

inherit

14

BTSCoolantPumpDutyCycle

Incoming

uint8

[-1]

inherit

15

ACPressureDischarge

Incoming

single

[-1]

inherit

16

ACPressureSuction

Incoming

single

[-1]

inherit

17

AmbientTemperature

Incoming

single

[-1]

inherit

18

EAC_status

Incoming

Enum: VtSig_Compressor_Status_t

[-1]

inherit

19

HSCoolantPumpCurrent

Incoming

single

[-1]

inherit

20

HSCoolantPumpRequest

Incoming

uint8

[-1]

inherit

21

HeaterCoolantPressure

Incoming

single

[-1]

inherit

22

HVH_Status

Incoming

Enum: VtSig_Heater_Status_t

[-1]

inherit

23

PTC_DiagnosticReq

Incoming

Enum: VtSig_PTC_DiagnosticReq_t

[-1]

inherit

24

HVActSysState

Incoming

Enum: VtSig_HVActSysState_t

[-1]

inherit

25

HVActSysState_valid

Incoming

boolean

[1]

inherit

26

HVChargingState

Incoming

Enum: ActualChargingState_t

[-1]

inherit

27

HVBPCActState

Incoming

Enum: VtSig_HVBPCActState_t

[-1]

inherit

28

HeaterUAct

Incoming

single

[-1]

inherit

29

GearShiftSt

Incoming

Enum: VtSig_GS_Est_State_t

[-1]

inherit

30

Sleep

Incoming

boolean

[-1]

inherit

31

BattPackTHRData_valid

Incoming

boolean

[1]

inherit

32

CoolantTemperatureTarget

Outgoing

single

[-1]

inherit

33

BTS_MalfunctionEvent

Outgoing

Enum: VtSig_BTS_MalfunctionEvent_t

[-1]

inherit

34

BTS_OverheatEvent

Outgoing

boolean

[-1]

inherit

35

BTS_LowCoolantWarningState

Outgoing

boolean

[-1]

inherit

36

BTS_HighPressureWarningState

Outgoing

boolean

[-1]

inherit

37

CoolingCritical

Outgoing

boolean

[-1]

inherit

38

SleepReady

Outgoing

boolean

[-1]

inherit

39

ACLowRefrigerantPressWrng

Outgoing

boolean

[-1]

inherit

40

ACHighRefrigerantPressWrng

Outgoing

boolean

[-1]

inherit

41

HS_LowCoolantWarningState

Outgoing

boolean

[-1]

inherit

42

HS_HighPressureWarningState

Outgoing

boolean

[-1]

inherit

43

BTSSystemState

Outgoing

Enum: VtSig_BTSSystemState_t

[-1]

inherit

44

ACMalfunctionState

Outgoing

boolean

[-1]

inherit

45

HSMalfunctionState

Outgoing

boolean

[-1]

inherit

46

AcRfrPChkOk

Outgoing

boolean

[-1]

inherit

13.7.4. Parameters

Id

Data Type

Dimensions

Range

Unit

Description

1

BtssmAcCmprFltDur

uint16

[1,1]

Min: 0, Max: 3600

sec

The time duration for the the AC compressor feedback signal to report fault status, before flagging an AC fault

2

BtssmCooltPmpDutyMin

uint8

[1,1]

Min: 0, Max: 100

%

The minimum duty cycle of the coolant pump when active

3

BtssmHeatgPmpCurMax

single

[1,1]

Min: 0, Max: 10

A

The maximum current draw expected by the coolant pump whilst active

4

BtssmHeatgPmpCurMin

single

[1,1]

Min: 0, Max: 10

A

The minimum current draw expected by the coolant pump whilst active

5

BtssmHeatgPmpFltDur

uint16

[1,1]

Min: 0, Max: 3600

sec

The minimum time duration with fault conditions true before raising a fault condition for the coolant pump

6

BtssmHvHeatrFltDur

uint16

[1,1]

Min: 0, Max: 3600

sec

The time duration for the HVHeater High voltage check

7

BtssmHvHeatrHiULowrThd

single

[1,1]

Min: 0, Max: 1000

V

Lower Voltage threshold HVHeater High voltage check

8

BtssmHvHeatrHiUUpprThd

single

[1,1]

Min: 0, Max: 1000

V

Upper Voltage threshold HVHeater High voltage check

9

BtssmRfrLoPChkDur

uint16

[1,1]

Min: 0, Max: 3600

sec

The time duration for the low pressure check

10

BtssmRfrLoPChkRstDur

uint16

[1,1]

Min: 0, Max: 3600

sec

The time duration for the low pressure check RESET

11

BtssmRfrLoPFltDur

uint16

[1,1]

Min: 0, Max: 3600

sec

The time duration for the low pressure check, before flagging a low pressure fault

12

BtssmRfrOverPDur

uint16

[1,1]

Min: 0, Max: 3600

sec

The time duration for the high pressure to be detected, before flagging an overpressure fault

13

BtssmRstAllWarn

boolean

[1,1]

Min: 0, Max: 1

Reset all warnings at BTS state machine

14

BtssmSlpTiout

uint16

[1,1]

Min: 0, Max: 3600

sec

Timer to sleep if HVBatteryState and BTSSystemState not active

15

BtssmDewPntMarg

int8

[1,1]

Min: -50, Max: 50

degC

The minimum allowed temperature difference between the coolant and the battery box dewpoint temperature

16

BtssmCooltTHys

single

[1,1]

Min: 0, Max: 10

degC

The amount of hysteresis in coolant temperature to consider for transitioning between passive and cooling states

17

BtssmCooltTTar

single

[1,4]

Min: -50, Max: 100

degC

The coolant supply temperature target

18

BtssmDcdcOverTThd

int16

[1,1]

Min: -50, Max: 150

degC

The temperature of the DCDC that will flag an over-temperature warning

19

BtssmHvbmOverTThd

int16

[1,1]

Min: -50, Max: 150

degC

The temperature of the HVBM that will flag an over-temperature warning

20

BtssmHvbmTAct

single

[1,4]

Min: -50, Max: 100

degC

The HVBM temperature threshold to consider for deciding the coolant supply temperature target

21

BtssmHvbmTCritChrg

int16

[1,1]

Min: -40, Max: 70

degC

HVBM temperature threshold to consider critical for arbitrating compressor noise against battery temperature (whilst the battery is being charged)

22

BtssmHvbmTCritCoolg

int16

[1,1]

Min: -40, Max: 70

degC

The HVBM temperature threshold to consider critical for arbitrating compressor noise against battery temperature (whilst the battery is not being charged)

23

BtssmObcOverTThd

int16

[1,1]

Min: -50, Max: 210

degC

The temperature of the OBC that will flag an over-temperature warning

24

BtssmRfrTBsln

single

[1,4]

Min: -50, Max: 100

degC

The minimum expected pressure in the refrigerant circuit when the AC compressor is switched off, as a function of ambient temperature

25

BtssmTHiLowrLimDft

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Cooling’ to ‘Passive’ thermal state in Default mode

26

BtssmTHiLowrLimChrg

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Cooling’ to ‘Passive’ thermal state in Charging mode

27

BtssmTHiLowrLimPrecdn

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Cooling’ to ‘Passive’ thermal state in Preconditioning mode

28

BtssmTHiUpprLimChrg

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Passive’ to ‘Cooling’ thermal state in Charging mode

29

BtssmTHiUpprLimDft

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Passive’ to ‘Cooling’ thermal state in Default mode

30

BtssmTHiUpprLimPrecdn

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Passive’ to ‘Cooling’ thermal state in Preconditioning mode

31

BtssmTLoLowrLimChrg

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Passive’ to ‘Heating’ thermal state in Charging mode

32

BtssmTLoLowrLimDft

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Passive’ to ‘Heating’ thermal state in Default mode

33

BtssmTLoLowrLimPrecdn

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Passive’ to ‘Heating’ thermal state in Preconditioning mode

34

BtssmTLoUpprLimChrg

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Heating’ to ‘Passive’ thermal state in Charging mode

35

BtssmTLoUpprLimDft

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Heating’ to ‘Passive’ thermal state in Default mode

36

BtssmTLoUpprLimPrecdn

int16

[1,1]

Min: -200, Max: 200

degC

The HVBM temperature in degC to transition from ‘Heating’ to ‘Passive’ thermal state in Preconditioning mode

37

BtssmCooltPHeatrLowrLim

single

[1,1]

Min: -0.6, Max: 2.7

bar

The minimum pressure expected within the Heater coolant circuit when the pump is running

38

BtssmCooltPHeatrUpprLim

single

[1,1]

Min: -0.6, Max: 2.7

bar

The maximum pressure expected within the Heater coolant circuit

39

BtssmCooltPLowrLim

single

[1,1]

Min: -0.6, Max: 2.7

bar

The minimum pressure expected within the battery coolant circuit when the pump is running

40

BtssmCooltPUpprLim

single

[1,1]

Min: -0.6, Max: 2.7

bar

The maximum pressure expected within the battery coolant circuit

41

BtssmRfrOverPThd

single

[1,1]

Min: 0, Max: 100

bar

Refrigerant overpressure threshold

42

BtssmRfrPBsln

single

[1,4]

Min: 0, Max: 100

bar

The minimum expected pressure in the refrigerant circuit when the AC compressor is switched off, as a function of ambient temperature