* Update EG4 LL-V2 component to v1.1.0 Fixes RAR/esphome-eg4-bms#7: some EG4 LL-V2 units intermittently answer with a CRC-valid function-03 response whose register data area is entirely zero. The component published those zeroes as a real reading, collapsing SoC, pack voltage and capacity for one poll cycle. v1.1.0 rejects implausible blocks and no longer lets them refresh the online tracker, so a unit stuck returning zeroes now goes offline instead of reporting a flat-zero battery. No YamBMS-side changes are required: neither EG4 package uses the removed designed_capacity sensor, and both already use the cell_average_voltage key.
21 KiB
YamBMS changelog
-
YamBMS 1.8.0 :
- Rewritten Cut-Off / EOC charging logic : adds a current deadband (rejects sensor noise / low-solar current limiting) and a minimum SoC gate before Cut-Off can be declared, extends the cut-off confirmation delay from 60s to 180s to reject transient voltage readings, see release note
- New select
Cut-Off Cell Voltage: choose betweenMax Cell Voltage(default, conservative) andAverage Cell Voltage(consistent charge termination voltage for packs with a runner cell, requires Auto CVL and/or Auto CCL for cell protection) - New sliders
Max charge C-Rate/Max discharge C-Rate: the max charge/discharge current is now the lowest of the user slider, the BMS OCP safety margin, and battery capacity × C-Rate - Renamed
Inverter Offset V.toCharger Offset V.and allowed negative values (-1V to +1V) - Auto EOC : new 1-hour grace period holding the last computed current after target time passes (instead of releasing to maximum current), smoothed remaining-capacity estimate between BMS 1% SoC steps to remove current sawtoothing,
Stop SoCslider capped at 98% (100% could never trigger because SoC is clamped to 98% until end-of-charge) - New
Auto CCL Current Taperfunction : tapers CCL from a configurable knee voltage/C-Rate down to a bulk C-Rate, then holds a configurable balance current while at bulk or after EOC ; release hysteresis and Balance Current max are now scaled to cell count/battery capacity instead of flat constants, and a NaN guard prevents a spurious taper during the boot transient, see changelog Requested Charge Voltage (CVL)calculation reworked :Auto CVL,Auto Floatand the newAuto Custom CVLare now summed on top of the phase target in every charging phase (Bulk/Float/Stop), instead ofAuto CVLsilently applying a Bulk-anchored correction during Float/Stop too ;Auto CVLnow has dedicated Float/Stop behavior (based on average cell voltage, one-directional, chained floors down to nominal/discharge voltage) instead of only correcting Bulk ;Stopcharging voltage target changed fromRebulk V.to nominal voltage, see changelog- New substitutions
custom_ccl_derating_reason/custom_dcl_derating_reasonallowing a custom current-limiting source (e.g. added viayambms_custom.yaml) to report itself in the CCL/DCL derating reason sensor, and a similarAuto Custom CVLslot for voltage - The CCL/DCL auto-limiting globals are now reset at the start of every cycle instead of only being overwritten by their owning function, preventing a past derating reason/value from getting silently stuck if the condition that caused it disappears
- Fixed incorrect Max/Min Cell Voltage scaling (×100 instead of ×1000) sent on the CAN bus for the Deye PCS protocol
- Improved PACE BMS Modbus : power is now computed from current × voltage instead of a raw register (fixes incorrect readings), improved offline detection
- Updated EG4 LL-V2 component to v1.1.0 : fixes issue 7, some EG4 LL-V2 units intermittently answer with a CRC-valid response whose register data is entirely zero, which was published as a real reading and collapsed SoC / voltage / capacity for one poll cycle ; those blocks are now rejected and no longer refresh the online tracker
- Reworked Modbus timing options :
send_wait_timeis now a response timeout (default lowered from 2000ms to 200ms) and a newturnaround_timeoption was added; shared multi-node settings (yambms_config.yaml) updated accordingly - New
loop_task_stack_sizeoption (8192/16384/32768) available on every board, to prevent stack overflow with a large number of BMS/entities, see documentation - Updated default PSRAM options for ESP-IDF 5.5+, see documentation
- Set esphome
min_versionto2026.7.0 - Updated HA dashboards
1.8.0for the new Cut-Off Cell Voltage, Charger Offset V., C-Rate and Auto CCL Current Taper entities - New documentation :
- Merged PR 308 Check if Auto SoC Limit has reached its target
- Merged PR 303 Auto CCL Current Taper
- Merged PR 290 Add grace period to Auto EOC
-
YamBMS 1.7.0 :
- Partial rewrite of
yambms_coreand merging of C++ code into a single lambda in several stages with increased datas control. - Added LVGL display dashboard for Waveshare Touch-LCD 4.3" and 7" (Blue Navy 800x480 design)
- Fixed issue 10 Sending CAN bus data before the end of the combination process
- Fixed issue 154 Add
Enerkey Balancersbalance stop diff voltage setting (register 0x1A) - Fixed issue 160 The SOH sensor is interpreted as a battery percentage
- Fixed issue 182 Compliance of Auto functions for YamBMS 1.7.0
- Fixed issue 268 [Add an option] The inverter is not sending ACK CAN ID 0x305
- Fixed issue 282 JK errors_bitmask has been removed
- Merged PR 281 Add WS Touch-LCD-4.3B board
- Merged PR 261 Add LilyGo T-Connect Pro Lite board (without screen)
- Merged PR 259 Add support for Rebulk Days
- Merged PR 258 Auto EOC: Factor in Auto SoC Limit for battery capacity calculation
- Merged PR 255 Add support for Auto SoC Limit
- Merged PR 236 Switch to VictronMPPT-ESPHOME fork
- Merged PR 235 Basen: Add "Enable communication" switch
- Merged PR 200 Add M5Stack Tab5 with LVGL display
- Merged PR 199 Add Ecoworthy BMS integration for YamBMS
- Merged PR 194 Component Fault Registry & Advanced LED Control
- Merged PR 178 Basen BMS: Add heating control
- Merged PR 170 Add Freenove S3 board
- Merged PR 162 PACE Sensor Fixes
- Merged PR 158 Automatically disable shunt when connected BMSs are going offline
- Partial rewrite of
-
YamBMS 1.6.0 :
- New dashboards
1.6.0 - Added
iBMS V3.3board - Updated
JK-PBreadme with V19 warning and SoC 100% reset solution 1 and 2 - Added board option
UART flow controlallows you to activate atalk_pinfor the UART of your choice (e.g. WS-RS485-CAN) - Added AtomS3 GPIOs for
Atomic RS485 base(uart_esp_3) - Disabled the
reboot_timeoutafter 15 minutes in case of WiFi unavailability - New
Hardware highlighteddocumentation (LilyGo / Waveshare / M5Stack) - New readme for LilyGo T-Connect, WS RS485-CAN and M5Stack AtomS3 boards
- Improved documentation.
- Fixed issue 83 Add esphome-pace-bms
- Fixed issue 94 Multi-BMS Seplos V3 don't work
- Fixed issue 96 Improve the SoC returned at the end of discharge
- Fixed issue 100 Improve the BMS Seplos V1 V2 examples
- Fixed issue 102 Improve Remaining Capacity when using a shunt
- Added issue 106 [FEATURE REQUEST] Temperature-based current limiting
- Fixed issue 108 [WARNING] esphome::select::Select::state` is deprecated
- Fixed issue 122 Adjust
bms_namein all example YAML to something unique - Fixed issue 128 Align the names of the shunt entities
- Fixed issue 142 Maximum capacity needs to be increased for
JK_RS485BMS - Merged PR 76 Add
Auto EOCfunction - Merged PR 82 Add support for external balancer
- Merged PR 85 Adding
EG4 LLV2BMS - Merged PR 97 Add
Basen controllerversion with talk/flow control pin - Merged PR 99 Basen: Use new binary sensors for charging/discharging
- Merged PR 112 Adding
FLIP_C3board - Merged PR 117 Round requested charge/discharge current to nearest integer
- Change PR 119 Updated
Powergauge (-10kW to 10kW) - Merged PR 133 Add
Studer XTM-4000to supported inverters - Merged PR 142 Sub device support
- Merged PR 143 Improved
Cut-Off charginglogic equation and documentation - Merged PR 147 Improved
CCL,DCLandTemp-basedcurrent control - Merged PR 155 Update temperature sensor filters to reduce noise
- New dashboards
-
YamBMS 1.5.8 :
- New Dashboards
1.5.8compatible withCANBUSandRS485inverter communication protocol - Added BMS
SEPLOS V3(beta) - Added YamBMS
Web Server v3 - Added
WiFi AP WiFi APandWeb Servercredentials centralized insecrets.yaml- Added
WT32-ETH01board - Fixed issue 8 ETH01-EVO board - Davicom DM9051 SPI Ethernet Controller is now integrated in esphome
2025.7 - Fixed issue 24 [JK-PB] SoC never reaches 100%
- Fixed issue 63 [JK RS485 component] Fix ._SCHEMA deprecations
- Merged PR 67 Add options to restrict max. charge and discharge current
- Merged PR 72 Add Pylontech RS485 inverter protocol
- Merged PR 74
PYLON RS485link status, Heartbeat and Requested Force Charge - Merged PR 75 Round
Auto CCL/Auto DCLvalues - Merged PR 77
PYLON RS485prevent stale data on BMS disconnect - Merged PR 80 BMS Modbus client: Return 0 when not online
- Merged PR 81 Fix balance trigger voltage for Basen and Deye
- New Dashboards
-
YamBMS 1.5.7 :
- Adapted the default
min/maxvalues for theFloatslider - Merged PR 53 Add feature
Auto Float Voltage - New dashboard for
Auto Float Voltagefunction - Defining
state_classfor all YamBMS sensors - Set esphome
min_versionto2025.6.0 - Fixed: change
Charge StatustoBulkwhenForce Chargeis requested - Merged PR 70 Dashboards compatible with
HA 2025.7 - Merged PR 70 Dashboard
max/mincell voltage in color using macro - Removed all special characters in entities name + dashboards correction
- Adapted the default
-
YamBMS 1.5.6 :
- Fixed issue 58 Compilation problem with
esphome 2025.5.0 - Fixed issue 55 New CPU frequency option
- Fixed issue 65 JBD Circular dependency error
- Fixed issue 35 BMS Charging Cycles Offset
- Merged PR 51 Support for RP2040 RPi Pico
- Merged PR 56 Add support for Basengreen BMS
- Merged PR 60 Fixes for new ESPHome and add of BMS Cycle Count offset
- Merged PR 61 Set Modbus BMS values to 0 when BMS goes offline
- New
board_ESP32-S3_Touch-LCD-4.3.yamlboard - New
board_ESP32-S3_Touch-LCD-7.yamlboard - New
board_ESP32-S3_YBoard_DJK.yamlboard - New
board_RP2040_RPi_Pico.yamlboard
- Fixed issue 58 Compilation problem with
-
YamBMS 1.5.5 :
- New
main.yamlwith LP (local packages) and RP (remote packages) versions - New
board.yamlwith modular UART/CAN interfaces - The name of the JK
bms.yamlis no longer linked to a specific model - SoC calculation is now based on remaining capacity for more accuracy (BMS only) issues #39
- SoH calculation is moved to BMS level (for those who do not provide this information)
- Improvement of the Victron SmartShunt doc issues #38
- New
-
YamBMS 1.5.4 :
- New low SoC corrected at each BMS level (the corrected SoC is the one transmitted to YamBMS)
- New BMS dashboard
- New end of charge logic at each BMS level, the charge switch turns off when the cells are equalized (disabled by default)
- Fixed
errors_bitamskfor JK-PB RS485, test OK with YamBMS (forked component)
-
YamBMS 1.5.3 :
- Broadcasting JK-PB settings to all BMS set to OFF by default
- Reorganizing the
boardfolder and YAMLs (device_base.yaml moved to board.yaml) device_base.yamlshould no longer be part ofYamBMS_main.yaml- New
RGB LED statuslight effects (red, green, blue, cyan) as anoptionspackages forboard.yaml - Increased CPU frequency to
240Mhzas anoptionspackages forboard.yaml - Added
ESP32 Generic,LilyGo T-CAN485,LilyGo T-ConnectandXIAOboards - Fixed SoC logic (low SoC will be detected at BMS level and no longer at YamBMS level)
- Simplified combination logic (removal of the combine switch) + dashboard update
- Check
Battery Capacityis> 0before combining info (see issue #14) - Improved alarm logic with a common
YamBMS errors bitmaskfor all BMS models (see OTP vs UTP bug reported by @ChrisG) - Added PR #7547 regarding publishing entities via the API
- Removed
captive_portalbecause it increases theloop timetoo much PSRAMwill no longer be enabled by default as this has a bad impact onBLE BMS
-
YamBMS 1.5.2 :
- Added shunt
Online Statusbinary_sensor - Shunt combine condition based on the new binary_sensor
Online Status - Logger
baud_rate: 0by default (frees the 3rd UART and avoids some bugs like "WK2168 with canbus" or "BLE client with RS485 modbus") - Changed names of
bmsandshuntYAMLs for modbusmulti-nodesolution - Added shared configuration file to simplify main YAML (centralization of parameters)
- Simplification (fewer options) when importing
BMS / ShuntYAMLs - New
multi-nodesolution usingRS485 modbusto communicate information to YamBMS - New board
espBerrywith2-CH-CAN HAT
- Added shunt
-
YamBMS 1.5.1 :
- The conditions for
combiningBMS and thecharginganddischarginginstructions no longer have any relation with theerrors_bitmasksensor, the new system relies on the three binary_sensoronline status,charging allowedanddischarging allowedbeing linked to the status of alarms and switches. - The BMS combination procedure has been completely rewritten.
- Improved structure and ID names of
bms.yaml. - The
yambms.yamlandyambms_combine.yamlglobal variable names have been changed for better code reading. - Improved code regarding the CAN bus
esp_lightstatus for boards without integrated LED. - New
Atom S3Rboard andSmartshunt BLEshunt. - New
JBD,Seplos V1 V2,JK-B RS485(display port) andFAKEBMS. - New
YamBMS DEMOYAML and firmware offered to test and discover howYamBMSworks. - New management of temperature sensors (no longer limited to two sensors).
- @Der_Hannes fixed the AtomS3
black screenissue (with esphome > 2024.7.3) and developed new code for display management based on the ili9xxx platform. Auto CCL/DCLfunctions have been fixed to work withJK-PBandnew JK-BBMS, see this issue.- The
UVPRandOVPRsensors are no longer used and replaced byUVPandOVPto ensure operation with all BMS. - @txubelaxu fixed a bug in the
JK-PB RS485component that could cause a false battery voltage value to be sent, see this issue. - Improved documentation, added a
HowToto create its main YAML, warning about galvanic isolation.
- The conditions for
-
CANBUS 2.3.7 : If there is no response from the inverter, the time before a new communication test has been reduced from
120sto60s, added Victron0x372nbr. of modulesblocking charge/discharge. -
YamBMS 1.4.5 : Changed the way to configure WiFi/Ethernet network, added
ESP32-C3 ETH01-EVOethernet board, reduction of the number of YAML bms files, UARTrx_buffer_sizeis set to512by default for JK-B and JK-PB, new JK-BMS BLE sensors (last commits of @syssi) and new BLEstandardversion -
CANBUS 2.3.6 : Sending CAN frames stops immediately if there are no combined BMS
-
YamBMS 1.4.4 : Multi-shunt support, Simplified and new YamBMS option
battery chemistry, slidermin/maxvalues are automatically configured based on the battery chemistry and cell count, addedYamBMS Fallback Hotspot, added YamBMSUpdate service, added PVbrain2 and Atom Matrix board, added PSRAM settings YAML (not enabled by default), new MIN/MAX temperature sensor, added DC current icon, fixed dual sensorCell UVPR (MAX)bug, Improvedcombinecode, Breaking change : Atom S3GPIOs 1 and 2reversed -
CANBUS 2.3.5 : New MIN/MAX temperature / sensor ID, Improved Victron protocol (online/offline battery modules, installed/available battery capacity)
-
CANBUS 2.3.4 : Fixed bug of canbus link validation without inverter connected
-
YamBMS 1.4.3 : Added Victron and Junctek KH-F
Shuntsupport andRequested Force Chargefunction based onSoC start/stop, newTotal Daily Energysensors -
CANBUS 2.3.3 : Added
AutomaticBMS name selection andRequested Force ChargeBit 3/4/5 (PYLON 0x35C) -
CANBUS 2.3.2 : Added
LuxPowerprotocol with updatedcan_id0x355, 0x356, 0x359 and 0x35C -
CANBUS 2.3.1 : Improved the procedure for sending canbus frames with reduced loop time, rewritten of the canbus link validation code and added
Inverter Heartbeat Monitoringfunction -
YamBMS 1.4.2 : Added new
Auto CVL Boost V.andRebulk SoCfunctions, new debug.yaml for ESP32 and ESP32-S3, improved code and comments -
YamBMS 1.4.1 : Rewriting of the alarm system, bug fixes and improvement of the charging logic (new status
Cut-Off), icon allocation for each sensor, UART and CANBUS!extend ${vars}, New sensorYamBMS Delta Cell V., ImprovedBattery SOClogic -
YamBMS 1.3.2 : New var
yambms_cell_count, the BMS charge or discharge switches can be activated separately without causing the decombination of the BMS, newminimalversion of the BMS YAML in order to reduce the loop time -
YamBMS 1.3.1 : First multi-BMS version named
YamBMS