Wiki source code of 3.3 Control

Version 76.10 by Admin on 2026/03/31 13:02

version	line-number	content
4.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;" %)
33.1	2	= Configuration =
1.3	3
4.1	4	(% 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;" %)
	5	== Control ==
3.1	6
	7	=== Common settings ===
	8
1.3	9	To change the common BMS settings, select the "Control → Common settings" section:
	10
6.2	11	[[image:1735054851946-552.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="105" width="800"]]
1.3	12
	13	In this section:
	14
76.3	15	* Cell capacity – nominal capacity of cells, Ah;
	16	* Cell resistance – nominal (maximum) internal resistance of the cells, Ohm;
	17	* Connection of cells:
	18	Serial **– all cells are connected in series in a single string.
	19	Parallel-Serial **– cells are grouped in parallel and serial items;
	20	* Parallel-Serial: Number of Logic devices in a chain;
	21	* Parallel-Serial: Number of parallel chains in a block;
	22	* Parallel-Serial: Number of serial blocks in a string;
	23	* Relax time (after charging) – a relaxation time after charging, second;
	24	* Relax time (atfer discharging) – a relaxation time after discharging, second;
76.4	25	* Reset SOC – a command to reset cells state of charge. New cell SOC values will be calculated based on cell voltage and “Uocv (open-circuit voltage) table”: in the “Control → SOC estimation” section;
	26	* Reset resistance – a command to reset cells resistance to “Cell resistance” value;
	27	* Reset capacity – a command to reset cells capacity to “Cell capacity” value;
76.3	28	* Method of calculating the battery voltage*:
	29	Summation of cell voltages** – the overall voltage is calculated as on sum of all cells in the battery;
	30	Using voltage before contactors** – the overall voltage is estimated as voltage before contactors measured by BMS.
1.3	31
76.3	32	The "Parallel-Serial" connection works as follows: a bunch of serial connected Logics are grouped into chains. A bunch of parallel connected chains are grouped to blocks. A bunch of serial connected blocks are grouped into string. By configuring the corresponding settings it is possible to create a complex string configuration. Current through each chain will be estimated as a fraction of overall current accordingly to the number of chains in a block.
1.3	33
76.3	34	The values “Capacity” and “Resistance” are used to calculate the SOC of cells and the battery.
1.3	35
76.3	36	The values of “Relax time” are used to determine the state of the battery. If the battery is in a state of relaxation, the system recalculates the voltage on the cells to the state of charge of the battery.
1.3	37
76.5	38	The “Reset SOC”, "Reset resistance" and "Reset capacity" command is used for starting-up and adjustment of the battery.
76.3	39
3.1	40	=== SOC estimation ===
1.3	41
76.5	42	The BMS Main 3 / BMS Main 2R device calculates the state of charge (SOC) of each cell, and then the overall battery SOC, by using following algorithms:
1.3	43
	44	The “Voltage” SOC calculation algorithm calculates cells SOC based on the tabular dependence Uocv = Uocv(SOC, t °C).
	45
	46	The “Current and voltage (simplified)” SOC calculation algorithm works as follows:
	47
	48	* if I = 0, the battery is in the state of relaxation and the cell voltage Uocv is outside the [U,,ocv[point 1],,; U,,ocv[point 2],,], the SOC calculation is based on the tabular dependency Uocv = Uocv(SOC, t °C);
	49	* in any other cases, the SOC value is proportional to the charge (coulomb) passed through the battery (current time integral).
	50
	51	The “Current and voltage (enhanced)” SOC calculation algorithm differs from the simplified algorithm by online correction of the effective capacity. When using this algorithm, it is necessary to fine tune the tabular dependence Uocv = Uocv (SOC, t °C).
	52
76.5	53	To change the algorithm for calculating the SOC, select the "Control → SOC estimation" section:
1.3	54
2.1	55	[[image:1733322611551-852.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="148" width="800"]]
1.3	56
76.5	57	In this section:
1.3	58
76.5	59	* Algorithm:
	60	Voltage **– by open circuit voltage;
	61	Current and voltage (simplified)** – recommended for LFP cells;
	62	Current and voltage (enhanced)** – recommended for NMC cells:
	63	* Final SOC – method of calculating overall SOC of battery:
	64	Minimal SOC** – the battery SOC is assumed to be the minimum SOC among the cells;
	65	Average SOC** – the battery SOC is taken equal to the arithmetic average of the cell SOC;
	66	Min-Max SOC** – the battery SOC is calculated based on the minimum and maximum SOC of the cells (recommended). Final SOC will be a) 100% if __any cell__ has 100% SOC, b) 0% if __any cell__ has 0% SOC;
	67	Max-Min SOC** – the battery SOC is calculated based on the minimum and maximum SOC of the cells. Final SOC will be a) 100% if __all cells__ have 100% SOC, b) 0% if __all// //cells__ have 0% SOC.
	68	* Scale the final SOC – a flag to scale the battery SOC by the following values;
	69	* SOC corresponding to 0% – the battery SOC that sets to be 0%;
	70	* SOC corresponding to 100% – the battery SOC that sets to be 100%.
	71	* Uocv (open-circuit voltage) table – the dependence of the cell open circuit voltage Uocv on SOC and the cell temperature (selected for specific batteries);
	72	* Linear zone - linear zone of the Uocv = Uocv(SOC, t°C) dependency, inside which the cell voltage changes insignificantly:
	73	Linear zone: point 1** – starting point of the Uocv linear zone;
	74	Linear zone: point 2** – ending point of the Uocv linear zone;
	75	* Coulomb counting correction (temperature) – the dependence of battery capacity on temperature;
	76	* Coulomb counting correction (cycles) – the dependence of battery capacity on the number of charge-discharge cycles.
1.3	77
3.1	78	=== SOC correction ===
1.3	79
76.5	80	The BMS Main 3 / BMS Main 2R device can recalculate the battery SOC after long-term storage or after long-term working in the case when the battery was not charged fully or discharged totally. Recalculation is done based on the tabular dependency Uocv = Uocv (SOC, t) (see [[SOC estimation>>doc:\|\|anchor="HSOCestimation"]]).
1.3	81
	82	To configure parameters for periodically correcting the battery state of charge, select the "Control → SOC correction" section:
	83
2.1	84	[[image:1733322624656-766.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="121" width="800"]]
1.3	85
	86	In this section:
	87
76.5	88	* Enable – a flag to enable the SOC correction;
	89	* Shutdown period – a time the battery is off, day. If the BMS detects on its startup that it was off during the “Shutdown period” time, the BMS recalculates the battery state of charge based on the tabular dependency Uocv = Uocv (SOC, t);
	90	* Correction period – a period of correcting the battery SOC, day. If the BMS detects that the last correction was more than the “Correction period” ago, the BMS recalculates the battery state of charge based on the tabular dependency Uocv = Uocv (SOC, t) and tunes it gradually during the “SOC change time”.
	91	* SOC change time – a duration of the linear changing the battery SOC to the value calculated by the correction algorithm, minute;
	92	* Ignore the linear zone – a flag to ignore linear SOC zone while correction (recommended to be unset);
	93	* Last correction timestamp – time when last correction was made.
