Wiki source code of BMS Main 3X

Last modified by Admin on 2026/10/09 04:44

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