shaggy-solar/eg4battery/homeassistant/README.md

HA-side configuration for the eg4-battery daemon

Reference configs that go into your Home Assistant instance — they aren't installed by install.sh (HA typically lives on a different host / in an HA OS appliance), but they're tracked here so the full stack is reproducible.

What's in here

File	Where it goes in HA
recorder.yaml	configuration.yaml → under a recorder: key, or merge into existing
template_sensors.yaml	configuration.yaml → under a top-level template: list, or include via !include
lovelace_overview.yaml	Raw Lovelace card config — paste into a new dashboard view

All of it assumes pack names lifepower4_1, lifepower4_2, lifepower4_3 matching the daemon's default config. If you renamed your packs, do a sed -i 's/lifepower4_/your_prefix_/' *.yaml first.

Recommended retention tiers

Full rationale in ../NOTES.md and the architecture thread, but the short version:

• Tier 1 — keep forever: pack_voltage, pack_current, soc, soh, cycle_count, cell_voltage_min/max/delta_mv, capacity_ah.
• Tier 2 — keep short: all 14 warning_* + 14 protection_*, error_code, remaining_ah, heater, the derived temperature_max and pack_power.
• Tier 3 — exclude (the recorder.yaml here does this): all 136 raw register_NN entities per pack, the 16 individual cell_NN_voltage series, static metadata (bms_version_*, model, firmware_version, firmware_date, battery_mode, cell_count, etc.), and the uptime_ds counter that increments every second.

Enabling in HA

Easiest path:

# configuration.yaml

# merge our recorder exclusions with your existing recorder config
recorder: !include eg4_battery/recorder.yaml

# include the template sensors (creates a new `template:` list block)
template: !include eg4_battery/template_sensors.yaml

And drop the two YAMLs into ~/homeassistant/eg4_battery/.

If you already have recorder: or template: keys elsewhere, merge by hand — HA doesn't allow two definitions of the same top-level key.

Energy dashboard wiring (optional)

Once the derived pack_power template sensors exist, add them to the Energy dashboard via Settings → Dashboards → Energy → Home battery storage — each pack's pack_power integrates to pack_energy_in_kwh and pack_energy_out_kwh automatically, with per-pack bars.