v12.0.0

[dalathegreat]

What's Changed 📦

Version 12 is a new major release of the Battery-Emulator, with many enhancements and MQTT changes that might require attention when updating. Please familiarize yourself with the release notes carefully before OTA updating to this version.

-MQTT: reduced memory usage and improved reliability

This release significantly lowers the heap usage of the MQTT module, with the biggest gains on double and triple battery setups, and fixes a bug where batteries 2 and 3 reported battery 1's charged and discharged energy totals. Cell voltages and balancing states are now published every 60 seconds instead of every 5, combined into a single message, while all live values — power, current, battery voltage, SOC, and cell min/max/delta — continue to update at the normal publish interval. Availability on the /status topic is now published retained once on connect, following the standard last-will pattern.

Two changes affect existing setups. Battery 2 and 3 values have moved from suffixed keys on <name>/info (such as SOC_2) to their own topics, <name>/info_2 and <name>/info_3, using plain un-suffixed keys. The separate balancing_data* topics have been removed, with that data now included in spec_data* under the cell_balancing key, ensuring perfect sync with cell_voltages. Home Assistant autodiscovery users need to take no action, as entities migrate automatically; only manually configured MQTT sensors, Node-RED flows, and similar integrations need updating.

-Inverter Charge Taper 📉

This releases implements an optional, battery-integration-independent charge power taper based on scaled SOC: the allowed charge power is linearly reduced from full at (100% − band) down to 0 W at 100% scaled SOC, with an optional configurable floor (minimum charge power held through the tail of the band). Configurable via a new checkbox next to the existing low pass filter setting, with taper band (percent) and floor (W) fields shown only when enabled.

⚠️ IMPORTANT NOTE: For integrations using estiamated charge power (Tesla S/3/X/Y, Relion LV, BMW iX, BMW PHEV, Kia64FD, RJXZS, GEELY SEA) This new charge taper is MANDATORY and will automatically be enabled. It replaces the old method of ramping down the allowed charge power at high SOC that was individually implemented in each feature. Users should pay close attention to the new settings, since on an estimated charge power install you are the deciding factor how much power can be extracted from the battery. Estimated integrations are inherently less safe to operate due to this. Checkout the instructions here:

-Periodic BMS reset improvements

Periodic BMS reset can now be performed at either 24h (default), or a 48h interval. There are now also two optional guards, shown in the web UI only when the periodic reset is enabled. Why do we need the setting? It's observed that for example AZE0 likes to finish balancing. If BMS rebooted during balance, it won't restart. ZE1 can overbalance, so it may be wise to intrerrupt it daily. The user has to have a choice here to improve battery balancing operation

Apart from all this, there are several other bugfixes and enhancements. Please check out the full list of changes below

Taking this release into use ⚙️

Important

In order to OTA update to this version, you already need to be on a v10 release!

Note that v10 was a major new release of the Battery-Emulator software. The first time when taking a version > v10.0.0 version into use, you are required to perform an initial one time USB setup via this webpage! This is because we changed the flash frequencies, partitioning layouts and other under the hood changes to ensure longterm system stability. After any v10 has been installed via USB, following 10.X.X releases can be updated over the air.

Quickstart video: https://youtu.be/sR3t7j0R9Z0

Batteries 🔋

• Ford: Adjust cell temperature offset to make temperatures more reasonable by @TheOfficialBatteryMan in Adjust Ford Mach-E cell temperature offset #2583
• Ford: Safety ⚠️ Use actual battery charge/discharge limits instead of user estimated values by @dalathegreat in Ford: Safety ⚠️ Use actual battery charge/discharge limits instead of estimated values #2580
• MEB Battery: Implement BMS Reset from webserver interface by @malec1984 in MEB Battery: Implement BMS Reset #2638
• Nissan LEAF: Safety; Adjust battery voltage limits for top charge by @nagyrobi in Safety: Adjust battery voltage limits for Leaf 🔋 #2657
• Nissan LEAF: Bugfix: Fixed a bug where info for double/triple batteries would not be visible on the More Battery Info page by @nagyrobi in Bugfix: Leaf per-battery data on advanced page for double/triple setups #2670
• BYD Vehicle: Speed up sourcing of pack voltage & current from CAN / add insulation resistance by @demon1300 in Improvement: BYD - Change source pack voltage & current from CAN / add insulation resistance #2656
• Dyness Pylon: Corrected calculation of cell voltages by @tekampe-oss in Dyness Pylon: Corrected calculation of cell votages #2679
• Safety: ⚠️ Make interconnect check more reliable for double/triple batteries by @dalathegreat in Safety: ⚠️ Make interconnect check more reliable #2357
• Improvement: Add guards to periodic BMS reset and add 48h option by @nagyrobi in Improvement: Add guards to periodic BMS reset #2668
• Fake battery: Support triple setup, mirror pack voltage, fake balancing by @nagyrobi in Fake battery: support triple setup, mirror pack voltage, fake balancing #2659
• Fake battery: A bit more realistic by @nagyrobi in Fake battery: a bit more realistic #2669

