Skip to content

Battery SOC Display Fix

Choose a tag to compare

View all tags
@smcneece smcneece released this 15 Nov 17:18
v2025.11.10
33efef2

Release Date: November 15, 2025
Type: Bug fix

What's New

Bug Fixes

  • Battery State of Charge Display: Fixed battery percentages showing 100x too high (3100% instead of 31%)
    • pypvs v0.2.7 changed to return percentages directly (0-100), but our converter was multiplying by 100 again
    • Removed duplicate percentage multiplication for SOC, Customer SOC, and SOH values
    • Battery charge levels now display correctly

User Impact

For Battery System Users (New Firmware)

  • Battery state of charge now shows correct percentages (31% instead of 3100%)
  • Affects users with pypvs 0.2.7 and battery control features
  • No configuration changes needed; values display correctly after update

For Solar-Only Users

  • No impact; this fix only affects battery system sensors

Upgrade Instructions

Automatic Update

  • HACS Users: Standard HACS update process
  • Manual Install: Copy updated files and restart Home Assistant

Recommended Actions

  • Update anytime; no specific timing requirements
  • After restart, verify battery SOC shows reasonable percentage (typically 0-100%)

Technical Details

pypvs v0.2.7 changed ESS field behavior to return percentages already multiplied by 100. Our converter was applying an additional 100x multiplication, causing display values to be 10000x the actual decimal value (0.31 → 31 → 3100).

Fix removes the multiplication step for:

  • soc_val (State of Charge)
  • customer_soc_val (Customer-visible SOC)
  • soh_val (State of Health)

Files Modified:

  • pypvs_converter.py: Lines 190-192

For detailed documentation, see the README and TROUBLESHOOTING guides.

Assets 2
Loading