Skip to content

WebSocket Live Data & Misc Fixes PLEASE READ

Choose a tag to compare

View all tags
@smcneece smcneece released this 22 Apr 13:33
v2026.04.6
4818bf7

If you are upgrading from v2026.04.3 or earlier, v2026.04.4 and v2026.04.5 were pre-releases. Everything from those releases is included here. The full set of changes since v2026.04.3 is below.

New Feature: WebSocket Live Data (New Firmware Only) - added in v2026.04.4

Optional real-time sensor updates via PVS WebSocket for systems on new firmware (BUILD 61840+ on PVS6, BUILD 5408+ on PVS5). When enabled, a new "PVS Live Data" device appears with sensors that update as values change rather than on the poll schedule.

The PVS broadcasts data on port 9002. The integration subscribes to this stream and only writes sensor state when values actually change. Power sensors have an additional threshold filter (default 0.05 kW) to reduce database writes during stable conditions.

New sensors under the PVS Live Data device:

  • Production Power / Production Energy
  • Net Power / Net Energy
  • Site Load Power / Site Load Energy
  • Battery Power / Battery Energy (battery systems only)
  • Battery State of Charge (battery systems only)
  • Backup Time Remaining (battery systems only)
  • MID State (battery systems only)
  • Data Timestamp (disabled by default)

To enable: Go to Settings, Devices and Services, Enhanced SunPower, Configure Gear. The Live Data page appears for new firmware installs only.

⚠️ SD Card Warning: Real-time updates generate significantly more database writes than normal polling. Leave this disabled on SD card installs. SSD storage is recommended. See TROUBLESHOOTING.md for recorder.exclude configuration if you want live data display without database writes.

Battery users: "Backup Time Remaining" and "MID State" may show as Unknown even with a connected WebSocket. This appears to depend on whether the PVS broadcasts those fields in the live stream, which may vary by firmware version. Other sensors are not affected. See TROUBLESHOOTING.md for details.

Bug Fix: Diagnostics Device Showing Wrong Version - fixed in v2026.04.5

The Enhanced SunPower Diagnostics device was showing a hardcoded firmware version string ("2025.8.12") instead of the actual installed integration version. Fixed.

Improvement: Live Data Sensors No Longer Build Long-Term Statistics - v2026.04.5

Live data sensors had state_class set, causing HA to build long-term statistics for them even though they are not used in the Energy Dashboard. Removed. Display and dashboard behavior is unchanged, but recorder overhead is reduced.

Upgrading from v2026.04.4? After restarting HA you will see repair notifications for each live data sensor saying "no longer has a state class." This is expected. Click each one and choose Delete to clean up the orphaned statistics. This is a one-time cleanup. New installs will not see these notifications.

Bug Fix: Shared HA Session Cookie Jar Being Cleared on Every Poll - v2026.04.6

The integration was calling cookie_jar.clear() on the shared Home Assistant aiohttp session before each varserver request. This session is shared across all integrations, so every poll cycle was clearing cookies that other integrations depend on. The call was also unnecessary since PVS session cookies are passed explicitly in each request. Both occurrences (initial request and re-auth retry path) have been removed.

This bug has been present since varserver support was added. If you have other integrations that authenticate via cookies and have seen occasional unexplained session drops, this may have been the cause.

Improvement: Reduced Log Spam During PVS Offline Periods - v2026.04.6

Polling errors during PVS reboots or connectivity loss now log at WARNING on the first failure, then drop to DEBUG for subsequent failures. Previously every failed poll logged at ERROR, producing hundreds of log entries during a nightly PVS reboot. A single INFO recovery message is logged when the PVS comes back online.

Improvement: WebSocket Stale Detection Tuning - v2026.04.6

The WebSocket stale timeout was increased from 90 seconds to 180 seconds. During stable conditions (steady production, constant load) the PVS may not send WebSocket messages for extended periods since it only broadcasts on value changes. The 90 second threshold was triggering unnecessary reconnects on stable systems. The log message when this triggers has also been downgraded from WARNING to INFO since it is self-recovering.

Heads Up: Old Firmware Support Being Removed in the Next Release

Support for old firmware (dl_cgi, BUILD below 61840 on PVS6 or below 5408 on PVS5) will be removed in the next release. This version (v2026.04.6) is the last to support it.

How to check if this affects you: In Home Assistant, open the PV Supervisor device under Settings, Devices and Services, Enhanced SunPower. Your firmware BUILD number is shown there.

If you are on old firmware and using HACS: Remove the integration from HACS and switch to a manual install of this version (v2026.04.6) now. That way you stay pinned here and will not accidentally auto-update past it. A manual install preserves all your existing sensors and history. Download from the releases page.

If you are on old firmware and installed manually: You are already protected as long as you do not update past this version.

Users on new firmware (BUILD 61840+ on PVS6, BUILD 5408+ on PVS5) are not affected and should update normally.

No breaking changes. No configuration migration needed. Update via HACS or manual file copy and restart.

If this integration is useful to you, consider watching the repo (Watch button, top of page) to stay notified of releases and discussions. User reports from the community, especially battery system users, directly shape what gets built. Every observation helps.

Assets 2
Loading