v2.2.2

Release Notes – Multiple Battery Support

Summary

This release adds support for multiple home battery storage systems to the HA Solar Dashboard. The currently configured battery remains available automatically as Battery 1. Additional batteries can be added directly below it in the visual editor, named individually, and configured with their own Home Assistant entities.

Highlights

• Added support for multiple home batteries
• Existing battery configuration is automatically used as Battery 1
• Additional batteries can be added and removed in the visual editor
• Each additional battery supports its own sensor entities
• Combined state-of-charge and power-flow calculations
• Fully backward-compatible with existing configurations

New Battery Configuration

The following entities can be configured for each additional battery:

• State of charge (SoC)
• Signed battery power flow
• Battery voltage
• Separate charging power
• Separate discharging power
• Minimum or reserve SoC
• Maximum or target SoC
• Battery temperature
• Daily battery cycles

Similar to the existing PV string configuration, every additional battery has its own configuration block with a customizable name and a button for removing the entry.

Display and Calculations

• The SoC shown in the battery tile is calculated as the average of all currently available battery SoC sensors.
• Charging and discharging power from all configured batteries is combined using the correct sign.
• Positive signed power values continue to represent charging, while negative values represent discharging.
• When separate charging and discharging sensors are configured, the currently active power flow is used.
• Unavailable or invalid sensor values are ignored when calculating the combined SoC.

Technical Changes

• Added a normalized batteries configuration list for additional battery storage systems
• Added normalization support for alternative and legacy field names
• Added editor actions for adding and removing batteries
• Extended editor configuration tracking to include additional battery entities
• Added aggregation of multiple SoC entities for the existing battery metric
• Added net power-flow calculation across multiple batteries
• Added translations for English, German, Spanish, French, and Polish
• Regenerated distributable bundles:
  • ha-solar-dashboard.js
  • ha-solar-dashboard-editor.js

Compatibility

• Existing configurations do not require migration.
• Existing entities.battery_* entries remain unchanged and represent Battery 1.
• Additional batteries are optional and are stored in the new batteries list.
• Without additional batteries, the dashboard behaves exactly as before.
• No known breaking changes.

Validation

• JavaScript build passed
• HACS package validation passed
• Domain logic tests passed
• Whitespace and patch validation passed

Full Changelog: v2.2.1...v2.2.2