You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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).
Copy file name to clipboardExpand all lines: docs/DASHBOARD_GUIDE.md
+33-10Lines changed: 33 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -43,15 +43,35 @@ The main at-a-glance view with real-time power flows.
43
43
| Card | Description |
44
44
|------|-------------|
45
45
|**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 |
46
47
|**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) |
47
48
|**Solar Summary**| Production metrics with animated glow ring, yield, forecast, self-use, costs, savings |
48
49
|**7-Day Chart**| Bar chart showing daily solar, home, and grid import over the last week |
49
50
|**Smart Recommendation**| AI-powered energy tip based on forecast, pricing, and current conditions |
50
51
|**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.)|
52
53
|**EV Status**| Conditional — shows charging state, current, power, session progress when EV is connected |
53
54
|**Weather**| Live clock, temperature, weather conditions, 5-day forecast with temperature bars |
54
55
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
+
55
75
### Energy
56
76
57
77
Deep dive into energy production, consumption, and environmental impact.
@@ -95,20 +115,23 @@ EV charging session tracking and statistics.
95
115
|**Charging Status**| Current mode, power, session energy, solar share |
96
116
|**Session Gauges**| Daily energy vs target, solar share percentage |
97
117
|**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 |
99
119
|**EV Intelligence**| Taper trend visualization, virtual SOC estimate, charge skip status & reasoning, battery health indicator |
100
120
|**Lifetime Statistics**| Total energy, cost, sessions, solar share over all time |
101
121
102
-
#### Charging setup variants (1.5.16+)
122
+
#### Charging mode selector (v1.6.3)
103
123
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:
105
125
106
-
| Default — solar-first with grid fallback | Tariff-optimized — defer to cheap hours | Pure solar — overnight grid off |
| 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 |
110
133
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)**.
112
135
113
136
### Control
114
137
@@ -118,7 +141,7 @@ All settings and device management in one place.
118
141
119
142
| Card | Description |
120
143
|------|-------------|
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)|
122
145
|**Surplus Control**| Surplus available indicator, regulation offset |
0 commit comments