Home Assistant integration for gridX-based energy management systems.
Also known as: E.ON Home Manager, Viessmann Gridbox
- Live energy data polling (60s intervals)
- Automatic device creation for batteries, heat pumps, EV chargers, and heaters
- Proper state_class metadata for HA Energy dashboard compatibility
- SG Ready state monitoring for heat pumps
- Cumulative grid meter readings (import/export)
- Exponential backoff on API errors (respects the API)
- Open HACS in Home Assistant
- Go to Integrations
- Click the three dots menu → Custom repositories
- Add
lackas/ha-gridxwith category "Integration" - Install "gridX Energy Management"
- Restart Home Assistant
Copy the custom_components/gridx folder to your Home Assistant custom_components directory.
- Go to Settings → Devices & Services → Add Integration
- Search for "gridX"
- Enter your E.ON Home / gridX account email and password
- Open HACS → Integrations → gridX Energy Management
- Click "Update information" to refresh repository data
- Click "Redownload" and confirm
- Go to Settings → System → a "Restart required" repair will appear — click Restart
The integration creates devices based on your system:
| Device | Entities | Created when |
|---|---|---|
| gridX | 17 sensors (power flows, rates, meter readings) | Always |
| gridX Battery | 7 sensors (SoC, power, charge/discharge, capacity) | If battery present |
| gridX Heat Pump | 2 sensors (power, SG Ready state) | If heat pump present |
| gridX EV Charger | 6 sensors (power, SoC, currents, total energy) | If EV charger present |
| gridX Heater | 2 sensors (power, temperature) | If heater present |
Multiple appliances of the same type are supported (e.g., "gridX Battery" and "gridX Battery 2").
This is an unofficial, community-maintained integration. It is not affiliated with, endorsed by, or supported by gridX GmbH or E.ON SE.
Inspired by and based on the work of:
This is a clean-room reimplementation as a native HA integration. No code was copied from the original projects.
Apache License 2.0 — see LICENSE