Skip to content

Virtual Meter Fix, Old Firmware Error Messaging & pypvs Diagnostics

Pre-release
Pre-release

Choose a tag to compare

View all tags
@smcneece smcneece released this 07 Dec 17:05
v2025.12.1
63f4a8d

Release Date: December 7, 2025
Type: Bug fixes (one minor breaking change) + diagnostic enhancement

What's New

Bug Fixes

Virtual Production Meter "KWh To Grid" Removal:

  • Removed misleading "KWh To Grid" sensor from virtual production meter(s)
  • This sensor was incorrectly duplicating the "Lifetime Power" value
  • Now matches krbaker's original behavior

Old Firmware 403 Error Messaging:

  • Improved error messages for old firmware (BUILD < 61840) 403 errors
  • Now clearly indicates network/hardware issue with actionable recovery steps
  • Suggests restarting Raspberry Pi (if using proxy) and/or PVS
  • Eliminates confusion about authentication errors on old firmware (which doesn't use auth)

Diagnostic Enhancement

pypvs Return Value Logging (Issue #39):

  • Added diagnostic logging to track what pypvs library returns after each poll
  • Logs inverter/meter/gateway counts at INFO level
  • Warns when 0 inverters returned during daytime (possible pypvs issue)
  • Helps diagnose stuck inverter issues by showing if pypvs is returning empty data
  • No functionality changes - purely diagnostic tool for troubleshooting

User Impact

⚠️ BREAKING CHANGE: Virtual Production Meter

If you have a virtual production meter, the "KWh To Grid" entity will become unavailable after this update.

Action Required:

  1. Update to v2025.12.1
  2. Restart Home Assistant
  3. Go to Settings → Devices & Services → Enhanced SunPower
  4. Click on "Virtual Production Meter" device
  5. Click on the KWh To Grid entity, click the gear icon, and click "Delete"

Why this change: Virtual meters aggregate inverter data and can't measure grid flow. Only real consumption meters with CT clamps should have "KWh To Grid" sensors. This sensor was misleading and showed incorrect data.

Apologies for the manual cleanup required. This sensor shouldn't have been created in the first place, and removing it now prevents future confusion about grid export tracking.

For Old Firmware Users

  • 403 errors now show clearer, more helpful messages
  • Error messages suggest specific recovery actions (restart Pi/PVS)
  • No confusion about authentication (old firmware doesn't require it)

For Users Experiencing Stuck Inverter Issues (Issue #39)

  • New diagnostic logging helps identify root cause
  • Enable debug logging in configuration.yaml to see pypvs return counts
  • Logs will show if pypvs is returning empty inverter data
  • Helps determine if issue is pypvs library or integration-specific

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

Technical Details

Files Modified:

  • data_processor.py: Removed incorrect neg_ltea_3phsum_kwh field from virtual production meter creation
  • __init__.py: Lines 871-891 - Improved error messaging for old firmware 403 errors with actionable recovery steps
  • __init__.py: Lines 783-795 - Added pypvs return value diagnostic logging

For detailed documentation, see the README and TROUBLESHOOTING guides.

Assets 2
Loading