Odczyty licznika
Odczyt to jedna pełna komunikacja z licznikiem. ZiggyMeter otwiera łącze optyczne, identyfikuje licznik, zbiera każdy punkt danych, który ma pobrać, zamyka łącze i publikuje wynik.
Nic nie jest przesyłane w sposób ciągły — licznik jest odpytywany, a to, co widzisz, jest zawsze wynikiem ostatniego odczytu.
Co wyzwala odczyt
| Wyzwalacz | Gdzie |
|---|---|
| Harmonogram | Automatycznie, patrz niżej |
| Przycisk | Pojedyncze krótkie kliknięcie |
| Interfejs webowy | Licznik → Odczyt → |
| API REST | GET /api/v1/iec62056/read |
| Zigbee | Przełącznik On/Off na punkcie końcowym 2 |
Harmonogram
Ustawisz go w Licznik → Harmonogram. Harmonogram ma trzy części: jednostkę okresu, okres i czas wyzwolenia, określający, w którym miejscu okresu urządzenie ma wykonać odczyt.
| Jednostka | Dostępne okresy | Używane pola czasu |
|---|---|---|
| Min | 1, 5, 10, 15, 30 | brak — odczytuje co n minut |
| Godzina | 1, 2, 4, 8, 12 | minuta w obrębie godziny |
| Dzień | 1, 7, 14, 28 | godzina i minuta |
| Miesiąc | 1, 2, 3, 6 | dzień miesiąca (1–28), godzina i minuta |
Przykład: jednostka godzina, okres 4, minuta wyzwolenia 0 daje odczyty o 00:00, 04:00, 08:00 i tak dalej. Jednostka miesiąc, okres 1, dzień 1, czas 06:00 daje jeden odczyt miesięcznie, pierwszego dnia o szóstej rano.
INFO
Dzień miesiąca jest ograniczony do 1–28, żeby harmonogram miesięczny zadziałał w każdym miesiącu, również w lutym.
Wybór częstotliwości
Kompromis to rozdzielczość kontra zużycie energii.
| Sytuacja | Sugerowany punkt wyjścia |
|---|---|
| Zasilanie z USB-C lub z sieci | 1 godzina |
| Praca na bateriach przez Zigbee | 24 godziny |
| Pierwsza konfiguracja lub diagnostyka | 1 minuta, potem zmniejsz, gdy zadziała |
Każdy odczyt budzi układ radiowy, więc na bateriach częstotliwość odczytów jest głównym czynnikiem decydującym o trwałości ogniw. Zobacz Zasilanie i baterie.
WARNING
Harmonogram co minutę na bateriach szybko rozładuje parę ogniw AAA. Użyj go, żeby udowodnić, że łącze optyczne działa, a potem ustaw realistyczny okres.
Co zawiera odczyt
Każda wartość jest opatrzona kodem OBIS — standardowym identyfikatorem stosowanym w europejskiej metrologii. Typowy odczyt jednofazowy wygląda tak:
| OBIS | Znaczenie | Przykład |
|---|---|---|
1-0:1.8.0 | Energia czynna pobrana, sumarycznie (import) | 4244,88 kWh |
1-0:2.8.0 | Energia czynna oddana, sumarycznie (eksport) | 4134,77 kWh |
1-0:1.7.0 | Chwilowa moc czynna pobierana | 0,076 kW |
1-0:11.7.0 | Prąd chwilowy | 0,324 A |
1-0:12.7.0 | Napięcie chwilowe | 234,98 V |
To, które kody się pojawią, zależy wyłącznie od Twojego licznika i od tego, jak skonfigurował go dostawca. Kody kończące się na .8.1 i .8.2 to rejestry taryfowe (dzień/noc). Wartości mogą zawierać oznaczenie okresu rozliczeniowego, takie jak *101.
Strona Licznik → Odczyt pokazuje wartość surową, sparsowaną liczbę z jednostką oraz opis w języku interfejsu.
Dokąd trafiają odczyty
| Cel | Zachowanie |
|---|---|
| Interfejs webowy | Ostatni odczyt, trzymany w pamięci urządzenia |
| API REST | /iec62056/last zwraca te same dane bez ponownego odczytu |
| Home Assistant | Wysyłane do API REST Home Assistant po każdym odczycie |
| Zigbee | Mapowane na atrybuty ZCL i raportowane do koordynatora |
INFO
Odczyty nie są zapisywane w urządzeniu. ZiggyMeter przechowuje wyłącznie ostatni odczyt. Historia długoterminowa należy do tego, co konsumuje dane — Home Assistant, InfluxDB, Twoja własna baza.
Mapowanie Zigbee
Na potrzeby Zigbee każdy kod OBIS jest mapowany na klaster i atrybut ZCL. Ustawienia domyślne obejmują najczęstsze kody:
| OBIS | Klaster / atrybut | Znaczenie |
|---|---|---|
1-0:1.8.0 | 0x0702 / 0x0000 | Current summation delivered |
1-0:2.8.0 | 0x0702 / 0x0001 | Current summation received |
1-0:1.7.0 | 0x0B04 / 0x050B | Moc czynna, faza A |
1-0:11.7.0 | 0x0B04 / 0x0508 | Prąd skuteczny, faza A |
1-0:12.7.0 | 0x0B04 / 0x0505 | Napięcie skuteczne, faza A |
Aby coś zmienić, kliknij dwukrotnie komórkę Mapowanie w danym wierszu w Licznik → Odczyt i wybierz inny cel z listy rozwijanej. Zapisuje się natychmiast.
Dostępne cele i wariant przez API opisuje Integracje → Zigbee.
Zegar
Każdy odczyt dostaje znacznik czasu. Zegar jest ustawiany z jednego z trzech źródeł — klastra Time w Zigbee, NTP przez Wi-Fi albo ręcznie z przeglądarki — przy czym Zigbee ma pierwszeństwo, gdy oba układy radiowe są włączone. Ustaw strefę czasową w System → Zegar, aby lokalne znaczniki czasu były poprawne; zobacz jak ustawiany jest zegar.
Zegar nie ma podtrzymania bateryjnego, więc jest tracony przy włączeniu zasilania i po zaniku prądu. Głęboki sen go nie traci: urządzenie na bateriach zachowuje poprawny czas między odczytami.
Dopóki zegar nie jest poprawny, znaczniki czasu zaczynają się od 1970 — to przydatny sygnał w logu szeregowym, że nie został jeszcze ustawiony.