Wiki source code of 3.6 Battery protection

Version 41.1 by Admin on 2025/01/10 09:49

version	line-number	content
38.1	1	(% data-numbered-headings-start="3" style="--numbered-headings-start: 2;font-size: 0px;color: rgba(0, 0, 0, 0.0);margin-bottom: 0px; margin-top: 0px;" %)
	2	= Configuration =
	3
	4	(% data-numbered-headings-start="6" style="--numbered-headings-start: 5;font-size: 0px;color: rgba(0, 0, 0, 0.0);margin-bottom: 0px; margin-top: 0px;" %)
	5	== Battery protection ==
	6
1.1	7	The BMS Main 2.x board continuously monitors the state of the cells, BMS Logic boards, the external environment and, when detecting abnormalities, protects the battery and system components from damage.
	8
38.1	9	=== Overcurrent protection ===
1.1	10
	11	To change the current protection of the battery, select the menu "Protections → Overcurrent protection":
2.2	12
37.1	13	[[image:1732211959984-118.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="266" width="386"]]
2.3	14
4.13	15	In this section:
2.3	16
	17	* Enable – a flag to enable the protection;
	18	* Maximum charging current, А;
	19	* Tolerant charging current, А;
	20	* Maximum discharging current, А;
	21	* Tolerant discharging current, А;
	22	* Delay before setting the error, second;
	23	* Delay before clearing the error, second;
	24	* Lock the error until the device is reset – a flag to block the error until the board is restarted.
	25
	26	As a result of operation of the current protection, the "Overcurrent" error is generated.
	27
	28	Error generation conditions:
	29
	30	* the current is positive (charging), and its modulo value is greater than the “Maximum charging current” value for the “Delay before setting the error” time;
	31	* the current is negative (discharging), and its modulo value is greater than the “Maximum discharging current” value for the “Delay before setting the error” time.
	32
	33	Conditions for removing the error:
	34
	35	* the current is positive (charging) or zero, and its modulo value is less than the “Tolerant charging current” value for the “Delay before clearing the error” time;
	36	* the current is negative (discharging), and its modulo value is less than the “Tolerant discharging current” value for the “Delay before clearing the error” time.
	37
	38	(% class="box infomessage" %)
	39	(((
33.3	40	If there is the "Overcurrent" error, the charging and discharging relay open.
2.3	41	)))
3.2	42
38.1	43	=== Undervoltage protection ===
3.2	44
	45	The board implements battery protection from too low or too high voltage on the cells.
	46
	47	To change the battery protection parameters from low voltage on the cells, select the menu "Protections → Undervoltage protection":
	48
37.1	49	[[image:1732212212350-294.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="207" width="359"]]
3.3	50
	51	In this section:
	52
	53	* Enable – a flag to enable the protection;
	54	* Minimum cell voltage, V;
	55	* Tolerant cell voltage, V;
	56	* Delay before setting the error, second;
	57	* Delay before clearing the error, second;
	58	* Lock the error until the device is reset.
	59
	60	As a result of the operation of battery protection from low voltage, the "Undervoltage" error is generated.
	61
	62	Error generation conditions:
	63
	64	* the minimum voltage among all cells of the battery is less than the “Minimum cell voltage” value for the “Delay before setting the error” time.
	65
	66	Conditions for removing the error:
	67
	68	* the minimum voltage among all cells of the battery is greater than the “Tolerant cell voltage” value for the “Delay before clearing the error” time.
	69
	70	(% class="box infomessage" %)
	71	(((
33.4	72	If there is the "Undervoltage" error, the discharging relay opens.
3.3	73	)))
	74
38.1	75	=== Overvoltage protection ===
4.2	76
	77	To change the battery protection parameters from high voltage on the cells, select the menu "Protections → Overvoltage protection":
	78
37.1	79	[[image:1732212357972-295.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="218" width="338"]]
4.2	80
4.3	81	In this section:
	82
	83	* Enable – a flag to enable the protection;
	84	* Maximum cell voltage, V;
	85	* Tolerant cell voltage, V;
	86	* Delay before setting the error, second;
	87	* Delay before clearing the error, second;
	88	* Switch off the discharging relay on error – a flag to open the discharging relay when the "Overvoltage" error is generated;
	89	* Lock the error until the device is reset.
	90
	91	As a result of the operation of the battery protection from high voltage, the "Overvoltage" error is generated.
	92
	93	Error generation conditions:
	94
	95	* the maximum voltage among all cells of the battery is greater than the “Maximum cell voltage” value for the “Delay before setting the error” time.
	96
	97	Conditions for removing the error:
	98
	99	* the maximum voltage among all cells of the battery is less than the “Tolerant cell voltage” value for the “Delay before clearing the error” time.
	100
	101	(% class="box infomessage" %)
	102	(((
33.4	103	If there is the "Overvoltage" error, the charging relay and discharging relay opens (if the “Switch off the discharging relay on error” flag is set).
4.3	104	)))
	105