1.3	94
65.2	95	=== SOH estimation ===
	96
	97	The BMS Main 3 device calculates the state of health of the battery (SOH) using two algorithms:
	98
76.5	99	In "By effective capacity" mode SOH is calculated as a ratio of effective capacity to nominal capacity. Effective capacity is estimated to DOD value when battery SOC reaches 0%, so SOH is recalculated each full battery discharge.
65.2	100
76.5	101	In "By total charge–" mode SOH is calculated as a linear function of "Total charge-" counter. While "Total charge-" constantly increases during battery operation, SOH will be linearly decrease at the same time. This mode requires a confirmed data about cell health depending of amount of discharge rate to configure the linear function.
65.2	102
68.1	103	To configure parameters for battery state of health calculation, select the "Control → SOH correction" section:
	104
	105	[[image:1765447975228-766.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="96" width="800"]]In this section:
	106
76.5	107	* Algorithm:
	108	By effective capacity;**
	109	By total charge–;**
	110	* Total charge: Charge– – total amount of charge– for expected SOH;
	111	* Total charge: SOH – expected SOH value at the total amount of charge–.
68.1	112
3.1	113	=== Resistance estimation ===
1.3	114
	115	Calculation of the resistance of cells is carried out in two ways. The first method is used when the battery passes from a relaxation state to a charge or discharge state, wherein the cell resistance value
	116
10.6	117	{{formula fontSize="SMALL" imageType="PNG"}}
10.3	118	R = \frac{U-U_{ocv}}{I_{stable}}
	119	{{/formula}}
1.3	120
10.3	121	where U — the cell voltage measured in the charge or discharge state, V; U,,ocv,, — cell voltage measured in the state of relaxation (before switching to the state of charge or discharge); I,,stable,, — stabilized current through the cell in the state of charge or discharge.
10.2	122
1.3	123	The second method is used for a stepwise change in the current through the cell, while the value of the cell resistance:
	124
10.6	125	{{formula fontSize="SMALL"}}
10.5	126	R = \frac{U_2-U_1}{I_{stable2}-I_{stable1}}
	127	{{/formula}}
1.3	128
10.5	129	provided that
	130
10.6	131	{{formula fontSize="SMALL"}}
	132	\| I_{stable2}-I_{stable1} \| > 0.2 × Qmax
10.4	133	{{/formula}}
10.3	134
10.6	135	where Q,,max,, — the maximum cell capacity,U,,2,, — voltage on the cell at the moment when the stabilized current I,,stable2,, is flowing through it; U,,1,, — the voltage on the cell at the moment when the stabilized current I,,stable1,, flowing through it.
1.3	136
	137	The stabilized current I,,stable,, = I, if during the stabilization time the instantaneous current I is in the range from 0.95 × I to 1.05 × I.
	138
	139	To change parameters of the algorithm for calculating the cell resistance, select the "Control → Resistance estimation" section:
	140
2.1	141	[[image:1733322624659-473.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="108" width="800"]]
1.3	142
	143	In this section:
	144
76.5	145	* Current stabilization time, millisecond;
	146	* Maximum calculation period – maximum time between resistance measurements. If more time has elapsed since the last determination of the stabilized current I,,stable,, than is determined in this field, the resistance calculation is not performed, second;
	147	* Maximum resistance factor – the coefficient of calculation of the maximum acceptable resistance of the cell;
	148	* Minimum SOC – minimum cell SOC value for resistance calculation;
	149	* Maximum SOC – maximum cell SOC value for resistance calculation.
1.3	150
10.7	151	The calculated resistance is accepted by the system as valid (and therefore updated) if its value is in the range from Resistance / 2 to “Maximum resistance factor” × Resistance, where "Resistance" is the nominal resistance of the cell (see [[Common settings>>doc:\|\|anchor="HCommonsettings"]]). If the calculated resistance value is greater than the value (Maximum resistance factor × Resistance), the updated resistance value will be equal to the value (Maximum resistance factor × Resistance).
1.3	152
3.1	153	=== Low SOC (signal) ===
1.3	154
76.5	155	The "Low SOC" is indicative signal that can be assigned to a discrete output or a power switch.
	156
1.3	157	To change the parameters of the generation a signal about low battery level, select the "Control → Low SOC (signal)" section:
	158
2.1	159	[[image:1733322624660-513.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="116" width="800"]]
1.3	160
	161	In this section:
	162
76.5	163	* Enable – a flag to enable signal generation;
	164	* Minimum SOC, %;
	165	* Tolerant SOC, %;
	166	* Delay before setting the signal, second;
	167	* Delay before clearing the signal, second;
	168	* Lock – lock the signal until the device is reset.
1.3	169
	170	Signal generation conditions:
	171
	172	* the battery SOC is less than the “Minimum SOC” value during the “Delay before setting the signal” time.
	173
	174	Conditions for clearing the signal:
	175
	176	* the battery SOC is greater than the “Tolerant SOC” during the “Delay before clearing the signal” time.
	177
3.1	178	=== High charging current (signal) ===
1.3	179
76.5	180	The "High charging current" is indicative signal that can be output to a discrete output or a power switch.
	181
1.3	182	To change the parameters of the generation high-current signal, select the "Control → High charging current (signal)" section:
	183
2.1	184	[[image:1733322624661-915.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="107" width="800"]]
1.3	185
	186	In this section:
	187
76.5	188	* Enable – a flag to enable signal generation;
	189	* Maximum charging current, А;
	190	* Tolerant charging current, А;
	191	* Delay before setting the signal, second;
	192	* Delay before clearing the signal, second;
	193	* Lock – lock the signal until the device is reset.
1.3	194
	195	Signal generation conditions:
	196
	197	* the measured current is greater than the “Maximum charging current” value during the “Delay before setting the signal” time.
	198
	199	Conditions for clearing the signal:
	200
	201	* the measured current is less than the “Tolerant charging current” value during the “Delay before clearing the signal” time.
	202
3.1	203	=== Charge map ===
1.3	204
76.5	205	The BMS Main 3 / BMS Main 2R device calculates the maximum allowable charge current values in respect to SOC, battery temperature, contactor temperature and cell voltage.
1.3	206
	207	Calculated current values are sent to a charger or an intellectual load over the CAN bus. External devices based on received data provide correct battery operation.
	208
	209	To configure parameters for determining the charge current limit, select the "Control → Charge map" section:
	210
26.1	211	[[image:1735064362593-844.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="153" width="800"]]
1.3	212
	213	In this section:
	214
