commissioned

LVX6048/homeassistant/README.md

@@ -12,6 +12,7 @@ Mirrors the `eg4battery/homeassistant/` pattern.
 |----------------------------|--------------------------------------------------------------|
 | `mqtt_controls.yaml`       | `configuration.yaml` → `mqtt: !include lvx6048/mqtt_controls.yaml` (or merge by hand) |
 | `template_sensors.yaml`    | `configuration.yaml` → `template: !include lvx6048/template_sensors.yaml` |
+| `daily_energy_package.yaml`| `configuration.yaml` → `homeassistant: packages: {lvx6048_daily_energy: !include lvx6048/daily_energy_package.yaml}` |
 | `lovelace_controls.yaml`   | Raw Lovelace card config — paste into a new dashboard view   |
 
 The auto-discovery sensors (battery V, fault code, mode, MPPT power, …)
@@ -103,6 +104,24 @@ mosquitto_sub -h <broker> -u mqtt -P <pass> -v \
 …then flip a select in the dashboard. Both inverters should publish
 `"Succeeded"` within ~1 s.
 
+## Daily energy indicators (harvested / used today)
+
+`daily_energy_package.yaml` adds two daily-resetting kWh sensors for a
+dashboard tile:
+
+- `sensor.solar_harvested_today` — PV generated today, summed across both
+  inverters. Sourced from each inverter's lifetime `total_pv_generated_energy`
+  Wh counter via a daily `utility_meter` (the LVX6048 firmware has no
+  daily-energy query, so we meter the lifetime counter instead).
+- `sensor.solar_used_today` — household load consumed today. No cumulative
+  load counter exists, so `sensor.lvx6048_stack_ac_output_active_power` (W)
+  is Riemann-integrated into energy and metered daily.
+
+Requires `template_sensors.yaml` (for the stack load-power rollup). A ready
+two-tile Lovelace card is in the file's trailing comment. After enabling,
+the two sensors read 0 at local midnight and climb through the day; give the
+integration a few minutes to accumulate its first non-zero value.
+
 ## Energy / SoC dashboard wiring (optional)
 
 Once both inverters' `ac_output_active_power` and the EG4 daemon's