38.1	106	=== Low temperature protection ===
4.3	107
4.11	108	The board implements battery protection from too low temperature.
4.4	109
4.11	110	To change the battery protection parameters from low temperature, select the menu "Protections → Low temperature protection":
	111
37.1	112	[[image:1732213953083-955.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="237" width="338"]]
4.11	113
	114	In this section:
	115
	116	* Enable – a flag to enable the protection;
	117	* Minimum charging temperature, °C;
	118	* Tolerant charging temperature, °C;
	119	* Minimum discharging temperature, °C;
	120	* Tolerant discharging temperature, °C;
	121	* Delay before setting the error, second;
	122	* Delay before clearing the error, second;
	123	* Lock the error until the device is reset.
	124
	125	As a result of the operation of the battery protection from low temperature, the "Low CH temperature" or “Low DCH temperature” error is generated.
	126
	127	Error generation conditions:
	128
	129	* the minimum temperature among all cells of the battery is less than the “Minimum charging (discharging) temperature” value for the “Delay before setting the error” time.
	130
	131	Conditions for removing the error:
	132
	133	* the minimum temperature among all cells of the battery is greater than the “Tolerant charging (discharging) temperature” value for the “Delay before clearing the error” time.
	134
	135	(% class="box infomessage" %)
	136	(((
33.4	137	If there is the "Low CH temperature" error, the charging relay opens.
	138	If there is the "Low DCH temperature" error, the discharging relay opens.
4.11	139	)))
	140
38.1	141	=== High temperature protection ===
4.5	142
4.11	143	The board implements battery protection from too high temperature.
	144
	145	To change the battery protection parameters from high temperature, select the menu "Protections → High temperature protection":
	146
37.1	147	[[image:1732213990755-759.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="258" width="370"]]
4.12	148
4.11	149	In this section:
	150
	151	* Enable – a flag to enable the protection;
	152	* Maximum charging temperature, °C;
	153	* Tolerant charging temperature, °C;
	154	* Maximum discharging temperature, °C;
	155	* Tolerant discharging temperature, °C;
	156	* Delay before setting the error, second;
	157	* Delay before clearing the error, second;
	158	* Lock the error until the device is reset.
	159
	160	As a result of the operation of the battery protection from high temperature, the "High CH temperature" or “High DCH temperature” error is generated.
	161
	162	Error generation conditions:
	163
	164	* the maximum temperature among all cells of the battery is greater than the “Maximum charging (discharging) temperature” value for the “Delay before setting the error” time.
	165
	166	Conditions for removing the error:
	167
	168	* the maximum temperature among all cells of the battery is less than the “Tolerant charging (discharging) temperature” value for the “Delay before clearing the error” time.
	169
	170	(% class="box infomessage" %)
	171	(((
33.4	172	If there is the "High CH temperature" error, the charging relay opens.
	173	If there is the "High DCH temperature" error, the discharging relay opens.
4.11	174	)))
	175
38.1	176	=== Battery cover protection ===
4.5	177
4.12	178	To change the protection parameters from opening the battery cover, select the menu "Protections → Battery cover protection":
	179
37.1	180	[[image:1732214030014-281.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="155" width="334"]]
7.2	181
4.12	182	In this section:
	183
	184	* Enable – a flag to enable the protection;
	185	* Delay before setting the error, second;
	186	* Delay before clearing the error, second;
	187	* Lock the error until the device is reset.
	188
	189	As a result of the operation of the protection against opening the battery cover, the “Battery cover error” is generated.
	190
	191	Error generation conditions:
	192
	193	* there is a signal from the battery cover during the “Delay before setting the error” time.
	194
	195	Conditions for removing the error:
	196
	197	* no signal from the battery cover during the “Delay before clearing the error” time.
	198
	199	(% class="box warningmessage" %)
	200	(((
33.4	201	If there is the "Battery cover error", the “Critical error” is generated and all relays open.
4.12	202	)))
	203
38.1	204	=== High humidity protection ===
4.10	205
4.13	206	The board can protect the battery from high humidity and water.
	207
	208	To change the protection parameters of the battery from high humidity, select the menu "Protections → High humidity protection":
	209
37.1	210	[[image:1732214076060-358.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="185" width="321"]]
4.14	211
4.13	212	In this section:
	213
	214	* Enable – a flag to enable the protection;
10.2	215	* Maximum humidity, RH%;
	216	* Tolerant humidity, RH%;
4.13	217	* Delay before setting the error, second;
	218	* Delay before clearing the error, second;
	219	* Lock the error until the device is reset.
	220
	221	As a result of the operation of the battery protection from high humidity, the "High humidity" error is generated.
	222
	223	Error generation conditions:
	224
	225	* the measured humidity is greater than “Maximum humidity” during the “Delay before setting the error” time.
	226
	227	Conditions for removing the error:
	228
	229	* the measured humidity is less than the “Tolerant humidity” during the “Delay before clearing the error” time.
	230