76.5	215	* Enable – a flag to start calculation of the charge current limit;
	216	* Maximum charge current – a maximum allowable value of the charge current (under normal conditions), A;
	217	* Rate of change – a rate of change the current limit to a new value (0 is for immediate change), A/s;
	218	* Option 1: Limit charge current by the battery SOC and temperature – a flag to enable correction of maximum allowable charging current Kcs depending on __maximum cell SOC__ and battery temperature;
	219	* Option 1: SOC x Temperature x Factor – the dependence of the correction factor on SOC and battery temperature;
	220	* Option 2: Limit charge current by the contactor temperature – a flag to enable correction of maximum allowable charging current Kcc depending on contactor temperature;
	221	* Option 2: Contactor temperature x Factor – the dependence of the correction factor on SOC and contactor temperature;
	222	* Option 3: Limit charge current by the maximum cell voltage – a flag to enable correction of maximum allowable charging current Kcv depending on __the maximum cell U,,ocv,, voltage__ (corrected due to current and cell resistance)
	223	* Option 3: Cell voltage x Factor – the dependence of the correction factor on maximum cell voltage;
	224	* Option 4: Limit charge current by the cell temperature – a flag to enable correction of maximum allowable charging current Kct depending on maximum cell temperature;
	225	* Option 4: Cell temperature x Factor – the dependence of the correction factor on maximum cell temperature.
1.3	226
	227	Value of the charge current limit at given SOC, temperature, contactors temperature, maximum cell voltage and maximum cell temperature is calculated as follows:
	228
32.1	229	Charge current limit = Maximum charge current × Kcs × Kcc × Kcv × Kct
1.3	230
3.1	231	=== Discharge map ===
1.3	232
76.5	233	The BMS Main 3 / BMS Main 2R device calculates the maximum allowable discharge current values in respect to SOC, battery temperature, contactor temperature and cell voltage.
1.3	234
	235	Calculated current values are sent to a charger or an intellectual load over the CAN bus.
	236
	237	To configure parameters for determining the discharge current limit, select the "Control → Discharge map" section:
	238
26.1	239	[[image:1735064399985-526.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="152" width="800"]]
1.3	240
	241	In this section:
	242
76.5	243	* Enable – a flag to start calculation of the discharge current limit;
	244	* Maximum discharge current – a maximum allowable value of the discharge current (under normal conditions), A;
	245	* Rate of change – a rate of change the current limit to a new value (0 is for immediate change), A/s;
	246	* Option 1: Limit discharging current by the battery SOC and temperature – a flag to enable correction of maximum allowable discharging current Kds depending on __minimum cell SOC__ and temperature;
	247	* Option 1: SOC x Temperature x Factor – the dependence of the correction factor on SOC and battery temperature;
	248	* Option 2: Limit discharge current by the contactor temperature – a flag to enable correction of maximum allowable discharging current Kdc depending on contactor temperature;
	249	* Option 2: Contactor temperature x Factor – the dependence of the correction factor on SOC and contactor temperature;
	250	* Option 3: Limit discharge current by the cell voltage – a flag to enable correction of maximum allowable discharging current Kdv depending on __the minimum cell U,,ocv,, voltage__ (corrected due to current and cell resistance)
	251	* Option 3: Cell voltage x Factor – the dependence of the correction factor on minimum cell voltage;
	252	* Option 4: Limit discharge current by the cell temperature – a flag to enable correction of maximum allowable discharging current Kdt depending on maximum cell temperature;
	253	* Option 4: Cell voltage x Factor – the dependence of the correction factor on minimum cell temperature.
1.3	254
	255	Value of the discharge current limit at given SOC, temperature, contactors temperature, minimum cell voltage and maximum cell temperature is calculated as follows:
	256
32.1	257	Discharge current limit = Maximum discharge current × Kds × Kdc × Kdv × Kdt
1.3	258
3.1	259	=== Charge map (PEAK & CONTINUOUS) ===
1.3	260
76.6	261	The BMS Main 3 / BMS Main 2R has an alternative algorithm for the maximum allowed charging current based on peak and continuous battery operating modes.
1.3	262
	263	To configure parameters for determining the charge current limit, select the "Control → Charge map (PEAK & CONTINUOUS)" section:
	264
26.1	265	[[image:1735064434321-430.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="124" width="800"]]
1.3	266
	267	In this section:
	268
76.6	269	* Enable – a flag to start calculation of the charge current limit;
	270	* Maximum PEAK charge current – a maximum peak charge current (under normal conditions), A;
	271	* Maximum CONTINUOUS charge current – a maximum continuous charge current (under normal conditions), A;
	272	* PEAK: SOC x Temperature x Factor – the dependence of the correction factor for peak current K,,cp,, on SOC and battery temperature;
	273	* CONTINUOUS: SOC x Temperature x Factor – the dependence of the correction factor for continuous current K,,cc,, on SOC and battery temperature;
	274	* PEAK time – a time for peak current to be allowed, s;
	275	* Sliding time – a time of linear change of the maximum charging current from peak to continuous and from continuous to peak value, ms;
	276	* Waiting time – a time for peak current to be prohibited, s.
1.3	277
	278	The maximum charging current value equals to the peak or continuous current according to the following diagram:
	279
2.1	280	[[image:1733322717451-608.png\|\|data-xwiki-image-style-alignment="center"]]
1.3	281
76.6	282	I,,peak,, = Maximum PEAK charge current × K,,cp,,
1.3	283
76.6	284	I,,continuous,, = Maximum CONTINUOUS charge current × K,,cc,,
1.3	285
3.1	286	=== Discharge map (PEAK & CONTINUOUS) ===
1.3	287
76.6	288	The BMS Main 3 / BMS Main 2R has an alternative algorithm for the maximum allowed discharging current based on peak and continuous battery operating modes.
1.3	289
	290	To configure parameters for determining the discharge current limit, select the "Control → Discharge map (PEAK & CONTINUOUS)" section:
	291
26.1	292	[[image:1735064454708-345.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="124" width="800"]]
1.3	293
	294	In this section:
	295
76.6	296	* Enable – a flag to start calculation of the discharge current limit;
	297	* Maximum PEAK discharge current – a maximum peak discharge current (under normal conditions), A;
	298	* Maximum CONTINUOUS discharge current – a maximum continuous discharge current (under normal conditions), A;
	299	* PEAK: SOC x Temperature x Factor – the dependence of the correction factor for peak current K,,dp,, on SOC and battery temperature;
	300	* CONTINUOUS: SOC x Temperature x Factor – the dependence of the correction factor for continuous current K,,dc,, on SOC and battery temperature;
	301	* PEAK time – a time for peak current to be allowed, s;
	302	* Sliding time – a time of linear change of the maximum charging current from peak to continuous and from continuous to peak value, ms;
	303	* Waiting time – a time for peak current to be prohibited, s.
1.3	304
	305	The maximum discharging current value equals to the peak or continuous current according to following diagram:
	306
