Skip to content

Battery Serial # Bug Fix Release (Pre-Release for Testing)

Pre-release
Pre-release

Choose a tag to compare

View all tags
@smcneece smcneece released this 15 Dec 18:51
v2025.12.3
76039b5

Release Date: December 15, 2025
Type: Bug Fix Release (Pre-Release for Testing)

Critical Bug Fix: Multi-Module Battery Systems

This release fixes a critical bug preventing battery systems with 4+ modules from being detected.

What Was Broken

Battery systems with multiple modules (4-5+ batteries) were completely missing from Home Assistant:

  • No battery entities created
  • No State of Charge sensors
  • No battery power/temperature/voltage sensors
  • PVS returned the data correctly, but integration silently rejected it

Root Cause

The data_processor.py validation logic rejected device serials longer than 50 characters as "suspiciously long" to protect against corrupted data. However, multi-module battery systems have composite serial numbers that can be 70+ characters:

Serial format: {HubSerial}_{Module1Serial}_{Module2Serial}_{Module3Serial}_{Module4Serial}

Example from affected system (72 chars):

00001C398F32_M00122132A10D3_M00122125A0B6F_M00122132A0EBD_M00122132A10D0

The Fix

Increased serial validation limit from 50 to 150 characters

  • Accommodates battery systems with up to ~9 modules
  • Still protects against truly corrupted data (>150 chars)
  • Backward compatible - no impact on existing installations

Files Modified:

  • data_processor.py (Lines 221-226)

Who Should Install This

REQUIRED for:

  • Users with multi-module battery systems (4+ batteries) where battery entities are missing

Safe for:

  • All users - this is a bug fix with no breaking changes
  • Systems with smaller battery configurations (1-3 modules)
  • Solar-only systems (no battery)

Known Issues

None specific to this release.

For general troubleshooting, see TROUBLESHOOTING.md

Full Changelog

See CHANGELOG.md for complete version history.

Support

Generated with Claude Code

Assets 2
Loading