Skip to content

v1.2.0 — Multi-array actual generation

Choose a tag to compare

View all tags
@AshGSmith AshGSmith released this 22 Apr 20:25
v1.2.0
4080af1

What's new in v1.2.0

Multi-array actual generation display

Today's actual-generation bar can now show a proportional stacked breakdown across multiple solar arrays. This is an entirely optional, manual feature — existing users see no change.

New actual_arrays config field

Add one entry per array, each with an entity (kWh or Wh sensor) and a single-character label (shown inside the segment and in the popup):

actual_arrays:
  - entity: sensor.solar_east_array_energy_today
    label: E
  - entity: sensor.solar_west_array_energy_today
    label: W

Visual editor support

The card editor now includes an Actual Generation Arrays expansion panel with add/remove controls, an entity selector, and a labelled single-character input field.

Bar behaviour

Condition Bar
No arrays configured Existing single purple bar (unchanged)
1 array producing Single-colour bar (single-source fallback)
≥ 2 arrays producing Proportional stacked segments
All arrays at zero / unavailable Bar falls back to today_actual_entity height

Segments are sized proportionally using each array's kWh value. The label is shown inside a segment when it is tall enough. Colours cycle through an 8-slot palette: purple · blue · indigo · slate-blue · violet · emerald · periwinkle · steel.

Consistent actual total across all views

When arrays are configured, their sum is the canonical actual total used everywhere — the bar height, the card header, and the popup subtitle. today_actual_entity is only used when no arrays are configured.

Popup header breakdown

Today's hourly popup shows a per-array breakdown alongside the running total:

E: 4.2 kWh | W: 3.8 kWh | Total: 8.0 kWh

When no arrays are configured, the popup shows the single total from today_actual_entity (new in this release for non-array users too).

Forecast achieved threshold tightened

The card previously treated today as "forecast achieved" when actual generation reached 90% of the forecast, hiding the dotted remainder overlay early.

New rule: the forecast is only considered achieved when actual ≥ forecast exactly. Any value below forecast continues to show the dotted remainder.

Other fixes and polish

  • The second array segment colour is now a cornflower/sky-blue rather than teal, which was too close to green and clashed with the forecast colour scheme
  • The array label input in the visual editor now shows a clear "Label (1 char)" heading and a "bar & popup" hint, with placeholder E instead of ?

Change log since v1.1.0

Version Change
v1.2.0-beta.01 Add actual_arrays config, stacked bar rendering, popup header breakdown, visual editor support
v1.2.0-beta.02 Tighten forecast-achieved threshold to actual ≥ forecast; change second array colour to blue; improve array label field UX
v1.2.0-beta.03 Fix card header to use array sum when arrays are configured (was incorrectly reading today_actual_entity)
v1.2.0 Stable release; README updated with actual_arrays documentation and Open-Meteo integration details
Assets 3
Loading