2.1	307	[[image:1733322753429-968.png\|\|data-xwiki-image-style-alignment="center"]]
1.3	308
76.6	309	I,,peak,, = Maximum PEAK discharge current × K,,dp,,
1.3	310
76.6	311	I,,continuous,, = Maximum CONTINUOUS discharge current × K,,dc,,
1.3	312
10.8	313	=== Main contactor ===
	314
76.7	315	The BMS Main 3 / BMS Main 2R device controls the main contactor. The main contactor is usually placed in the common (minus) battery line for opening the charge and discharge circuits in case of sealing of the charging or discharging contactors.
10.8	316
11.1	317	The Main contactor algorithm supports the following modes:
	318
76.7	319	In “Always on” mode main contactor closes if all the following is true:
11.1	320
33.2	321	* Other contactors are open;
76.8	322	* There are __no errors__ from the "Errors 1, 2 ..." bitfileds.
11.1	323
76.7	324	and opens if all the following is true:
11.1	325
33.2	326	* Other contactors are open;
76.8	327	* There is __an error__ from the the "Errors 1, 2 ..." bitfileds.
11.1	328
76.7	329	In “Automatic” mode, the main contactor closes by internal algorithms at the same time with other contactors.
11.1	330
76.7	331	In “On demand” mode, the main contactor closes by external the “Close Main contactor” request.
11.1	332
29.5	333	(% class="box infomessage" %)
	334	(((
	335	Note: when errors occur in the system, the Main contactor opens either immediately or with the delay T,,off,, (depends on the settings described below).
	336	)))
	337
11.1	338	To change the parameters of the main contactor, select the "Control → Main contactor" section:
	339
26.1	340	[[image:1735064488658-863.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="112" width="800"]]
11.1	341
	342	In this section:
	343
76.7	344	* Enable – a flag to enable the main contactor control;
	345	* Algorithm – main contactor control algorithm:
76.8	346	Always on** – contactor is always closed;
	347	Automatic** – contactor closes by internal charge and discharge algorithms;
	348	On demand** – contactor is closed by an external request;
	349	* Time to keep the contactor closed before closing the others – a time for other contactors to be open after the main contactor is closed;
	350	* Delay before opening the contactor – a time which is used to detect conditions for opening the contactor, s;
	351	* Keep the contactor open until the device is restarted – a flag for keeping the main contactor open until the system is reset;
	352	* Errors 1, 2 to open the main contactor – bitfields to choose the errors which will open the main contactor.
11.1	353
10.8	354	=== Charging status ===
	355
26.1	356	To change the parameters of charging process status, select the "Control → Charging status" section:
	357
75.1	358	[[image:1771432488941-251.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="154" width="800"]]
26.1	359
47.2	360	In this section:
	361
76.8	362	* Current to set the "Charging current present" – a current level to generate the "Charging current present" signal, A;
76.9	363	* Current to clear the "Charging current present" – a current level to clear the "Charging current present" signal, A;
	364	* Voltage to clear the “Ready to charge” – a threshold U,,ocv,, (corrected due to current and cell resistance) voltage level on the cell, V; if the voltage of any cell is above this level, the “Ready to charge” (hence, the “Allow charging”) signal is cleared;
	365	* Voltage to reset the “Ready to charge” – a tolerant U,,ocv,, (corrected due to current and cell resistance) voltage level on the cell, V; if all cell voltages are below the tolerant level, the “Ready to charge” (hence, the “Allow charging”) signal is set;
	366	* Use actual voltage to generate the "Ready to charge" signal – a flag to disable voltage correction for "Ready to charge" signal;
	367	* Treat negative currents as zero currents for generating the "Ready to charge" signal – a flag to disable voltage correction for "Ready to charge" signal at discharging current;
	368	* Delay before recharging – a time after which the previously opened the allow charging contactor closes again, minute; to disable the operation by timeout set "Delay before recharging" to 0;
	369	* Check the 'Charge current limit' value to generate the 'Ready to charge' – a flag to enable check of "Charging current limit" to generate the "Ready to charge" signal;
	370	* Charge current limit to clear the 'Ready to charge' – a threshold charging current limit value, A; if the limit is //above //this level, the “Ready to charge” signal is cleared;
	371	* Charge current limit to set the 'Ready to charge' – a tolerant charging current limit value, A; if the limit is //below //this level, the “Ready to charge” signal is set;
	372	* Errors 1, 2 to clear the "Ready to charge" – bitfields to choose the errors which will clear the "Ready to charge" signal.
10.8	373
11.3	374	(% class="box infomessage" %)
	375	(((
12.2	376	Note: The "Allow charging" signal activates under two independent conditions:
11.3	377	1) the voltage on the cells reaches the “Voltage to reset the “Ready to charge"” level and
	378	2) the "Delay before recharging" time has passed since the opening of the allow charging contactor.
	379	)))
	380
10.8	381	=== Discharging status ===
	382
31.1	383	To change the parameters of discharging process status, select the "Control → Discharging status" section:
26.1	384
73.1	385	[[image:1771431570393-551.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="155" width="800"]]
26.1	386
49.2	387	In this section:
	388
76.9	389	* Current to set the "Discharging current present" – a current level to generate the "Discharging current present" signal, А;
	390	* Current to clear the "Discharging current present" – a current level to clear the "Discharging current present" signal, А;
	391	* Voltage to clear the “Ready to discharge” – a threshold U,,ocv,, (corrected due to current and cell resistance) voltage level on the cell, V; if the voltage of any cell is below this level, the “Ready to discharge” signal is cleared;
	392	* Voltage to reset the “Ready to discharge” – a tolerant U,,ocv,, (corrected due to current and cell resistance) voltage level on the cell, V; if all cells voltages are above the tolerant level, the “Ready to discharge” signal is set;
	393	* Use actual voltage to generate the "Ready to discharge" signal – a flag to disable voltage correction for "Ready to discharge" signal;
	394	* Treat positive currents as zero currents for generating the "Ready to discharge" signal – a flag to disable voltage correction for "Ready to discharge" signal at charging current;
	395	* Check the 'Discharge current limit' value to generate the 'Ready to discharge' – a flag to enable check of "Discharging current limit" to generate the "Ready to discharge" signal;
	396	* Discharge current limit to clear the 'Ready to discharge' – a threshold discharging current limit value, A; if the limit is //above //this level, the “Ready to discharge” signal is cleared;
	397	* Discharge current limit to set the 'Ready to discharge' – a tolerant discharging current limit value, A; if the limit is //below //this level, the “Ready to discharge” signal is set;
76.10	398	* Clear the 'Ready to discharge' signal if the 'Low SOC' signal is set;
	399	* Errors 1, 2 to clear the "Ready to discharge" – bitfields to choose the errors which will clear the "Ready to discharge" signal.
