Wiki source code of BMS Main 3X

Last modified by Admin on 2026/09/01 12:01

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