Skip to content

v1.6.0

Choose a tag to compare

View all tags
@hcraveiro hcraveiro released this 05 May 14:47
v1.6.0
a0dc5d9
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

What's changed

This release adds configurable solar production forecast providers, including optional Solcast forecast support.

The integration now supports two forecast providers:

  • Native (last 7 days) — the existing built-in forecast based on recent Home Assistant Recorder history
  • Solcast — uses a user-selected Solcast forecast sensor already available in Home Assistant

The native provider remains the default for new and existing config entries.

New: Solcast forecast provider

Users can now select Solcast as the forecast provider from:

Settings → Devices & Services → FusionSolar App Integration → Configure

When Solcast is selected, the options flow asks for the Solcast forecast sensor to use.

The selected sensor must expose a detailedHourly attribute containing forecast entries with:

  • period_start
  • pv_estimate

For example:

sensor.solcast_pv_forecast_forecast_today

The integration converts the selected Solcast forecast into the same internal forecast format used by the native provider.

Smooth 5-minute Solcast forecast curve

Solcast detailedHourly data is hourly, but the FusionSolar forecast sensor exposes a dashboard-friendly 5-minute curve.

The Solcast provider now:

  • reads hourly pv_estimate values
  • interpolates smoothly between hourly forecast points
  • blends the forecast into the current real panel production power near now
  • applies a small smoothing window
  • normalizes the curve to preserve the expected remaining energy

This avoids stepped charts and makes the Solcast forecast suitable for live ApexCharts dashboards.

Same dashboard attributes for both providers

The FusionSolar forecast sensors keep the same attributes regardless of the selected provider:

  • forecast_power_chart
  • forecast_cumulative_chart
  • curve

This means existing dashboards can continue using:

data_generator: |
  return entity.attributes.forecast_power_chart || [];

without needing different card configuration for native vs Solcast forecasts.

New forecast attributes

Forecast sensors now expose additional provider and diagnostic attributes, including:

  • provider
  • provider_entity_id
  • source_entity_id
  • estimate10_kwh
  • estimate90_kwh
  • confidence
  • generated_at
  • step_minutes

When using Solcast, estimate10, estimate90 and confidence information are exposed when available from the selected Solcast sensor.

Forecast provider architecture refactor

Forecast generation has been refactored into dedicated provider builders.

New forecast modules:

  • forecast/models.py
  • forecast/native.py
  • forecast/solcast.py
  • forecast/base.py

The coordinator is now responsible for API/session orchestration and provider selection, while forecast-specific logic lives under the new forecast/ package.

This makes the integration easier to maintain and prepares it for additional forecast providers in the future.

README updates

The README has been updated with:

  • forecast provider configuration
  • Solcast setup instructions
  • native vs Solcast behaviour
  • Solcast smoothing details
  • shared ApexCharts attributes
  • updated dashboard notes
  • new forecast FAQ entries

Notes

  • Existing setups continue to use the native forecast provider by default
  • Existing dashboards using forecast_power_chart or forecast_cumulative_chart should continue to work
  • Solcast support requires a Solcast forecast sensor already available in Home Assistant
  • The Solcast provider only builds forecast points from the current moment forward
  • Historical dashboard offsets do not reconstruct past Solcast forecasts
  • The native provider still depends on Home Assistant Recorder history
Assets 2
Loading