v2.0.20250729

Breaking Changes

• Driver version greater or equal to v2.0.20250502dev

  • Changes to config.default.ini: SOC_RESET_VOLTAGE was replaced by SOC_RESET_CELL_VOLTAGE

• Driver version greater or equal to v2.0.20250207dev

  • Changes to config.default.ini: TEMPERATURE_SOURCE_BATTERY is now a list of temperature sensors, so you can choose which sensors you want to use

• Driver version greater or equal to v2.0.20250107dev

  • Changes to config.default.ini: CELL_VOLTAGE_DIFF_KEEP_MAX_VOLTAGE_TIME_RESTART was superseeded by SWITCH_TO_FLOAT_CELL_VOLTAGE_DEVIATION, which has a different behavior
  • Changes to config.default.ini: CELL_VOLTAGE_DIFF_KEEP_MAX_VOLTAGE_UNTIL was replaced by SWITCH_TO_FLOAT_CELL_VOLTAGE_DIFF
  • Changes to config.default.ini: CELL_VOLTAGE_DIFF_TO_RESET_VOLTAGE_LIMIT was replaced by SWITCH_TO_BULK_CELL_VOLTAGE_DIFF
  • Changes to config.default.ini: CVL_ICONTROLLER_MODE was superseeded by CVL_CONTROLLER_MODE, which has a different behavior
  • Changes to config.default.ini: LINEAR_LIMITATION_ENABLE was superseeded by CHARGE_MODE, which has a different behavior
  • Changes to config.default.ini: LINEAR_RECALCULATION_EVERY was replaced by CVL_RECALCULATION_EVERY
  • Changes to config.default.ini: LINEAR_RECALCULATION_ON_PERC_CHANGE was replaced by CVL_RECALCULATION_ON_MAX_PERCENTAGE_CHANGE
  • Changes to config.default.ini: MAX_VOLTAGE_TIME_SEC was replaced by SWITCH_TO_FLOAT_WAIT_FOR_SEC

• Driver version greater or equal to v2.0.20250103dev

  • Changes to config.default.ini: SOC_LEVEL_TO_RESET_VOLTAGE_LIMIT was replaced by SWITCH_TO_BULK_SOC_THRESHOLD

• Driver version greater or equal to v2.0.20241202dev

  • The driver path changed from /data/etc/dbus-serialbattery to /data/apps/dbus-serialbattery
  • Changes to config.default.ini: MODBUS_ADDRESSES was replaced by BATTERY_ADDRESSES
  • Changes to config.default.ini: SEPLOS_USE_BMS_VALUES was replaced by USE_BMS_DVCC_VALUES
  • Changes to config.default.ini: Changed default values for Cell Voltage Current Limitation and Temperature Current Limitation

• Driver version greater or equal to v2.0.20241211dev

  • Changes to config.default.ini: SOC_CALC_CURRENT_REPORTED_BY_BMS was replaced by CURRENT_REPORTED_BY_BMS
  • Changes to config.default.ini: SOC_CALC_CURRENT_MEASURED_BY_USER was replaced by CURRENT_MEASURED_BY_USER

• Driver version greater or equal to v2.0.20241217dev

  • Changes to config.default.ini: EXTERNAL_CURRENT_SENSOR_DBUS_DEVICE was replaced by EXTERNAL_SENSOR_DBUS_DEVICE
  • Changes to config.default.ini: EXTERNAL_CURRENT_SENSOR_DBUS_PATH was replaced by EXTERNAL_SENSOR_DBUS_PATH_CURRENT

• Driver version greater or equal to v2.0.20241218dev

  • Changes to config.default.ini: TEMP_BATTERY was replaced by TEMPERATURE_SOURCE_BATTERY
  • Changes to config.default.ini: TEMP_1_NAME was replaced by TEMPERATURE_1_NAME
  • Changes to config.default.ini: TEMP_2_NAME was replaced by TEMPERATURE_2_NAME
  • Changes to config.default.ini: TEMP_3_NAME was replaced by TEMPERATURE_3_NAME
  • Changes to config.default.ini: TEMP_4_NAME was replaced by TEMPERATURE_4_NAME