4.14	231	(% class="box infomessage" %)
	232	(((
4.13	233	If there is the "High humidity" error, no action is taken. The error is indicative.
4.14	234	)))
4.13	235
38.1	236	=== Water protection ===
4.10	237
4.14	238	To change the protection parameters of the battery from water, select the menu "Protections → Water protection":
	239
37.1	240	[[image:1732214111990-184.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="199" width="340"]]
4.14	241
	242	In this section:
	243
	244	* Enable – a flag to enable the protection;
	245	* Maximum (water) humidty, RH%;
	246	* Tolerant humidity, RH%;
	247	* Delay before setting the error, second;
	248	* Delay before clearing the error, second;
	249	* Lock the error until the device is reset.
	250
	251	As a result of the operation of the battery protection from water, the "Water" error is generated.
	252
	253	Error generation conditions:
	254
	255	* the measured humidity is greater than the “Maximum (water) humidity” value during the “Delay before setting the error” time.
	256
	257	Conditions for removing the error:
	258
	259	* the measured humidity is less than the “Tolerant humidity” value during the “Delay before clearing the error” time.
	260
	261	(% class="box warningmessage" %)
	262	(((
33.4	263	If there is the “Water” error, the “Critical error” is generated and all relays open.
4.14	264	)))
	265
38.1	266	=== Current sensor error ===
4.10	267
4.14	268	The board is implemented to check the current sensor connection circuits. The circuits are checked for breakage and short-circuit to the +5 V supply line.
	269
	270	To change the test parameters of the current sensor connection circuits, select the menu "Protections → Current sensor error":
	271
37.1	272	[[image:1732214146724-132.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="438" width="365"]]
4.14	273
	274	In this section:
	275
	276	* Enable – a flag to enable the protection;
	277	* Maximum voltage, V;
	278	* Minimum voltage, V;
	279	* Hysteresis voltage – a hysteresis value to clear the error, V;
	280	* Delay before setting the error, second;
	281	* Delay before clearing the error, second;
	282	* Lock the error until the device is reset.
	283
	284	If there is an open or short circuit connection of a current sensor, the "Current sensor error" is generated.
	285
	286	Error generation conditions:
	287
	288	* the voltage in the signal line or zero level line of the current sensor is greater than the “Maximum voltage” value during the “Delay before setting the error” time;
	289	* the voltage in the signal line or zero level line of the current sensor is less than the “Minimum voltage” value during the “Delay before setting the error” time.
	290
	291	Conditions for removing the error:
	292
	293	* the voltage in the signal line or zero level line of the current sensor is in range from (Minimum voltage + Hysteresis voltage) to (Maximum voltage - Hysteresis voltage) during the “Delay before clearing the error” time.
	294
4.15	295	(% class="box warningmessage" %)
	296	(((
33.4	297	If there is the “Current sensor error”, the “Critical error” is generated and all relays open.
4.15	298	)))
4.14	299
38.1	300	=== Short circuit protection ===
4.10	301
4.15	302	The BMS implements a protection of power circuits (contactors, power cables) against overheating caused by the flow of high current for a long time.
	303
	304	To change the protection parameters from short circuit, select the menu "Protections → Short circuit protection":
	305
37.1	306	[[image:1732214207026-822.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="528" width="371"]]
4.15	307
	308	In this section:
	309
	310	* Level 1, 2, 3 – three protection levels. The following parameters are configured at each level:
	311	** Enable – a flag to enable the protection;
	312	** Maximum current, A;
	313	** Delay before setting the error, second;
	314	* Delay before clearing the error, second;
	315	* Switch off the charging relay on error – a flag to open the charging relay when the "Short circuit" error occurs;
	316	* Switch off the discharging relay on error – a flag to open the discharging relay when the "Short circuit" error occurs;
	317	* Lock the error until the device is reset.
	318
	319	If there is a short circuit, the "Short circuit" error is generated.
	320
	321	Error generation conditions:
	322
	323	* at any of the three protection levels, the current modulo is greater than the “Maximum current” value during the “Delay before setting the error” time.
	324
	325	Conditions for removing the error:
	326
	327	* the current modulo is lower than the “Maximum current” values for all three protection levels during the “Delay before setting the error” time.
	328
	329	(% class="box infomessage" %)
	330	(((
33.4	331	If there is the "Short circuit" error, the charging relay opens (the “Switch off the charging relay on error” flag is set) and the discharging relay opens (the “Switch off the discharging relay on error flag” is set).
4.15	332	)))
	333
