modified: README.md
modified: src/README.md
This commit is contained in:
@@ -133,6 +133,7 @@ gdzie:
|
|||||||
|
|
||||||
## Znane problemy
|
## Znane problemy
|
||||||
Czasami w aplikacji Mój Licznik włącza się captha (jeżeli masz dużo danych historycznych lub wielokrotnie instalujesz dodatek)
|
Czasami w aplikacji Mój Licznik włącza się captha (jeżeli masz dużo danych historycznych lub wielokrotnie instalujesz dodatek)
|
||||||
|
Dane wytwórcy (energia oddana oraz bilans) nie są dostępne, prace w tym zakresie trwają.
|
||||||
|
|
||||||
## Uwagi
|
## Uwagi
|
||||||
Dostęp do aktualnej wersji API nie jest zabezpieczony tokenem
|
Dostęp do aktualnej wersji API nie jest zabezpieczony tokenem
|
||||||
|
|||||||
@@ -20,90 +20,14 @@
|
|||||||
|
|
||||||
To jest dodatek dla [Home Assistant](https://www.home-assistant.io/). Instalacja dodatku [Energa meter](https://github.com/tcich/ha-addon-energa-meter) umożliwia cykliczne pobieranie danych z aplikacji [Mój Licznik - Energa](https://mojlicznik.energa-operator.pl) udostępnianej klientom Operatora energetycznego Energa
|
To jest dodatek dla [Home Assistant](https://www.home-assistant.io/). Instalacja dodatku [Energa meter](https://github.com/tcich/ha-addon-energa-meter) umożliwia cykliczne pobieranie danych z aplikacji [Mój Licznik - Energa](https://mojlicznik.energa-operator.pl) udostępnianej klientom Operatora energetycznego Energa
|
||||||
|
|
||||||
|
## Możliwości:
|
||||||
|
* Obsługa liczników jako sensory
|
||||||
|
* Wykresy w Grafana
|
||||||
|
|
||||||
## Instalacja
|
## Instalacja
|
||||||
1) Dodaj repozytorium do repozytoriów dodatków swojego HA za pomocą poniższego przycisku
|
|
||||||
|
|
||||||
[](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Ftcich%2Fha-addon-energa-meter)
|
Instrukcja instalacji jest dostępna pod adresem: [Instrukcja konfiguracji](https://github.com/tcich/ha-addon-energa-meter/blob/main/README.md)
|
||||||
|
|
||||||
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)
|
|
||||||
|
|
||||||
2) Odszukaj dodatek na liście dodatków w sklepie z dodatkami i zainstaluj go.
|
|
||||||
|
|
||||||
3) 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
|
|
||||||
|
|
||||||
4) 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
|
|
||||||
1) 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*
|
|
||||||
2) 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](https://github.com/tcich/ha-addon-energa-meter/blob/main/README.md#jak-doda%C4%87-wykres-do-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
|
|
||||||
|
|
||||||
|
## Motywacja
|
||||||
|
|
||||||
**Podoba Ci się?** [Postaw kawę.](https://buycoffee.to/tcich)
|
**Podoba Ci się?** [Postaw kawę.](https://buycoffee.to/tcich)
|
||||||
|
|||||||
Reference in New Issue
Block a user