Releases: dewet22/givenergy-hass
v1.3.27
Battery nameplate sensors
This release decodes three battery-topology nameplate values from givenergy-modbus 2.6.0 — Battery Nominal Power, Nominal Current, and Max Charge Percentage — and surfaces them as diagnostic sensors. These report the battery's rated parameters, not live telemetry. The underlying registers are carried on AC-coupled and All-in-One models; on DC-coupled hybrids that don't expose them, the sensors simply don't appear. The power and current scaling follows the library's most-likely reading and hasn't yet been confirmed against live hardware, so treat those two as provisional for now.
Three-phase startup fix
The PV Direct Today sensor added in v1.3.26 no longer logs a spurious "library field drift" warning at startup on three-phase systems, where its underlying field is single-phase-only.
Changes
- feat: add battery nominal sensors + bump modbus to 2.6.0 (#231) (294c780)
- fix: use getattr for e_pv_direct_today value_fn (3-phase AttributeError) (#232) (98f430f)
Full Changelog: v1.3.26...v1.3.27
v1.3.26
EMS dashboard: Glance and Flow tabs restored
The Glance and Flow panels now render on EMS-controller systems. Previously an over-conservative EMS guard dropped the whole prefix, leaving only the classic tab set (Overview, Energy, EMS Controls, Diagnostics). The Flow panel's Load node routes through the EMS calculated-load aggregate. Analyst and Batteries remain deferred pending further sensor work.
PV Direct Today
A new energy sensor reporting the portion of solar generation that reached your load directly, bypassing both the battery and the grid. It's available on DC-coupled GEN1 hybrid inverters; AC-coupled and All-in-One units, and non-GEN1 DC models, don't expose the underlying figure yet, so the sensor simply won't appear there. Requires givenergy-modbus 2.5.13.
EMS inverter clock handling
On EMS systems the controller's clock can't be set locally — it re-syncs from the GivEnergy cloud — so the one-click clock-drift repair could error when opened. The drift is now shown as an informational notice pointing you to the GivEnergy app instead, and the System Time entity returns a clear message rather than failing if you try to set it on an EMS controller.
Changes
- fix: render Glance and Flow dashboard tabs on EMS plants (#228) (a463c98)
- feat: add PV Direct Today sensor (modbus 2.5.13) (#229) (92e22b3)
- fix: handle clock drift correctly on EMS controllers (#230) (941ec38)
Full Changelog: v1.3.25...v1.3.26
v1.3.25
Self-consumption energy sensors
Two new sensors report the share of your solar generation that's used on-site rather than exported: Self Consumption Today and Self Consumption Total (PV generation minus grid export). They mirror the figures GivTCP publishes, so dashboards that split self-used against exported energy — energy-flow donut and Sankey cards in particular — no longer need a template helper to derive them.
Both are energy sensors in kWh and feed the Home Assistant Energy dashboard. They're created on single-phase inverters; three-phase and EMS-controlled systems don't yet expose them while the per-controller figures are validated.
Changes
- feat: expose self-consumption energy sensors (#223) (edb5faf)
- fix: use a non-resetting clamp for lifetime self-consumption (#227 review) (8f21926)
Full Changelog: v1.3.24...v1.3.25
v1.3.24
Inverter clock drift detection
Home Assistant now raises a repair when your inverter's internal clock drifts more than ten minutes from Home Assistant's own time. The inverter runs its charge and discharge time-of-use slots from its onboard clock, so a drifted clock can quietly fire those slots — and any Predbat scheduling built on them — at the wrong time. The repair offers a one-click fix that sets the inverter clock to Home Assistant's current time, and it clears itself automatically once the clock is back in step.
If you deliberately keep your inverter in a different time zone, such as UTC, there's a new option to switch the warning off: open the integration's Configure dialog and untick Warn when the inverter clock drifts from Home Assistant.
Changes
Full Changelog: v1.3.23...v1.3.24
v1.3.23
EMS: Battery Charge/Discharge Today no longer stuck on "unknown"
On EMS-controlled systems the Battery Charge Today and Battery Discharge Today sensors on the controller device read a permanent "unknown" — they map to an inverter-level register the EMS controller doesn't populate. They're now suppressed on EMS systems, matching how the other controller-local figures (House Consumption, Load Power) are already handled. The per-inverter values were always correct and are unaffected, and the empty sensors are cleared automatically on upgrade.
Changes
Full Changelog: v1.3.22...v1.3.23
v1.3.22
Experimental features opt-in (splice-guard heal window) — modbus 2.5.11
Adds a collapsible "Experimental features" section to the integration's options flow, where opt-in givenergy-modbus client flags can be toggled per-installation. The section is hidden when the registry is empty, so it only appears now that the first real flag is registered.
Splice-guard heal window (Enable splice-guard heal window): when enabled, the battery splice-guard can recover from legitimate LiFePO4 charge-knee surges (voltage/capacity class, multi-poll streak gate) rather than keeping the battery permanently offline. Leave off unless you see repeated battery disconnects near full charge and a maintainer has suggested enabling it.
Bumps givenergy-modbus to >=2.5.11 for the splice_reject_heal_seconds client parameter.
Changes
- feat: experimental-features mechanism for opt-in modbus client flags (5f2bd57)
- style: move mid-file imports to top of test_config_flow.py (1df9bc9)
- feat: wire in splice_reject_heal_seconds as first experimental flag (modbus 2.5.11) (ae9b74a)
- fix: preserve existing experimental options when section is omitted on save (3bc1ffd)
- docs: clarify frontend assumption in section-default comment (413089f)
- test: pin explicit-false path for experimental section disable (65c27f3)
Full Changelog: v1.3.21...v1.3.22
v1.3.21
v1.3.21
More robust battery telemetry after comms gaps
Updates givenergy-modbus to 2.5.10, which closes a gap in the splice guard that protects battery readings from bus corruption. Previously, a corrupted temperature frame arriving after a connection drop or a short read could poison the baseline and leave a battery's temperatures stuck unavailable. This hardening covers those paths too.
Changes
- fix(deps): bump givenergy-modbus to 2.5.10 (splice-guard cohort gate) (888fa64)
Full Changelog: v1.3.20...v1.3.21
v1.3.20
v1.3.20
Export Priority now shows the correct setting
The Export Priority control was displaying the wrong option — for example "Battery First" when the portal showed "Load First" — due to a mismatched value mapping in the underlying library. It now reads the right value.
Battery AC charge/discharge limit minimum restored to 1
The minimum for the AC-coupled "Inverter Charge/Discharge Power Percentage" controls was briefly lowered to 0 in v1.3.17, but the inverter rejects a 0 write to those registers (the DC-side limits still accept 0). The minimum is back to 1.
Both backed by givenergy-modbus 2.5.9.
Changes
- fix: restore the AC charge/discharge limit floor to 1 (#52) (83d6c1b)
- fix(deps): bump givenergy-modbus to 2.5.9 (Export Priority + AC floor) (#218) (065f018)
Full Changelog: v1.3.19...v1.3.20
v1.3.19
v1.3.19
Inverter system clock exposed as a datetime entity
The inverter's system time is now available as a System Time entity that can be both read and set. This is handy for tools like Predbat that compare the inverter's clock against the host to spot drift. The existing "sync time" service is unchanged — it stays the one-shot button to set the inverter to Home Assistant's current time.
Changes
Full Changelog: v1.3.18...v1.3.19
v1.3.18
v1.3.18
EMS dashboard grid direction fixed
The Overview power-flow card was showing grid import as export (and vice versa), which also threw off the home figure. The grid bubble now reads the correct direction. This affected any install using the power-flow-card-plus on the auto-generated dashboard, not just EMS plants.
Changes
- chore(ci): drop the retired givenergy-modbus-release dispatch trigger (#215) (7f0567c)
- fix: invert the power-flow-card-plus grid sign (#212) (#216) (4813cba)
Full Changelog: v1.3.17...v1.3.18