38.1	334	=== Contactor high temperature protection ===
4.10	335
4.15	336	The BMS protects power contactors from overheating. To measure the temperature of the contactor, a thermistor is used, connected to the P13 connector of the board. Configuring of the analog input for temperature measurement is described in section Input signals.
	337
	338	To change the overheating protection parameters of power contactors, select the menu "Protections → Contactor high temperature protection":
	339
37.1	340	[[image:1732214237851-405.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="234" width="336"]]
4.15	341
	342	In this section:
	343
	344	* Enable – a flag to enable the protection;
	345	* Maximum temperature, °C;
	346	* Tolerant temperature, °C;
	347	* Delay before setting the error, second;
	348	* Delay before clearing the error, second;
	349	* Switch off the charging relay on error – a flag to open the charging relay when the "Contactor high temperature" error occurs;
	350	* Switch off the discharging relay on error – a flag to open the discharging relay when the "Contactor high temperature" error occurs;
	351	* Lock the error until the device is reset.
	352
	353	If there is a contactor overheat, the "Contactor high temperature" error is generated.
	354
	355	Error generation conditions:
	356
	357	* the contactor temperature is greater than the “Maximum temperature” value during the “Delay before setting the error” time.
	358
	359	Conditions for removing the error:
	360
	361	* the contactor temperature is lower than the “Tolerant temperature” value during the “Delay before clearing the error” time.
	362
	363	(% class="box infomessage" %)
	364	(((
33.5	365	If there is the "Contactor high temperature" error, the charging relay opens (the “Switch off the charging relay on error” flag is set) and the discharging relay opens (the “Switch off the discharging relay on error flag” is set).
4.15	366	)))
	367
38.1	368	=== Unallowable charging protection ===
4.10	369
4.16	370	The BMS can detect that the battery is charging through the discharging circuit and protectively open the discharging relay to prevent unallowable battery operation.
	371
	372	To change the parameters of the unallowable charging protection, select the menu "Protections → Unallowable charging protection":
	373
37.1	374	[[image:1732214272022-547.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="145" width="312"]]
4.16	375
	376	In this section:
	377
	378	* Enable – a flag to enable the protection;
	379	* Delay before setting the error, second;
	380	* Delay before clearing the error, second;
	381	* Lock the error until the device is reset.
	382
	383	If there is charging the battery through the discharging circuit detected, the "Unallowable charging" error is generated.
	384
	385	Error generation conditions:
	386
	387	* the charging relay is open and the battery current is not zero during the “Delay before setting the error” time.
	388
	389	Conditions for removing the error:
	390
	391	* the battery current is zero during the “Delay before clearing the error” time.
	392
	393	(% class="box infomessage" %)
	394	(((
33.5	395	If there is the "Unallowable charging" error, the discharging relay opens.
4.16	396	)))
	397
38.1	398	=== Stuck contactor protection ===
4.10	399
4.16	400	The BMS Main 2.x protects contactors against sticking.
	401
	402	To change the protection parameters against sticking, select the menu "Protections → Stuck contactor protection":
	403
37.1	404	[[image:1732214367207-318.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="152" width="331"]]
4.16	405
	406	In this section:
	407
	408	* Enable – a flag to enable the protection;
	409	* Delay before setting the error, second;
	410	* Delay before clearing the error, second;
	411	* Lock the error until the device is reset;
	412
	413	If there is a stuck contactor, the “Stuck contactor” error is generated.
	414
	415	Error generation conditions:
	416
	417	* charging and discharging contactors are open, but the “Charging current present” or “Discharging current present” signal is set.
	418
33.7	419	(% class="box warningmessage" %)
	420	(((
	421	If there is the “Stuck contactor error”, the “Critical error” is generated and all relays open.
	422	)))
33.5	423
38.1	424	=== Contactor feedback check ===
4.10	425
40.1	426	The BMS Main 2.x can receive feedback signals from contactors and detect discrepancy between the control value and the feedback signal. To enable specific contactor protection, one of the discrete input must be set as corresponding contactor feedback signal (see [[Input and output signals>>doc:Battery management systems.BMS Main 2\.1.3\. Configuration.3\.3 Input and output signals.WebHome]]).
4.16	427
	428	To change the contactor feedback check parameters, select the menu "Protections → Contactor feedback check":
	429
37.1	430	[[image:1732214400721-274.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="150" width="323"]]
4.17	431
	432	In this section:
	433
	434	* Enable – a flag to enable the protection;
	435	* Delay before setting the error, second;
	436	* Delay before clearing the error, second;
	437	* Lock the error until the device is reset;
	438
	439	If there is a discrepancy at any contactor, the corresponding contactor feedback error is generated. Error generation conditions:
	440
	441	* discrete output of charging, precharge, discharging, charging/discharging or main contactor not matches its feedback value.
	442
33.8	443	(% class="box warningmessage" %)
	444	(((
	445	If there is the contactor feedback error, the “Critical error” is generated and all relays open.
	446	)))
