Skip to content

Commit 8434c9e

Browse files
author
belinea4071
committed
docs(#298,#284): document Today's Plan + v1.6.3 sweep on DASHBOARD_GUIDE
Surfaced by @RienduPre on #284 — Today's Plan card has been on the Home tab for several releases but was never documented user-facing. The v1.6.3 ETA additions (#298, battery full/floor + EV target) made the gap more visible. - Adds a Today's Plan card row to the Home tab table and a dedicated ``#### Today's Plan rows`` subsection with a row-by-row table: Now, Solar peak, Cheap/Expensive boundaries, Night window open/end, EV charging starts (with the gentle peak-managed ramp / tariff-optimized subtitle variants), Min reached (kWh), the three v1.6.3 ETA rows, and the Charge-by deadline. Conditions for when each row appears. - Adds ``#### Charging mode selector (v1.6.3)`` subsection in the EV tab covering the 5 named modes (replaces the v1.5.16 "Charging setup variants" section whose 3 screenshots showed entities that no longer exist). - Replaces stale Home / EV / Control tab card descriptions that still mentioned ``Smart Night Charging`` / ``Overnight grid charging`` / ``Cheapest hours`` toggles — these were removed in v1.6.3 and their intent now lives in the Charge mode selector. - Removes the now-orphaned ``sem_ev_setup_default.png`` / ``sem_ev_setup_tariff.png`` / ``sem_ev_setup_night_off.png`` screenshots (yesterday's v1.6.0 captures showing the removed switches).
1 parent 9c0e39d commit 8434c9e

4 files changed

Lines changed: 33 additions & 10 deletions

File tree

docs/DASHBOARD_GUIDE.md

Lines changed: 33 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -43,15 +43,35 @@ The main at-a-glance view with real-time power flows.
4343
| Card | Description |
4444
|------|-------------|
4545
| **Status Chips** | Solar power, battery SOC, autarky rate, EV status, optimization score |
46+
| **Today's Plan** | Forward-looking timeline of today's solar, tariff, night-window, and EV events — see [Today's Plan rows](#todays-plan-rows) for the row-by-row breakdown |
4647
| **System Diagram** | Illustrated SVG with detailed component drawings (solar panels, house, battery, grid pole, EV charger), K-Flow-inspired spark flow animations, time-based sun arc, clickable nodes, individual device list (desktop) |
4748
| **Solar Summary** | Production metrics with animated glow ring, yield, forecast, self-use, costs, savings |
4849
| **7-Day Chart** | Bar chart showing daily solar, home, and grid import over the last week |
4950
| **Smart Recommendation** | AI-powered energy tip based on forecast, pricing, and current conditions |
5051
| **Peak Load + Energy Tip** | Current 15-min peak vs limit, actionable energy tip |
51-
| **Quick Controls** | Smart Night Charging and observer mode toggles |
52+
| **Quick Controls** | Observer mode toggle. (`Smart Night Charging` and `Night Charging` switches were removed in v1.6.3 — their intent now lives in the per-charger [Charge mode selector](#charging-mode-selector-v163) on the EV tab.) |
5253
| **EV Status** | Conditional — shows charging state, current, power, session progress when EV is connected |
5354
| **Weather** | Live clock, temperature, weather conditions, 5-day forecast with temperature bars |
5455

56+
#### Today's Plan rows
57+
58+
Today's Plan is the forward-looking timeline at the top of the Home tab. It collapses solar, tariff, night-window, EV-session, and home-battery events into one chronological list so you can see at a glance what SEM is planning between now and tomorrow morning. Rows appear conditionally based on what's active — an empty plan is normal during the day for a configuration without dynamic tariff or active EV session.
59+
60+
| Row | Meaning | When it appears |
61+
|---|---|---|
62+
| **Now** | Anchor row for the current moment. Everything below this is "from here." | Always |
63+
| **Solar peak — X kWh expected today** | Forecast solar peak time + total kWh expected | When a solar forecast is available (Solcast or HA's Energy dashboard) |
64+
| **Cheap hours open** / **Cheap hours end** | Boundaries of the cheapest contiguous price window | Dynamic tariff configured |
65+
| **Expensive hours start** / **end** | Boundaries of the price-peak window | Dynamic tariff configured, peak window is in the future |
66+
| **Night charging window opens** | Time SEM enters night mode (your `Night earliest start` or the dynamic dusk window). Until this opens, EV night charging stays gated off regardless of mode. | Always — even when no EV is connected, so you can see the window |
67+
| **EV charging starts** with subtitle `gentle peak-managed ramp` *or* `tariff-optimized, waiting for cheap window` | Time SEM expects the EV to start pulling. Subtitle = how: gentle ramp within peak limit, or wait for cheap-tariff window before starting. | EV connected, mode allows night/grid charging |
68+
| **Min reached (X kWh)** | Predicted ETA for hitting the Min target on the charger — derived from planned ramp rate, your Min current, peak headroom, and home-load forecast. If later than your `Charge by` deadline, SEM forces the rate up automatically and this row turns red. | EV session is planned or in progress |
69+
| **EV reaches target at HH:MM** | Live ETA for hitting the Max target during an active session (v1.6.3, #298) | EV is actively charging |
70+
| **Battery full at HH:MM** | Live ETA for the home battery reaching 100% SOC (v1.6.3, #298) | Home battery is charging at a meaningful rate (\|power\| > 200 W) |
71+
| **Battery reaches floor at HH:MM** | Live ETA for the home battery reaching its floor SOC (v1.6.3, #298) | Home battery is discharging at a meaningful rate |
72+
| **Charge-by deadline** | Your configured `Charge by` time. Hard end of the night plan — earlier than the window's natural end means SEM forces the ramp to guarantee Min by then (even if it briefly exceeds the peak limit). | EV has a deadline set |
73+
| **Night charging window ends** | End of the night-mode window | Always (paired with `opens`) |
74+
5575
### Energy
5676

5777
Deep dive into energy production, consumption, and environmental impact.
@@ -95,20 +115,23 @@ EV charging session tracking and statistics.
95115
| **Charging Status** | Current mode, power, session energy, solar share |
96116
| **Session Gauges** | Daily energy vs target, solar share percentage |
97117
| **Charging Power Chart** | 24h EV power curve |
98-
| **Charging Settings** | Charge target range (Min ↔ Max), Overnight grid charging, Cheapest hours (tariff), Charge by deadline picker, Set as default |
118+
| **Charging Settings** | Charge target range (Min ↔ Max), [Charge mode selector](#charging-mode-selector-v163), Charge by deadline picker, Set as default |
99119
| **EV Intelligence** | Taper trend visualization, virtual SOC estimate, charge skip status & reasoning, battery health indicator |
100120
| **Lifetime Statistics** | Total energy, cost, sessions, solar share over all time |
101121

102-
#### Charging setup variants (1.5.16+)
122+
#### Charging mode selector (v1.6.3)
103123

104-
The Charge Target panel renders differently based on which controls are enabled. Three common configurations:
124+
The per-charger `Charge mode` selector replaces the v1.6.x toggle-soup (`Overnight grid charging`, `Smart night charging`, `Cheapest hours`) with one named intent control. Five modes:
105125

106-
| Default — solar-first with grid fallback | Tariff-optimized — defer to cheap hours | Pure solar — overnight grid off |
107-
|:--:|:--:|:--:|
108-
| ![Default](images/sem_ev_setup_default.png) | ![Tariff](images/sem_ev_setup_tariff.png) | ![Night off](images/sem_ev_setup_night_off.png) |
109-
| Overnight grid charging ON, Cheapest hours OFF. Standard peak-managed night top-up to hit Min by 07:00. | Overnight grid charging ON, Cheapest hours ON. Defers night charging to the cheapest contiguous window in the upcoming 24h; Min still guaranteed by the deadline. | Overnight grid charging OFF. Solar-only — never pulls grid for the EV. The Cheapest hours sub-row is hidden because tariff timing is a refinement of grid charging. |
126+
| Mode | Behaviour | Typical user |
127+
|---|---|---|
128+
| **Solar only** | Surplus only — never imports from grid | Solar maximalist |
129+
| **Solar + cheapest hours** | Surplus by day, grid only in the cheapest contiguous tariff window at night (hidden if no dynamic tariff is configured) | Dynamic-tariff users |
130+
| **Min + Solar** (default) | Guarantee Min by deadline (from night top-up), solar adds up to Max. Zone-adaptive during the day. | Daily commuter |
131+
| **Always (max)** | Charge at max regardless of source | "Just charge the car" / strict legacy `minpv` |
132+
| **Off** | No charging — SEM monitors but issues no commands | Disabled |
110133

111-
For the full decision matrix (mode × time-of-day × switches × outcomes), see **[EV_CHARGING_LOGIC.md](EV_CHARGING_LOGIC.md)**.
134+
A help line under the selector explains what the currently-selected mode does. For the full decision matrix (mode × time-of-day × outcomes) and the v4 → v7 migration mapping, see **[EV_CHARGING_LOGIC.md](EV_CHARGING_LOGIC.md)**.
112135

113136
### Control
114137

@@ -118,7 +141,7 @@ All settings and device management in one place.
118141

119142
| Card | Description |
120143
|------|-------------|
121-
| **EV Charging** | Night charging toggle, smart night charging, target, current settings |
144+
| **EV Charging** | Per-charger [Charge mode](#charging-mode-selector-v163) selector, target range, current settings (the standalone `night_charging` and `smart_night_charging` toggles were removed in v1.6.3 — their intent is now carried by the mode) |
122145
| **Surplus Control** | Surplus available indicator, regulation offset |
123146
| **Battery Management** | Priority/minimum/resume SOC, capacity |
124147
| **Heat Pump & Hot Water** | Boost offset, hot water max temperature |
-84.2 KB
Binary file not shown.
-81.4 KB
Binary file not shown.
-86.7 KB
Binary file not shown.

0 commit comments

Comments
 (0)