Skip to content

Commit 6f891cd

Browse files
authored
Update README.md
1 parent 5ddb44b commit 6f891cd

1 file changed

Lines changed: 28 additions & 4 deletions

File tree

‎README.md‎

Lines changed: 28 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,15 +24,17 @@ Select your brand in the visual editor. Entities and polarity are configured aut
2424
* Configurable battery and grid polarity sign conventions
2525
* Dual MPPT support - configure two solar strings independently
2626
* Optional EV charging node with animated flow, blinking bolt, SOC and daily energy
27+
* Extra consumption nodes — appliances, garage, heat pump, and custom loads, each with its own power sensor, icon, and label
2728
* Animated pulse flow lines with speed proportional to power output
29+
* Inverter → home flow coloured by the mix feeding the home (solar green / battery amber / grid red)
2830
* Color-coded values: solar (green), grid (red), home (cyan), battery (yellow)
2931
* Inverter icon with 4 status LEDs indicating active energy flows
3032
* Battery runtime estimation with shutdown SOC and ETA
3133
* Optional weather display (temperature and humidity)
3234
* 24-hour sparkline charts with Catmull-Rom interpolation, updated every 5 minutes
3335
* Sparkline tooltips showing power and timestamp on hover
3436
* Auto-scaling Y-axis on all sparklines
35-
* Circular self-sufficiency ring — color-coded arc, centered %, leaf glyph, and hover/tap label
37+
* Circular self-sufficiency ring — split by the source feeding the home (solar / battery / grid), centered %, leaf glyph, sliding slice transitions, and hover/tap label
3638
* Daily totals for import, export, and production in kWh
3739
* Trend arrows for rising, falling, or stable values
3840
* Graceful handling of unavailable sensors (`--`)
@@ -44,17 +46,18 @@ Select your brand in the visual editor. Entities and polarity are configured aut
4446
* Three-phase grid voltage display (L1/L2/L3)
4547
* Split battery charge/discharge sensors for Solis/Modbus setups
4648
* Daily energy cost overlay (import cost / export earnings)
49+
* Optional energy price display driven by a tariff sensor (with price icons)
4750
* Grid status indicator dot (on-grid / off-grid)
4851
* Click any node to open its more-info dialog — dual-MPPT opens each string (PV1/PV2) separately
4952
* Full theming via CSS custom properties (`--xpf-*`)
5053
* Performance-optimized: entity diffing, paused updates in hidden tabs
51-
* Animated value transitions, smooth count-up on power changes
54+
* Animated value transitions, smooth count-up on power and self-sufficiency changes
5255
* Gradient-filled sparkline areas
5356
* EV SOC shown as a mini iOS-style pill (green while charging)
5457
* Respects `prefers-reduced-motion` (all animations disabled)
55-
* Fully translated visual editor (all 8 languages)
58+
* Fully translated visual editor (all 9 languages)
5659
* One-click entity auto-detection (HA Energy Dashboard + power sensor heuristics)
57-
* Live entity validation in the editor missing entities flagged in red
60+
* Live entity validation in the editor — missing entities flagged in red
5861
* `prefers-color-scheme` theme fallback when HA theme info is absent
5962

6063
## Installation
@@ -172,6 +175,27 @@ weather_humidity: sensor.my_outdoor_humidity
172175
| `extra{1,2,3}_name` | | Custom label for each extra-consumer node (falls back to the icon's name) |
173176
| `extra{1,2,3}_icon` | `appliance` / `heatpump` / `garage` | Icon per node: `appliance`, `heatpump`, `garage`, `generic` |
174177

178+
## Extra consumption nodes & energy price
179+
180+
Set in YAML (not exposed in the visual editor yet).
181+
182+
### Extra consumption nodes
183+
Up to three extra loads branch off the home node. Each appears only when its `*_power` entity is set.
184+
185+
| Option | Description |
186+
| --- | --- |
187+
| `extra1_power`, `extra2_power`, `extra3_power` | Power sensor for the extra load (required to show the node) |
188+
| `extra1_name`, `extra2_name`, `extra3_name` | Optional label (falls back to the icon's default name) |
189+
| `extra1_icon`, `extra2_icon`, `extra3_icon` | Icon type — `appliance`, `heatpump`, or `garage` (defaults: 1 = appliance, 2 = heatpump, 3 = garage) |
190+
191+
Shorthand aliases also work and map to the three slots: `appliance_power` → extra1, `heatpump_power` → extra2, `garage_power` → extra3 (each with a matching `*_name`).
192+
193+
### Energy price
194+
| Option | Description |
195+
| --- | --- |
196+
| `price_sensor` | Sensor holding the current energy price; shown with a price icon |
197+
| `import_cost`, `export_cost` | Import cost / export earnings rates for the daily cost overlay |
198+
175199
### Polarity Guide
176200

177201
**Battery power:**

0 commit comments

Comments
 (0)