33.5	447
38.1	448	=== Charging contactor cycles protection ===
4.10	449
4.18	450	The BMS protects the charging contactor against frequent switching.
4.17	451
4.18	452	To change the protection parameters against high frequency switching of the charging contactor, select the menu "Protections → Charging contactor cycles protection":
	453
37.1	454	[[image:1732214432750-543.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="260" width="336"]]
4.18	455
	456	In this section:
	457
	458	* Enable – a flag to enable the protection;
	459	* Cycles threshold – a number of cycles in a given period, upon which the “CH contactor cycles error” is generated;
	460	* Period – a time in which the BMS counts switchings of the charging contactor, second;
	461	* Delay before setting the error, second;
	462	* Delay before clearing the error, second;
	463	* Lock the error until the device is reset;
	464	* Cycles – a number of the charging contactor switchings made during battery operation.
	465
	466	If there is the high switching frequency of the charging contactor, the “CH contactor cycles error” is generated.
	467
	468	Error generation conditions:
	469
	470	* the number of switchings of the charging contactor for the “Period” time is greater than or equal to the “Cycles threshold” value. The error is generated with the “Delay before setting the error” delay.
	471
	472	Conditions for removing the error:
	473
	474	* the “Delay before clearing the error” time has passed since the error was generated.
	475
	476	(% class="box infomessage" %)
	477	(((
33.5	478	If there is the "CH contactor cycles error" error, the charging relay opens.
4.18	479	)))
	480
38.1	481	=== Discharging contactor cycles protection ===
4.10	482
4.18	483	The BMS protects the discharging contactor against frequent switching.
	484
	485	To change the protection parameters against high frequency switching of the discharging contactor, select the menu "Protections → Discharging contactor cycles protection":
	486
37.1	487	[[image:1732214468462-541.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="269" width="346"]]
4.18	488
	489	In this section:
	490
	491	* Enable – a flag to enable the protection;
	492	* Cycles threshold – a number of cycles in a given period, upon which the “DCH contactor cycles error” is generated;
	493	* Period – a time in which the BMS counts switchings of the charging contactor, second;
	494	* Delay before setting the error, second;
	495	* Delay before clearing the error, second;
	496	* Lock the error until the device is reset;
	497	* Cycles – a number of the charging contactor switchings made during battery operation.
	498
	499	If there is the high switching frequency of the discharging contactor, the “DCH contactor cycles error” is generated.
	500
	501	Error generation conditions:
	502
	503	* the number of switchings of the discharging contactor for the “Period” time is greater than or equal to the “Cycles threshold” value. The error is generated with the “Delay before setting the error” delay.
	504
	505	Conditions for removing the error:
	506
	507	* the “Delay before clearing the error” time has passed since the error was generated.
	508
	509	(% class="box infomessage" %)
	510	(((
33.5	511	If there is the "DCH contactor cycles error" error, the discharging relay opens.
4.18	512	)))
	513
38.1	514	=== Temperature sensor error ===
4.10	515
4.18	516	The board is implemented to check the temperature sensors connection circuits. The circuits are checked for breakage and short-circuit.
	517
	518	To change the protection parameters of the temperature sensors circuits, select the menu "Protections → Temperature sensor error":
	519
37.1	520	[[image:1732214501360-654.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="154" width="334"]]
4.18	521
	522	In this section:
	523
	524	* Enable – a flag to enable the protection;
	525	* Delay before setting the error, second;
	526	* Delay before clearing the error, second;
	527	* Lock the error until the device is reset.
	528
	529	If there are no temperature sensors connected to a BMS Logic board or any temperature sensor is shorted, the "No temp. sensors" error and "Temp. sensor is shorted" error are generated respectively. These errors generated and removed with the “Delay before setting the error” and “Delay before clearing the error” delays.
	530
4.19	531	(% class="box warningmessage" %)
	532	(((
33.6	533	If there is the “No temp. sensors” or “Temp. sensor is shorted” error, the “Critical error” is generated and all relays open.
4.19	534	)))
4.18	535
38.1	536	=== Logic high temperature protection ===
4.10	537
4.19	538	To change the overheating protection parameters of BMS Logic boards, select the menu "Protections → Logic high temperature protection":
	539
37.1	540	[[image:1732214545352-111.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="156" width="309"]]
4.19	541
	542	In this section:
	543
	544	* Enable – a flag to enable the protection;
	545	* Maximum Logic temperature, °C;
	546	* Tolerant Logic temperature, °C;
	547	* Lock the error until the device is reset.
	548
	549	As a result of the operation of the protection from high temperatures of BMS Logic boards, the "Logic high temperature" is generated.
	550
	551	Error generation conditions:
	552
	553	* a BMS Logic board temperature is higher than the “Maximum Logic temperature” value.
	554
	555	Conditions for removing the error:
	556
	557	* a BMS Logic board temperature is less than the “Tolerant Logic temperature” value.
	558
	559	(% class="box infomessage" %)
	560	(((
33.3	561	Cell balancing is prohibited for overheated boards.
4.19	562	)))
	563
