9.3. Low Voltage Checks Driver - LvChk

Id

LvChk

Version

0.3.2.0

Title

Low Voltage Checks Driver

System

Low Voltage Power

Document Type

Application Software Component Specification Preview

9.3.1. Overview

The Low Voltage Checks Driver (LvChk) monitors the low voltage battery state of charge and voltage levels. It detects low state of charge, low voltage, and overvoltage conditions. The component also checks for faults in the battery management system (BMS), analog measurements, and communication.

9.3.2. Functions

Title

Description

1

Battery State of Charge Monitoring

Monitors the battery state of charge and sets corresponding status flags for low and critically low state of charge conditions.

2

Battery Voltage Monitoring

Monitors the battery voltage and sets status flags for low voltage and overvoltage events.

3

Battery Measurement Fault Detection

Detects faults in the battery voltage measurements from the BMS, analog sensors, and communication interfaces. Sets corresponding fault flags.

9.3.3. Ports

Id

Direction

Data Type

Dimensions

Unit

Description

Keywords

1

BatU

Incoming

single

[1]

V

Battery Voltage

2

BatUVld

Incoming

boolean

[1]

Battery Voltage Valid

3

SnsLvBusU

Incoming

single

[1]

Sense Lv Bus Voltage

4

SnsLvBusMeasmFlt

Incoming

boolean

[1]

Sense Lv Bus Measurement Fault

5

SnsLvBusUVld

Incoming

boolean

[1]

Sense Lv Bus Voltage Valid

6

BasU

Incoming

single

[1]

V

Base Voltage

7

SnsBatSoc

Incoming

single

[1]

%

Sense Battery Soc

8

SnsBatSocVld

Incoming

boolean

[1]

Sense Battery Soc Valid

9

SnsBatSocValSt

Incoming

Enum: CmnenaQly

[1]

Sense Battery Soc Value State

10

BmsFlt

Incoming

boolean

[1]

Bms Fault

11

BmsFltVld

Incoming

boolean

[1]

Bms Fault Valid

12

BatUSt

Incoming

Enum: CmnenaQly

[1]

Battery Voltage State

13

Diagc

Outgoing

Bus: LvchkDiagc

[3]

Diagnostic

14

AnFlt

Outgoing

boolean

[1]

Analog Fault

15

BatLoUEve

Outgoing

Enum: CmnenaAcvnSt

[1]

Battery Low Voltage Event

16

BatOverUEve

Outgoing

Enum: CmnenaAcvnSt

[1]

Battery Over Voltage Event

17

BatU1

Outgoing

single

[1]

V

Battery Voltage

18

LvBmsFlt1

Outgoing

boolean

[1]

Lv Bms Fault

19

BatSocLo

Outgoing

Enum: CmnenaEveNotifSt

[1]

Battery Soc Low

20

LvAlertFlatBat

Outgoing

Enum: CmnenaEveNotifSt

[1]

Lv Alert Flat Battery

9.3.4. Parameters

Id

Data Type

Dimensions

Range

Unit

Description

Keywords

1

LvchkBat1LoSocHealThd

single

[1,1]

Min: 0, Max: 100

%

Threshold for unsetting a low SOC event

Lvchk Battery1 Low Soc Heal Threshold

2

LvchkBat1LoSocHealTmr

single

[1,1]

Min: 0, Max: 7200

s

Time required to confirm unsetting a low SOC event

Lvchk Battery1 Low Soc Heal Timer

3

LvchkBatCritLoSoc

single

[1,1]

Min: 0, Max: 125

%

Critical LV battery Low SoC event threshold

Lvchk Battery Critical Low Soc

4

LvchkBatLoSoc

single

[1,1]

Min: 0, Max: 125

%

LV battery Low SoC event threshold

Lvchk Battery Low Soc

5

LvchkBatLoUHealThd

single

[1,1]

Min: 0, Max: 31

V

LV battery low voltage event healing threshold

Lvchk Battery Low Voltage Heal Threshold

6

LvchkBatLoUThd1

single

[1,1]

Min: 0, Max: 31

V

LV battery Low Voltage event threshold

Lvchk Battery Low Voltage Threshold1

