v4.2.0

Feature-completeness and code quality is the focus of this release.

What's Changed

TL>DR:

• Automated forecast updates that do not require an automation by @autoSteve and @BJReplay
• Granular dampening to dampen per half hour period and by site by @autoSteve and @isorin
• Dampening applied at forecast fetch and not to forecast history @autoSteve and @isorin
• Retrieve un-dampened forecast values using service call by @autoSteve (thanks @Nilogax)
• Get presently set dampening factors using service call by @autoSteve (thanks @Nilogax)
• Migration of un-dampened forecast to un-dampened cache on startup by @autoSteve
• Add site breakdown option for detailed forecasts by @autoSteve
• Add hard limit configuration to options by @autoSteve
• Suppress integration reload when many configuration options are changed by @autoSteve
• Translations of service call error responses by @autoSteve

Automated forecast updates

All users of this integration will have Home Assistant automation(s) set up to fetch forecast updates at desirable times of day. And that's great for the power users, who want an update just after midnight, then another strategic update pre-dawn, and then spread other updates up to API limit throughout the day (or not...).

If you don't need to do anything special, then head into the integration configure options and turn on 'Auto-update'. Disable or delete your automation. You can specify whether you want automated updates over twenty-four hours, or from sunrise to sunset. More in the readme.

Granular dampening

The only option to set dampening previously was at per-hour increments, and not the half hour forecast periods that Solcast provide to hobbyists. You can specify a total of 48 dampening values now, corresponding to one for every half-hourly forecast period, and do this per-site if needed. See the readme for more on this.

Dampening at forecast fetch

Previously, dampening was applied to all forecasts, both up-coming and all history, but those dampened values were not saved to retain historical differences in dampening that had changed over time.

The history of dampened forecasts is now preserved, and only newly fetched forecasts have dampening adjusted.

At 'day one' there will be no dampening applied to your history, but this will build over time.

Retrieve un-dampened forecast values

Because history is now dampened as-at the dampening values set at the time, automations might need un-dampened data to calculate future dampening based on consistent past differences in generation performance versus recent history. The 'get forecasts' service call is extended to allow this by specifying undampened: true.

At upgrade, the past fourteen days of undampened history will be saved, allowing this extended call to be used immediately.

Get currently set dampening values

To avoid an automation needing to keep track of dampening set, the current dampening values can be retrieved with a new service call.

Full spread of attributes breakdown by site

Absolutely all sensor attributes may now be broken down by site, including the detailed half-hourly and hourly forecasts.

All attributes sent to Home Assistant may be configured in configure options. Turn them on or off to reduce clutter.

Hard limit

Hard limit is now in the configure options dialogue. Don't know what it does? Ask the readme. You probably don't need it.

Suppression of integration re-load on options change

Previously, should any configure option be changed then the integration would simply re-load. Now if the integration does not need to then it will not fully re-load.

Full Changelog: v4.1.7...v4.2.0
Changes since v4.1.9: v4.1.9...v4.2.0