38.1	564	=== Logic offline protection ===
4.10	565
4.19	566	To change the protection parameters from loss of communication with BMS Logic boards, select the menu "Protections → Logic offline protection":
	567
37.1	568	[[image:1732214579147-515.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="107" width="204"]]
4.19	569
4.20	570	In this section:
4.19	571
4.20	572	* Enable – a flag to enable the protection;
	573	* Lock the error until the device is reset.
	574
	575	As a result of the protection from loss of communication with BMS Logic boards, the "Logic offline" error is generated.
	576
	577	Error generation conditions:
	578
	579	* at least one of the connected BMS Logic boards does not respond to the commands of the BMS Main 2.x board for 10 seconds.
	580
	581	Conditions for removing the error:
	582
	583	* all connected BMS Logic boards respond to the commands of the BMS Main 2.x board.
	584
	585	(% class="box warningmessage" %)
	586	(((
33.6	587	If there is the "Logic offline" error, the “Critical error” is generated and all relays open.
4.20	588	)))
	589
38.1	590	=== Cell count protection ===
4.10	591
4.20	592	To change the protection parameters from the mismatch of the number of cells to the set value, select the menu "Protections → Cell count protection":
	593
37.1	594	[[image:1732214641606-453.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="178" width="341"]]
4.20	595
	596	In this section:
	597
	598	* Enable – a flag to enable the protection;
	599	* Cell count – a number of cells connected to the BMS;
	600	* Delay before setting the error, second;
	601	* Delay before clearing the error, second;
	602	* Lock the error until the device is reset.
	603
	604	As a result of the operation of the protection from the mismatch of the number of cells, the "Cell count error" is generated.
	605
	606	Error generation conditions:
	607
	608	* the number of cells connected to the BMS is not equal to the “Cell count” value during the “Delay before setting the error” time.
	609
	610	Conditions for removing the error:
	611
	612	* the number of cells connected to the BMS is equal to the “Cell count” value during the “Delay before clearing the error” time.
	613
	614	(% class="box warningmessage" %)
	615	(((
33.6	616	If there is the "Cell count error", the “Critical error” is generated and all relays open.
4.20	617	)))
	618
38.1	619	=== Logic count protection ===
4.10	620
4.20	621	To change the protection parameters from the mismatch of the number of BMS Logic boards to the set value, select the menu "Protections → Logic count protection":
	622
37.1	623	[[image:1732214675358-202.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="163" width="230"]]
4.20	624
	625	In this section:
	626
	627	* Enable – a flag to enable the protection;
	628	* Logic count – a number of BMS Logic boards connected to the BMS Main 2.x;
	629	* Fast scan – a flag to scan BMS Logic boards fast (boards with addresses from 1 to “Logic count” are scanned; this mode reduces BMS system startup time);
	630	* Lock the error until the device is reset.
	631
	632	As a result of the operation of the protection from the mismatch of the number of BMS Logic boards, the "Logic count error" is generated.
	633
	634	Error generation conditions:
	635
	636	* the number of BMS Logic boards connected to the BMS Main 2.x is not equal to the “Logic count” value.
	637
	638	Conditions for removing the error:
	639
	640	* the number of BMS Logic boards connected to the BMS Main is equal to the “Logic count” value.
	641
	642	(% class="box warningmessage" %)
	643	(((
33.6	644	If there is the "Logic count error", the “Critical error” is generated and all relays open.
4.20	645	)))
	646
38.1	647	=== WDT protection ===
4.10	648
4.20	649	If the BMS firmware hangs, the watchdog timer resets the board. The BMS can detect that the board was reset and generates the “WDT reset” error.
	650
	651	To change the parameters of the watchdog protection, select the menu "Protections → WDT protection":
	652
37.1	653	[[image:1732214703914-144.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="127" width="323"]]
4.20	654
4.21	655	In this section:
	656
	657	* Enable – a flag to enable the protection;
	658	* Delay before clearing the error, second;
	659	* Lock the error until the device is reset.
	660
	661	Conditions for removing the error:
	662
	663	* the “Delay before clearing the error” time has passed from the board startup.
	664
4.22	665	(% class="box warningmessage" %)
	666	(((
35.1	667	If there is the "WDT reset" error, the “Critical error” is generated and all relays open.
4.22	668	)))
4.21	669
38.1	670	=== Insulation monitoring ===
4.10	671
4.22	672	BMS Main 2.x can detect a signal from an external insulation monitoring device (such as Bender IR155) to monitor the insulation quality.
	673
	674	To change the insulation monitoring parameters, select the menu "Protections → Insulation monitoring":
	675
