Skip to content

Repository files navigation

GridPilot capacity tariff meter

GridPilot

GridPilot is een Home Assistant integratie voor energiebeheer, gericht op het bewaken en zo laag mogelijk houden van het capaciteitstarief. Daarnaast biedt GridPilot ondersteuning voor het beheer van thuisbatterijen, zonne-energieproductie en het laden van elektrische voertuigen. De integratie combineert een veilige rekenmodule met een compacte dashboardkaart voor het visualiseren van batterij- en energiestromen.

GridPilot is a Home Assistant energy management integration focused on monitoring and minimizing the capacity tariff. It also provides support for managing home batteries, solar energy production, and EV charging. The integration combines a safe calculation engine with a compact dashboard card for visualizing battery and energy flows.

Current status

Version 1.4.6 is the current stable release. Battery and EV actuation remain in shadow mode by default and can be enabled independently. Battery setpoint actuation can be enabled explicitly from the integration options after the existing battery controller has been disabled.

Initial features

  • UI-only configuration through a Home Assistant config flow.
  • Generic entity mapping with a Victron-oriented preset.
  • Integration-owned grid-power and battery-curve options without helpers.
  • Optional forecast-driven charge-SOC controls for solar production, with or without the EV energy needed for its configured departure target.
  • Calculated grid setpoint and operating-mode sensors.
  • Phase-aware PV-surplus and EV-current calculations.
  • Configurable battery-power sign convention for PV-surplus calculations.
  • Separate opt-in EV current actuation with start, stop and restart hysteresis.
  • Manual charging from a UI-managed current helper.
  • Battery-to-EV charging from UI-managed reserve-SOC, time-to-go and deadline helpers.
  • Explicit PV, manual and battery-to-EV strategy diagnostics.
  • Authoritative charging-mode selection without a separate override entity.
  • Measurement-validity binary sensor.
  • Bundled custom:gridpilot-card frontend card.
  • Automatic GridPilot dashboard with battery, setpoint and EV-control status.
  • EV SOC estimation between vehicle updates from measured charged energy.
  • Dutch and English translations.

GridPilot creates a storage dashboard at /gridpilot-dashboard, adds it to the Home Assistant sidebar and refreshes its configuration whenever the integration loads. The dashboard includes an EV-priority slider in PV mode and manual current and phase controls in manual mode. Battery-to-EV mode shows the configured minimum home-battery SOC as an adjustable discharge-limit slider.

Configure the optional EV SOC for dashboard entity to show a separate vehicle battery card. This mapping is display-only and is not used for battery-to-EV safety.

Manual development installation

Copy custom_components/gridpilot into the Home Assistant configuration directory under custom_components, restart Home Assistant, and add GridPilot from Settings > Devices & services.

Keep the existing controller enabled while comparing GridPilot in shadow mode. Disable it before enabling GridPilot's active battery control.

License

MIT

About

Home Assistant energy management integration focused on monitoring and minimizing the capacity tariff. It also provides support for managing home batteries, solar energy production, and EV charging.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages