Documentation, Kostal Plenticore & FoxESS templates, minor code fixes #3102
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…fic steps to follow
…rder errors (in FAQ's)
Contributor
There was a problem hiding this comment.
Pull request overview
This pull request enhances Predbat's documentation and inverter support with a focus on expanding inverter configuration templates, improving user guidance, and adding support for the Axle VPP service. The changes include bug fixes for logging verbosity, updates to inverter templates for better compatibility, and comprehensive documentation improvements for manual control, web interface features, and inverter setup processes.
Key changes:
- Added comprehensive Kostal Plenticore inverter support with detailed automation instructions
- Enhanced FoxESS template with improved documentation and corrected sensor names
- Integrated Axle VPP service documentation and configuration across multiple templates
- Improved charge/discharge curve logging and documentation
- Extended manual control documentation to support 48-hour advance scheduling
- Added guidance for separating EV charging costs across multiple vehicles
Reviewed changes
Copilot reviewed 29 out of 31 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| templates/sigenergy_sigenstor.yaml | Added reserve and charge limit settings, corrected to use available_max_active_power sensor |
| templates/luxpower.yaml | Enabled freeze charge support with automation configuration |
| templates/kostal.yaml | New comprehensive template for Kostal Plenticore inverters with full automation setup |
| templates/givenergy_*.yaml | Added Axle VPP API key configuration comments across all GivEnergy templates |
| templates/fox_cloud.yaml | Added Axle VPP API key configuration comment |
| templates/fox.yaml | Major update with improved documentation, corrected sensor naming with foxess_ prefix, and work mode explanations |
| docs/what-does-predbat-do.md | Documented Read-Only (Axle) status for VPP events |
| docs/web-interface.md | Added plan history views and multi-attribute entity charting documentation |
| docs/output-data.md | Clarified car charging cost entities track all cars, linked to cost separation example |
| docs/inverter-setup.md | Comprehensive rewrite with step-by-step inverter setup guidance and detailed inverter-specific instructions |
| docs/install.md | Added note about inverter-specific configuration requirements |
| docs/faq.md | Added predbat.cost_yesterday to recorder exclusion list |
| docs/energy-rates.md | Added comprehensive Axle VPP service documentation |
| docs/devices.md | Added Ohme Direct section with link to configuration |
| docs/customisation.md | Extended manual control to 48 hours, improved automation examples |
| docs/components.md | Added component configuration editing documentation |
| docs/car-charging.md | Added detailed example for separating charging costs across multiple EVs |
| docs/apps-yaml.md | Enhanced battery curve documentation with search criteria and sensor requirements |
| apps/predbat/web.py | Improved unhealthy status message, fixed num_cars comparison logic |
| apps/predbat/plan.py | Reduced log verbosity by changing dp4() to dp2()/dp1() for cleaner debug output |
| apps/predbat/output.py | Fixed format string for currency display |
| apps/predbat/octopus.py | Added dp2() formatting for Intelligent slot logging |
| apps/predbat/inverter.py | Improved charge curve logging with better error messages and labels |
| apps/predbat/fetch.py | Added dp2() formatting for standing charge logging |
| apps/predbat/config/apps.yaml | Added Axle API key configuration comment |
| apps/predbat/config.py | Enabled has_target_soc and has_reserve_soc for Sigenergy inverters |
iangregory
pushed a commit
to iangregory/batpred
that referenced
this pull request
Dec 24, 2025
…springfall2008#3102) * Logfile formatting tweaks * Updated manual control for 48 hour feature & automation changes * springfall2008#3048 Expand inverter-setup, guidance of inverter-specific steps to follow * Added predbat.cost_yesterday to list of entities to exclude from recorder errors (in FAQ's) * springfall2008#2916 LuxPower Freeze Charge * Link Ohme direct from devices page * springfall2008#2895 Expand 'unhealthy' status text on web dashboard * Plan history views on web console * springfall2008#3006 Separate cost of car charging for multiple EV's * springfall2008#2873 add reserve to Sig inverter * springfall2008#789 added Victron placeholder * springfall2008#2624 Kostal Plenticore inverter * springfall2008#2624 Updated Kostal inverter config * Compare: suppress 'no cars' cost if num_cars = 0 * springfall2008#2624 Updated Kostal setup * Add more dpX() to reduce logfile clutter in debug mode and Octopus intelligent slots * springfall2008#2077 Sigenergy add charge target, revised automation * springfall2008#2720 Updated FoxESS configuration * springfall2008#2720 Revise charge/discharge curve logs * springfall2008#2077 Sig inverter_limit corrected * springfall2008#2720 added soc_max sensor and soc_kw template * Expand battery (dis)charge curve documentation * springfall2008#2077 Sig update battery_rate_max * springfall2008#2077 Fox standard PV sensor * springfall2008#2720 FoxESS grid power sensor * Expand Axle VPP docs in energy rates and apps.yaml * Expand Web Entities view for new attribute selection features * Documented editing component configuration * Document Read-Only (Axle) status and minor Axle doc tweaks * Add axle API entry to GivEnergy, SigenStor and Fox templates * [pre-commit.ci lite] apply automatic fixes --------- Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
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.
Documentation changes:
Bug fixes and minor code changes:
Inverter setup and apps.yaml template changes for different inverter types:
Octopus Energy HA integration on pause until April #789 added Victron placeholder
Add support for Kostal Plenticore inverter to Predbat Docu #2624 Documented Kostal Plenticore inverter setup
Fox ESS AC1+ECS4100 h7 - Known working configuration example (UK Octopus Cosy) #2720 Updated FoxESS configuration
Freeze charge - LuxPower inverters. #2916 LuxPower Freeze Charge
Configure Predbat to control Sigenergy SigenStor inverter #2077 Sigenergy, updated automation and template