10.8	400
31.1	401	=== Precharge ===
10.8	402
76.10	403	The BMS Main 3 / BMS Main 2R device can control the precharge contactor. The precharge contactor is used to charge the intermediate capacity with low current and usually placed with the limiting resistor in parallel to charging or discharging contactor.
10.8	404
76.10	405	BMS Main 3 device detects errors while pre-charging the load capacity by monitoring the current and voltage difference before and after contactors.
26.1	406
76.10	407	BMS Main 2R device detects errors while pre-charging the load capacity only by monitoring the current.
	408
	409	Also BMS can measure the power dissipated on precharge resistor and generate an error if it greater than configured limit.
	410
31.1	411	TBA
	412
26.1	413	To change the parameters of precharge contactor, select the "Control → Precharge" section:
	414
53.2	415	[[image:1750328428183-819.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="178" width="800"]]
26.1	416
	417	* Precharge current threshold to finish precharging – a minimum current value at which precharging process assumed to be finished, A;
	418	* Check voltages before and after contactors to finish precharging – a flag to check the voltages before and after contactors to ensure that precharge process has finished and it is allowed to close the discharging contactor;
	419	* Minimum voltage difference to finish precharging – minimal voltage difference before and after contactors at which precharge process is meant to be finished, V;
53.8	420	* Keep the precharging relay closed until precharge is finished – a flag to ignore the Precharge time and wait precharging to finish before open precharge relay;
26.1	421	* Number of precharging attempts – maximum number of precharging attempts before setting the "Precharge error";
53.7	422	* Delay before current measurement – a delay before first current measurement after closing precharge, millisecond;
26.1	423	* Precharge time – a duration of closing the precharge contactor before closing the discharging contactor, millisecond;
	424	* Relaxation between attempts – a duration between precharge attempts, millisecond;
	425	* Check the power dissipated in the preacharge resistor - a flag to enable the calculation of power dissipated in precharge resistor;
	426	* Precharge resistor resistance, Ohm;
	427	* Maximum allowable power dissipated in the resistor, W;
	428	* Delay before setting the "Precharge error" when checking power, millisecond;
	429	* Delay before clearing the "Precharge error", second;
	430	* Lock the "Precharge error" – a flag to block the error until the device is restarted.
	431
36.1	432	“Precharge error” generation conditions if any of the following is true:
26.1	433
36.1	434	* the precharge current does not decrease during the "Precharge time" after "Number of precharging attempts";
	435	* voltages before and after contactors are not equal during the "Precharge time" after "Number of precharging attempts";
26.1	436	* power dissipated on the precharge resistor is above the maximum value during the “Delay before setting the 'Precharge error' when checking power” time.
	437
29.2	438	(% class="box warningmessage" %)
26.1	439	(((
29.2	440	Behavior of contactors at “Precharge error” is configured in corresponding contactor settings!
26.1	441	)))
	442
3.1	443	=== Charge ===
1.3	444
	445	There are two contactors that serve charging the battery: a charging contactor and an allow charging contactor. With the help of the allow charging contactor, the BMS commands the charger to start or stop charging.
	446
	447	The device supports three charge control algorithms:
	448
	449	* Always on – charging is always allowed;
	450	* On charger connected – charging is allowed when there is a signal “Charger connected”;
	451	* On charge request – charging is allowed when there is a signal “Charge request”.
	452
33.7	453	If the "Always on" algorithm is selected, the charging contactor and the allow charging contactor are always closed. If at least one of the errors from the "Errors 1, 2 ..." bitfields appears or one of the signals:
1.3	454
12.9	455	* Service reset;
	456	* Power down request;
12.8	457	* Inhibit charging,
1.3	458
33.7	459	both contactors are open (no current flows).
1.3	460
	461	When the algorithm "On charger connected" is selected, the control is performed as follows:
	462
33.7	463	* If there is a signal “Charger connected” and there are no errors (see the "Errors 1, 2 ..." bitfields), then through the delay time T,,on,, the charging contactor and the allow charging contactor close;
1.3	464	* If the signal “Charger connected” disappears, the allow charging contactor opens and after the delay time T,,off,, the charging contactor opens;
	465	* If in the process of charging the voltage on the cell exceeds the “Ready to charge” level, the allow charging contactor opens (while the charging contactor remains closed);
33.7	466	* If errors from the "Errors 1, 2 ..." bitfields occur the charging contactor and allow charging contactor open.
1.3	467
	468	When the "On charge request" algorithm selected, the control is performed as follows:
	469
33.7	470	* If there is a signal “Charge request” and there are no errors (see the "Errors 1, 2 ..." bitfields), then through the delay time T,,on,, the charging contactor and the allow charging contactor close;
1.3	471	* If the signal “Charge request” disappears, the allow charging contactor opens and after the delay time T,,off,, the charging contactor opens;
	472	* If in the process of charging the voltage on the cell exceeds the “Ready to charge” level, the allow charging contactor opens (while the charging contactor remains closed);
33.8	473	* If errors from the "Errors 1, 2 ..." bitfields occur the charging contactor and allow charging contactor open.
1.3	474
12.8	475	(% class="box infomessage" %)
	476	(((
29.5	477	Note: when errors occur in the system, the Charge contactor opens either immediately or with the delay T,,off,, (depends on the settings described below).
12.8	478	)))
1.3	479
	480	To change the parameters of the battery charge control algorithm, select the "Control → Charge" section:
	481
12.3	482	[[image:1735063563460-549.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="262" width="800"]]
1.3	483
	484	In this section:
	485
	486	* Enable – a flag to activate the charge control;
	487	* Algorithm:
	488	** Always on – charging is always allowed;
	489	** On charger connected – charging is allowed when there is a signal “Charger connected”;
	490	** On charge request – charging is allowed when there is a signal “Charge request”;
12.6	491	* Allow charging only when the "Ready to charge" signal is set – charging contactor will open if "Ready to charge" signal is cleared;
1.3	492	* Delay before starting charging – a time delay T,,on,, before closing the charging contactor and the allow charging contactor, millisecond;
	493	* Delay before stopping charging – a time delay T,,off,, before opening the charging contactor, millisecond;
