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