Mittarilukemat
Lukema on yksi täydellinen keskustelu mittarin kanssa. ZiggyMeter avaa optisen yhteyden, tunnistaa mittarin, kerää kaikki tiedot, joita se on määritetty pyytämään, sulkee yhteyden ja julkaisee tuloksen.
Mitään ei lähetetä jatkuvana virtana — mittarilta kysytään, ja näkemäsi on aina viimeisimmän lukukerran tulos.
Mikä käynnistää lukemisen
| Käynnistäjä | Missä |
|---|---|
| Aikataulu | Automaattisesti, katso alta |
| Painike | Yksi lyhyt napautus |
| Verkkokäyttöliittymä | Meter → Readings → |
| REST API | GET /api/v1/iec62056/read |
| Zigbee | On/Off-kytkin päätepisteessä 2 |
Aikataulu
Aikataulu määritetään kohdassa Meter → Schedule. Siinä on kolme osaa: yksikkö, jakso ja ajankohta, joka määrittää, milloin jakson aikana lukeminen suoritetaan.
| Yksikkö | Käytettävissä olevat jaksot | Käytetyt aikakentät |
|---|---|---|
| Minuutit | 1, 5, 10, 15, 30 | ei mitään — lukee n minuutin välein |
| Tunnit | 1, 2, 4, 8, 12 | minuutti tunnin sisällä |
| Päivät | 1, 7, 14, 28 | tunti ja minuutti |
| Kuukaudet | 1, 2, 3, 6 | kuukaudenpäivä (1–28), tunti ja minuutti |
Esimerkiksi: yksikkö tunnit, jakso 4 ja minuutti 0 lukee kello 00:00, 04:00, 08:00 ja niin edelleen. Yksikkö kuukaudet, jakso 1, päivä 1 ja aika 06:00 lukee kerran kuukaudessa, 1. päivänä kello kuusi aamulla.
INFO
Kuukaudenpäivä on rajattu väliin 1–28, jotta kuukausittainen aikataulu toteutuu joka kuukausi, myös helmikuussa.
Lukutiheyden valinta
Kyse on tarkkuuden ja virrankulutuksen välisestä tasapainosta.
| Tilanne | Ehdotettu lähtökohta |
|---|---|
| Virta USB-C:stä tai verkkovirrasta | 1 tunti |
| Paristokäyttö Zigbeen yli | 24 tuntia |
| Ensimmäinen käyttöönotto tai vianetsintä | 1 minuutti, ja harvennus sen jälkeen kun kaikki toimii |
Jokainen lukukerta herättää radion, joten paristokäytössä lukutiheys ratkaisee eniten paristojen keston. Katso Virransyöttö ja paristot.
WARNING
Minuutin välein tapahtuva lukeminen tyhjentää AAA-paristoparin nopeasti. Käytä sitä optisen yhteyden varmistamiseen ja aseta sen jälkeen realistinen jakso.
Mitä lukema sisältää
Jokainen arvo on merkitty OBIS-koodilla — vakiotunnisteella, jota käytetään kaikkialla eurooppalaisessa energiamittauksessa. Tyypillinen yksivaiheinen lukema näyttää tältä:
| OBIS | Merkitys | Esimerkki |
|---|---|---|
1-0:1.8.0 | Pätöenergia verkosta otettuna, yhteensä | 4244,88 kWh |
1-0:2.8.0 | Pätöenergia verkkoon syötettynä, yhteensä | 4134,77 kWh |
1-0:1.7.0 | Hetkellinen otettu pätöteho | 0,076 kW |
1-0:11.7.0 | Hetkellinen virta | 0,324 A |
1-0:12.7.0 | Hetkellinen jännite | 234,98 V |
Se, mitkä koodit näkyvät, riippuu täysin mittaristasi ja siitä, miten verkkoyhtiö on sen määrittänyt. Koodit, jotka päättyvät .8.1- ja .8.2-osaan, ovat tariffirekistereitä (päivä/yö). Arvoissa voi olla laskutuskauden merkintä, kuten *101.
Sivu Meter → Readings näyttää raaka-arvon, tulkitun luvun ja yksikön sekä kuvauksen käyttöliittymän kielellä.

Minne lukemat menevät
| Kohde | Toiminta |
|---|---|
| Verkkokäyttöliittymä | Viimeisin lukema laitteen muistissa |
| REST API | /iec62056/last palauttaa samat tiedot lukematta uudelleen |
| Home Assistant | Lähetetään Home Assistantin REST-rajapintaan jokaisen lukukerran jälkeen |
| Zigbee | Kytketään ZCL-määritteisiin ja raportoidaan koordinaattorille |
INFO
Lukemia ei tallenneta laitteeseen. ZiggyMeter säilyttää vain viimeisimmän lukeman. Pitkän aikavälin historia kuuluu sinne, missä tietoja käytetään — Home Assistantiin, InfluxDB:hen tai omaan tietokantaasi.
Zigbee-kytkennät
Zigbeetä varten jokainen OBIS-koodi kytketään ZCL-klusteriin ja -määritteeseen. Oletusarvot kattavat yleisimmät koodit:
| OBIS | Klusteri / määrite | Merkitys |
|---|---|---|
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 | Active power, vaihe A |
1-0:11.7.0 | 0x0B04 / 0x0508 | RMS current, vaihe A |
1-0:12.7.0 | 0x0B04 / 0x0505 | RMS voltage, vaihe A |
Kytkennän vaihtaminen onnistuu kaksoisnapsauttamalla rivin Mapping-solua sivulla Meter → Readings ja valitsemalla toinen kohde avautuvasta luettelosta. Muutos tallentuu heti.
Katso Integraatiot → Zigbee, mitkä kohteet ovat käytettävissä ja miten sama onnistuu rajapinnan kautta.
Kello
Jokainen lukema saa aikaleiman. Kello asetetaan yhdestä kolmesta lähteestä — Zigbeen Time-klusterista, NTP:stä Wi-Fin yli tai käsin selaimestasi — ja Zigbee on ensisijainen, kun molemmat radiot ovat käytössä. Aseta aikavyöhyke kohdassa System → Clock, jotta paikalliset aikaleimat ovat oikein; katso miten kello asetetaan.
Kellossa ei ole paristovarmennusta, joten se nollautuu virran kytkemisen yhteydessä ja sähkökatkon jälkeen. Syväuni ei nollaa sitä: paristokäyttöinen laite säilyttää oikean ajan lukemien välillä.
Kunnes kello on kelvollinen, aikaleimat alkavat vuodesta 1970 — hyödyllinen merkki sarjalokissa siitä, ettei kelloa ole vielä asetettu.