155 Commits
Author SHA1 Message Date
Sleeper85 25727029f6 Fake Equalizing - Disabled by default
The inferred balancing flag stops the Cut-Off timer while the cell spread
stays above bms_balance_trigger_voltage. A pack that does not actually
balance (no balancer, balancing disabled, or a balancer too weak for the
pack) never closes its spread, so the charge stayed in Cut-Off until the
EOC timer ended it, or indefinitely with the EOC timer switch off.

bms_fake_equalizing_enabled now defaults to 'false' for every BMS that
includes the package (EG4 LL V2, Seplos V1/V2, Seplos V3, JK RS485
DISPLAY, Fake/Demo BMS): the flag reports the constant false these
packages used to hardcode. Set it to 'true' per BMS to enable it.

Charging_logic.md and Changelog_Fake_Equalizing.md describe the new
default and the warning.
2026-11-19 02:31:42 +01:00
Sleeper85 bd7c20cd7e Auto Float - Keep the Bulk CVL when Float starts (#353)
Outside Float, the Auto Float interval cleared var_auto_float to 0. When
Float started, the CVL dropped to the final Float voltage for up to 60s,
then rose back to Bulk on the next interval tick before the step-down.

The delta is now kept armed at Bulk - Float outside Float. The core only
adds it while the instruction is Float, so Bulk and Stop are unchanged,
and the first Float CVL is the Bulk voltage.

Issue #353
2026-11-17 20:28:11 +01:00
Andrew Rankin a7e190b8e1 EG4 LL-V2: no General alarm for a full pack, component v1.1.4 (#349)
Fixes #342

* EG4 LL-V2: no General alarm for a full pack, component v1.1.2

EG4 packs hold protection bit 12 ("Low Capacity") while they are full and
have stopped charging, and it clears once they discharge. It was mapped to
General alarm, so every full charge raised a YamBMS alarm and sent it to
the inverter over CAN (#342). It is no longer mapped.

Discharge over temperature (0x0200) and discharge under temperature
(0x0800) protection were not mapped; they now raise the high and low
temperature alarms, as charge OT/UT already raise the charge ones.

Component v1.1.2 tracks each register block on its own
(RAR/esphome-eg4-bms#9): a pack goes offline when either block stops
giving valid replies, and that block's sensors publish NaN, so the
bitmask lambda now reads a NaN bitmask as no bits.

* EG4 LL-V2: component v1.1.3 (bus turnaround gap)

v1.1.2 took packs offline on a shared bus: a request sent right after
another pack's reply was often not answered. v1.1.3 waits a turnaround
time (50 ms) after each reply (RAR/esphome-eg4-bms#9).

* EG4 LL-V2: update date and version of the changed YAMLs
* EG4 LL-V2: component v1.1.4 (only the awaited reply ends the wait)
2026-11-16 20:50:55 +01:00
Sleeper85 dfbe4805ad Auto SoC Limit - Follow the Max Charge Current while the CCL limit is held
In the CCL and Float + CCL modes, the offset -(Max Charge Current - Auto
SoC Limit CCL) was computed once, when the target SoC was reached, and
then kept until the SoC dropped below the hysteresis. If the Max Charge
Current increased in the meantime (a pack rejoining the bank, a BMS
raising its limit), the cached offset applied to the larger maximum
released the limit: e.g. 141A requested instead of 1A.

While the target is reached in a CCL mode, the offset is now recomputed
on every pass, before the 60s throttle. A NaN Max Charge Current leaves
the previous offset in place.

Reported in #352
2026-11-14 20:24:19 +01:00
Sleeper85 eee476340d YamBMS - Stop the Cut-Off and EOC timers in Wait and while no BMS is combined
The cut-off timer (180s) and the EOC timer (30min) were only stopped when
the Bulk phase was re-entered. While the charging logic was suspended (no
BMS combined) or in Wait (charging not allowed), they kept running, so a
dropout or a charge block during the Cut-Off phase could declare an EOC
with no BMS data to confirm it: the status went to Float or EOC, SoC 100%
could be sent and the rebulk days counter was reset.

Both timers are now stopped while the logic is suspended and whenever the
status is set to Wait. With bms_options_charging_logic.yaml, Wait is only
entered when the Charging switch is off, so the Cut-Off performed by
YamBMS itself is not affected. When charging is allowed again after a
Wait in Cut-Off, a new Bulk starts and the Cut-Off phase is run again.

Charging_logic.md is updated accordingly.

Reported in #352
2026-11-14 20:24:19 +01:00
Sleeper85 21c0251309 YamBMS - Apply the Auto Float adjustment to the Float voltage only
The 1.8.0 CVL rework added the Auto Float delta to the requested charge
voltage for every charging instruction. Auto Float clears that delta on
its own 60s interval once the instruction is no longer Float, so after a
Float => Bulk transition (Force Bulk, rebulk rules, Force Charge) the CVL
was the Bulk voltage plus the delta for up to 60s. The delta can reach
Bulk - Float when Float has just been entered.

The delta is now added in the Float branch only, as in 1.7.0. Auto CVL
and the custom CVL still apply to every instruction.

Reported in #352
2026-11-14 20:24:12 +01:00
Sleeper85 e569bfbac9 CAN 0x35A - Send inactive alarms and warnings as OK (10), not 00
Each alarm and warning of 0x35A is a 2-bit field : 1 is active, 2 is
inactive (OK), 0 and 3 mean not supported. YamBMS only set the active
bit and left 00 otherwise, so an inverter read every field that was not
in alarm as "not supported" instead of OK.

Every field is now written explicitly, active or inactive, and a frame
with no alarm is AA AA AA 02 AA AA AA 02, which is what a BYD battery
sends at rest. The reserved fields of bytes 3 and 7 stay at 0. The
mapping of the YamBMS bits is unchanged.

The frame is sent by PYLON V2, SMA and Victron. SMA calls the two bits
"arrive" and "leave", with the same meaning. The alarms are only
displayed and logged by the inverter, they do not change how it charges.

Design_decisions.md records why OK must never be sent as 0.
2026-11-14 19:50:47 +01:00
Sleeper85 6085e6ff24 PYLON CAN 0x359 - Send Charge Over Current on bit 0, stop sending UnBalanced Cell (#345)
Charge Over Current was set with 0x80 in bytes 1 and 3, a copy of the
Discharge Over Current value of byte 0. PYLON V1 and V2, LuxPower and the
other 0x359 specifications put it on bit 0 of both bytes, which is also
where 0x35A already sends it. Bit 7 is undefined, so the inverter never
saw the alarm.

UnBalanced Cell was sent on bit 4 of bytes 1 and 3. PYLON V2 defines byte
1 bit 4 as an external communication timeout that stops charge and
discharge, so a cell imbalance alarm could stop the inverter. Byte 3 bit
4 is reserved. Neither is sent any more; cell imbalance is still sent on
0x35A.

The frame layout is the same in PYLON V1 and V2, so the fix applies to
both, and to LuxPower which shares frame 5.
2026-11-14 19:50:47 +01:00
Sleeper85 0ef4ab355b Send the protection alarms when all combined BMS are in alarm (#344)
The alarm bitmask was published only when the number of BMS in alarm
equalled var_bms_counter, the number of configured BMS. But only
combined BMS are counted in alarm, so with one BMS offline or missing a
value the alarm could never be raised : the inverter received only the
warning bits, and the "Alarm" text sensor showed "Warning".

STEP 2 now compares with var_to_combine_bms_counter. An uncombined BMS
is offline or has missing data, it does not count as "not in alarm".
This matches the rest of the combiner, where charge and discharge are
already decided by the combined BMS only.

The "Alarm" text sensor no longer compares counters : it is derived from
the published alarm and warning bitmasks, so it shows what is sent to
the inverter.

The comment on the alarm sensor said "bitwise AND", it is an OR.
2026-11-14 19:08:36 +01:00
Sleeper85 0db1572953 Docs: Add JK RS485 1.2 to the 1.8.2 changelog 2026-11-13 08:12:00 +01:00
Sleeper85 249541420e Restore Float or EOC when charging is allowed again after Wait (#343)
When charging was not allowed, the status went to Wait, also from Float or
EOC. When charging was allowed again, the Init / Wait -> Bulk rule came
first in the rebulk chain, so a full battery got the Bulk voltage again
after any short block, without any rebulk rule being checked.

The status is now kept in var_charge_status_before_wait on entering Wait.
When charging is allowed again, Float or EOC is restored before the Force
Bulk and rebulk rules, which then decide whether a new Bulk is needed.
Any other status goes to Bulk as before.

A dedicated variable is used rather than var_eoc: Auto SoC Limit sets
Float without a full charge and leaves var_eoc false on purpose, and that
Float must be restored too.

Charging_logic documents when the status goes to Wait and what happens
when charging is allowed again.

Fixes #343
2026-11-11 00:41:13 +01:00
Sleeper85 fcbe5023af Suspend the charging logic while no BMS is combined
The STEP 3 guard tested its values with has_state(), which ESPHome sets on
every publication, NaN included. STEP 2 publishes NaN when no BMS is
combined, so STEP 3 ran on every tick of a boot or a BMS dropout. The
charging logic then saw "Charging allowed" false and set the status to
Wait, and the Init/Wait -> Bulk rebulk rule restarted a Bulk on a full
battery as soon as the BMS came back.

- The guard follows the can_be_combined rules: isnan() or a comparison
  for sensors, has_state() for binary sensors. It reads the live
  var_to_combine_bms_counter rather than bms_combined, which STEP 2 only
  publishes once per round.
- The inner "At least one BMS combined" check is removed: the guard is
  now the single test. CVL, DVL, CCL, DCL and Requested Force Charge
  move up one level.
- A new else branch suspends the logic: var_charge_status keeps its
  value, the instructions and requested values are cleared for Home
  Assistant, and var_initialized is set to false.
- The end of STEP 3 no longer tests bms_combined and total_voltage,
  already guaranteed by the guard.

This fixes the dropout case of #343. A BMS that blocks charging while
combined still goes through Wait.

Charging_logic documents the BMS dropout behaviour, Design_decisions the
guard and its else branch.

Refs #343
2026-11-11 00:20:09 +01:00
Sleeper85 2fcfc4f44f Silence the Voltronic LIB link until YamBMS is initialized
The CAN and PYLON links only send data while var_initialized is true and
at least one BMS is combined. The LIB link only checked its protocol, so
it kept answering the inverter during a boot or a BMS dropout, and its
read_lambdas converted the NaN values to integers, which is undefined.

The 100 ms interval now moves the Modbus server to address 248, the
mechanism already used for Disabled, until YamBMS is initialized. The
status mirroring still follows the protocol only: an active link left
silent serves no request, its Status goes false and raises the fault,
like the other links during a dropout.

Design_decisions documents the second condition.
2026-11-11 00:00:27 +01:00
Sleeper85 77237e7c6c Reject NaN values in the BMS and shunt can_be_combined conditions
The BMS condition tested most sensors with has_state(), which ESPHome sets
on every publication, NaN included. A BMS that had published NaN once on a
mandatory sensor (for example the PACE power template, which returns NaN
when the current is unknown) stayed combinable, and the NaN corrupted the
totals that drive the inverter.

- Sensors are tested with !std::isnan(): a sensor's state starts at NaN,
  so it also covers a sensor that never published.
- cell_ovp and cell_uvp use > 0, like total_voltage and battery_capacity.
  JK, KS and PACE packages declare them as a number, whose state starts
  at 0, so isnan() alone would combine the BMS before its protection
  settings are read.
- Binary sensors keep has_state(), a bool cannot be NaN.

The shunt condition only checked the switch and online_status. It now
also checks the four values the combiner reads: voltage > 0, and current,
power and soc with isnan(). A combined shunt replaces the BMS values, so a
NaN there reached the inverter directly.

Both conditions move from the binary sensor lambda to STEP 1, on the
device's turn, and are published to "Can be combined". A template binary
sensor with a lambda runs it on every loop, about 60 times per second per
device, for a value read once per round.

Design_decisions documents which test applies to which entity type, that
every entity in the conditions is mandatory, and why they are evaluated in
STEP 1.
2026-11-10 22:54:46 +01:00
Sleeper85 c9502bd196 Fix Requested Force Charge turning on while no BMS is combined (#346)
The binary sensor lambda was evaluated on every loop, including while no
BMS was combined (boot, BMS dropout). The SoC was NaN then, and
`int soc = NaN` is undefined: the request could turn on, and with a real
SoC between Start and Stop it stayed on until Stop SoC once the packs came
back.

The rule now runs in STEP 3, inside the "At least one BMS combined" block,
and publishes the sensor. While no BMS is combined it is not evaluated, so
the request keeps its last state. The SoC is read as a float: a NaN fails
both comparisons and keeps the current state too. The "Request force
charge" switch clears the request at once with an on_turn_off, even while
no BMS is combined.

Reported in #346, first fix proposed in #347.
2026-11-10 22:02:11 +01:00
Sleeper85 239f9137c3 Docs: Add inferred balancing to the 1.8.1 upgrade guide
EG4 LL V2, Seplos V1/V2, Seplos V3 and JK RS485 DISPLAY now infer their
balancing state. It changes when the charge ends without any validation
error, so it belongs in the biggest changes of the upgrade guide.
2026-11-10 13:20:24 +01:00
Andrew Rankin 8b24872878 Update EG4 LL-V2 component to v1.1.1 (builds on ESPHome 2026.11) (#341)
Update EG4 LL-V2 component to v1.1.1 (builds on ESPHome 2026.11)

ESPHome 2026.11 removed format_hex_pretty(), which v1.1.0 used in its frame
logs, so every EG4 LL-V2 config failed to compile on dev:
'format_hex_pretty' was not declared in this scope. v1.1.1 uses its own
formatter (same output) and changes nothing else.

Checked with the EG4 LL-V2 example (3 BMS, ESP32) on ESPHome 2026.11.0b3.
2026-11-09 23:19:31 +01:00
Sleeper85 a36677320c Docs: Add the 1.8.2 changelog 2026-11-09 00:18:43 +01:00
Sleeper85 67b6892e24 Set ESPHome min_version to 2026.11.0 and declare sub-device relation
ESPHome 2026.11 makes `relation` a required option for every entry under
`esphome: devices:`, and 2026.10 rejects that key. Both changes have to
land together, so raise min_version to 2026.11.0 in the same commit.

Use `relation: via` on all ten device declarations (BMS, sniffer, shunt,
balancer, Deye stack, board, YamBMS instance, CAN and RS485 links). It is
the value the API assumed before the key existed, so Home Assistant keeps
showing the devices exactly as before. `child` would fit the board, the
YamBMS instance and the inverter links better, but it is left for later:
a Home Assistant release that reads the field without supporting `child`
drops those devices and their entities.

Docs: ESPHome 2026.11.0 in README and Installation_procedure (which still
said 2025.11.0), Design_decisions no longer equates min_version with the
flow_control requirement, and Coding_conventions documents the
`relation: via` rule.
2026-11-09 00:06:28 +01:00
Sleeper85 d2001d8394 Docs: Add the hub daily energy fix (#336) to the 1.8.1 changelog 2026-11-08 23:11:30 +01:00
Sleeper85 1cf367f333 Docs: Add the 1.8.1 upgrade guide and complete the changelog
New Changelog_upgrade_to_YamBMS_1.8.1.md: a short step-by-step guide to
move a 1.7.0 or 1.8.0 YAML to 1.8.1, starting from the example YAML. It
covers the biggest changes (inverter brand, UART and CAN declared by the
packages, RS485 entry point, C-Rate defaults, CCL/DCL divided by the
number of declared links), CAN and RS485 examples with the valid UART
ids, the inverter brand selection, the 1.8.1 dashboard, the common
validation errors and the PVbrain2 board files.

Changelog.md: link the new documentation pages and the 1.8.1 dashboards,
and list the remaining 1.8.1 changes (services and telemetry, Auto CCL,
0 A limits, fixes and merged PRs).
2026-11-08 23:08:34 +01:00
Sleeper85 faad9e60ce YamBMS 1.8.1 LP/RP examples
Update the root YAML and the examples for the UART and CAN declarations, the
RS485 block and the Board Options section.
2026-11-08 23:08:34 +01:00
Sleeper85 cab5a63e0e Docs: Rewrite the inverter brand and protocol section
Lead with the three setup steps: select the inverter brand, leave
Protocol on Automatic, then configure the inverter from the dashboard.
Forcing a protocol moves to its own subsection, as the exception it is.

The screenshot now shows the brand and protocol selects and the active
protocol card, and replaces YamBMS_CANBUS_Protocol.png.
2026-11-08 23:08:34 +01:00
Sleeper85 cb9638653d Docs: The CCL/DCL divider counts declared links
Document that every declared CAN or RS485 inverter link divides the requested
CCL/DCL, including a link whose protocol is `Disabled` or left on `Automatic`
with no brand, and that only links actually wired to an inverter should be
declared.

Design_decisions.md records why the divider must not be restricted to active
links: a disabled link usually still has an inverter drawing from the bank, an
unconfigured link is the state every link starts in after 1.8.0, and a lost
link must never raise the current sent to the remaining inverters.

YamBMS_functions.md: fix the RS485 package name (`yambms_rs485.yaml`).
2026-11-08 23:08:34 +01:00
Sleeper85 00e04df04b Docs: Add the Telemetry page and change the services URL
Replace the README Data collection section with Telemetry.md and point
the update and telemetry requests to script.yambms.org.
2026-11-08 23:08:34 +01:00
Sebastian a4844fc947 YamBMS: Auto EOC 24h charging window (#338)
Auto EOC assumed daylight charging: the target was always today and the
target hour was limited to 12-23, so a night window could not be planned.

- New Auto EOC Start Hour/Minute define the charging window from the
  start time to the next target time. It may cross midnight
  (e.g. 22:00 -> 06:00 for grid charging); start = target is 24h.
- Target hour can be set from 0 to 23.
- Outside the window the status is "Wait: Starts at hh:mm" instead of
  "Stop: Target time passed". The 1h grace period is unchanged and has
  priority over a window starting within it.
- Times are local and DST safe.
- Default start 00:00 keeps the previous daylight behaviour.
- Dashboards, docs and changelog updated.
2026-11-08 23:08:34 +01:00
Sebastian 61424486c0 Round daily energy sensors to 10 Wh (#339)
Daily Charging/Discharging Energy (YamBMS and per BMS) were published
with 1 Wh resolution. Home Assistant records every float change, so a
new state was written every few seconds while charging or discharging.

- Add a round: 2 filter and set accuracy_decimals to 2 (0.01 kWh).
- bms_base_daily_energy 1.1.4, changelog updated.
2026-11-08 23:08:34 +01:00
Sleeper85 7b750a4b35 Docs: Fix 1.8.1 changelog errors and discharge C-Rate comment 2026-11-08 23:08:34 +01:00
Sleeper85 9203dd09f9 Docs: Add why_yambms and update the Cut-Off diagram
Explain why YamBMS is useful when the BMS already talks to the inverter, and
refresh the Cut-Off charging logic diagram.
2026-11-08 23:08:34 +01:00
Sleeper85 58c03ac83f Packages: Declare each CAN node in the package that consumes it
yambms_canbus.yaml and the Deye top packages now import their node from
canbus_platform (esp32_can, mcp2515 or external). canbus_bitrate replaces
esp32_canbus_bitrate and mcp2515_canbus_bitrate. Breaking change.
2026-11-08 23:08:34 +01:00
Sleeper85 e3f35aedb0 Packages: Declare each UART in the package that consumes it
Each package now imports its UART from its *_uart_id var and keeps its own baud
rate key. WK2168 channels work the same way, uart_flow_control_pin replaces the
flow control include, and min_version moves to 2026.10.0. Breaking change.
2026-11-08 23:08:34 +01:00
Sleeper85 5c171aea14 Docs: Explain the 0 A limit in the combiner
Document why the combiner accepts 0 A as a valid charge and discharge limit.
2026-11-08 23:08:34 +01:00
Sleeper85 ee12380087 YamBMS: Inverter brand registry and RS485 entry point
Rename the inverter registry to yambms_brand_registry.yaml and add the new brands.
yambms_rs485.yaml becomes the file to include, with a rs485_protocol var that
selects PYLON or Voltronic LIB.
2026-11-08 23:08:34 +01:00
Sleeper85 51cf3972ed Added RS485 Voltronic LIB protocol
Added RS485 Voltronic LIB protocol

Experimental support for Voltronic Power's own Modbus RTU protocol
(YB_PROTO_RS485_VOLTRONIC_LIB), distinct from Pylontech and confirmed by
an independent Epever cross-reference (PRO=26, same document authors).
Implemented natively via ESPHome's modbus_server rather than an external
component, since it's plain Modbus RTU unlike Pylontech's own framing.

Voltronic (Axpert/InfiniSolar) and MPP Solar share this protocol and are
added to both inverter brand selects - confirmed identical by MPP Solar's
own manual. Required splitting the RS485 entry point the other way round
(yambms_rs485_pylon.yaml/yambms_rs485_voltronic.yaml now include the
shared yambms_rs485.yaml, not the reverse) so a node can run a different
protocol on each RS485 link.

Scope is deliberately reduced to what the inverter firmware actually
honors: per Voltronic's own documentation only the charge voltage limit
is applied, so Auto CCL Current Taper and Auto Float have no effect
through this link - accurate SOC/telemetry and charge/discharge
enable/disable are the real value here. Unverified on real hardware.
2026-11-08 23:08:34 +01:00
Sleeper85 281d39ac18 New inverter brand select drives the CAN and RS485 protocol
BREAKING CHANGE: both inverter link selects are renamed, so their stored value is
reset. The link stays inactive until an inverter brand is selected. See
documents/README/changelog/Changelog_Inverter_brand_and_protocol.md

New `Inverter brand` select (16 brands) and reworked `Protocol` select, now
defaulting to `Automatic`. Selecting the brand is enough, the protocol follows;
an explicit protocol still takes priority over the brand.

The protocol is resolved once, at boot and on every select change, into
`canbus${canbus_id}_active_protocol` / `rs485${rs485_id}_active_protocol`.
Everything else reads that integer instead of dispatching on `active_index()`,
where `== 5` meant LuxPower purely by convention of the option order.

New shared `yambms_inverter_registry.yaml`: protocol dictionary (`YB_PROTO_*`),
brand to protocol mapping, and the battery mode and note of each couple.

Removed the `YamBMS name` select: the manufacturer name sent on CAN frame 0x35E
now derives from the protocol in use, which is what `Automatic` already did.

Removed the `canbus_extended_ack` substitution: both the 11-bit and the 29-bit
ACK triggers are registered, so the Schneider XW Pro needs no configuration.

Renamed CAN `PYLON 1.2` to `PYLON V1` and RS485 `Pylontech` to `PYLON`.

New per-link diagnostics `Inverter link protocol`, `Inverter battery mode` and
`Note`, with a markdown card in the dashboards, alongside a system fault card.

Telemetry: `comm_bus` / `comm_protocol` replaced by `inverter_brand`,
`inverter_bus`, `inverter_protocol` and `inverter_protocol_source`, one slot per
declared link instead of a single value overwritten by the last one.

RS485 packages split: `yambms_rs485.yaml` is the entry point carrying the selects,
`yambms_rs485_pylon.yaml` the protocol implementation. The baud rate is applied
with `set_baud_rate()` + `load_settings()` instead of extending the uart
component, so boards using a UART expander no longer need their own include.

Fixes:
- the CAN bus kept re-emitting the last frame every 100 ms when the protocol was
  set to `Disabled` at runtime
- the RS485 link kept answering the inverter with stale data on `Disabled`, the
  proxy sensors it reads are now invalidated
- a `Disabled` link no longer lights the fault LED, it is unregistered from the
  fault registry instead of being reported as failing
- the reported bus and protocol were overwritten when a node declares several
  inverter links
- changing the protocol restarts the CAN frames immediately instead of waiting up
  to 30 s for the next retry tick
2026-11-08 23:08:33 +01:00
Sleeper85 3e596ea82a Reworked the update and telemetry services
- update and telemetry are now gated independently by substitution;
  var_service and its Update service switch are removed
- the uptime text sensor is published by its source instead of polling
  it, which fixes the 24855d readings that reached the telemetry, and
  the raw seconds are now sent instead of the formatted string
- the MAC address is replaced by a salted SHA-256, derived identically
  server side so no pairing window is needed
2026-11-08 23:08:33 +01:00
Sleeper85 9dd22fa56b Inferred equalizing for BMS that do not report a balancing flag
Some BMS balance their cells but never expose a balancing flag, so
`bms_equalizing` stays false and the core cannot tell a pack that is still
balancing from one that has finished. This is not cosmetic : while
equalizing is true, yambms_core.yaml stops the Cut-Off timer and lets the
charge run to the EOC timer instead of terminating early.

bms_options_fake_equalizing.yaml infers that flag from the pack itself. No
absolute cell voltage is hardcoded : the anchor is bulk_voltage / cell
count, the same derivation as cell_bulk_v in yambms_core.yaml, so it
follows `yambms_battery_chemistry`, the cell count and the configured bulk
voltage automatically.

  START when BOTH are true
    max cell >= cell_bulk_v                     the pack is at the setpoint
    AND (max - min) >= trigger voltage          its own balancing threshold

  STOP when EITHER is true
    max cell <  cell_bulk_v - hysteresis        the pack dropped off the setpoint
    OR (max - min) <  trigger - delta hyst.     the spread closed back below it

Only two deltas and one offset are configurable, and none of the three
depends on the chemistry - LFP, Li-ion and LTO all want the same few tens
of mV. The absolute anchor they hang off comes from the core, for free.

The delta condition is what keeps this honest : a pack that reaches the
setpoint perfectly balanced has nothing to equalize, so it reports false
and the Cut-Off timer does its job. A plain voltage comparison would report
balancing forever and terminate every charge on the EOC timer.

It extends bms<id>_bms_equalizing, the raw BMS flag, and not the combined
bms<id>_equalizing sensor. bms_base_balancer.yaml is therefore neither
modified nor duplicated, and keeps giving an external balancer priority
whenever one is online : the inference only applies when no balancer
reports for this pack.

This commit only adds the package. Nothing includes it yet, so no existing
configuration changes behaviour. Candidates sharing the same case are
Seplos V3, Seplos V1/V2, EG4 LL V2 and JK RS485 DISPLAY, whose
bms_equalizing is a hardcoded `return false;`.
2026-11-08 23:08:33 +01:00
Sleeper85 17360765d4 Update Changelog.md 2026-11-08 23:08:33 +01:00
Sleeper85 7fc55192c8 Updated Auto CVL changelog 1.8.0 2026-11-08 23:08:33 +01:00
Sleeper85 cb3b0eedba Installed Battery Capacity now follows a capacity change at runtime
The installed total was accumulated once per BMS per boot, latched by
bms<id>_combined_once, so a BMS reconfigured with a different capacity
kept contributing its boot value until the next reboot.

Each BMS now remembers the last capacity it contributed in
bms<id>_installed_capacity and applies only the difference to the total.

- the update runs in the can_be_combined branch, so an offline BMS simply
  stops updating its contribution, which stays in the total : the installed
  capacity still never shrinks on an uncombine, as before
- a BMS coming back with a different capacity is applied as a delta, with
  no double counting
- combined_once had no other reader and is removed

The total is deliberately not turned into a per-round accumulator reset in
the Global vars reset block like the other totals : its sensor is polled
independently of STEP 2 and its state is written straight into CAN frame
0x379 with no has_state() guard, so a transient zero would announce 0 Ah of
installed capacity to the inverter. See Design_decisions.md.
2026-11-08 23:08:33 +01:00
Sleeper85 0f7bf94111 Added KS BMS support #151 2026-11-08 23:08:33 +01:00
Sleeper85 b7bb2e93ea Moved Auto CCL Current Taper section 2026-11-08 23:08:33 +01:00
Sleeper85 e4b8aacc0a Fixed 6h reboot on networks that filter the ESP32 outbound traffic
http_request runs on the loop task, which has a 4s budget before the
5s task WDT panics. A dropped connect() blocks for 4.5s (the ESPHome
default timeout) and a filtered port 53 blocks for a fixed 7s, which
timeout does not cover.

- timeout 3s and watchdog_timeout 60s cover the two blocking paths
- a failure counter stops the service after 3 network-level failures,
  instead of freezing the loop 14s every 6h forever
- the POST is now skipped when the GET failed

Reproduced and measured on OPNsense.
See Design_decisions.md.
2026-11-08 23:08:33 +01:00
Sleeper85 9f90436849 Multi-inverter support, division of CCL/DCL by the number of inverters/chargers 2026-11-08 23:08:33 +01:00
Sleeper85 4d4d11e832 Auto CVL - Float / Stop (suspended) 2026-11-08 23:08:32 +01:00
Andrew Rankin 40daa229b5 Update EG4 LL-V2 component to v1.1.0 (fixes zero-value BMS readings) (#315)
* 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.
2026-11-08 23:08:32 +01:00
Sleeper85 da0e5c8c23 Updated secrets.yaml examples 2026-11-08 23:08:32 +01:00
Sleeper85 bfa36fb15f Added dev README 2026-11-08 23:08:32 +01:00
Sleeper85 2cdc61e8b4 Fixed Auto CVL Float lockup at Rebulk threshold
Rewrote Auto CVL from template sensor lambdas to interval
lambdas, splitting each into a value sensor and a delta sensor.

Fixed a bug confirmed in production: Auto CVL's Float floor coincided
exactly with the Rebulk V. threshold, letting it trigger its own rebulk.
The floor is now capped relative to the live target instead of a fixed
chemistry constant, the Float/Stop integral term can no longer get stuck
once clamped, and PI state now resets when crossing the Bulk <-> Float/Stop
boundary.
2026-11-08 23:08:32 +01:00
Sleeper85 717503e73a Added HA entities cleanup readme 2026-11-08 23:08:32 +01:00