7

LvchkBatLoUThd2

single

[1,1]

Min: 0, Max: 31

V

LV battery Low Voltage event threshold

Lvchk Battery Low Voltage Threshold2

8

LvchkBatUNotAvlTmr

single

[1,1]

Min: 0, Max: 7200

s

LV battery low voltage NA event timeout

Lvchk Battery Voltage Not Available Timer

9

LvchkComLossPerd

single

[1,1]

Min: 0, Max: 7200

s

Communication loss detection time period

Lvchk Communication Loss Period

10

LvchkDftBatU

single

[1,1]

Min: 0, Max: 31

V

LV Battery voltage to be used in the event of all voltage measurement methods failing

Lvchk Default Battery Voltage

11

LvchkDifAnToDcuThd

single

[1,1]

Min: 0, Max: 31

V

Maximal expected difference between the voltage readings of the DCU supply voltage and the analog DCU measurement on the primary LV powernet

Lvchk Difference Analog To Dcu Threshold

12

LvchkIgnAnFlt

boolean

[1,1]

Min: 0, Max: 1

Ignore analogue fault of battery

Lvchk Ignore Analog Fault

13

LvchkIgnFlt

boolean

[1,1]

Min: 0, Max: 1

Ignore analogue fault of battery

Lvchk Ignore Fault

14

LvchkIgnLoSoc

boolean

[1,1]

Min: 0, Max: 1

Ignore low SoC fault of battery

Lvchk Ignore Low Soc

15

LvchkLoSocTiout

single

[1,1]

Min: 0, Max: 7200

s

LV battery Low SoC event detection timeout

Lvchk Low Soc Timeout

16

LvchkMaxUDifBmsToDcu

single

[1,1]

Min: 0, Max: 31

V

Maximal expected difference between the voltage readings of the BMS measurement and DCU supply voltage measurement

Lvchk Maximum Voltage Difference Bms To Dcu

17

LvchkMaxUDifDcuToBms

single

[1,1]

Min: 0, Max: 31

V

Maximal expected difference between the voltage readings of the DCU supply voltage measurement and BMS measurement

Lvchk Maximum Voltage Difference Dcu To Bms

18

LvchkSysSwBatUVld

boolean

[1,1]

Min: 0, Max: 1

Set if the system software voltage measurement is valid or not

Lvchk System Software Battery Voltage Valid

19

LvchkUFltDlyTmr1

single

[1,1]

Min: 0, Max: 7200

s

Time 1 when the difference between measurement voltage value should attend, to avoid false fault detection

Lvchk Voltage Fault Delay Timer1

20

LvchkUFltDlyTmr2

single

[1,1]

Min: 0, Max: 7200

s

Time 2 when the difference between measurement voltage value should attend, to avoid false fault detection

Lvchk Voltage Fault Delay Timer2

21

LvchkUFltHealTmr

single

[1,1]

Min: 0, Max: 7200

s

Monitoring time of the voltage for fault clearance

Lvchk Voltage Fault Heal Timer

22

LvchkUseAnU

boolean

[1,1]

Min: 0, Max: 1

Use anaolgue voltage for battery

Lvchk Use Analog Voltage

23

LvchkBatOverUHealThd

single

[1,1]

Min: 0, Max: 31

V

LV battery overvoltage event healing threshold

Lvchk Battery Over Voltage Heal Threshold

24

LvchkBatOverUThd

single

[1,1]

Min: 0, Max: 50

V

LV battery overvoltage event threshold

Lvchk Battery Over Voltage Threshold

25

LvchkLoBatU

single

[1,1]

Min: 0, Max: 31

V

LV battery flat battery event threshold that can cause VSM to go to sleep

Lvchk Low Battery Voltage

26

LvchkDifAnToBmsThd

single

[1,1]

Min: 0, Max: 31

V

Maximal expected difference between the voltage readings of the LV BMS and analog DCU measurement

Lvchk Difference Analog To Bms Threshold

27

LvchkUOfsAnToBms

single

[1,1]

Min: 0, Max: 31

V

Offset to be added to DCU analog voltage measurement to estimate battery voltage

Lvchk Voltage Offset Analog To Bms