Inverters ⚡

• Feature: 🔨📉🔋SOC-based, universal charge power taper towards inverter by @nagyrobi in Feature: 🔨📉🔋SOC-based, universal charge power taper towards inverter  #2628
• Make SOC-based charge taper 🔨📉🔋 mandatory for estimated power battery integrations by @nagyrobi in Make SOC-based charge taper 🔨📉🔋 mandatory for selected battery types #2637
• Improvement: Remove old charge power rampdowns in favour of the new inverter based "SOC-based charge taper" by @dalathegreat in Improvement: Remove old charge power rampdowns in favour of the new inverter based rampdown #2678
• Added "Inverter detected" event for Modbus and RS485 inverters by @nagyrobi in Add inverter detected event for Modbus and RS485 inverters #2634
• Solax: Tidy log output by @jonny5532 in Solax: Tidy log output #2631
• Fronius: Allow faster reboots by reporting STANDBY until DC bus is live by @nagyrobi in Improvement: BYD-Modbus - report STANDBY until DC bus is live #2666
• VCU Zombie: VCU mode bitmapping fixes by @dalathegreat in Bugfix: VCU mode bitmapping fixes #2647
• Sungrow: SBR cleanup and updates by @aferrara in Sungrow: SBR cleanup and updates #2675

Connectivity 🛜

• MQTT: Significantly reduce heap usage, especially on double/triple battery setups by @nagyrobi in MQTT: reduce heap usage, especially on double/triple battery setups #2643
• MQTT: Improvement: Add generic MQTT autodiscovered Insulation Resistance sensor by @nagyrobi in Improvement: Add generic MQTT autodiscovered Insulation Resistance sensor #2671
• MQTT: Add configurable Home Assistant MQTT discovery topic by @StarkJohan in Add configurable Home Assistant MQTT discovery topic #2592
• Syslog: Allow syslog server to run on low flash boards by @nagyrobi in feature: Add general logging to a syslog server to low flash boards #2645

Housekeeping 🧹

• Feature: Make CPU temperature configurable, with an offset by @dalathegreat in Make CPU temperature configurable, with an offset #2639
• Improvement: Remove obsolete "Use CanFD as classic CAN:" setting by @dalathegreat in Improvement: Remove "Use CanFD as classic CAN:" setting #2646
• Improvement: Apply user current caps to low pass filter input by @nagyrobi in Improvement: Apply user current caps to low pass filter input #2627
• Improvement: Skip unchanged values in NVS settings store to reduce flash writes and prevent task overruns by @nagyrobi in Improvement: Skip unchanged values in NVS settings store to reduce flash writes and prevent task overruns #2625
• Improvement: Web UI: Only offer double/triple battery for integrations that support it by @nagyrobi in Web UI: only offer double/triple battery for integrations that support it #2661
• Improvement: Make core-task CAN logging non-blocking to prevent task overruns by @nagyrobi in Improvement: Make core-task CAN logging non-blocking to prevent task overruns #2624
• Bugfix, NVM: allow max charge/discharge to be set to 0 by @jonny5532 in NVM: allow max charge/discharge to be set to 0 #2633
• Improvement: Make sure we don't try to send to uninitialized CAN interfaces by @jonny5532 in CAN: Make sure we don't try to send to uninitialized interfaces #2630
• Fix measure-firmware-size artifact filter by @ngehrsitz in Fix measure-firmware-size artifact filter #2642
• Make USB debug logging non-blocking to prevent task overruns by @nagyrobi in Make USB debug logging non-blocking to prevent task overruns #2640
• Unifiy build & release (uncompressed) by @ngehrsitz in Unifiy build & release (uncompressed) #2615
• Remove checkprogsize rebuild by @ngehrsitz in Remove checkprogsize rebuild #2653
• Update gitignore file by @dalathegreat in Update gitignore file #2667
• Fix inverter CAN alive-event handling in update_machineryprotection by @ekholm in Fix inverter CAN alive-event handling in update_machineryprotection #2677
• Bugfix: missing newline on truncated log lines by @nagyrobi in Bugfix: missing newline on truncated log lines #2680
• Bump actions/setup-python from 6 to 7 by @dependabot[bot] in Bump actions/setup-python from 6 to 7 #2682

New Contributors 🦸

• @TheOfficialBatteryMan made their first contribution in Adjust Ford Mach-E cell temperature offset #2583
• @ekholm made their first contribution in Fix inverter CAN alive-event handling in update_machineryprotection #2677

Full Changelog: v11.1.0...v12.0.0

---

This discussion was created from the release v12.0.0.