Energa meter Home Assistant add-on
Podoba Ci się? Postaw kawę.
O dodatku
To jest dodatek dla Home Assistant. Instalacja dodatku Energa meter umożliwia cykliczne pobieranie danych z aplikacji Mój Licznik - Energa udostępnianej klientom Operatora energetycznego Energa
Instalacja
- Dodaj repozytorium do repozytoriów dodatków swojego HA za pomocą poniższego przycisku
Lub zainstaluj manualnie z Ustawienia -> Dodatki -> Sklep z dodatkami -> ⁞ (Menu) -> Repozytoria -> Wpisz https://github.com/tcich/hassio-mojlicznik -> Dodaj. Następnie w ⁞ (Menu) -> Sprawdź aktualizacje (może być konieczne przeładowanie strony)
-
Odszukaj dodatek na liście dodatków w sklepie z dodatkami i zainstaluj go.
-
W zakładce konfiguracja uzupełnij nazwę użytkownika oraz hasło do aplikacji Mój Licznik, jeżeli potrzebujesz to zmień udostępniany port dla API
-
Przejdź do zakładki informacje i uruchom dodatek (pierwsze uruchomienie może trwać kilkanaście minut), jeżeli w logu pojawi się informacja INFO: Czekam... oznacza to, że pierwsze inicjalne pobieranie danych zostało ukończone.
Wersja Docker
docker run -p 8000:8000 -e ENERGA_USERNAME=LoginEnerga -e ENERGA_PASSWORD=HasloEnerga tomcic/energa-meter:v0.1.0
Konfiguracja sensorów
- Ustal ID Twoich liczników, w tym celu przejdź do adresu Twojego HA na porcie 8000 lub innym jeźeli zmieniłeś go w konfiguracji, np. http://192.168.1.10:8000 wyświetli się w formacie json lista dostępnych liczników, możesz również odszukać ID w logu: Licznik 12335379 istnieje w systemie
- W pliku configuration.yaml w HA dodaj następującą konfigurację np.:
sensor:
- platform: rest
resource: http://localhost:8000/meters/12335379
name: "Energia aktualna T1"
unique_id: 12335379_sumz1
unit_of_measurement: "kWh"
value_template: "{{ value_json.meter.zone1.meter | round(2) }}"
- platform: rest
resource: http://localhost:8000/meters/12335379
name: "Dzienny odczyt licznika"
unique_id: 12335379_meterz1
unit_of_measurement: "kWh"
value_template: "{{ value_json.meter.zone1.sum | round(2) }}"
- platform: rest
resource: http://localhost:8000/meters/12335379
name: "Energia aktualna T2"
unique_id: 12335379_sumz2
unit_of_measurement: "kWh"
value_template: "{{ value_json.meter.zone2.meter | round(2) }}"
- platform: rest
resource: http://localhost:8000/meters/12335379
name: "Dzienny odczyt licznika"
unique_id: 12335379_meterz2
unit_of_measurement: "kWh"
value_template: "{{ value_json.meter.zone2.sum | round(2) }}"
Opis konfiguracji
| element konfiguracji | Opis |
|---|---|
| resource: http://localhost:8000/meters/12335379 | Adres API z danymi konkretnego licznika, podajemy nazwę instancji dockera (Nazwa hosta z okna dodatku) lub localhost |
| name: "Energia aktualna" | Nazwa sensora, wpisz dowolną |
| unique_id | Unikalny ID sensora, nie mogą być w systemie dwa sensory z tym samym ID |
| unit_of_measurement: "kWh" | Jednostka miary, nie zmieniaj chyba, że wiesz co robisz |
| value_template: "{{ value_json.meter.zone2.meter | round(2) }}" | Zaokrąglony do dwóch miejsc po przecinku stan sensora |
Opis konfiguracji cd
| value_template | Opis |
|---|---|
| value_json.meter.zone1.sum | Suma licznika oraz dziennego zużycia dla tartfy1 (dostępne są: zone1, zone2, zone3) |
| value_json.meter.zone2.meter | Stan licznika dziennego dla taryfy1 (dostępne są: zone1, zone2, zone3) |
API dla wykresów, np. Grafana
Aby pobrać dane z API w formacie JSON należy użyć adresu http://home_assistant:8000/charts/12729?start_date=1695332400129&end_date=1697924583285
gdzie:
- 12729 - jest to ID licznika
- start_date - początek okresu w milisekundach wg. standardu EPOCH (timestamp)
- end_date - koniec okresu w milisekundach wg. standardu EPOCH (timestamp)
Jak dodać wykres do Grafana
Instrukcja konfiguracji Grafana
Znane problemy
Czasami w aplikacji Mój Licznik włącza się captha (jeżeli masz dużo danych historycznych lub wielokrotnie instalujesz dodatek)
Uwagi
Dostęp do aktualnej wersji API nie jest zabezpieczony tokenem Każde przeinstalowanie dodatku pobiera ponownie dane z aplikacji Mój Licznik
Podoba Ci się? Postaw kawę.