LuxPower Freeze Charging support: documentation updates, template improvements, and warning suppression #3238
+6,193
−0
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
PR Description
This PR improves support for LuxPower inverters when using Predbat Freeze Charging and Freeze Export, focusing on documentation clarity, configuration correctness, and stable runtime behaviour.
Summary of changes
Documentation
Revises the LuxPower section of Inverter Setup to fully document how Freeze Charging and Freeze Export are implemented for LuxPower inverters.
Explains the required Home Assistant helpers and automations.
Introduces and documents the new
maintain_freeze_charge_statusinverter option, including why it is required for LuxPower.Configuration
Updates the luxpower.yaml example template to:
Enable Freeze Charging / Freeze Export where supported.
Reference
battery_min_socfrom the LuxPython integration to avoid discrepancies between user configuration and inverter state.Reference
battery_rate_maxfrom an input_numberhelper rather than a hard-coded value.Adds
maintain_freeze_charge_statusto the inverter configuration options and documents its purpose.Runtime behaviour
Updates inverter.py to support
maintain_freeze_charge_status.When enabled, Predbat suppresses expected warnings caused by manipulating
scheduled_charge_enableduring Freeze Charging.This prevents predbat.status from transitioning into Warn: states during normal Freeze Charging operation, allowing existing automations (e.g. Freeze exit handling) to behave reliably.
Suppression only applies during Freeze Charging and does not affect normal charging behaviour or genuine error conditions.
Rationale
LuxPower inverters do not provide native Freeze Charging support and rely on controlled manipulation of
scheduled_charge_enable. During Freeze Charging, this can legitimately cause Predbat to observe a mismatch between expected and reported state, resulting in warnings that are expected but disruptive.maintain_freeze_charge_statusensures Predbat treats these cases as expected behaviour only while Freeze Charging is active, keeping predbat.status stable and avoiding unintended automation triggers.Notes
No functional changes to Predbat planning logic.
Changes are opt-in and limited to inverters that enable
maintain_freeze_charge_status.Fixes #2916