Wiki source code of BMS Main 3X

Last modified by Admin on 2026/08/27 09:25

Show last authors
1 (% class="box infomessage" %)
2 (((
3 BMS Main 3X firmware update procedure is described [[here>>doc:Battery management systems.BMS Main 3.6\. Firmware update.WebHome]].
4 )))
5
6 = v3.11.0 =
7
8 [[BMS_Main_3X_v3.11.0.bin>>FileManager.BMS_Main_3X_v3\.11\.0\.bin]]
9
10 == Features ==
11
12 * compatibility with the BMS Main 2RX device; from this release onwards, the BMS Main 2RX firmware version will be the same as the BMS Main 3X firmware version
13 * support for the ESS Modbus controller (see the "External equipment - ESS Modbus controller" section)
14 * ability to manually clear/reset device errors via CANopen, Modbus, CLI (see the "State - Error reset" section)
15 * new input signals "Status 1", "Status 2", "Status 3", "Status 4"
16
17 == Fixes ==
18
19 * resolving the problem of device stability when reading/writing large amounts of data using the Modbus protocol
20 * resolving a problem in the cellular communications subsystem
21
22 = v3.10.1 =
23
24 [[BMS_Main_3X_v3.10.1.bin>>FileManager.BMS_Main_3X_v3\.10\.1\.bin]]
25
26 == Improvements ==
27
28 * support for multiple clients expecting compressed CLI responses
29 * deleting old log files when the SD card is full (see the corresponding flag in the "Service - SD card" section)
30
31 = v3.10.0 =
32
33 [[BMS_Main_3X_v3.10.0.bin>>FileManager.BMS_Main_3X_v3\.10\.0\.bin]]
34
35 == Features ==
36
37 * compressing CLI responses for some commands to speed up data exchange over slow interfaces
38 * ability to reset a device password using a signed token
39
40 == Improvements ==
41
42 * maintaining continuous current limits below peak current limits
43 * ability to clear the "Precharge error" based on the clock (calendar) time (see the "Control - Precharge" section)
44 * Unibat: new parameter that determines the duration of the reduction in current limits after the insulation fault is detected
45
46 == Fixes ==
47
48 * resolving the issue of incorrect SD card handling when the filesystem is corrupted
49
50 = v3.9.1 =
51
52 [[BMS_Main_3X_v3.9.1.bin>>FileManager.BMS_Main_3X_v3\.9\.1\.bin]]
53
54 == Fixes ==
55
56 * resolving the problem of device rebooting when sending data via FTP and MQTT protocols using the BMS GSM v2 cellular module
57
58 = v3.9.0 =
59
60 == Improvements ==
61
62 * support for the second bootloader v3
63 * ability to complete device initialization without waiting for voltage stabilization on the power switches (see the "Control - Initialization" section)
64 * MQTT optimization
65 * optimization of BMS WiFi v2, BMS GSM v1, and BMS GSM v2 drivers
66 * new assignment "Close External 1" and "Close External 1" for the discrete inputs (see the "Signals - Input discrete signals - Assignments" section)
67 * new assignment "External 1" and "External 2" for the discrete outputs and power switches (see the "Signals - Output discrete signals - Assignments" and "Signals - Power switches - Assignments" sections). The "External 1" and "External 2" output is directly controlled by the "Close External 1" and "Close External 2" command.
68 * ability to configure the generation of "External 1" and "External 2" signals based on other internal signals as an alternative to the "Close External 1" and "Close External 2" commands (see the "Signals - External 1-2 signals" section)
69 * Unibat: ability to halve current limits when the insulation warning is detected (see the "External equipment - Unibat vehicle - General parameters" section)
70 * Unibat: ability to emergency disconnect the battery when the isolation alarm is detected in any operating mode (charge and discharge) (see the "External equipment - Unibat vehicle - General parameters" section)
71 * Unibat: ability to delay emergency battery disconnection when the isolation alarm is detected (see the "External equipment - Unibat vehicle - General parameters" section)
72 * Unibat: ability to linearly reduce current limits to zero when the isolation alarm is detected (see the "External equipment - Unibat vehicle - General parameters" section)
73 * Unibat: use of Ohm/Volt units to define insulation warning and alarm thresholds (see the "External equipment - Unibat vehicle - Diagnostic parameters" section)
74
75 == Fixes ==
76
77 * corrected values ​​of the "Internal signals that cause events to be sent" parameter in the "Service - MQTT" section
78
79 = v3.8.2 =
80
81 [[BMS_Main_3X_v3.8.2.bin>>FileManager.BMS_Main_3X_v3\.8\.2\.bin]]
82
83 == Improvements ==
84
85 * Unibat: preventing the reset of the HVBPITS and HVBPITR signals if the device shutdown was caused by the insulation fault
86
87 == Fixes ==
88
89 * Unibat: charge current limit protection is disabled in charge mode only when the "Use continuous charge current limit" flag is set
90 * Unibat: discharge current limit protection is enabled regardless of whether the battery is in discharge or charge mode
91
92 = v3.8.1 =
93
94 [[BMS_Main_3X_v3.8.1.bin>>FileManager.BMS_Main_3X_v3\.8\.1\.bin]]
95
96 == Improvements ==
97
98 * setting and clearing the "Voltage unbalance" errors without delays
99 * new CAN bus speed is not applied until the device is rebooted
100 * logging the following new parameters: "UnibatState", "UnibatOperationalModeState", "Keyrun", "ChargeOn"
101 * Unibat: ability to shutdown the battery if its SOC is too low (see the "External equipment - Unibat vehicle - Diagnostic parameters" section)
102 * Unibat: change the resolution of parameters CC and DC from 0.01 to 0.1 Ah/bit
103 * Unibat: do not turn on the amber lamp if the actual battery SOC is equal to the configured maximum operational SOC
104
105 == Fixes ==
106
107 * resolving the problem of completing the initialization process before the power switch voltage stabilizes
108
109 = v3.8.0 =
110
111 [[BMS_Main_3X_v3.8.0.bin>>FileManager.BMS_Main_3X_v3\.8\.0\.bin]]
112
113 == Features ==
114
115 * support for the Trolleybat vehicle (see the "External equipment - Trolleybat vehicle" section)
116
117 == Improvements ==
118
119 * checking the continuous charge current limit only if the "Use continuous charge current limit" flag is set in the "External equipment - Unibat vehicle - General parameters" section
120 * Unibat: transition to charging mode according to the condition EESCD=7
121
122 == Fixes ==
123
124 * resolving the problem of completing the initialization process before the power switch voltage stabilizes
125 * Unibat: prevent the "Charge request" and "Discharge request" signals from being reset if the Unibat vehicle goes offline (the signals are controlled in the Unibat state machine)
126
127 = v3.7.1 =
128
129 [[BMS_Main_3X_v3.7.1.bin>>FileManager.BMS_Main_3X_v3\.7\.1\.bin]]
130
131 == Fixes ==
132
133 * Unibat: do not send the insulation error DTC if the IMD goes offline when the battery system is in the shutdown mode
134
135 = v3.7.0 =
136
137 [[BMS_Main_3X_v3.7.0.bin>>FileManager.BMS_Main_3X_v3\.7\.0\.bin]]
138
139 == Features ==
140
141 * new profile section with global battery status, which includes total charge and energy counters, total operating time, contactor opening count, etc. (see the "Profile" tab in the Unified monitor)
142 * new total charge counters (plus and minus)
143
144 == Improvements ==
145
146 * Unibat: new flag to set the custom value (=3) for the EESCD signal (see the "External equipment - Unibat vehicle - General parameters" section)
147 * Unibat: new bit field to ignore internal errors that cause battery shutdown (see the "External equipment - Unibat vehicle - General parameters" section)
148 * Unibat: sending a new packet containing the continuous charge current limit
149
150 == Fixes ==
151
152 * optimization of the logging process, minimizing the time to open the next log file if the current one is full
153 * resolving the stability problem when the SD card is full
154 * Unibat: prevent sending module online statuses if the power down condition is met
155 * Unibat: small fixes
156
157 = v3.6.2 =
158
159 [[BMS_Main_3X_v3.6.2.bin>>FileManager.BMS_Main_3X_v3\.6\.2\.bin]]
160
161 == Improvements ==
162
163 * turning on power switches with a delay of 1 second after reaching the supply voltage of 9V
164 * Unibat: new flag that allows to hide the insulation testing status when repeating measurements (see the "External equipment - Unibat vehicle" section)
165 * expansion of the list of parameters that are reset to default values when the device is powered on while holding the button on the board. The following parameters are affected: all CAN1 (ext) settings; all CAN2 (int) settings; all CAN3 (BMS) settings; all RS-485-1 (Modbus) settings; LAN settings: IP mode, IP address, Netmask, Gateway address
166
167 == Fixes ==
168
169 * resolving the issue of false warnings indicating that the battery current exceeds the current limits (affects Unibat vehicle)
170 * Unibat: changes that make it so that the output period is responsible for only 4 messages, not for all messages (see the "External equipment - Unibat vehicle" section)
171 * Unibat: resolving the issue of TP messages not being sent if the transport is already transmitting something at the time of the request
172 * corrections of typos in parameter descriptions
173
174 = v3.6.1 =
175
176 [[BMS_Main_3X_v3.6.1.bin>>FileManager.BMS_Main_3X_v3\.6\.1\.bin]]
177
178 == Improvements ==
179
180 * new parameters for switching to the sum of battery modules' currents if the current sensor error is detected or the sensor is saturated (see the "Inputs - Current sensor" section)
181 * new flag allowing to swap CAN2 (int) and CAN3 (BMS) interfaces (see the "Connectivity" section under the service account)
182
183 = v3.6.0 =
184
185 [[BMS_Main_3X_v3.6.0.bin>>FileManager.BMS_Main_3X_v3\.6\.0\.bin]]
186
187 == Features ==
188
189 * Unibat: refined algorithms and new parameters to meet requirements of version 8.5 of the logic (protocol v6.1)
190
191 == Improvements ==
192
193 * new flag enabling fast current measurements (see the "Signals - Current sensor" section)
194 * new parameters to ignore the specified errors when setting the critical error (see the "Protections - Critical error" section)
195 * displaying HV calibration values for the service account (see the "Service - Calibration" section)
196 * Unibat: structuring parameters into subgroups: "General parameters", "Battery parameters", "Diagnostic parameters", "Power limiting parameters", "Battery version" (see the "External equipment - Unibat vehicle" section)
197
198 = v3.5.0 =
199
200 [[BMS_Main_3X_v3.5.0.bin>>FileManager.BMS_Main_3X_v3\.5\.0\.bin]]
201
202 == Features ==
203
204 * support for sending battery state and events via MQTT protocol via Wi-Fi or cellular network (see the "Service - MQTT" section)
205
206 == Improvements ==
207
208 * support for secure (TLS) connections in BMS GSM v1 and v2 drivers
209
210 == Fixes ==
211
212 * synchronization of the precharge procedure with the charge/discharge algorithms, so that precharge is stopped if charging and discharging are prohibited
213
214 = v3.4.0 =
215
216 [[BMS_Main_3X_v3.4.0.bin>>FileManager.BMS_Main_3X_v3\.4\.0\.bin]]
217
218 == Features ==
219
220 * new protection checking that the voltage of joined battery modules is equal to the voltage before contactors (the "High voltage 1" value). If this is not the case, the error "Battery voltage mismatch" is generated (see the "Protections - Battery voltage" section)
221
222 == Improvements ==
223
224 * new CLI command "find-log" which finds a log file containing a specified timestamp
225 * ability to acknowledge battery module errors via CLI (see the "Service - Errors journal" section) and Modbus protocol
226
227 == Fixes ==
228
229 * resolving the issue of rebooting the device if formatting the SD card is activated
230
231 = v3.3.0 =
232
233 [[BMS_Main_3X_v3.3.0.bin>>FileManager.BMS_Main_3X_v3\.3\.0\.bin]]
234
235 == Features ==
236
237 * ability to calibrate high voltage measuring means, available starting with the service account (see the "Service - Calibration" section)
238
239 == Improvements ==
240
241 * new type of temperature sensors: NTC 10k B25/50=3380K (see the "Signals - Temperature sensors" section)
242
243
244 = v3.2.5 =
245
246 [[BMS_Main_3X_v3.2.5.bin>>FileManager.BMS_Main_3X_v3\.2\.5\.bin]]
247
248 == Improvements ==
249
250 * dynamic calculation of data transfer schedule for optimal communication with a large number of battery modules
251 * ability to complete device initialization after the set timeout has expired and the minimum number of modules has been detected (see the "Control - Initialization" section)
252 * 30 second delay when remounting SD card after detecting mount error
253 * saving the number of joined modules in log files
254 * Unibat: new flag disabling insulation measurement
255 * Unibat: calculation of the battery current depending on the connection variant of current sensors
256 * Unibat: preventing HVILS changes if the battery is in power-down state
257
258 == Fixes ==
259
260 * resolving the problem of ignoring the parameter that selects the connection variant of current sensors
261 * Unibat: corrections in message identifiers HVESSS1, HVESSD2, HVESSD3, HVESSD8, storing battery module data
262 * Unibat: corrections in HVESSCFG message priority
263
264 = v3.2.4 =
265
266 [[BMS_Main_3X_v3.2.4.bin>>FileManager.BMS_Main_3X_v3\.2\.4\.bin]]
267
268 == Improvements ==
269
270 * new flags that allow to interrupt (shorten) the module balancing stage if all battery modules are already joined (see the "Control - Charge", "Control - Discharge", "Control - Charge/Discharge" sections)
271 * forwarding CLI and bootloader CAN messages from CAN1 interface to CAN2 interface and back, that allows the user to configure and update the firmware of internal devices such as BMS IMD or BMS Display
272 * new parameter for setting the type of network to which the BMS GSM communication module connects (see the "Connectivity - Cellular" section)
273
274 == Fixes ==
275
276 * Unibat: resolving the problem of calculating the CRC of the HVESSS1 message
277 * Unibat: resolving the problem of sending a message about battery disconnection even it is already disconnected
278
279 = v3.2.3 =
280
281 [[BMS_Main_3X_v3.2.3.bin>>FileManager.BMS_Main_3X_v3\.2\.3\.bin]]
282
283 == Improvements ==
284
285 * forwarding CLI and bootloader CAN messages from CAN1 and CAN2 interfaces to CAN3 interface and back, that allows the user to configure and update the firmware of battery modules without direct connection to the modules
286 * ability to acknowledge errors in the error journal via the Modbus protocol (holding registers 0x4100-0x4101)
287 * ability to update the device serial number from the service account if the number is reset to the default value for some reason (see the "Service" section)
288 * new flag that controls whether to use open circuit voltage or actual voltage when determining the voltage unbalance error (see the "Protections - Voltage unbalance (in any state)" section)
289 * new regulator that maintains battery current limiting to ensure that actual module currents do not exceed their current limits (see the "Control - Charge", "Control - Discharge", "Control - Charge/Discharge" sections)
290 * ability to select the battery module errors that cause the battery critical error (see the "Protections - Critical error" section)
291 * Unibat: refined algorithms and new parameters to meet requirements of version 7 of the logic
292
293 == Fixes ==
294
295 * resolving the problem of saving discrete input signals of battery modules in log files
296
297 = v3.2.1 =
298
299 [[BMS_Main_3X_v3.2.1.bin>>FileManager.BMS_Main_3X_v3\.2\.1\.bin]]
300
301 == Improvements ==
302
303 * new parameter that sets the delay before measuring the current to determine that precharge is finished (see the "Control - Precharge" section)
304 * ability to exclude errors from being saved in the error journal (see the "Service - Errors journal" section)
305 * new flags indicating the readiness of battery modules to join for charging and discharging (see the "Modules" section)
306 * new flag to set the "Voltage unbalance" errors for battery modules that are not ready to charge or discharge (see the "Protections - Voltage unbalance (in any state)" section)
307 * Unibat: new parameters setting the BMS and VCU addresses (see the "External equipment - Unibat vehicle" section)
308 * Unibat: new flag to invert the discharge current limit sent to the vehicle (see the "External equipment - Unibat vehicle" section)
309 * Unibat: using the difference between the maximum and minimum temperatures among all cells as an input for the coolant pump controller
310 * Unibat: automatically switch from discharging to charging mode if the CHARGE_ON signal or the charging station command is set (without rejoining the battery)
311 * extension of the CANopen dictionary to provide additional information for the BMS Display (device serial number, battery serial number, battery address, Wi-Fi and LAN addresses, SOH, capacity, etc.)
312
313 == Fixes ==
314
315 * resolving the issue of ignoring the minimum number of battery modules allowed to join located in the "Control - Discharge" section
316 * resolving the issue of joining battery modules the number of which must be greater than or equal to the minimum value specified in the settings
317 * making the service reset function work properly
318 * small internal fixes
319
320 = v3.2.0 =
321
322 (% class="wikigeneratedid" %)
323 [[BMS_Main_3X_v3.2.0.bin>>FileManager.BMS_Main_3X_v3\.2\.0\.bin]]
324
325 == Features ==
326
327 * new algorithm in the Charging/Discharging controller that allow to control the Charging/Discharging contactor independently from the Charging and Discharging signals (see the "Control - Charge/Discharge" section). The new "Independent" algorithm is preferred in the battery systems with one contactor
328 * new "Need acknowledge" warning signal that is set when a new record is created in the errors journal. The signal can be cleared in the "Service - Errors journal" section
329 * new Max-Min algorithm for calculating the final battery SOC in the "Control - Calculation" section
330 * improved control of the precharging contactor, which can precharge capacitive load using multiple attempts and detect high power dissipated in the precharge resistor (see the "Control - Precharge" section)
331 * ability to select errors that the device saves in the errors journal (see the "Service - Errors journal" section)
332
333 == Improvements ==
334
335 * ability to finish device initialization even if the number of battery modules found is less than the number of modules enabled
336 * ability to configure and monitor the device via the CAN1 (ext) bus
337 * placing the device input signals to the "Battery" section and adding raw discrete inputs to the "Signals" section
338 * Unibat: support for functional description v3.5 (protocol v1.5)
339
340 = v3.1.1 =
341
342 [[BMS_Main_3X_v3.1.1.bin>>FileManager.BMS_Main_3X_v3\.1\.1\.bin]]
343
344 == Fixes ==
345
346 * resolving the problem of incorrect range of temperature parameter values (in the "Control - Coolant pump" section)
347 * resolving the possible problem of saving device parameters
348 * resolving the problem of writing the device's working time to a non-volatile memory very often
349 * resolving the issue of preparing battery module states written to Modbus registers
350
351 = v3.1.0 =
352
353 [[BMS_Main_3X_v3.1.0.bin>>FileManager.BMS_Main_3X_v3\.1\.0\.bin]]
354
355 == Features ==
356
357 * new parameter to set the minimum number of battery modules allowed to join (see the "Control - Charge" and "Control - Discharge" sections)
358 * ability to rejoin battery modules if their voltage is close to the battery voltage (see the "Control - Charge" and "Control - Discharge" sections)
359 * selection of errors that cause reset of contactor control signals (see the "Control - Main contactor", "Control - Charge", "Control - Discharge", "Control - Heater", "Control - Cooler", "Control - Coolant pump" sections)
360 * new internal signal "General error (modules)" which is the logical sum of the "General error" signals from the battery modules
361 * new assignments "Critical error" and "General error (modules)" for the discrete outputs and power switches (see the "Signals - Output discrete signals - Assignments" and "Signals - Power switches - Assignments" sections)
362
363 == Improvements ==
364
365 * use the measured voltage before contactors as the battery voltage if the "Control - High voltage" function is enabled
366 * Unibat: new flag to enable sending a control message to start/stop ventilation fans installed in the battery modules (see the "External equipment - Unibat vehicle" section)
367 * rearrangements in the settings sections, which are made to simplify the setup process
368
369 == Fixes ==
370
371 * Unibat: minor changes in the communication protocol