https://github.com/fistacho/ha-eon-pl
Home Assistant custom integration for E.ON Polska (Mój E.ON) — energy consumption, OZE production, hourly stats for Energy Dashboard
https://github.com/fistacho/ha-eon-pl
energy eon hacs hacs-integration home-assistant homeassistant oze photovoltaics poland smart-meter
Last synced: 2 months ago
JSON representation
Home Assistant custom integration for E.ON Polska (Mój E.ON) — energy consumption, OZE production, hourly stats for Energy Dashboard
- Host: GitHub
- URL: https://github.com/fistacho/ha-eon-pl
- Owner: Fistacho
- License: mit
- Created: 2026-04-28T18:08:31.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-28T18:51:56.000Z (3 months ago)
- Last Synced: 2026-04-28T20:29:16.107Z (3 months ago)
- Topics: energy, eon, hacs, hacs-integration, home-assistant, homeassistant, oze, photovoltaics, poland, smart-meter
- Language: Python
- Size: 29.3 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# E.ON Polska — Home Assistant Add-on
Automatyczne pobieranie zużycia energii z **Mój E.ON** do Home Assistant. Login `email + hasło` raz w configu addona — reszta dzieje się sama.
## Co robi
- **Logowanie automatyczne** — Selenium + chromium odpalane on-demand (~30 s peak), jeśli portal zaakceptuje reCAPTCHA v3.
- **Tryb ręcznego ciasteczka** — wariant bez CapSolvera: logujesz się normalnie w przeglądarce i wklejasz `.AspNet.Cookies` albo pełny nagłówek `Cookie` w Web UI.
- **Hourly imported / exported** → Home Assistant **external statistics** (Energy Dashboard).
- **Year-to-date backfill** przy pierwszym uruchomieniu (chunki 60 dni).
- **Live "ostatnia godzina"** sensors (`pobrana / wprowadzona / bilans`).
- **Roczne agregaty** + **bieżący okres rozliczeniowy** z `GetBillingData` / `GetOzeAgrData`.
- **MQTT auto-discovery** — encje pojawiają się w HA same.
- **Web UI ingress** — status sesji, ostatni login, ręczny refresh.
- Self-healing: keepalive co 5 min, automatyczne re-login co 12 h lub przy 302 do `/Logowanie`.
## Wymagania
- Home Assistant OS / Supervised z dostępem do Add-on Store
- **MQTT broker** (np. addon Mosquitto) — addon korzysta z auto-discovery
- Konto na
## Instalacja
1. **Settings → Add-ons → Add-on Store → ⋮ → Repositories**
2. Dodaj: `https://github.com/Fistacho/ha-eon-pl`
3. Zainstaluj **E.ON Polska**
4. **Configuration**:
```yaml
email: twoj@email.pl
password: TwojeHasło
scan_interval_hours: 6
cookie_refresh_hours: 12
manual_cookie_only: false # true = bez Selenium/CapSolver, tylko wklejone cookie
selected_kus: [] # puste = wszystkie aktywne KU
log_level: info
mqtt_discovery: true
```
5. **Start**
6. **Open Web UI** — zobacz status, kliknij "Pobierz dane teraz" jeśli chcesz przyspieszyć pierwszy fetch.
Encje pojawiają się w HA przez MQTT auto-discovery w ciągu kilku sekund po pierwszym fetchu.
Jeśli automatyczne logowanie kończy się błędem reCAPTCHA, ustaw `manual_cookie_only: true`, uruchom addon, otwórz **Open Web UI** i wklej `.AspNet.Cookies` albo pełny nagłówek `Cookie` skopiowany po ręcznym zalogowaniu na `eon.pl`. Addon będzie zapisywał odnowione cookie, jeśli E.ON zwróci nowe `Set-Cookie` podczas keepalive albo pobierania danych.
## Encje (per KU+PPE)
| Encja | Typ | Źródło |
| --- | --- | --- |
| `sensor.eon__consumption_current_period` | total_increasing kWh | `GetBillingData` |
| `sensor.eon__imported_year` | total_increasing kWh | `GetOzeAgrData` |
| `sensor.eon__exported_year` | total_increasing kWh | `GetOzeAgrData` |
| `sensor.eon__balance_year` | total kWh | `GetOzeAgrData` |
| `sensor.eon__last_hour_imported` | total kWh | hourly CSV |
| `sensor.eon__last_hour_exported` | total kWh | hourly CSV |
| `sensor.eon__last_hour_balance` | total kWh | hourly CSV |
Plus **external statistics** (Energy Dashboard):
- `eon_pl:imported_` — godzinowy kumulowany pobór
- `eon_pl:exported_` — godzinowy kumulowany eksport
## Energy Dashboard
**Settings → Dashboards → Energy**:
- **Electricity grid → Add consumption** → `eon_pl:imported_`
- **Electricity grid → Add return** → `eon_pl:exported_`
- **Solar panels → Add solar production** → encja Twojego inwertera
## Architektura
```text
┌──────────────────────────────────────────┐
│ HA Add-on container │
│ │
│ ┌──────────┐ ┌─────────────────┐ │
│ │ Web UI │ │ Main loop │ │
│ │ (ingress)│ │ - keepalive 5min │ │
│ └─────┬────┘ │ - fetch every Nh │ │
│ │ │ - relogin every Nh│ │
│ │ │ or manual cookie │ │
│ └──────►│ - on-demand login │ │
│ └────┬─────────┬─────┘ │
│ ▼ ▼ │
│ ┌──────────────┐ ┌─────────────┐ │
│ │ Playwright + │ │ httpx async │ │
│ │ chromium │ │ → eon.pl │ │
│ │ (on-demand) │ └─────────────┘ │
│ └──────────────┘ │
│ │ │
│ ┌──────────────────────┴────┐ │
│ ▼ ▼ │
│ ┌─────────┐ ┌──────────┐ │
│ │ MQTT │ → discovery │ HA REST │ │
│ │ pub │ + state │ recorder │ │
│ └─────────┘ │ statistics│ │
│ └──────────┘ │
└──────────────────────────────────────────────┘
```
**RAM profile:**
- Idle: ~30 MB (sam Python + httpx + aiomqtt)
- Login peak: ~500 MB przez ~30 s (chromium), potem zwolniony
- Średnio: ~30 MB
## Migracja z `custom_components/eon_pl`
Stary HACS-ready custom_component (v0.1–v0.2) został zarchiwizowany w git history (tag `v0.2.1`). Addon to kompletny rewrite:
- Stare encje `sensor.e_on_*` z entity_registry można bezpiecznie usunąć (Settings → Devices & Services → ⋮ → Entities → filter `e_on`).
- Stare `eon_pl:imported_` external statistics **zostają w recorderze** — addon wznawia od ostatniej znanej sumy, żadnych dziur w Energy Dashboard.
- W configu HA **nie** trzeba nic dodawać — addon publikuje wszystko przez MQTT discovery.
## Limitacje
- Hourly data ma **24–48 h opóźnienia publikacji**. Addon używa `today − 3` jako górnej granicy okna.
- Wymaga MQTT brokera w HA.
- Nieafiliowany z E.ON Polska. Korzystasz na własne ryzyko.
## License
MIT — patrz [LICENSE](./LICENSE).