Identyfikatory (TAURON eLicznik) #
Identyfikatory ELICZNIK umożliwiają odczyt danych o energii pobranej z sieci i oddanej do sieci, taryfie oraz ostatnich dostępnych wskazaniach licznika. Integracja jest dostępna dla modułu DOMIQ Base 2.0.
Poniżej przedstawiono przegląd kanałów oraz ich szczegółowy opis z przykładami zastosowania. Konfigurację połączenia z kontem TAURON opisuje rozdział 9.16. – Integracje (Tauron eLicznik).
1. Format identyfikatorów #
ELICZNIK.<NazwaLicznika>.<parametr>
ELICZNIK– oznaczenie integracji.<NazwaLicznika>– nazwa punktu poboru energii (PPE) nadana w konfiguracji integracji.<parametr>– nazwa odczytywanej informacji.
W przykładach przyjęto nazwę Home. Zastąp ją nazwą skonfigurowaną w swoim module. Zmiana nazwy PPE zmienia również identyfikatory, dlatego wymaga aktualizacji odwołań w interfejsie i logice systemu.
Znaczenie nazw parametrów:
consumed– energia pobrana z sieci. W instalacji z własnym źródłem energii nie jest to całkowite zużycie energii w budynku.produced– energia oddana do sieci. Nie obejmuje całej produkcji fotowoltaiki, w szczególności energii zużytej bezpośrednio w budynku.gross– dane przed zbilansowaniem. Parametry okresowe bez tego przyrostka zawierają dane po zbilansowaniu.
2. Aktualizacja danych i okresy pomiarowe #
Dane w serwisie eLicznik aktualizują się zwykle raz dziennie, najczęściej w nocy. Integracja DOMIQ domyślnie pobiera dane co 8 godzin. Częstsze pobieranie nie oznacza, że serwis udostępnia nowe pomiary.
Przedrostek current oznacza bieżący okres kalendarzowy, a last – poprzedni zakończony okres. Dostępność i kompletność wartości zależą od danych opublikowanych w eLiczniku.
| Fragment nazwy | Zakres danych |
|---|---|
current_day | Bieżący dzień. |
last_day | Poprzedni dzień. |
current_week | Bieżący tydzień, od poniedziałku do bieżącego dnia. |
last_week | Poprzedni tydzień, od poniedziałku do niedzieli. |
current_month | Bieżący miesiąc, od pierwszego dnia miesiąca. |
last_month | Poprzedni miesiąc kalendarzowy. |
Ważne: dane dotyczące bieżącego dnia mogą być niedostępne lub niepełne. Również dane za zakończony okres mogą pojawić się z opóźnieniem. Braku danych nie należy interpretować jako zerowego poboru lub oddawania energii. Integracja służy do analizy danych okresowych; nie dostarcza pomiaru chwilowej mocy ani bieżącej nadwyżki PV.
3. Przegląd identyfikatorów #
Wszystkie opisane kanały służą do odczytu stanu. Nie udostępniają komend zmieniających taryfę lub wskazania licznika. W tabeli znak + oznacza dostępną funkcję, a – jej brak.
| Grupa identyfikatorów | Skrócony opis | Stan | Komenda |
|---|---|---|---|
tariff | Nazwa taryfy przypisanej do PPE. | + | – |
Okresowe …_consumed | Energia pobrana po zbilansowaniu. | + | – |
Okresowe …_produced | Energia oddana po zbilansowaniu. | + | – |
Okresowe …_consumed_gross | Energia pobrana przed zbilansowaniem. | + | – |
Okresowe …_produced_gross | Energia oddana przed zbilansowaniem. | + | – |
meter_consumed, meter_produced | Ostatnie dostępne wskazania licznika. | + | – |
meter_consumed_date, meter_produced_date | Daty odczytów licznika. | + | – |
Wielokropek w tabeli oznacza fragment nazwy zależny od okresu, np. current_day. Pełne identyfikatory znajdują się poniżej.
4. Taryfa – tariff #
Identyfikator informuje o taryfie przypisanej do danego punktu poboru energii.
| Logika systemu | Identyfikator | Wartość | Opis |
|---|---|---|---|
| Stan | ELICZNIK.Home.tariff | tekst | Nazwa taryfy, np. G11. |
5. Energia po zbilansowaniu (netto) #
Parametry bez przyrostka _gross udostępniają ilości energii po zbilansowaniu godzinowym. W każdej godzinie zestawiane są energia pobrana z sieci i energia oddana do sieci, z uwzględnieniem wszystkich faz. Pozostała po zbilansowaniu ilość jest przypisywana do poboru albo oddawania energii.
Przykład: jeżeli w tej samej godzinie licznik zarejestruje pobór 5 kWh i oddanie 2 kWh, po zbilansowaniu pozostanie 3 kWh energii pobranej oraz 0 kWh energii oddanej.
Z tej zasady wynika, że wartości dzienne, tygodniowe i miesięczne należy rozumieć jako sumy odpowiednich danych po zbilansowaniu poszczególnych godzin. Nie należy zastępować tego obliczenia jednorazowym odjęciem całej energii oddanej od całej energii pobranej za dany dzień lub miesiąc.
| Logika systemu | Identyfikator | Wartość | Opis |
|---|---|---|---|
| Stan | ELICZNIK.Home.current_day_consumed | liczba [kWh] | Energia pobrana z sieci w bieżącym dniu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.last_day_consumed | liczba [kWh] | Energia pobrana z sieci w poprzednim dniu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.current_day_produced | liczba [kWh] | Energia oddana do sieci w bieżącym dniu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.last_day_produced | liczba [kWh] | Energia oddana do sieci w poprzednim dniu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.current_week_consumed | liczba [kWh] | Energia pobrana z sieci w bieżącym tygodniu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.last_week_consumed | liczba [kWh] | Energia pobrana z sieci w poprzednim tygodniu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.current_week_produced | liczba [kWh] | Energia oddana do sieci w bieżącym tygodniu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.last_week_produced | liczba [kWh] | Energia oddana do sieci w poprzednim tygodniu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.current_month_consumed | liczba [kWh] | Energia pobrana z sieci w bieżącym miesiącu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.last_month_consumed | liczba [kWh] | Energia pobrana z sieci w poprzednim miesiącu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.current_month_produced | liczba [kWh] | Energia oddana do sieci w bieżącym miesiącu, po zbilansowaniu. |
| Stan | ELICZNIK.Home.last_month_produced | liczba [kWh] | Energia oddana do sieci w poprzednim miesiącu, po zbilansowaniu. |
6. Energia przed zbilansowaniem (brutto) #
Parametry z przyrostkiem _gross przedstawiają energię pobraną i oddaną, zarejestrowaną przez licznik przed bilansowaniem godzinowym. Nazwy „netto” i „brutto” odnoszą się tutaj do sposobu prezentacji ilości energii, a nie do cen lub podatku VAT.
| Logika systemu | Identyfikator | Wartość | Opis |
|---|---|---|---|
| Stan | ELICZNIK.Home.current_day_consumed_gross | liczba [kWh] | Energia pobrana z sieci w bieżącym dniu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.last_day_consumed_gross | liczba [kWh] | Energia pobrana z sieci w poprzednim dniu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.current_day_produced_gross | liczba [kWh] | Energia oddana do sieci w bieżącym dniu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.last_day_produced_gross | liczba [kWh] | Energia oddana do sieci w poprzednim dniu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.current_week_consumed_gross | liczba [kWh] | Energia pobrana z sieci w bieżącym tygodniu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.last_week_consumed_gross | liczba [kWh] | Energia pobrana z sieci w poprzednim tygodniu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.current_week_produced_gross | liczba [kWh] | Energia oddana do sieci w bieżącym tygodniu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.last_week_produced_gross | liczba [kWh] | Energia oddana do sieci w poprzednim tygodniu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.current_month_consumed_gross | liczba [kWh] | Energia pobrana z sieci w bieżącym miesiącu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.last_month_consumed_gross | liczba [kWh] | Energia pobrana z sieci w poprzednim miesiącu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.current_month_produced_gross | liczba [kWh] | Energia oddana do sieci w bieżącym miesiącu, przed zbilansowaniem. |
| Stan | ELICZNIK.Home.last_month_produced_gross | liczba [kWh] | Energia oddana do sieci w poprzednim miesiącu, przed zbilansowaniem. |
Dane dotyczące energii oddanej są dostępne w zakresie udostępnianym przez serwis eLicznik dla danego PPE.
7. Odczyty licznika i daty odczytów #
Kanały meter_consumed i meter_produced zawierają narastające wskazania licznika. Nie są sumami energii za pojedynczy dzień, tydzień ani miesiąc. Przedstawiają ostatni odczyt dostępny w serwisie eLicznik.
| Logika systemu | Identyfikator | Wartość | Opis |
|---|---|---|---|
| Stan | ELICZNIK.Home.meter_consumed | liczba [kWh] | Ostatnie dostępne wskazanie licznika energii pobranej z sieci. |
| Stan | ELICZNIK.Home.meter_consumed_date | data | Data odczytu energii pobranej. |
| Stan | ELICZNIK.Home.meter_produced | liczba [kWh] | Ostatnie dostępne wskazanie licznika energii oddanej do sieci. |
| Stan | ELICZNIK.Home.meter_produced_date | data | Data odczytu energii oddanej. |
Daty są prezentowane w formacie zwracanym przez integrację. Data odczytu licznika nie jest tym samym co moment pobrania danych przez DOMIQ. Przy prezentacji wskazania warto wyświetlać również odpowiadającą mu datę.
8. Przykłady zastosowania #
Wyświetlanie energii pobranej w poprzednim dniu #
Dodaj element typu Tekst w zakładce Remote. W polu Kanał wpisz:
ELICZNIK.Home.last_day_consumed
W etykiecie zastosuj opis „Energia pobrana wczoraj”, a przy wartości uwzględnij jednostkę kWh. Przykładowa odczytana wartość 12.5 oznacza 12,5 kWh energii pobranej w poprzednim dniu po zbilansowaniu.
Wyświetlanie energii oddanej w bieżącym miesiącu #
W polu Kanał elementu prezentującego wartość wpisz:
ELICZNIK.Home.current_month_produced
Przykładowa odczytana wartość 145.8 oznacza 145,8 kWh energii oddanej w bieżącym miesiącu po zbilansowaniu, według danych dostępnych w eLiczniku.
Wyświetlanie wskazania licznika wraz z datą #
Użyj dwóch elementów prezentujących wartości. Do pierwszego przypisz ELICZNIK.Home.meter_consumed, a do drugiego ELICZNIK.Home.meter_consumed_date. Dzięki temu użytkownik zobaczy wskazanie energii pobranej oraz datę, której ono dotyczy