37.1	676	[[image:1732214731490-961.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="162" width="315"]]
4.22	677
	678	In this section:
	679
	680	* Enable – a flag to enable the protection;
	681	* Delay before setting the error, second;
	682	* Delay before clearing the error, second;
	683	* Lock the error until the device is reset.
	684
	685	Error is set if corresponding discrete input is set up and it received logical zero.
	686
33.9	687	(% class="box warningmessage" %)
	688	(((
35.1	689	If there is the "Insulation monitoring" error, the “Critical error” is generated and all relays open.
33.9	690	)))
	691
38.1	692	=== Critical error parameters ===
4.10	693
4.22	694	To change the critical error parameters, select the menu "Protections → Critical error parameters":
	695
37.1	696	[[image:1732214761141-983.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="158" width="348"]]
4.22	697
	698	In this section:
	699
	700	* Enable – a flag to enable the protection;
	701	* Delay before setting the error, second;
	702	* Delay before clearing the error, second;
	703	* Lock the error until the device is reset.
	704
	705	The critical error flag is generated if at least one of the following errors is generated during the “Delay before setting the error” time:
	706
	707	* “Battery cover error”;
	708	* “Water”;
	709	* “Logic offline”;
	710	* “Cell count error”;
	711	* “Logic count error”;
	712	* “ADC error”;
	713	* “No temp. sensors”;
	714	* “Temp. sensor is shorted”;
	715	* “Current sensor error”;
34.1	716	* "Stuck contactor";
	717	* "Contactor feedback";
4.22	718	* “Shunt offline”;
	719	* “Shunt error”;
	720	* “Settings error”;
33.9	721	* “WDT reset”
	722	* "Insulation monitoring".
4.22	723
	724	The “Critical error” is cleared if there are no errors from the list above during the “Delay before clearing the error” time.
	725
	726	(% class="box warningmessage" %)
	727	(((
	728	If there is the “Critical error”, all relays open.
	729	)))
	730
38.1	731	=== General error parameters ===
4.10	732
27.2	733	To change the general error parameters, select the menu "Protections → General error parameters":
	734
37.1	735	[[image:1732214987517-111.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="535" width="349"]]
27.2	736
	737	In this section:
	738
	739	* Enable – a flag to enable the protection;
	740	* Delay before setting the error, second;
	741	* Delay before clearing the error, second;
27.3	742	* Lock the error until the device is reset;
	743	* Errors – a section to select errors that should trigger General error.
27.2	744
41.1	745	The general error flag is generated if at least one of the selected errors is generated during the “Delay before setting the error” time.
27.3	746
28.2	747	The “General error” is cleared if there are no errors from selected list during the “Delay before clearing the error” time.
	748
33.6	749	(% class="box infomessage" %)
	750	(((
28.2	751	The "General error" is //indicative //and can be linked to any discrete output of the board.
33.6	752	)))
28.2	753
38.1	754	=== Low SOC signal ===
4.10	755
4.22	756	To change the parameters of the generation a signal about low battery level, select the menu "Protections → Low SOC signal":
	757
37.1	758	[[image:1732215174961-645.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="186" width="325"]]
4.22	759
	760	In this section:
	761
	762	* Enable – a flag to enable signal generation;
	763	* Minimum SOC, %;
	764	* Tolerant SOC, %;
	765	* Delay before setting the signal, second;
	766	* Delay before clearing the signal, second;
	767	* Lock the signal until the device is reset.
	768
	769	Signal generation conditions:
	770
	771	* the battery SOC is less than the “Minimum SOC” value during the “Delay before setting the signal” time.
	772
	773	Conditions for clearing the signal:
	774
	775	* the battery SOC is greater than the “Tolerant SOC” during the “Delay before clearing the signal” time.
	776
33.6	777	(% class="box infomessage" %)
	778	(((
4.23	779	The "Low SOC signal" is //indicative //and can be linked to any discrete output of the board.
33.6	780	)))
4.22	781
38.1	782	=== High charging current signal ===
4.10	783
4.23	784	To change the parameters of the generation high-current signal, select the menu "Protections → High charging current signal":
	785
37.1	786	[[image:1732215211714-445.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="181" width="322"]]
4.23	787
	788	In this section:
	789
	790	* Enable – a flag to enable signal generation;
	791	* Maximum charging current, А;
	792	* Tolerant charging current, А;
	793	* Delay before setting the signal, second;
	794	* Delay before clearing the signal, second;
	795	* Lock the signal until the device is reset.
	796
	797	Signal generation conditions:
	798
	799	* the measured current is greater than the “Maximum charging current” value during the “Delay before setting the signal” time.
	800
	801	Conditions for clearing the signal:
	802
	803	* the measured current is less than the “Tolerant charging current” value during the “Delay before clearing the signal” time.
	804
