Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 36 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -234,7 +234,7 @@ To avoid that snapshot problem entirely, there's also a dashboard *strategy* tha
```yaml
strategy:
type: custom:givenergy
mode: classic # classic (default) | flow — see below
mode: classic # classic (default) | flow | glance | analyst | all — see below
max_power_kw: 10 # optional; default 10; Overview 24h chart y-axis envelope (kW)
serial: SA2114G047 # optional; pin one inverter on a multi-plant install
```
Expand All @@ -255,7 +255,41 @@ strategy:

The Flow view is rendered as a `panel: true` view. If you have the **kiosk-mode** custom integration installed (HACS), the strategy adds hints to hide the header and sidebar for a true full-screen display; without it, the view simply renders inside the normal HA chrome. The card is responsive (container-query based), so it works as a wall-tablet kiosk and reflows for a phone webview.

The remaining directions from [the redesign brief](docs/design/dashboard-redesign-brief.md) — `glance`, `analyst`, and the tariff-aware `coach` — are still to come.
The tariff-aware `coach` direction from [the redesign brief](docs/design/dashboard-redesign-brief.md) is still to come.

#### `mode: glance`

`mode: glance` leads the dashboard with a calm, full-width **Glance** view: a single-sentence system summary, three large numbers (solar generated today, battery SOC, house consumption today), and a row of health pills showing battery count, import and export totals for the day, and per-string PV generation when active. It's built around a bundled `custom:givenergy-glance` card — nothing extra to install.

```yaml
strategy:
type: custom:givenergy
mode: glance
```

The status sentence is derived from the live signs of grid, battery, and solar power — covering states like self-sufficient, exporting, solar-and-grid importing, battery-only overnight, and so on. The dot to its left pulses green when the system is self-sufficient or exporting, amber when importing from the grid or when battery SOC drops below 20%. The full classic view set follows the Glance panel, so the detailed tabs are still one tap away. Like `flow`, the Glance view is `panel: true` and picks up kiosk-mode hints when the integration is present.

#### `mode: analyst`

`mode: analyst` leads the dashboard with a dense **Analyst** view aimed at optimisation and debugging: a live metrics strip (PV, load, battery, grid), an energy ledger breaking down today's sources and sinks as kWh and percentages, a diagnostics table (temperatures, grid frequency, power factor, work time, consecutive failures), a 24-hour power overlay chart (requires `apexcharts-card`), and per-pack cell heatmaps. Nothing extra to install beyond the apexcharts card for the chart.

```yaml
strategy:
type: custom:givenergy
mode: analyst
```

The Analyst view is a standard (non-panel) multi-card view, so the full classic tab set still follows it.

#### `mode: all`

`mode: all` stacks all four views — Glance, Flow, Analyst, and the classic tab set — into a single dashboard. Useful if you want to switch between display styles without maintaining separate dashboards.

```yaml
strategy:
type: custom:givenergy
mode: all
```

### Voice assistants & LLM access

Expand Down
2 changes: 1 addition & 1 deletion custom_components/givenergy_local/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@
# served from the same package dir so they resolve offline without a CDN.
_FONTS_DIRNAME = "fonts"
_FONTS_URL = f"/{DOMAIN}/{_FONTS_DIRNAME}"
_STRATEGY_VERSION = "5"
_STRATEGY_VERSION = "8"

# Per-config-entry topology cache. PlantCapabilities is persisted as
# `to_dict()` directly (no envelope) following HA Core's Store convention —
Expand Down
Loading
Loading