Skip to content

PVS5 New Firmware Support

Choose a tag to compare

View all tags
@smcneece smcneece released this 21 Dec 14:26
v2025.12.4
dcc708d

Release Date: December 21, 2025
Type: Bug Fix Release

Critical Bug Fix: PVS5 New Firmware Support

This release fixes a critical bug preventing installation on PVS5 systems with new firmware (build 5412+).

What Was Broken

Users with PVS5 systems that received firmware updates to 0.0.25.5412 or similar couldn't install the integration:

  • Setup would fail with "invalid flow" error
  • No helpful error message
  • Integration completely non-functional

Root Cause

The new PVS5 firmware returns the BUILD field in a different format:

Old/Expected formats:

  • PVS6: 61846 (integer)
  • PVS6: "61846" (string)

New PVS5 format:

  • "2025.11, Build 5412" (string with version prefix)

The integration's firmware detection logic expected a plain number and couldn't parse the new format, causing:

  1. String-to-integer comparison failures
  2. Incorrect firmware type detection
  3. Setup flow exceptions

The Fix

Added intelligent BUILD number parser:

  • Handles multiple firmware version formats automatically
  • Extracts numeric build number from various string formats
  • Falls back gracefully if format is unrecognized

Supported BUILD formats:

  • "2025.11, Build 5412" → 5412 (PVS5 new firmware)
  • "0.0.25.5412" → 5412 (PVS5 dotted format)
  • "61846" → 61846 (PVS6 string)
  • 61846 → 61846 (PVS6 integer)

Enhanced logging:

  • Shows both raw and parsed BUILD values
  • Helps diagnose future firmware format changes
  • Logs firmware detection decisions (pypvs vs dl_cgi)

Files Modified:

  • config_flow.py - Added parse_build_number() function and updated firmware detection

Firmware Version Reference

For troubleshooting and future reference, here are the known firmware formats:

PVS Model Firmware Version BUILD Format Example
PVS5 0.0.25.5408 "YYYY.MM, Build XXXX" "2025.11, Build 5412"
PVS5 0.0.25.5412 "YYYY.MM, Build XXXX" "2025.11, Build 5412"
PVS6 2025.10.20.61846 Integer or String 61846 or "61846"
PVS6 2025.11.x.61xxx Integer or String 61846 or "61846"

Firmware Detection Logic:

  • BUILD < 61840 → Old firmware (uses legacy dl_cgi, no authentication)
  • BUILD >= 61840 → New firmware (uses pypvs library with authentication)

Who Should Install This

REQUIRED for:

  • PVS5 users who received firmware update to build 5412 or later
  • Anyone experiencing "invalid flow" error during integration setup
  • New installations on recently updated PVS5 systems

Safe for:

  • All users - this is a bug fix with no breaking changes
  • PVS6 systems (no impact on existing firmware detection)
  • Systems already running older firmware (backward compatible)

Installation Instructions

Via HACS (Recommended)

  1. Update Integration:

    • HACS → Integrations → Enhanced SunPower
    • Click "Update" if update notification appears
    • OR manually check for updates

  2. Restart Home Assistant:

    • Settings → System → Restart

  3. Install/Reinstall Integration:

    • Settings → Devices & Services → Add Integration
    • Search "Enhanced SunPower"
    • Follow setup wizard

Manual Installation

  1. Download sunpower.zip from the v2025.12.4 release
  2. Extract to custom_components/sunpower/
  3. Restart Home Assistant
  4. Add the Enhanced SunPower integration

Verification Steps

After installing v2025.12.4, verify the fix worked:

  1. Check Setup Success:

    • Integration should complete setup without "invalid flow" error
    • Should proceed through all 3 setup pages

  2. Check Logs (Optional):

    • Settings → System → Logs
    • Search for "sunpower"
    • Look for: ✅ supervisor/info: SERIAL=xxx, BUILD=5412 (raw: 2025.11, Build 5412)
    • Should show both parsed and raw BUILD values

  3. Verify Device Detection:

    • Settings → Devices & Services → Enhanced SunPower
    • Should see PVS, Inverters, Power Meters detected
    • Entity count should match your system configuration

Reporting Issues

If you're still experiencing setup problems after v2025.12.4:

  1. Share diagnostics:

    • Complete setup as far as possible
    • Settings → Devices & Services → Enhanced SunPower
    • Click ⋮ → Download Diagnostics
    • Attach to GitHub discussion

  2. Share supervisor/info:

    • Visit: http://YOUR_PVS_IP/cgi-bin/dl_cgi/supervisor/info
    • Copy/paste the JSON response to GitHub discussion

  3. Share logs:

    • Settings → System → Logs
    • Search for "sunpower" or "config_flow"
    • Share relevant errors (use "Show raw logs" if needed)

Known Issues

None specific to this release.

For general troubleshooting, see TROUBLESHOOTING.md

Full Changelog

See CHANGELOG.md for complete version history.

Support

Assets 2
Loading