13.5. Battery Thermal System Coolant Pump Control - BatThermSysCooltPmpCtl
Id |
BatThermSysCooltPmpCtl |
Title |
Battery Thermal System Coolant Pump Control |
System |
Thermal |
Document Type |
Application Software Component Specification Preview |
13.5.1. Overview
The Battery Thermal System Coolant Pump Control component controls the battery coolant pump to regulate the battery temperature. It determines the target pump duty cycle based on battery temperatures and other factors. The component also handles pump fault detection and manages pump speed changes.
13.5.2. Functions
Title |
Description |
|
|---|---|---|
1 |
Determine Target Coolant Pump Duty Cycle |
Determines the target duty cycle for the battery coolant pump based on the battery coolant temperature, maximum cell temperature, and cell temperature delta, using lookup tables. |
2 |
Manage Coolant Pump Duty Cycle |
Manages increasing or decreasing the coolant pump duty cycle at a controlled rate of change. Enforces minimum and maximum duty cycle limits. |
3 |
Detect Coolant Pump Faults |
Detects faults with the coolant pump operation based on pump current draw. Requires the fault condition to persist for a calibrated time before setting the fault state. |
4 |
Control Pump for Cooling Fill Procedure |
Runs the pump at calibrated duty cycles and durations for the multi-stage cooling loop filling procedure. |
5 |
Respond to Overheating Event |
Runs pump at a calibrated elevated duty cycle when an overheating event is detected in the battery. |
13.5.3. Ports
Id |
Direction |
Data Type |
Dimensions |
Unit |
|
|---|---|---|---|---|---|
1 |
BatOvrheatgEve |
Incoming |
boolean |
[-1] |
inherit |
2 |
BTSSystemState |
Incoming |
Enum: VtSig_BTSSystemState_t |
[-1] |
inherit |
3 |
BatCooltT |
Incoming |
single |
[-1] |
inherit |
4 |
LowestAverageMDTemp |
Incoming |
int16 |
[-1] |
inherit |
5 |
HighestAverageMDTemp |
Incoming |
int16 |
[-1] |
inherit |
6 |
CCI_ActualChargingState |
Incoming |
Enum: ActualChargingState_t |
[-1] |
inherit |
7 |
PTC_DiagnosticState |
Incoming |
Enum: VtSig_PTC_DiagnosticState_t |
[-1] |
inherit |
8 |
PmpCurAct |
Incoming |
single |
[-1] |
inherit |
9 |
PmpSpdReq |
Outgoing |
uint8 |
[-1] |
inherit |
10 |
PmpFlt |
Outgoing |
boolean |
[-1] |
inherit |
13.5.4. Parameters
Id |
Data Type |
Dimensions |
Range |
Unit |
Description |
|
|---|---|---|---|---|---|---|
1 |
BtscpcCoolgFillgPrcdrStep1PmpSpdReq |
single |
[1,1] |
Min: 0, Max: 100 |
% |
Battery pump duty cycle during stage 1 of the cooling fill routine |
2 |
BtscpcCoolgFillgPrcdrStep1TiDur |
uint16 |
[1,1] |
Min: 0, Max: 1000 |
s |
Time duration of stage 1 of the cooling fill routine |
3 |
BtscpcCoolgFillgPrcdrStep2PmpSpdReq |
single |
[1,1] |
Min: 0, Max: 100 |
% |
Battery pump duty cycle during stage 2 of the cooling fill routine |
4 |
BtscpcCoolgFillgPrcdrStep2TiDur |
uint16 |
[1,1] |
Min: 0, Max: 1000 |
s |
Time duration of stage 2 of the cooling fill routine |
5 |
BtscpcCoolgFillgPrcdrStep3PmpSpdReq |
single |
[1,1] |
Min: 0, Max: 100 |
% |
Battery pump duty cycle during stage 3 of the cooling fill routine |
6 |
BtscpcCoolgFillgPrcdrStep3TiDur |
uint16 |
[1,1] |
Min: 0, Max: 1000 |
s |
Time duration of stage 3 of the cooling fill routine |
7 |
BtscpcCoolgFillgPrcdrStep4PmpSpdReq |
single |
[1,1] |
Min: 0, Max: 100 |
% |
Battery pump duty cycle during stage 4 of the cooling fill routine |
8 |
BtscpcCoolgPrcdrTopUpPmpSpdReq |
single |
[1,1] |
Min: 0, Max: 100 |
% |
Battery pump duty cycle during the coolant top-up routine |
9 |
BtscpcCooltPmpSpdTblBatCooltTAxis |
single |
[1,6] |
Min: , Max: |
degC |
target coolant pump duty cycle as a function of the battery coolant temperature, breakpoints |
10 |
BtscpcCooltPmpSpdTblCellDeltaTAxis |
single |
[1,6] |
Min: , Max: |
degC |
target coolant pump duty cycle as a function of the HVBM delta temperature, breakpoints |
11 |
BtscpcCooltPmpSpdTblCellTMaxAxis |
single |
[1,8] |
Min: , Max: |
degC |
target coolant pump duty cycle as a function of the HVBM max temperature, breakpoints |
12 |
BtscpcCooltPmpSpdTblReq1Axis |
single |
[1,8] |
Min: , Max: |
% |
target coolant pump duty cycle as a function of the HVBM max temperature, values |
13 |
BtscpcCooltPmpSpdTblReq2Axis |
single |
[1,6] |
Min: , Max: |
% |
target coolant pump duty cycle as a function of the HVBM delta temperature, values |
14 |
BtscpcCooltPmpSpdTblReq3Axis |
single |
[1,6] |
Min: , Max: |
% |
target coolant pump duty cycle as a function of the battery coolant temperature, values |
15 |
BtscpcOvrheatgDetdPmpSpdReq |
single |
[1,1] |
Min: 0, Max: 100 |
% |
Target coolant pump duty cycle when an overheating event is detected |
16 |
BtscpcPmpAMaxForSpdDec |
single |
[1,1] |
Min: -100, Max: -1 |
%/s |
Minimum permitted rate of change in %/s when decreasing the coolant pump duty cycle |
17 |
BtscpcPmpAMaxForSpdInc |
single |
[1,1] |
Min: 1, Max: 100 |
%/s |
Maximum permitted rate of change in %/s when increasing the coolant pump duty cycle |
18 |
BtscpcPmpCurMax |
single |
[1,1] |
Min: 0, Max: 30 |
A |
Maximum current draw expected by the coolant pump in continuous operation |
19 |
BtscpcPmpCurMin |
single |
[1,1] |
Min: 0, Max: 30 |
A |
Minimum current draw expected by the coolant pump whilst active |
20 |
BtscpcPmpFltDetnTi |
single |
[1,1] |
Min: 0, Max: 10 |
s |
Minimum time duration with fault conditions true before raising a fault condition for the coolant pump |
21 |
BtscpcPmpSpdReqMax |
single |
[1,1] |
Min: 0, Max: 100 |
% |
Maximum permitted coolant pump duty cycle |
22 |
BtscpcPmpSpdReqMin |
single |
[1,1] |
Min: 0, Max: 100 |
% |
Minimum permitted coolant pump duty cycle |
23 |
BtscpcRstPmpFlt |
boolean |
[1,1] |
Min: 0, Max: 1 |
Reset Battery pump faults |