42.5	494	* Control the precharging contactor – a flag that allows control of the precharging contactor while closing the charge contactor (see [[Precharge>>path:#HPrecharge]]);
12.8	495	* Errors 1, 2 to open the charging contactor – bitfields to choose the errors which will open the charging contactor;
1.3	496	* Use custom delays before stopping charging (on errors) – a flag to enable manual settings of time delays T,,off,, for specific errors;
12.8	497	* Custom delay: <error> – delay for specific error, millisecond;
1.3	498	* Switch off the charging contactor on errors without delay – a flag to protectively open the charging contactor without a delay. In the opposite case, when an error is detected, the charging contactor opens always with the delay “Delay before stopping charging”;
	499
3.1	500	=== Discharge ===
1.3	501
	502	The device controls the discharging contactor to connect battery to the load.
	503
	504	The device supports three algorithms to control battery discharging:
	505
	506	* Always on – load is always connected;
	507	* On charger disconnected – load is connected when there is no signal “Charger connected”;
	508	* On discharge request – load is connected when there is signal “Discharge request”.
	509
33.8	510	When the algorithm "Always on" is selected, the discharging contactor is always closed. If at least one of the errors from the "Errors 1, 2 ..." bitfields appears or one of the signals:
1.3	511
	512	* Service reset
	513	* Power down request
	514	* Inhibit discharging
	515
	516	the discharging contactor opens.
	517
	518	If the algorithm "On charger disconnected" is selected, the control is performed as follows:
	519
33.8	520	* if there is no signal “Charger connected”, the charging contactor is open and there are no errors (see the "Errors 1, 2 ..." bitfields), then through the delay time T,,on,, the discharging contactor closes;
	521	* If the signal “Charger connected” appears or errors occur (see the "Errors 1, 2 ..." bitfields), then after the delay time T,,off,, the discharging contactor opens.
1.3	522
	523	When the "On discharge request" algorithm selected, the control is performed as follows:
	524
33.9	525	* if there is signal “Discharge request”, the charging contactor is open and there are no errors (see the "Errors 1, 2 ..." bitfields), then through the delay time T,,on,, the discharging contactor closes;
33.8	526	* If the signal “Discharge request” disappears or errors occur (see the "Errors 1, 2 ..." bitfields), then after the delay time T,,off,, the discharging contactor opens.
1.3	527
12.9	528	(% class="box infomessage" %)
	529	(((
29.5	530	Note: when errors occur in the system, the Discharge contactor opens either immediately or with the delay T,,off,, (depends on the settings described below).
12.9	531	)))
1.3	532
	533	To change the parameters of the battery discharge control algorithm, select the "Control → Discharge" section:
	534
13.2	535	[[image:1735064038329-836.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="273" width="800"]]
1.3	536
	537	In this section:
	538
	539	* Enable – a flag to activate the discharge control;
	540	* Algorithm:
	541	** Always on – load is always connected;
	542	** On charger disconnected – load is connected when there is no signal “Charger connected”;
	543	** On discharge request – load is connected when there is signal “Discharge request”;
13.3	544	* Allow charging only when the "Ready to discharge" signal is set – discharging contactor will open if "Ready to discharge" signal is cleared;
1.3	545	* Delay before starting discharging – a time delay T,,on,, before closing the discharging contactor, millisecond;
	546	* Delay before stopping discharging – a time delay T,,off,, before opening the discharging contactor, millisecond;
42.6	547	* Control the precharging contactor – a flag that allows control of the precharging contactor while closing the discharge contactor (see [[Precharge>>doc:\|\|anchor="HPrecharge"]]);
13.2	548	* Errors 1, 2 to open the discharging contactor – bitfields to choose the errors which will open the discharging contactor;
1.3	549	* Use custom delays before stopping discharging (on errors) – a flag to enable manual settings of time delays T,,off,, for specific errors;
	550	* Custom delay: <error> – specific error delay, millisecond;
	551	* Switch off the discharging contactor on errors without delay – a flag to protectively open the discharging contactor without a delay. In the opposite case, when an error is detected, the discharging contactor opens always with the delay “Delay before stopping discharging”.
	552
3.1	553	=== Charge/Discharge ===
1.3	554
27.3	555	The BMS Main 3 device can control the charge/discharge contactor, which combines algorithms of charging and discharging contactor.
1.3	556
27.3	557	Charge/Discharge contactor has three algorithms of operation:
27.2	558
28.1	559	* Dependent (on Charging and Discharging signals) - Charge/Discharge contactor depends on Charge and Discharge algorithms and their signals and behaves as Charging contactor if Charging signal is set, otherwise – as Discharging contactor;
	560	* Independent (Always) - Charge/Discharge contactor is always closed if there is no errors;
28.3	561	* Independent (on Charge request or Discharge request) - Charge/Discharge contactor is based on its own controller that listen to Charge and Discharge requests and closes if one of these signals occurs.
27.3	562
31.1	563	TBA
	564
29.2	565	(% class="box infomessage" %)
	566	(((
29.5	567	Note: when errors occur in the system, the Charge/Discharge contactor opens either immediately or with the delay T,,off,, (depends on the settings described below).
29.2	568	)))
	569
1.3	570	The charging/discharging contactor control is configured in the “Control – Charge/Discharge” section:
	571
27.2	572	[[image:1735122153011-166.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="162" width="800"]]
1.3	573
	574	In this section:
	575
	576	* Enable – a flag to enable the charge/discharge controller.
28.1	577	* Algorithm:
	578	** Dependent (on Charging and Discharging signals) - Charge/Discharge contactor depends on Charge and Discharge algorithms and their signals and behaves as Charging contactor if Charging signal is set, otherwise – as Discharging contactor;
	579	** Independent (Always) - Charge/Discharge contactor is always closed if there is no errors;
	580	** Independent (on Charge request or Discharge request);
	581	* Delay before starting charging or discharging, millisecond;
	582	* Delay before stopping charging or discharging, millisecond;
	583	* Control the precharging contactor – a flag that enables control of precharging contactor while closing the charge/discharge contactor;
	584	* Emulate the "Charging" and "Discharging" signals – a flag to enable generation of "Charging" and "Discharging" signals when closing charge/discharge contactor;
	585	* Errors 1, 2 to prevent CHARGING through charging/discharging contactor, Errors 1, 2 to prevent DISCHARGING through charging/discharging contactor – bitfields to choose the errors which will open the charging/discharging contactor. This bitfields are combined by bitwise OR and intended to separate settings for charging and discharging processes;
	586	* Errors 1, 2 which affect the contactor only if battery CHARGING is detected – a bitfield to choose the errors which will trigger only if charging current is present. This bitfield is combined with "Errors 1, 2 to prevent CHARGING through charging/discharging contactor" by bitwise AND;
	587	* Errors 1, 2 which affect the contactor only if battery DISCHARGING is detected – a bitfield to choose the errors which will trigger only if discharging current is present. This bitfield is combined with "Errors 1, 2 to prevent DISCHARGING through charging/discharging contactor" by bitwise AND;
	588	* Switch off the charging/discharging contactor on errors without delay – a flag to protectively open the charging/discharging contactor without a delay. In the opposite case, when an error is detected, the charging/discharging contactor opens always with the delay “Delay before stopping discharging”.
1.3	589
3.1	590	=== Discharge (AUX) ===
1.3	591
	592	The BMS Main 3 device can control the power supply of external equipment using the auxiliary (AUX) discharging contactor. An example of external equipment can be an inverter that converts DC to AC to power a service laptop and other devices.
	593
	594	The power supply circuit of the external equipment using the auxiliary (AUX) discharging contactor is independent of the battery load circuit. The closing and opening of the auxiliary (AUX) discharging contactor is performed according to its program.
	595
	596	If the power supply function of the external equipment is enabled, the auxiliary (AUX) discharging contactor closes. The opening of this contactor occurs on three independent conditions:
	597
	598	* the battery has low SOC;
	599	* the battery voltage is out of range;
33.10	600	* the errors are detected (configured in the "Errors 1, 2 ..." bitfields).
1.3	601
	602	To change the parameters of the powering of external equipment, select the "Control → Discharge (AUX)" section:
	603
26.1	604	[[image:1735066190419-838.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="161" width="800"]]
1.3	605
	606	In this section:
	607
	608	* Enable – a flag to activate the auxiliary discharge control;
	609	* Switch off the discharging (AUX) contactor if the SOC is too low;
	610	* Minimum SOC – a minimum SOC value, when reached, the auxiliary (AUX) discharging contactor opens, %;
	611	* Tolerant SOC – a permissive SOC value, upon reaching which the auxiliary (AUX) discharging contactor re-closes, %;
38.1	612	* Switch off the discharging (AUX) contactor if the cell voltage is out of the range;
	613	* Minimum cell voltage, V;
	614	* Maximum cell voltage, V;
1.3	615	* Switch off the discharging (AUX) contactor if the battery voltage is out of the range;
26.1	616	* Minimum battery voltage, V;
	617	* Maximum battery voltage, V;
42.7	618	* Errors 1, 2 to open the auxiliary discharging contactor – bitfields to choose the errors which will open the auxiliary discharging contactor.
1.3	619
3.1	620	=== Cell balancing ===
1.4	621
	622	Balancing makes the voltage of all cells equal to the minimum cell voltage.
	623
	624	The following balancing rules are supported:
	625
	626	* when the battery is charging (current I > 0) and time after until the battery is relaxed;
	627	* when the battery is charging (current I > 0) or when the battery is in a state of relaxation;
	628	* always (regardless of battery state).
	629
	630	A balancing resistor is connected to the cell if the following conditions are simultaneously met:
	631
	632	* the voltage on the cell is higher than the balancing start voltage;
39.2	633	* the difference between the voltage on the cell and the minimum voltage among the battery cells is greater than the balancing start threshold;
1.4	634
	635	A balancing resistor is disconnected from the cell if any of the following conditions are met:
	636
41.1	637	* the voltage on the cell is less than the balancing stop voltage;
1.4	638	* the difference between the voltage on the cell and the minimum voltage among the battery cells is less than the balancing stop threshold.
	639
42.7	640	(% class="box infomessage" %)
	641	(((
1.4	642	If the “High logic temperature” occurs, then the balancing of the cells connected to the overheated BMS Logic device will not be performed.
42.7	643	)))
1.4	644
	645	The BMS Main 3 can enable the cell balancing by the external “Balancing request” signal. Balancing process will be started to cells which the voltage is higher than the balancing start voltage and the difference between the cell voltage and the minimum voltage among all the cells is greater than the balancing stop threshold.
	646
40.1	647	BMS Main 3 can force a cell balancing, if its voltage is higher than estimated value.
39.2	648
1.4	649	To change the cell balancing parameters, select the "Control → Cell balancing" section:
	650
26.1	651	[[image:1735065702806-422.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="130" width="800"]]
1.4	652
	653	In this section:
	654
	655	* Enable – a flag to enable cell balancing;
	656	* Balancing rule:
	657	** Balance on charge – balancing is performed while and after the charging (in the “Charge ON” and “Charge OFF” states);
	658	** Balance on charge or relaxed - balancing is performed while and after the charging and in the relaxed state (in “Charge ON”, “Charge OFF”, “Relaxed (after charging)” and “Relaxed (after discharging)” states);
	659	** Balance always – balancing is always performed regardless the battery state;
26.1	660	* Balancing condition:
	661	** Automatic – balancing will be performed automatically if needed conditions are met;
	662	** On balancing request – balancing will start only if a remote request is received. In this case cells will start to balance regardless the "Voltage deviation to start balancing" value;
1.4	663	* Minimum cell voltage to start balancing, V;
	664	* Voltage deviation to start balancing;
	665	* Voltage deviation to stop balancing;
28.4	666	* Voltage for forced balancing – if cell voltage is above this value, it will start discharging through balancing resistor;
26.1	667	* Maximum allowable temperature of BMS Logic devices, ºC;
1.4	668	* Command to discharge all cells – a flag to force the balancing of all cells.
	669
3.1	670	=== Series balancing ===
1.4	671
	672	The BMS Main 3 device supports work with two independent (galvanically unrelated) cell series. To monitor the status of two series, two current sensors are used. A series of cells must be equivalent: they must have the same number of cells and the same capacity.
	673
	674	Since the series of cells can operate at different loads, they must be balanced. For this, the BMS Main 3 provides two signals to power switches: “Balancing series 1” and “Balancing series 2”, as well as a combined algorithm that considers both the voltage of each series and the charge that these series gave load. The “Balancing series 1” and “Balancing series 2” signals are used to connect high-power balancing resistors in parallel with cell series 1 and 2.
	675
	676	When charging the battery, balancing is performed based on the voltage of the series. A balancing resistor is connected to the cell series if:
	677
	678	* the series voltage is higher than the start balancing voltage;
	679	* the difference between the voltage of a series of cells and the minimum voltage among the battery series is greater than the balancing threshold.
	680
	681	When the battery is discharging (work on load), balancing is turned on if one of the series gives the load a charge (Ah), which is more by the amount Qthr of the charge given off by another series.
	682
	683	To change the series balancing parameters, select the "Control → Series balancing" section:
	684
2.1	685	[[image:1733322892811-410.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="126" width="800"]]
1.4	686
	687	In this section:
	688
	689	* Enable – a flag to enable series balancing;
	690	* Number of Logics in a series;
	691	* Minimum series voltage to start balancing, V;
	692	* Balancing threshold, V;
	693	* Coulomb threshold – the difference of the charges Qthr, given by a series of cells, above which balancing to be started, Ah;
	694	* Period – a period to reset of charge counters for each series (to avoid accumulation of error), second;
2.1	695	* Do not sum series voltages – a flag to disable the summing of series voltages.3
1.4	696
3.1	697	=== Power down ===
1.4	698
	699	The BMS Main 3 device can shut down itself if the battery voltage is low or the battery is idle for a long time.
	700
	701	Shutting down the battery system is performed according to the following conditions:
	702
	703	* the battery voltage is below the minimum level;
	704	* the “Charger connected” signal is cleared for 60 seconds.
	705
	706	The BMS Main 3 device also shuts down the battery if it stays in the “Charging OFF”, “Discharging OFF”, “Relaxed (after charging)” or “Relaxed (after discharging)” for the configured time.
	707
	708	To change the parameters of the power down control, select the "Control → Power down" section:
	709
2.1	710	[[image:1733322892813-562.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="103" width="800"]]
1.4	711
	712	In this section:
	713
	714	* Minimum voltage to power down – a minimum voltage level of the battery below which the BMS commands to shut down the battery, V;
	715	* Idle time to power down – a time of battery inactivity after which the battery is shut down, minute;
	716	* Wait the "Power up/down request" is cleared (on startup) – a flag to enable delay for clearing the “Power up/down request” signal while starting the BMS.
	717	* Power down if KEYRUN and CHARGE_ON are cleared – a flag to power down the device if KEYRUN and CHARGE_ON signals are cleared;
	718	* Delay before setting the internal power down signal – a delay before turning off the device power when removing KEYRUN and CHARGE_ON or receiving the “Power down request” command, ms.
	719
3.1	720	=== Heater ===
1.4	721
	722	To change the parameters of the heater control algorithm, select the "Control → Heater" section:
	723
2.1	724	[[image:1733322901923-144.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="108" width="800"]]
1.4	725
	726	In this section:
	727
	728	* Enable – a flag to enable the heater control;
	729	* Minimum cell temperature, °C;
	730	* Tolerant cell temperature, °C;
	731	* Delay before starting the heater, millisecond;
	732	* Delay before stopping the heater, millisecond;
	733	* Switch off the heater on errors (Undervoltage, Overcurrent, High temperature, Short circuit or Critical error).
	734
	735	As a result of operating the heating algorithm, the “Heater” signal is generated.
	736
	737	Conditions for signal generation:
	738
	739	* the minimum temperature among all cells of the battery is less than the “Minimum cell temperature” value during the “Delay before starting the heater” time.
	740
	741	Conditions for clearing the signal:
	742
	743	* the minimum temperature among all cells of the battery is greater than the “Tolerant cell temperature” value during the “Delay before stopping the heater” time.
	744
39.1	745	(% class="box infomessage" %)
	746	(((
33.10	747	If there is the "Heater" signal, the heater contactor closes and/or a signal is set to the corresponding digital output.
39.1	748	)))
1.4	749
3.1	750	=== Cooler ===
1.4	751
	752	To change the parameters of the cooler control algorithm, select the "Control → Cooler" section:
	753
2.1	754	[[image:1733322901924-962.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="107" width="800"]]
1.4	755
	756	In this section:
	757
	758	* Enable – a flag to enable the cooler control;
	759	* Maximum cell temperature, °C;
	760	* Tolerant cell temperature, °C;
	761	* Delay before starting the cooler, millisecond;
	762	* Delay before stopping the cooler, millisecond;
	763	* Switch off the cooler contactor on errors (Undervoltage, Overcurrent, Low temperature, Short circuit or Critical error).
	764
	765	As a result of operating the cooling algorithm, the "Cooler" signal is generated.
	766
	767	Conditions for signal generation:
	768
	769	* the maximum temperature among all cells of the battery is greater than the “Maximum cell temperature” value during the “Delay before starting the cooler” time.
	770
	771	Conditions for clearing the signal:
	772
	773	* the maximum temperature among all cells of the battery is less than the “Tolerant cell temperature” value during the “Delay before stopping the cooler” time.
	774
39.1	775	(% class="box infomessage" %)
	776	(((
33.10	777	If there is the "Cooler" signal, the cooler contactor closes and/or a signal is set to the corresponding digital output.
39.1	778	)))
1.4	779
3.1	780	=== High voltage ===
1.4	781
	782	The BMS Main 3 device has an ability to measure high voltages before and after contactors.
	783
	784	To change the parameters of high voltage fault, select the "Control → High voltage" section:
	785
3.1	786	[[image:1733322914683-203.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="87" width="800"]]
1.4	787
	788	In this section:
	789
	790	* Enable – a flag to enable High voltage control;
	791	* Delay before clearing the High voltage fault, second;
	792	* Lock the High voltage fault.
	793
	794	The BMS Main 3 implements a self-diagnostics of high-voltage measurement lines. If measurement line breaks or high-voltage polarity is wrong, “High voltage fault” is generated.
	795
26.1	796	(% class="box warningmessage" %)
	797	(((
29.5	798	If there is the “High voltage fault”, the “Critical error” is generated.
26.1	799	)))
1.4	800
3.1	801	=== Cell analysis ===
1.4	802
	803	The battery discharge characteristic – the dependence Uocv = Uocv(DOD) – is used to determine the tabular dependence Uocv = Uocv(SOC, t°C), which is necessary for calculating the battery charge level.
	804
	805	The BMS Main 3 device can automatically determine the battery discharge characteristic.
	806
	807	Before starting the process of determining the discharge characteristic, it is necessary to prepare a BMS:
	808
	809	1. Charge the battery.
	810	1. Connect a resistive load to the discharging contactor, which will provide a discharge current of 0.5C (where C is the cell capacitance).
	811
	812	To configure parameters for determining the discharge characteristic of the battery, select the "Control → Cell analysis" section:
	813
3.1	814	[[image:1733322914685-558.png\|\|data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="107" width="800"]]
1.4	815
	816	In this section:
	817
	818	* Enable – a flag to enable cell analysis;
	819	* Discharge step, Ah;
	820	* Delta voltage – a maximum allowable voltage drop for the cell, V;
	821	* Logic index, Cell index – a position of the analyzed cell;
	822	* Analyse the most discharged cell – a flag to analyse of the least charged cell (in this case, the values “Logic index” and “Cell index” are ignored).
	823
	824	Discharge step should be set equal to
	825
	826	Discharge step= С/21,
	827
	828	where C is the cell capacity.
	829
	830	The discharge characteristic will be constructed for the given cell (its position is determined by the fields “Logic index” and “Cell index”).
	831
	832	The algorithm for determining the discharge characteristic of the battery will be started if the “Enable” flag is set. From this moment, the control of the discharge contactor is performed by this algorithm.
	833
	834	Algorithm steps:
	835
	836	1. DOD = 0.
	837	1. Opening the discharging contactor.
	838	1. Waiting for the relaxation of the battery.
	839	1. Measuring Uocv = U.
	840	1. Saving the point of the discharge characteristic (Q, U,,OCV,,).
	841	1. Closing of the discharging contactor. DOD,,1,, = DOD + Discharge step, U,,1,, = U
	842	1. If DOD = DOD,,1,, or U < (U,,1,, – Delta voltage), then go to step 2.
	843	1. If the "Undervoltage" error is detected, then the end of the algorithm.
	844
	845	During the operation of the algorithm, a file with the name "CELLANALYSIS.TXT" in the CSV format will be created on the SD card.
	846
	847	File structure:
	848
	849	\|Time\|DOD\|Logic\|Cell\|OCV\|Resistance
	850	\|10.11.2017 12:28:34\|0.0\|1\|1\|4.180\|0.080000
	851	\|...\|...\| \|…\|...\|...
	852
	853	Parameter names:
	854
	855	* Time – date and time;
	856	* DOD – depth of discharge, Ah;
	857	* Logic - position of the Logic device to which the analyzed cell is connected;
	858	* Cell – position of the analyzed cell for which OCV and Resistance values are provided;
	859	* OCV – cell voltage Uocv, V;
	860	* Resistance – cell resistance, Ohm.

Wiki source code of 3.3 Control

Applications

Navigation

Table of Contents