33.6	805	(% class="box infomessage" %)
	806	(((
4.23	807	The "High charging current" signal is //indicative //and can be linked to any discrete output of the board.
33.6	808	)))
4.23	809
38.1	810	=== Heater control ===
4.10	811
4.23	812	To change the parameters of the heater control algorithm, select the menu "Protections → Heater control":
	813
37.1	814	[[image:1732215252650-791.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="233" width="370"]]
4.23	815
	816	In this section:
	817
	818	* Enable – a flag to enable heater control;
	819	* Minimum cell temperature, °C;
	820	* Tolerant cell temperature, °C;
	821	* Delay before setting the signal, second;
	822	* Delay before clearing the signal, second;
	823	* Lock the signal until the device is reset;
	824	* Switch off the heater relay on errors (Undervoltage, Overcurrent, High temperature, Short circuit or Critical error).
	825
	826	As a result of operating the heating algorithm, the “Heater” signal is generated.
	827
	828	Conditions of signal generation:
	829
	830	* The minimum temperature among all cells of the battery is less than the “Minimum cell temperature” value during the “Delay before setting the signal” time.
	831
	832	Conditions for clearing the signal:
	833
	834	* the minimum temperature among all cells of the battery is greater than the “Tolerant cell temperature” value during the “Delay before clearing the signal” time.
	835
4.24	836	(% class="box infomessage" %)
	837	(((
33.6	838	If there is the "Heater" signal, the heater relay closes and/or a signal is output to the corresponded digital output.
4.24	839	)))
4.23	840
38.1	841	=== Heater (AUX) control ===
4.10	842
4.25	843	To change the parameters of the auxiliary heater control algorithm, select the menu "Protections → Heater (AUX) control":
4.24	844
37.1	845	[[image:1732215282135-420.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="228" width="361"]]
4.24	846
	847	In this section:
	848
	849	* Enable – a flag to enable heater control;
	850	* Minimum cell temperature, °C;
	851	* Tolerant cell temperature, °C;
	852	* Delay before setting the signal, second;
	853	* Delay before clearing the signal, second;
	854	* Lock the signal until the device is reset;
	855	* Switch off the heater relay on errors (Undervoltage, Overcurrent, High temperature, Short circuit or Critical error).
	856
	857	As a result of operating the heating algorithm, the “Heater (AUX)” signal is generated.
	858
	859	Conditions of signal generation:
	860
	861	* The minimum temperature among all cells of the battery is less than the “Minimum cell temperature” value during the “Delay before setting the signal” time.
	862
	863	Conditions for clearing the signal:
	864
	865	* the minimum temperature among all cells of the battery is greater than the “Tolerant cell temperature” value during the “Delay before clearing the signal” time.
	866
4.25	867	(% class="box infomessage" %)
	868	(((
33.6	869	If there is the "Heater (AUX)" signal, the auxiliary heater relay closes and/or a signal is output to the corresponded digital output.
4.25	870	)))
4.24	871
38.1	872	=== Cooler control ===
4.10	873
4.25	874	To change the parameters of the cooler control algorithm, select the menu "Protections → Cooler control":
	875
37.1	876	[[image:1732215313977-499.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="219" width="348"]]
4.25	877
	878	In this section:
	879
	880	* Enable – a flag to enable cooler control;
	881	* Maximum cell temperature, °C;
	882	* Tolerant cell temperature, °C;
	883	* Delay before setting the signal, second;
	884	* Delay before clearing the signal, second;
	885	* Lock the signal until the device is reset;
	886	* Switch off the cooler relay on errors (Undervoltage, Overcurrent, Low temperature, Short circuit or Critical error).
	887
	888	As a result of operating the cooling algorithm, the "Cooler" signal is generated.
	889
	890	Conditions of signal generation:
	891
	892	* the maximum temperature among all cells of the battery is greater than the “Maximum cell temperature” value during the “Delay before setting the signal” time.
	893
	894	Conditions for clearing the signal:
	895
	896	* the maximum temperature among all cells of the battery is less than the “Tolerant cell temperature” value during the “Delay before clearing the signal” time.
	897
	898	(% class="box infomessage" %)
	899	(((
33.7	900	If there is the "Cooler" signal, the cooler relay closes and/or a signal is output to the corresponded digital output.
4.25	901	)))
	902
38.1	903	=== Fault simulation ===
4.26	904
	905	The board provides the ability to manually generate error flags bypassing the protection algorithms. This functionality is intended for commissioning.
	906
	907	To simulate battery and BMS errors, select the menu "Protections → Fault simulation":
	908
37.1	909	[[image:1732215359330-850.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="732" width="204"]]
4.26	910
	911	To simulate errors, set the necessary flags and click on the "Save" button.

Wiki source code of 3.6 Battery protection

Applications

Navigation

Table of Contents