Wiki source code of 3.3 Control

Version 9.3 by Admin on 2025/02/28 13:40

Show last authors
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 = Settings =
3
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 ==
6
7 === General parameters ===
8
9 General parameters of BMS Main X are configured in the «Control → General» section:
10
11 [[image:1740747822632-731.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="111" width="800"]]
12
13 In this section:
14
15 * Initialization delay – a delay before processing functions after finishing device initialization (initialization includes current sensors calibration and battery modules search), millisecond.
16
17 === Battery modules ===
18
19 The BMS Main X allows up to 32 battery modules to be connected in parallel.
20
21 Flags for enabling battery modules are configured in the "Control → Modules → Enable (modules 1 to 8)" and "Control → Modules → Enable (modules 9 to 32)" section:
22
23 [[image:1740747928147-952.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="226" width="800"]]
24
25 The network addresses of the battery modules are configured in the "Control - Modules - Node IDs" section:
26
27 [[image:1740747965546-449.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="252" width="800"]]
28
29 Each module in a battery must have a unique address. You can change the address in the battery module settings in the “Connectivity → CAN” section of the BMS Main or BMS Mini S / BMS Mini 2 settings.
30
31 In corresponding section you can set up minimum number of found modules to finish initialization.
32
33 === Calculation of battery parameters ===
34
35 The BMS Main X device calculates battery parameters based on user settings.
36
37 Calculation of the battery state of charge (SOC) is configured in the "Control - Calculation - Final SOC" section:
38
39 [[image:1740749535746-215.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="106" width="800"]]
40
41 The following battery SOC calculation methods are supported:
42
43 * Minimal SOC – SOC of the modular battery is assumed to be the minimum SOC among the battery modules;
44 * Average SOC – SOC of the modular battery is taken equal to the arithmetic average of the SOC of the battery modules;
45 * Min-Max SOC – the battery SOC is calculated based on the minimum and maximum SOC of the modules. Final SOC will be a) 100% if any module has 100% SOC, b) 0% if any module has 0% SOC;
46 * Max-Min SOC – the battery SOC is calculated based on the minimum and maximum SOC of the modules. Final SOC will be a) 100% if all modules have 100% SOC, b) 0% if all modules have 0% SOC;
47
48 Calculation of the battery state of health (SOH) is configured in the "Control → Calculation → Final SOH" section. The following battery SOH calculation methods are supported:
49
50 * Minimal SOH – SOH of the modular battery is assumed to be the minimum SOH among the battery modules;
51 * Average SOH – SOH of the modular battery is taken equal to the arithmetic average of the SOH of the battery modules.
52
53 === Main contactor ===
54
55 The BMS Main X 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.
56
57 The Main contactor algorithm supports the following modes:
58
59 * Always on;
60 * Automatic, when the main contactor closes by the internal charging and discharging algorithms at the same time with Precharging, Charging, Discharging and Charging/Discharging contactors.
61
62 In “Always on” mode main contactor closes if all the following is true:
63
64 * Other contactors are open;
65 * There are no errors from the "Errors 1, 2 ..." bitfileds.
66
67 In “Always on” mode main contactor opens if all the following is true:
68
69 * Other contactors are open;
70 * There is an error from the the "Errors 1, 2 ..." bitfileds.
71
72 In “Automatic” mode, the main contactor closes by internal algorithms at the same time with other contactors.
73
74 To change the parameters of the main contactor, select the "Control → Main contactor" section:
75
76 [[image:1740749605680-464.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="117" width="800"]]
77
78 In this section:
79
80 * Enable – a flag to enable the main contactor control;
81 * Algorithm – main contactor control algorithm:
82 ** Always on – contactor is always closed;
83 ** Automatic – contactor closes by internal charge and discharge algorithms;
84 * Time to keep the contactor closed before closing the others – a time for other contactors to be open after the main contactor is closed, millisecond;
85 * Delay before opening the contactor – a time which is used to detect conditions for opening the contactor, millisecond;
86 * Keep the contactor open until the device is restarted – a flag for keeping the main contactor open until the system is reset;
87 * Errors to open the main contactor – error flags that cause the contactor to open.
88
89 === Charging status ===
90
91 To change the parameters for generating status signals when charging the battery, select the section “Control → Charging status”:
92
93 [[image:1740749824773-539.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="104" width="800"]]
94
95 In this section:
96
97 * Current corresponding to charging – a current level to set the "Charging current present" signal, A;
98 * Current corresponding to no charging – a current level to clear the "Charging current present" signal, A.
99
100 === Discharging status ===
101
102 To change the parameters for generating status signals when discharging the battery, select the section “Control → Discharging status”:
103
104 [[image:1740749862820-455.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="95" width="800"]]In this section:
105
106 * Current corresponding to discharging – a current level to set the "Discharging current present" signal, A;
107 * Current corresponding to no discharging – a current level to clear the "Discharging current present" signal, A.
108
109 === Precharge ===
110
111 To change the precharge parameters, select the section “Control → Precharge”:
112
113 [[image:1740749922669-238.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="165" width="800"]]
114
115 In this section:
116
117 * Precharge current threshold to close the discharging contactor – a current value to ensure that precharge process has finished and it is allowed to close the discharging contactor, A;
118 * Number of precharging attempts – maximum number of precharging attempts before setting the "Precharge error";
119 * Delay before current measurement – a delay before first current measurement after closing precharge, millisecond;
120 * Precharge time – a duration of closing the precharge contactor before closing the discharging contactor, millisecond;
121 * Relaxation between attempts – a duration between precharge attempts, millisecond;
122 * Check the power dissipated in the preacharge resistor - a flag to enable the calculation of power dissipated in precharge resistor;
123 * Precharge resistor resistance, Ohm;
124 * Maximum allowable power dissipated in the resistor, W;
125 * Delay before setting the "Precharge error" when checking power, millisecond;
126 * Delay before clearing the "Precharge error", second;
127 * Lock – a flag to block the error until the device is restarted.
128
129 “Precharge error” generation conditions if any of the following is true:
130
131 * the precharge current does not decrease during the "Precharge time" after "Number of precharging attempts";
132 * voltages before and after contactors are not equal during the "Precharge time" after "Number of precharging attempts";
133 * power dissipated on the precharge resistor is above the maximum value during the “Delay before setting the 'Precharge error' when checking power” time.
134
135 (% class="box warningmessage" %)
136 (((
137 Behavior of contactors at “Precharge error” is configured in corresponding contactor settings!
138 )))
139
140 === Charge ===
141
142 The BMS Main X device manages the parallel connection of the battery modules and the connection of the battery to the charging circuit.
143
144 The device supports the following charging modes:
145
146 1. Charging is always allowed (Always on) – the device ignores voltage and current unbalance of the battery modules and commands to close the charging contactors of the battery modules and the main charging contactor.
147 1. Charging is allowed provided that all battery modules are balanced (Balanced).
148 1. Charging is allowed for most balanced battery modules (Partially balanced). Unbalanced modules are disconnected from the common bus and do not participate in the charging.
149
150 The device controls two processes: joining battery modules and closing the main charging contactor.
151
152
153 The operation of the joining battery modules is described by the following steps:
154
155 1. Battery modules are disabled. When the “Join to charge” request is received and the voltage and current unbalance errors (Voltage unbalance (CH), Current unbalance (CH), Charging current unbalance) are cleared, go to step 2.
156 1. Checking the voltage unbalance of battery modules (the duration of the check is set in the settings). If there is no imbalance or errors are ignored (“Always on” and “Partially balanced”), go to step 3, otherwise open all charging contactors, and go to step 1.
157 1. Closing the precharging contactors of the battery modules (optional). Go to step 4.
158 1. Closing the charging contactors of the battery modules. The battery modules are self-balancing. Go to step 5.
159 1. Checking intermodular balancing currents (the duration of the check is set in the settings). If there is no current unbalance (“Current unbalance (CH)”) or errors are ignored (“Always on”), go to step 6, otherwise open all charging contactors, and go to step 1.
160 1. The battery modules are joined. If the “Join to charge” request is cleared or the "Charging current unbalance" and "Critical error" errors occur, go to step 1.
161
162 The operation of the main charging contactor is described in the following steps:
163
164 1. The main charging contactor is open. When the “Charge request” is received, the voltage and current unbalance errors (“Voltage unbalance (CH)”, “Current unbalance (CH)”, “Charging current unbalance”) are cleared, and the battery modules are joined, go to step 2.
165 1. Closing the main precharging contactor (optional). Go to step 3.
166 1. Closing the main charging contactor ("Charging" signal). Go to step 4.
167 1. The main charging contactor is closed. If the "Charge request" is cleared, the battery modules are disconnected, or the "Critical error" occurs, go to step 1.
168
169 The command to turn on the main charging contactor (“Charging”) can be issued both to the upper-level system via the CAN bus (external), and on the opto-relay of the device that serves to directly control the main charging contactor.
170
171 In addition to controlling the charging contactors, the charge controller calculates and transmits to the upper-level system the value of the maximum allowable current, which can be used to charge the modular battery (“Charge current limit”). The calculation of the charging current of the entire battery is performed based on the number of battery modules operating per charge and the values of the current limits transmitted by them.
172
173 The battery charge management is configured in the "Control - Charge" section:
174
175 [[image:1734356553573-447.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="146" width="600"]]
176
177 In this section:
178
179 * Enable – a flag to enable battery charge controller;
180 * Algorithm:
181 ** Always on – charging is always allowed;
182 ** Balanced – charging is allowed provided that all battery modules are balanced;
183 ** Partially balanced – charging is allowed for most balanced battery modules;
184 * Current corresponding to charging – a current level to set the "Charging current present" signal, A;
185 * Current corresponding to no charging – a current level to clear the "Charging current present" signal, A;
186 * Maximum current to rejoin modules – a maximum allowable current at which rejoining of battery modules is allowed, A;
187 * Checking voltages time – a time of checking voltages of battery modules, ms;
188 * Pre-balancing modules time – a time of pre-charging battery modules, ms;
189 * Balancing modules time – a time of balancing battery modules, ms;
190 * Control the precharging relay – a flag to control the main precharging contactor;
191 * Precharging time – a time of precharging, ms;
192 * Cancel charging without a delay;
193 * Canceling charging time – a delay before opening the main charging contactor, ms;
194 * Limit charging current – a flag that allows to limit the charging current of a modular battery so that the current of each battery module does not exceed its maximum allowable charge current;
195 * Slew rate – a rate of change of the charge current limit when the “Limit charging current” flag is set, А/s;
196 * Disconnect modules not ready to charge – a flag for disconnecting modules that have the “Ready to charge” signal cleared.
197
198 === Discharge ===
199
200 The BMS Main X device manages the parallel connection of the battery modules and the connection of the battery to the discharging circuit
201
202 The device supports the following discharging modes:
203
204 1. Discharging is always allowed (Always on) – the device ignores voltage and current unbalance of the battery modules and commands to close the discharging contactors of the battery modules and the main discharging contactor.
205 1. Discharging is allowed provided that all battery modules are balanced (Balanced).
206 1. Discharging is allowed for most balanced battery modules (Partially balanced). Unbalanced modules are disconnected from the common bus and do not participate in the discharging.
207
208 The device controls two processes: joining battery modules and closing the main discharging contactor.
209
210
211 The operation of the joining battery modules is described by the following steps:
212
213 1. Battery modules are disabled. When the “Join to discharge” request is received and the voltage and current unbalance errors (Voltage unbalance (DCH), Current unbalance (DCH), Discharging current unbalance) are cleared, go to step 2.
214 1. Checking the voltage unbalance of battery modules (the duration of the check is set in the settings). If there is no imbalance or errors are ignored (“Always on” and “Partially balanced”), go to step 3, otherwise open all discharging contactors, and go to step 1.
215 1. Closing the precharging contactors of the battery modules (optional). Go to step 4.
216 1. Closing the discharging contactors of the battery modules. The battery modules are self-balancing. Go to step 5.
217 1. Checking intermodular balancing currents (the duration of the check is set in the settings). If there is no current unbalance (“Current unbalance (DCH)”) or errors are ignored (“Always on”), go to step 6, otherwise open all discharging contactors, and go to step 1.
218 1. The battery modules are joined. If the “Join to discharge” request is cleared or "Discharging current unbalance" and "Critical error" errors occur, go to step 1.
219
220 The operation of the main discharging contactor is described in the following steps:
221
222 1. The main discharging contactor is open. When the “Discharge request” is received, the voltage and current unbalance errors (“Voltage unbalance (DCH)”, “Current unbalance (DCH)”, “Discharging current unbalance”) are cleared, and the battery modules are joined, go to step 2.
223 1. Closing the main precharging contactor (optional). Go to step 3.
224 1. Closing the main discharging contactor ("Discharging" signal). Go to step 4.
225 1. The main discharging contactor is closed. If the "Discharge request" is cleared, the battery modules are disconnected, or the "Critical error" occurs, go to step 1.
226
227 The command to turn on the main discharging contactor (“Discharging”) can be issued both to the upper-level system via the CAN bus (external), and on the opto-relay of the device that serves to directly control the main discharging contactor.
228
229
230 In addition to controlling the discharging contactors, the discharge controller calculates and transmits to the upper-level system the value of the maximum allowable current, which can be used to discharge the modular battery (“Discharge current limit”). The calculation of the discharging current of the entire battery is performed based on the number of battery modules operating per discharge and the values of the current limits transmitted by them.
231
232
233 The battery discharge management is configured in the "Control - Discharge" section:
234
235 [[image:1734356572308-630.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="139" width="600"]]
236
237 In this section:
238
239 * Enable – a flag to enable battery discharge controller;
240 * Algorithm:
241 ** Always on – discharging is always allowed;
242 ** Balanced – discharging is allowed provided that all battery modules are balanced;
243 ** Partially balanced – discharging is allowed for most balanced battery modules;
244 * Current corresponding to discharging – a current level to set the "Discharging current present" signal, A;
245 * Current corresponding to no discharging – a current level to clear the "Discharging current present" signal, A;
246 * Maximum current to rejoin modules – a maximum allowable current at which rejoining of battery modules is allowed, A;
247 * Checking voltages time – a time of checking voltages of battery modules, ms;
248 * Pre-balancing modules time – a time of precharging battery modules, ms;
249 * Balancing modules time – a time of balancing battery modules, ms;
250 * Control the precharging relay – a flag to control the main precharging contactor;
251 * Precharging time – a time of precharging, ms;
252 * Cancel discharging without a delay;
253 * Canceling discharging time – a delay before opening the main discharging contactor, ms;
254 * Limit module current – a flag that allows to limit the discharging current of a modular battery so that the current of each battery module does not exceed its maximum allowable discharge current;
255 * Slew rate – a rate of change of the discharge current limit when the “Limit module current” flag is set, А/s;
256 * Disconnect modules not ready to discharge – a flag for disconnecting modules that have the “Ready to discharge” signal cleared.
257
258 === Charge/Discharge ===
259
260 The BMS Main X can control the charging/discharging contactor that is used to both charge and discharge the battery.
261
262 The charge/discharge contactor (“Charging/Discharging” signal) receives a “Charging” signal (generated by the charge controller) if a “Charge request” signal is received from the upper-level system. In all other cases, the "Discharging" signal is output to the contactor (generated by the discharge controller).
263
264 The charge/discharge contactor control is configured in the “Control – Charge/Discharge” section:
265
266 [[image:1734356572312-596.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="58" width="600"]]
267
268 In this section:
269
270 * Enable – a flag to enable the charge/discharge controller.
271
272 === Module balancing ===
273
274 The BMS Main X device supports active balancing of battery modules both in the process of charging and in the process of discharging the battery.
275 \\When the battery is charging, balancing is performed by disconnecting the most charged battery modules from the common bus. Before disconnecting the modules, the BMS Main X sends a request to the upper-level system (charger) to reduce the charge current to zero, and after the current becomes zero, disconnects the most charged battery modules.
276
277 When the battery is discharging, balancing is performed by disconnecting the most discharged battery modules from the common bus. Battery modules are disconnected only if the battery discharge current has dropped to the threshold value set in the device settings.
278
279 Module balancing is configured in the “Control – Module balancing” section:
280
281 [[image:1734356572313-823.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="74" width="600"]]
282
283 In this section:
284
285 * Balance on charging – a flag to enable module balancing when the battery is charging;
286 * Delta voltage – a voltage difference at which the most charged modules are switched off (those modules whose voltage exceeds the minimum voltage among the modules by the “Delta voltage” value are switched off), V;
287 * Delta current – a current difference at which the most charged modules are switched off (those modules are switched off, the charge current of which is less than the maximum charge current among the modules by the “Delta current” value), A;
288 * Waiting time – a time the battery modules are in the disconnected state (after this time, the modules previously disconnected during the balancing process are reconnected to the common bus), s;
289 * Balance on discharging – a flag to enable module balancing when the battery is discharging;
290 * Required discharging current – a value of the discharge current at which the device switches off the most discharged battery modules, A.