[1.3.0] - 2026-08-14
Added
- Optional three-phase current protection: configure signed RMS current sensors and positive symmetric fuse/current limits in amperes for L1/L2/L3, and assign each battery to a physical phase. Automatic PD, direct tracking, predictive charging, time-slot control and rebalances share a conservative 5 W-rounded envelope based on 230 V / 0.90 power factor; partial layouts, phase removal and unassigned batteries are handled safely, invalid or stale telemetry isolates only the affected phase, and phase-capped overflow can use healthy phases. Meter bounds are intersected with battery-command limits, so phase telemetry can reduce but never raise a configured limit. Manual bypasses are surfaced through Repairs, while the grid sensor remains the global consumption source. Existing phase-protection settings must be re-entered after the schema change; leave margin below the fuse rating for latency, external loads and transients. (#240)
- Three-phase protection status sensor: adds
sensor.omnibattery_three_phase_protection_statuswithdisabled,active,limitinganddegradedstates, requested and assigned power, per-phase telemetry and budgets, limited and unassigned battery details, and a diagnostics view in the custom dashboard. Repairs warnings now appear only while a manual bypass route is active (#236). - Negative-price opportunistic charging for Dynamic Pricing: an opt-in import-price calendar charges batteries toward their configured maximum SOC when predictive balance has no deficit and normalized import prices are negative. Hourly and 15-minute prices select the most-negative intervals first, while typed
deficit,negative_priceandcombinedslots keep opportunity energy separate from normal deficit targets; runtime controls and diagnostics are included. - Smart Pre-discharge / Anti-curtailment for Dynamic Pricing: an opt-in planner preserves headroom for forecast PV surplus in configurable negative-injection windows, selects valuable eligible discharge blocks, adapts to actual solar production, and exposes live controls and diagnostics. Self-consumption, automatic and custom-limit modes replace the legacy export-power setting with migration support; the planner preserves SOC, power and safety blockers, holds the net grid target at
0 Wduring protected windows instead of blocking all self-consumption, prevents deliberate export, and uses only the remaining space after the solar reserve for negative-price charging. Existing installations remain disabled by default. - Per-battery manual mode: adds an independent manual-mode switch with persisted ownership and software charge/discharge controls, so selected batteries can be operated manually while the rest of the fleet remains automatic. Live limits cap both the sliders and direct commands, with dashboard, diagnostics, translations and documentation support.
- Optional per-battery MAC tracking (#254): IP-based batteries can be re-discovered through Home Assistant's DHCP integration after an address change. Tracking is opt-in, supports validated automatic or manual MAC detection, preserves entity IDs and history during migration, and ignores ambiguous shared-gateway MACs or conflicting endpoints. Thanks to @wilsto.
- Hoymiles MQTT model profiles: detects MS-A2, HiBattery 1920 AC, HiBattery 4020 X and HiBattery 4020 AC variants from MQTT discovery and applies their capacity, scalability and charge/discharge envelopes. Existing connections can be upgraded when discovery identifies another model, a manual override covers incorrect firmware metadata, and HiBattery 4020 systems use a symmetric 2500 W software ceiling while the device-published envelope remains authoritative.
- LilyGo RS485 ESPHome diagnostics: maps firmware diagnostics and 24 individual warning sensors into Omnibattery, including versions, network status, MOS/cell temperatures, cell-voltage delta and ESP WiFi data.
Changed
- Marstek active balancing moved to a Home Assistant blueprint: the integrated per-battery mode, runtime state and dashboard controls are replaced by
marstek_active_balance_blueprint.yaml, which discovers standard entities from the selected device, accepts optional overrides for renamed entities, runs one battery at a time through Battery Manual Mode, validates cleanup and migrates interrupted legacy runs. Normal voltage tapering, weekly full charge and passive monitoring remain integrated; notifications retain the battery name, status, initial-to-final delta, improvement and duration, use the persisted formal Cell Delta measurement (orn/awhen none exists), and wait for idle, SOC restoration and manual-mode-off confirmation without duplicate cancellation notices. - Marstek force-mode names are now consistent: v2, v3, Venus A, Venus D and ESPHome expose
None,ChargeandDischarge; existing ESPHome entities using the former lowercase spellings remain readable and writable during migration. - Venus A/D top-charge handling now completes against the BMS cutoff (#277): tapered charging remains at 200 W until a debounced cutoff, followed by a 60-second no-charge interval and one formal cell-delta measurement. If the first cutoff is above 3.60 V while SOC is below 100%, the cell is allowed to relax to 3.57 V and one controlled 200 W retry is attempted; only a subsequent confirmed refusal finalizes the charge and measurement state. Venus E top-voltage behavior is unchanged.
- Support diagnostics no longer need a hidden Configuration Summary sensor: downloaded diagnostics retain the configured grid, solar-forecast, average-price and three-phase current sensor IDs while continuing to redact hosts, IPs, credentials, serial ports and MACs.
- Peak shaving limit extended to 20 kW: the runtime slider accepts
500 Wto20000 Win100 Wsteps.
Fixed
- Dynamic Pricing rebuilds and pre-slot checks could use full-day energy forecasts (#263): only the scheduled 00:05 evaluation uses complete daily consumption and solar forecasts. Manual, startup, price-retry, runtime-option, evening and pre-slot reevaluations now use the remaining household consumption and solar, with a windowed excluded-load-adjusted accumulator and the larger of the unspent seven-day average or today's observed-rate projection; unnecessary slots are skipped or per-battery targets are reduced, and notifications and diagnostics distinguish remaining from full-day forecasts.
- Solar forecasts could receive a hidden 15% reduction outside the scheduled daily evaluation: intraday and startup reevaluations, Solar Charge Delay and Smart Pre-discharge now use the configured sensor value unchanged. Actual production is subtracted only when calculating energy remaining, while predictive conservatism is controlled explicitly by the Solar Forecast Safety Margin and Predictive Grid Charge Margin settings.
- Incremental PD could run a full cycle on identical grid-meter publications: sensor health and cadence use
last_reported, while P/D and predictive control advance only for a new transformed meter value; unchanged reports no longer trigger a control cycle, fast P1 meters no longer appear slow in Repairs, and stale-safety checks remain active. - PD target power and fleet limits could ignore configured battery ceilings (#252): the target slider now follows the configured fleet's charge and discharge limits, optional system caps apply independently by direction, changes take effect without a reload, and coordinators expose physical, configured and effective limits consistently through
effective_max_* = min(device_max_*, configured_max_*). Thanks to @waelha for the original PR. - Sessy authentication failures could look healthy and control writes could fail on stale HTTP sessions: the initial probe validates the protected strategy endpoint, repeated
401responses collapse into one actionable credential warning, and writes consume responses, rebuild stale keep-alive sessions and retry once after a disconnect. - Batteries could be marked non-responsive during startup or disappear from diagnostics after failed reconnection attempts (#245): Sessy receives a 65-second startup margin, while fresh reconnection failures preserve and increment the active failure counter so unreachable batteries remain visible in diagnostics and alerts. Thanks to @wilsto.
- Time-slot power overrides could be capped at 2500 W for non-Marstek batteries (#241): slot selectors now use each battery's configured charge and discharge ceilings, including Anker/SOLIX limits above 2500 W.
- Disabled excluded-device controls could corrupt the power-flow diagram: excluded-load configuration now travels in the panel payload, so hiding or disabling the control entity no longer removes that load from the diagram.
- Solar production sensor unit errors were misleading: invalid external production sensors now show
W/kWguidance on the Solar production field instead of the forecast sensor'skWh/Whmessage. - Dynamic Pricing reevaluation could crash without a solar forecast sensor (#224): the grid-charging check skips the Home Assistant state lookup when
solar_forecast_sensoris unset, so installations without solar panels can reevaluate safely. Thanks to @brunosccosta. - Marstek Venus E v2/v3 power caps could be overwritten or displayed as 2500 W: hardware writes use the app-supported 800/2500 W values while the integration preserves and displays the user's lower software limit.