9.1. Low Voltage Battery Aggregator - LvBatDaAggrr
Id |
LvBatDaAggrr |
Version |
0.1.0.1 |
Title |
Low Voltage Battery Aggregator |
System |
Low Voltage Power |
Document Type |
Application Software Component Specification Preview |
9.1.1. Overview
The Low Voltage Battery Aggregator component aggregates the low voltage battery measurements from various sources such as BMS, analog sensor, and system software. It performs diagnostics and generates events related to low voltage battery state of charge and voltage levels.
9.1.2. Functions
No. |
Title |
Description |
|---|---|---|
1 |
Aggregate Low Voltage Battery Voltage |
Aggregates the low voltage battery voltage from BMS e, analog sensor measurement, and system software, with configurable priority. |
2 |
Low Voltage Battery Diagnostics |
Performs diagnostics to detect faults in the low voltage battery voltage measurements from different sources. |
3 |
Low Voltage Battery State of Charge |
Monitors the low voltage battery state of charge and generates events when it falls below configurable thresholds. |
4 |
Low Voltage Battery Voltage Events |
Generates low voltage and overvoltage events when the aggregated battery voltage crosses configurable thresholds. |
9.1.3. Ports
Id |
Direction |
Data Type |
Dimensions |
Unit |
Description |
Keywords |
|
|---|---|---|---|---|---|---|---|
1 |
Ts |
Incoming |
single |
[1] |
s |
Sample time |
Ts |
2 |
BatU |
Incoming |
single |
[1] |
V |
Lv Battery voltage |
Battery Voltage |
3 |
BatUVld |
Incoming |
boolean |
[1] |
Validity state of Lv Battery voltage |
Battery Voltage Valid |
|
4 |
BasU |
Incoming |
single |
[1] |
V |
Base Voltage of IO device |
Base Voltage |
5 |
SnsBatSoc |
Incoming |
single |
[1] |
% |
Lv battery State of Charge |
Sense Battery Soc |
6 |
SnsBatSocVld |
Incoming |
boolean |
[1] |
Validity state of Lv Battery State of Charge signal |
Sense Battery Soc Valid |
|
7 |
SnsBatSocValSt |
Incoming |
Enum: CmnenaQly |
[1] |
State of Lv Battery State of Charge signal |
Sense Battery Soc Value State |
|
8 |
BmsFlt |
Incoming |
boolean |
[1] |
Bms fault |
Bms Fault |
|
9 |
BmsFltVld |
Incoming |
boolean |
[1] |
Validity state of Bms Fault signal |
Bms Fault Valid |
|
10 |
BatUSt |
Incoming |
Enum: CmnenaQly |
[1] |
State of Battery volatge signal |
Battery Voltage State |
|
11 |
SnsBatU |
Incoming |
single |
[1] |
V |
Voltage measurement of analog sensor pin |
Sense Battery Voltage |
12 |
SnsBatUSt |
Incoming |
Enum: CmnenaPinSt |
[1] |
State of analog sensor volatge pin |
Sense Battery Voltage State |
|
13 |
Diagc |
Outgoing |
Bus: AggbatdaDiagc |
[-1] |
Diagnostic |
||
14 |
AnFlt |
Outgoing |
boolean |
[1] |
Analog measurement fault |
Analog Fault |
|
15 |
BatLoUEve |
Outgoing |
Enum: CmnenaAcvnSt |
[1] |
Battery Low Voltage event |
Battery Low Voltage Event |
|
16 |
BatOverUEve |
Outgoing |
Enum: CmnenaAcvnSt |
[1] |
Battery Over Voltage Event |
||
17 |
BatUOut |
Outgoing |
single |
[1] |
Aggregated Lv voltage |
Battery Voltage Output |
|
18 |
LvBmsFlt |
Outgoing |
boolean |
[1] |
Lv Bms Fault |
Lv Bms Fault |
|
19 |
BatSocLo |
Outgoing |
Enum: CmnenaEveNotifSt |
[1] |
Lv Battery Low State of Charge event |
Battery Soc Low |
|
20 |
LvAlertFlatBat |
Outgoing |
Enum: CmnenaEveNotifSt |
[1] |
Flat Lv Battery Event |
Lv Alert Flat Battery |
|
21 |
SnsBatUMod |
Outgoing |
Enum: CmnenaPinMod |
[1] |
Configure Mode of analog sensor volatge pin |
Sense Battery Voltage Mode |
9.1.4. Parameters
Id |
Data Type |
Dimensions |
Range |
Unit |
Description |
Keywords |
|
|---|---|---|---|---|---|---|---|
1 |
AggbatdaBat1LoSocHealThd |
single |
[1,1] |
Min: 0, Max: 100 |
% |
Threshold for unsetting a low SOC event |
Aggbatda Battery1 Low Soc Heal Threshold |
2 |
AggbatdaBat1LoSocHealTmr |
single |
[1,1] |
Min: 0, Max: 7200 |
s |
Time required to confirm unsetting a low SOC event |
Aggbatda Battery1 Low Soc Heal Timer |
3 |
AggbatdaBatCritLoSoc |
single |
[1,1] |
Min: 0, Max: 125 |
% |
Critical LV battery Low SoC event threshold |
Aggbatda Battery Critical Low Soc |
4 |
AggbatdaBatLoSoc |
single |
[1,1] |
Min: 0, Max: 125 |
% |
LV battery Low SoC event threshold |
Aggbatda Battery Low Soc |
5 |
AggbatdaBatLoUHealThd |
single |
[1,1] |
Min: 0, Max: 31 |
V |
LV battery low voltage event healing threshold |
Aggbatda Battery Low Voltage Heal Threshold |
6 |
AggbatdaBatLoUThd1 |
single |
[1,1] |
Min: 0, Max: 31 |
V |
LV battery Low Voltage event threshold |
Aggbatda Battery Low Voltage Threshold1 |
7 |
AggbatdaBatLoUThd2 |
single |
[1,1] |
Min: 0, Max: 31 |
V |
LV battery Low Voltage event threshold |
Aggbatda Battery Low Voltage Threshold2 |
8 |
AggbatdaBatUNotAvlTmr |
single |
[1,1] |
Min: 0, Max: 7200 |
s |
LV battery low voltage NA event timeout |
Aggbatda Battery Voltage Not Available Timer |
9 |
AggbatdaComLossPerd |
single |
[1,1] |
Min: 0, Max: 7200 |
s |
Communication loss detection time period |
Aggbatda Communication Loss Period |
10 |
AggbatdaDftBatU |
single |
[1,1] |
Min: 0, Max: 31 |
V |
LV Battery voltage to be used in the event of all voltage measurement methods failing |
Aggbatda Default Battery Voltage |
11 |
AggbatdaDifAnToDcuThd |
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 |
Aggbatda Difference Analog To Dcu Threshold |
12 |
AggbatdaIgnAnFlt |
boolean |
[1,1] |
Min: 0, Max: 1 |
Ignore analogue fault of battery |
Aggbatda Ignore Analog Fault |
|
13 |
AggbatdaIgnFlt |
boolean |
[1,1] |
Min: 0, Max: 1 |
Ignore analogue fault of battery |
Aggbatda Ignore Fault |
|
14 |
AggbatdaIgnLoSoc |
boolean |
[1,1] |
Min: 0, Max: 1 |
Ignore low SoC fault of battery |
Aggbatda Ignore Low Soc |
|
15 |
AggbatdaLoSocTiout |
single |
[1,1] |
Min: 0, Max: 7200 |
s |
LV battery Low SoC event detection timeout |
Aggbatda Low Soc Timeout |
16 |
AggbatdaMaxUDifBmsToDcu |
single |
[1,1] |
Min: 0, Max: 31 |
V |
Maximal expected difference between the voltage readings of the BMS measurement and DCU supply voltage measurement |
Aggbatda Maximum Voltage Difference Bms To Dcu |
17 |
AggbatdaMaxUDifDcuToBms |
single |
[1,1] |
Min: 0, Max: 31 |
V |
Maximal expected difference between the voltage readings of the DCU supply voltage measurement and BMS measurement |
Aggbatda Maximum Voltage Difference Dcu To Bms |
18 |
AggbatdaUseAnU |
boolean |
[1,1] |
Min: 0, Max: 1 |
Use anaolgue voltage for battery |
Aggbatda Use Analog Voltage |
|
19 |
AggbatdaBatOverUHealThd |
single |
[1,1] |
Min: 0, Max: 31 |
V |
LV battery overvoltage event healing threshold |
Aggbatda Battery Over Voltage Heal Threshold |
20 |
AggbatdaBatOverUThd |
single |
[1,1] |
Min: 0, Max: 50 |
V |
LV battery overvoltage event threshold |
Aggbatda Battery Over Voltage Threshold |
21 |
AggbatdaLoBatU |
single |
[1,1] |
Min: 0, Max: 31 |
V |
LV battery flat battery event threshold that can cause VSM to go to sleep |
Aggbatda Low Battery Voltage |
22 |
AggbatdaUOfsAnToBms |
single |
[1,1] |
Min: 0, Max: 31 |
V |
Offset to be added to DCU analog voltage measurement to estimate battery voltage |
Aggbatda Voltage Offset Analog To Bms |
23 |
AggbatdaSysSwBatUVId |
boolean |
[1,1] |
Min: 0, Max: 1 |
Set if the system software voltage measurement is valid or not |
Aggbatda System Software Battery Voltage Velocity Identifier |
|
24 |
AggbatdaUFltDlyTmr1 |
single |
[1,1] |
Min: 0, Max: 7200 |
s |
Time 1 when the difference between measurement voltage value should attend, to avoid false fault detection |
Aggbatda Voltage Fault Delay Timer1 |
25 |
AggbatdaUFltDlyTmr2 |
single |
[1,1] |
Min: 0, Max: 7200 |
s |
Time 2 when the difference between measurement voltage value should attend, to avoid false fault detection |
Aggbatda Voltage Fault Delay Timer2 |
26 |
AggbatdaUFltHealTmr |
single |
[1,1] |
Min: 0, Max: 7200 |
s |
Monitoring time of the voltage for fault clearance |
Aggbatda Voltage Fault Heal Timer |
27 |
AggbatdaDifAnToBmsThd |
single |
[1,1] |
Min: 0, Max: 31 |
V |
Maximal expected difference between the voltage readings of the LV BMS and analog DCU measurement |
Aggbatda Difference Analog To Bms Threshold |