What's Changed

• Added: BLE - Config settings do enable/disable BLUETOOTH_USE_POLLING and BLUETOOTH_FORCE_RESET_BLE_STACK by @mr-manuel
• Added: BLE - Error message if BLE BMS_TYPE was misspelled by @mr-manuel
• Added: BLE - Error message if BLE address is missing by @mr-manuel
• Added: Calculation of history values not provided by the battery by @mr-manuel
• Added: Charge Voltage Limit mode - Clipped sum controller by @mr-manuel
• Added: Charge/Discharge current limitation by MOSFET temperature by @mr-manuel
• Added: Daly CAN - Read capacity with #217 from @atillack
• Added: Error handling for config.ini by @mr-manuel
• Added: Error handling for corrupt config.ini structure by @mr-manuel
• Added: Felicity BMS by @versager
• Added: GUIv2 - New page where you see all important data in one place for easy troubleshooting by @mr-manuel
• Added: JKBMS CAN - Extended protocol with version V2 by @Hooorny and @mr-manuel
• Added: JKBMS PB - Status of balancer switch with #286 by @KoljaWindeler
• Added: Kilovault HLX+ BMS by @alexphredorg
• Added: KS48100 (PAPool, Bemory, CERRNSS, VoltPolska, ...) BMS with #168 by @JoshuaDodds
• Added: LiTime BMS by @calledit
• Added: Make battery data available on MQTT under a single topic by enabling PUBLISH_BATTERY_DATA_AS_JSON by @mr-manuel
• Added: Min/Max lifetime temperature to history class and battery template by @mr-manuel
• Added: Pace BMS by @KoljaWindeler
• Added: Possibility to add external sensor for SoC by @mr-manuel
• Added: RV-C House Battery by @rogergrant99
• Added: Show BMS cable fault warning, if the BMS is not reachable anymore by @mr-manuel
• Added: Show CVL also on cell voltage base by @mr-manuel
• Added: Show if deprecated or invalid config options are used in the config.ini by @mr-manuel
• Added: Signal handler for clean service restart/shutdown by @mr-manuel
• Added: UBMS CAN - support for Valence U-BMS by @gimx
• Added: Venus OS image type to startup log by @mr-manuel
• Changed: A lot of under the hood optimizations by @mr-manuel
• Changed: Apply SOC_RESET_CELL_VOLTAGE after SOC_RESET_AFTER_DAYS regardless of whether the battery is in absorption, bulk, or float mode #123 by @mr-manuel
• Changed: BLE - Reworked installation for external Bluetooth USB dongle by @Felixrising & @mr-manuel
• Changed: BLE - Reworked log notifications be more helpful by @mr-manuel
• Changed: Charge Voltage Limit: Once the voltage is reduced slowly recover the voltage instead of jumping to the max voltage, this makes charging smoother on cell overvoltage by @mr-manuel
• Changed: Check /data/apps path for required free space instead of /data. This allows /data/apps to be mounted on another media by @mr-manuel
• Changed: Consumed capacity must be negative values by @mr-manuel
• Changed: Daly CAN - Driver improvements by @transistorgit
• Changed: Daly CAN - Refactored driver to match new CAN standard by @mr-manuel and @transistorgit
• Changed: Dependencies are now shipped with the driver and not downloaded anymore which allows a complete offline installation by @mr-manuel
• Changed: Do not set Allow to balance to False if unavailable by @mr-manuel
• Changed: Driver was moved from /data/etc/dbus-serialbattery to /data/apps/dbus-serialbattery by @mr-manuel
• Changed: EG4 LifePower - Fixed wrong cell voltage decoding. Fixes #155 by @dchiquito
• Changed: Fix /Info/BatteryLowVoltage remaining None #145 by @mr-manuel
• Changed: Fix double manipulation by VOLTAGE_DROP by @mr-manuel
• Changed: Fix missing charge/discharge fet status for EG4 LifePower, EG4 LL and Renogy. Fixes #129 by @mr-manuel
• Changed: Fixed driver starting issue when config.ini has no option by @mr-manuel
• Changed: Fixed issue, when calculated SOC is restored from dbus and BMS SOC is 0 by @mr-manuel
• Changed: Fixed issues when battery connection is lost by @mr-manuel
• Changed: Fixed Seplos V3 cell balance status with #213 by @marcelrv
• Changed: Fixed serial port handling with #211 by @WaldemarFech
• Changed: GUIv1 - Added note that it's not developed anymore by @mr-manuel
• Changed: GUIv2 - Moved all dbus-serialbattery stuff to custom pages to avoid confusion in Victron support requests by @mr-manuel
• Changed: Heltec BMS - Fixed issues with #246 by @ramack
• Changed: Improved driver and config.default.ini descriptions by @mr-manuel
• Changed: Improved handling when battery connection is lost by @mr-manuel
• Changed: Improved some error messages for better understanding by @mr-manuel
• Changed: Increased the minimum needed disk space from 30 MB to 70 MB by @mr-manuel
• Changed: JKBMS BLE - Reworked code by @mr-manuel
• Changed: JKBMS CAN - Per default only address 0 is recognized. Change BATTERY_ADDRESS to match your device address by @Hooorny and @mr-manuel
• CHanged: JKBMS PB - Fixed incorrect offsets with #283 by @gizmocuz
• CHanged: JKBMS PB - Fixed serial number reading with #270 by @marcelrv
• Changed: Licensing from MIT license to GNU AGPLv3 license by @mr-manuel
• Changed: LLT/JBD BLE - Fixed initial connection by @mr-manuel
• Changed: Precision of voltage sum from 3 decimals to 2 decimals by @mr-manuel
• Changed: Rebuild custom GUI install process by @mr-manuel
• Changed: Refactored driver installation via USB/SD card by @mr-manuel
• Changed: Renamed install-qml.sh to custom-gui-install.sh by @mr-manuel
• Changed: Renamed reinstall-local.sh to enable.sh by @mr-manuel
• Changed: Renamed restart-driver.sh to restart.sh by @mr-manuel
• Changed: Renamed restore-gui.sh to custom-gui-uninstall.sh by @mr-manuel
• Changed: Show data validation mismatches in the log by @mr-manuel
• Changed: The driver is now running directly from it's app folder. No need to copy the config.ini file anywhere, which means changes are applied by simply restarting the service by @mr-manuel
• Changed: The root filesystem is not mounted as read-write anymore, since overlay filesystems are used now. This allows to let the core system files untouched and to revert all changes with one command. The changes are now also persistant and do not have to be installed on every Venus OS update again by @mr-manuel
• Changed: The setting CELL_VOLTAGE_DIFF_KEEP_MAX_VOLTAGE_TIME_RESTART was superseeded by SWITCH_TO_FLOAT_CELL_VOLTAGE_DEVIATION, which has a different behavior by @mr-manuel
• Changed: The setting CELL_VOLTAGE_DIFF_KEEP_MAX_VOLTAGE_UNTIL was replaced by SWITCH_TO_FLOAT_CELL_VOLTAGE_DIFF by @mr-manuel
• Changed: The setting CELL_VOLTAGE_DIFF_TO_RESET_VOLTAGE_LIMIT was replaced by SWITCH_TO_BULK_CELL_VOLTAGE_DIFF by @mr-manuel
• Changed: The setting CVL_ICONTROLLER_MODE was superseeded by CVL_CONTROLLER_MODE, which has a different behavior by @mr-manuel
• Changed: The setting EXTERNAL_CURRENT_SENSOR_DBUS_DEVICE was replaced by EXTERNAL_SENSOR_DBUS_DEVICE in the config.default.ini by @mr-manuel
• Changed: The setting EXTERNAL_CURRENT_SENSOR_DBUS_PATH was replaced by EXTERNAL_SENSOR_DBUS_PATH_CURRENT in the config.default.ini by @mr-manuel
• Changed: The setting LINEAR_LIMITATION_ENABLE was superseeded by CHARGE_MODE, which has a different behavior by @mr-manuel
• Changed: The setting LINEAR_RECALCULATION_EVERY was replaced by CVL_RECALCULATION_EVERY by @mr-manuel
• Changed: The setting LINEAR_RECALCULATION_ON_PERC_CHANGE was replaced by CVL_RECALCULATION_ON_MAX_PERCENTAGE_CHANGE by @mr-manuel
• Changed: The setting MAX_VOLTAGE_TIME_SEC was replaced by SWITCH_TO_FLOAT_WAIT_FOR_SEC by @mr-manuel
• Changed: The setting MODBUS_ADDRESSES was replaced by BATTERY_ADDRESSES in the config.default.ini by @mr-manuel
• Changed: The setting SEPLOS_USE_BMS_VALUES was replaced by USE_BMS_DVCC_VALUES in the config.default.ini by @mr-manuel
• Changed: The setting SOC_CALC_CURRENT_MEASURED_BY_USER was replaced by CURRENT_MEASURED_BY_USER in the config.default.ini by @mr-manuel
• Changed: The setting SOC_CALC_CURRENT_REPORTED_BY_BMS was replaced by CURRENT_REPORTED_BY_BMS in the config.default.ini by @mr-manuel
• Changed: The setting SOC_LEVEL_TO_RESET_VOLTAGE_LIMIT was replaced by SWITCH_TO_BULK_SOC_THRESHOLD in the config.default.ini by @mr-manuel
• Changed: The setting SOC_RESET_VOLTAGE was replaced by SOC_RESET_CELL_VOLTAGE in the config.default.ini by @mr-manuel
• Changed: The setting TEMP_1_NAME was replaced by TEMPERATURE_1_NAME in the config.default.ini by @mr-manuel
• Changed: The setting TEMP_2_NAME was replaced by TEMPERATURE_2_NAME in the config.default.ini by @mr-manuel
• Changed: The setting TEMP_3_NAME was replaced by TEMPERATURE_3_NAME in the config.default.ini by @mr-manuel
• Changed: The setting TEMP_4_NAME was replaced by TEMPERATURE_4_NAME in the config.default.ini by @mr-manuel
• Changed: The setting TEMP_BATTERY was replaced by TEMPERATURE_SOURCE_BATTERY in the config.default.ini by @mr-manuel
• Changed: The setting TEMPERATURE_SOURCE_BATTERY is now a list of temperature sensors, so you can choose which sensors you want to use by @mr-manuel
• Changed: Tian Power BMS: Fixed command info request with #274 by @Shahar-Ariel
• Changed: Use corrected current for both normal current and SOC calculation if SOC_CALCULATION is enabled by @mr-manuel
• Changed: When SOC_CALCULATION is enabled, the SoC is reset to 100%, if the battery switches to float. Old options were removed by @mr-manuel
• Removed: BLE - Duplicated not found message by @mr-manuel
• Removed: The setting SOC_RESET_CURRENT was removed in the config.default.ini by @mr-manuel
• Removed: The setting SOC_RESET_TIME was removed in the config.default.ini by @mr-manuel

New Contributors

• @peterohman made their first contribution in #96
• @dchiquito made their first contribution in #156
• @alexphredorg made their first contribution in #183
• @asmcc made their first contribution in #199
• @DaniBubu15 made their first contribution in #206
• @WaldemarFech made their first contribution in #211
• @atillack made their first contribution in #217
• @ramack made their first contribution in #246

Full Changelog: v1.4.20240928...v2.0.20250729