Wiki source code of 3.3 Control

Version 7.1 by Admin on 2025/02/28 13:37

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="88" width="600"]]
77
78 === Charge ===
79
80 The BMS Main X device manages the parallel connection of the battery modules and the connection of the battery to the charging circuit.
81
82 The device supports the following charging modes:
83
84 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.
85 1. Charging is allowed provided that all battery modules are balanced (Balanced).
86 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.
87
88 The device controls two processes: joining battery modules and closing the main charging contactor.
89
90
91 The operation of the joining battery modules is described by the following steps:
92
93 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.
94 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.
95 1. Closing the precharging contactors of the battery modules (optional). Go to step 4.
96 1. Closing the charging contactors of the battery modules. The battery modules are self-balancing. Go to step 5.
97 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.
98 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.
99
100 The operation of the main charging contactor is described in the following steps:
101
102 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.
103 1. Closing the main precharging contactor (optional). Go to step 3.
104 1. Closing the main charging contactor ("Charging" signal). Go to step 4.
105 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.
106
107 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.
108
109
110 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.
111
112
113 The battery charge management is configured in the "Control - Charge" section:
114
115 [[image:1734356553573-447.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="146" width="600"]]
116
117 In this section:
118
119 * Enable – a flag to enable battery charge controller;
120 * Algorithm:
121 ** Always on – charging is always allowed;
122 ** Balanced – charging is allowed provided that all battery modules are balanced;
123 ** Partially balanced – charging is allowed for most balanced battery modules;
124 * Current corresponding to charging – a current level to set the "Charging current present" signal, A;
125 * Current corresponding to no charging – a current level to clear the "Charging current present" signal, A;
126 * Maximum current to rejoin modules – a maximum allowable current at which rejoining of battery modules is allowed, A;
127 * Checking voltages time – a time of checking voltages of battery modules, ms;
128 * Pre-balancing modules time – a time of pre-charging battery modules, ms;
129 * Balancing modules time – a time of balancing battery modules, ms;
130 * Control the precharging relay – a flag to control the main precharging contactor;
131 * Precharging time – a time of precharging, ms;
132 * Cancel charging without a delay;
133 * Canceling charging time – a delay before opening the main charging contactor, ms;
134 * 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;
135 * Slew rate – a rate of change of the charge current limit when the “Limit charging current” flag is set, А/s;
136 * Disconnect modules not ready to charge – a flag for disconnecting modules that have the “Ready to charge” signal cleared.
137
138 === Discharge ===
139
140 The BMS Main X device manages the parallel connection of the battery modules and the connection of the battery to the discharging circuit
141
142 The device supports the following discharging modes:
143
144 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.
145 1. Discharging is allowed provided that all battery modules are balanced (Balanced).
146 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.
147
148 The device controls two processes: joining battery modules and closing the main discharging contactor.
149
150
151 The operation of the joining battery modules is described by the following steps:
152
153 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.
154 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.
155 1. Closing the precharging contactors of the battery modules (optional). Go to step 4.
156 1. Closing the discharging contactors of the battery modules. The battery modules are self-balancing. Go to step 5.
157 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.
158 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.
159
160 The operation of the main discharging contactor is described in the following steps:
161
162 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.
163 1. Closing the main precharging contactor (optional). Go to step 3.
164 1. Closing the main discharging contactor ("Discharging" signal). Go to step 4.
165 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.
166
167 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.
168
169
170 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.
171
172
173 The battery discharge management is configured in the "Control - Discharge" section:
174
175 [[image:1734356572308-630.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="139" width="600"]]
176
177 In this section:
178
179 * Enable – a flag to enable battery discharge controller;
180 * Algorithm:
181 ** Always on – discharging is always allowed;
182 ** Balanced – discharging is allowed provided that all battery modules are balanced;
183 ** Partially balanced – discharging is allowed for most balanced battery modules;
184 * Current corresponding to discharging – a current level to set the "Discharging current present" signal, A;
185 * Current corresponding to no discharging – a current level to clear the "Discharging 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 precharging 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 discharging without a delay;
193 * Canceling discharging time – a delay before opening the main discharging contactor, ms;
194 * 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;
195 * Slew rate – a rate of change of the discharge current limit when the “Limit module current” flag is set, А/s;
196 * Disconnect modules not ready to discharge – a flag for disconnecting modules that have the “Ready to discharge” signal cleared.
197
198 === Charge/Discharge ===
199
200 The BMS Main X can control the charging/discharging contactor that is used to both charge and discharge the battery.
201
202 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).
203
204 The charge/discharge contactor control is configured in the “Control – Charge/Discharge” section:
205
206 [[image:1734356572312-596.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="58" width="600"]]
207
208 In this section:
209
210 * Enable – a flag to enable the charge/discharge controller.
211
212 === Module balancing ===
213
214 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.
215 \\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.
216
217 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.
218
219 Module balancing is configured in the “Control – Module balancing” section:
220
221 [[image:1734356572313-823.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true" height="74" width="600"]]
222
223 In this section:
224
225 * Balance on charging – a flag to enable module balancing when the battery is charging;
226 * 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;
227 * 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;
228 * 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;
229 * Balance on discharging – a flag to enable module balancing when the battery is discharging;
230 * Required discharging current – a value of the discharge current at which the device switches off the most discharged battery modules, A.