System

A készülék azonosítói, a firmware, az óra, az energiatakarékosság, a jelszó, a HTTPS-tanúsítvány, a hozzáférési tokenek és a visszaállítás.

Device

Magának a példánynak az azonosítói.

Mező	Megjegyzés
Manufacturer	ZiggyMeter
Model	Hardvermodell, például ZG-400
Serial number	Ennek a példánynak az egyedi azonosítója

Software version

Mező	Megjegyzés
Firmware	A futó firmware verziója — lásd: Verziószámozás
Zigbee firmware ID	A Zigbee koordinátornak jelzett build száma

Ezt nézze meg frissítés telepítése vagy a támogatás megkeresése előtt.

Clock

A mérőóra-leolvasások időbélyeget kapnak, ezért az óra számít.

Vezérlő	Jelentés
Synchronized / Not synchronized	Van-e a készüléknek érvényes ideje
Local time	A készülék aktuális ideje a beállított időzónában
Daylight saving	Érvényes-e a nyári időszámítás a kiválasztott időzónában, és mikor vált legközelebb
Set timezone	Az időzóna és a nyári időszámítás szabályának kiválasztása
SYNC TIME	Azonnal beállítja a készülék óráját a böngészője alapján

Hogyan állítható be az óra

Három forrás létezik:

Forrás	Beállítja az időt	Beállítja az időzónát
Zigbee — a koordinátor Time klasztere	Igen	Néha, lásd alább
NTP — Wi-Fin	Igen	Nem
Kézzel — itt a SYNC TIME gombbal, a böngésző órájából	Igen	Választhatóan, lásd alább

Az időzóna magától az időtől független beállítás. Ezen a kártyán a Set timezone kézzel állítja be, bármelyik forrás adja is az időt — így mindig javíthatja vagy felülírhatja.

INFO

Ha a Wi-Fi és a Zigbee is be van kapcsolva, a készülék a Zigbee-t használja, és nem indítja el az NTP-t. Ezután legfeljebb 24 óránként szinkronizál újra — a kvarca naponta kevesebb mint két másodpercet szalad el, így a gyakoribb szinkronizálás nem érne semmit.

TIP

Az első Zigbee-szinkronizáláskor, ha még nincs beállított időzóna, a készülék a koordinátor nyári időszámítási attribútumaiból következteti ki. Nem minden koordinátor teszi közzé őket — a Zigbee2MQTT nem —, ezért az időzónát így is előfordulhat, hogy kézzel kell beállítani.

INFO

Az óra nem rendelkezik tartalék elemmel: bekapcsoláskor és áramkimaradás után elveszik, és amíg nem állítják be, az időbélyegek 1970-től indulnak. A mélyalvás nem törli, így az elemes készülék a leolvasások között megtartja a helyes időt.

Upgrade

Vezérlő	Hatás
CHECK FOR UPDATES	Újabb firmware-t keres az interneten
UPGRADE FROM WEB	Letölti és telepíti
UPGRADE FROM FILE	Telepít egy .ota fájlt a számítógépéről

TIP

A frissítések ellenőrzéséhez csak a böngészőjének kell internetelérés — magának a ZiggyMeternek nem kell kijutnia az internetre.

A készülék a sikeres frissítés után újraindul. A teljes eljárás és az egyes hibák jelentése: Firmware-frissítés.

Power saving mode

Meghatározza, hogy a készülék alszik-e a leolvasások között.

Mód	Működés
Auto	Alapértelmezett. Elemről energiát takarít meg, USB-n vagy hálózatról teljes teljesítménnyel működik.
Always	Mindig energiát takarít meg, USB-n is. Power bank használatakor hasznos.
Never	Soha nem alszik. A készülék folyamatosan válaszkész, de az elemeket nagyon gyorsan lemeríti.

Lásd: Tápellátás és elemek.

Change password

1. Írja be az aktuális rendszergazdai jelszót.
2. Írja be az új jelszót, majd ismételje meg a megerősítéshez.
3. Válassza a CHANGE PASSWORD gombot.

Elfelejtette? A gyári visszaállítás az egyetlen út vissza.

HTTPS certificate

Az a tanúsítvány, amelyet a készülék felmutat, amikor HTTPS-en keresztül megnyitja a webes felületét. Minden készülék gyári tanúsítvánnyal érkezik; ezt lecserélheti a sajátjára — például az otthoni hitelesítésszolgáltatója (CA) által kiadottra, így a böngésző többé nem figyelmeztet a kapcsolat miatt.

Mező	Jelentés
Factory / Custom	Melyik tanúsítvány van telepítve
Valid until	Az érvényességi idő vége, alatta a kezdő dátummal — vagy Expired
Key	A kulcs típusa és mérete, például EC 256, valamint a láncban lévő tanúsítványok száma
Subject / Issuer	Kinek állították ki a tanúsítványt, és ki állította ki

Gomb	Hatás
UPLOAD	Telepíti a saját tanúsítványát, majd újraindul
RESTORE FACTORY	Visszahelyezi a gyári tanúsítványt, majd újraindul. Csak akkor érhető el, ha saját tanúsítvány van telepítve.

Saját tanúsítvány telepítése

1. Készítse elő a tanúsítványláncot — elöl a szervertanúsítvánnyal, utána az esetleges köztes tanúsítványokkal — és a hozzá tartozó privát kulcsot, PEM formátumban. Egyesítse őket egy fájlba, vagy hagyja őket két külön fájlban, és jelölje ki mindkettőt egyszerre.
2. Válassza az UPLOAD gombot, válassza ki a fájlt vagy a fájlokat, és erősítse meg.
3. A készülék ellenőrzi a tanúsítványt, telepíti, majd újraindul. Amikor ismét elérhető, töltse újra az oldalt.

Követelmények:

Formátum	PEM szöveg, a lánc és a kulcs együtt legfeljebb 12 KiB
Privát kulcs	Titkosítatlan, és a szervertanúsítványhoz tartozik. A jelszóval védett kulcsokat a készülék elutasítja.
Kulcstípus	EC vagy RSA. Erősen ajánlott az EC prime256v1 — ezt a készülék hardveresen gyorsítja.
Kulcshasználat	Ha a tanúsítvány korlátozza a felhasználását, engedélyeznie kell a digitális aláírást és a TLS-szerverhitelesítést
Név	A Subject Alternative Name mezőben szerepeljen az a név, amelyen a készüléket eléri — ZiggyMeter-XXXX, az IP-címe vagy mindkettő —, különben a böngésző továbbra is figyelmeztet

A készülék nem ellenőrzi az érvényességi időt, így olyan tanúsítványt is telepít, amely már lejárt, vagy még nem érvényes. Figyelje a Valid until mezőt, és cserélje le időben a tanúsítványt.

INFO

A feltöltéshez HTTPS szükséges. A fájl privát kulcsot tartalmaz, ezért a készülék nem fogadja el a hozzáférési pont módban használt titkosítatlan HTTP-n keresztül. Előbb csatlakoztassa a készüléket a Wi-Fi hálózatához.

Ha a készülék elutasítja a fájlt, semmi sem változik, és megjelenik az ok — például Private key does not match the (first) certificate. Ha egy telepített tanúsítvány valaha olvashatatlanná válik, a készülék a következő indításkor visszaállítja a gyárit.

TIP

A gyári tanúsítvány soha nem íródik felül, így mindig visszaállítható. A gyári visszaállítás a saját tanúsítványt is eltávolítja — utána töltse fel újra.

Long-lived access tokens

Tokenek a REST API-t használó szkriptek és integrációk számára. A szokásos bejelentkezési token 30 perc után lejár; ezek soha nem járnak le, így egy program úgy használhat egyet, hogy nem kell kezelnie a jelszót, és újra bejelentkeznie sem kell.

A kártya név és létrehozási dátum szerint sorolja fel a meglévő tokeneket. Egyszerre legfeljebb három token létezhet.

Token létrehozása

1. Válassza a CREATE TOKEN gombot.
2. Adjon meg egy nevet, amelyből kiderül, hol használja a tokent — legfeljebb 32 karakter: latin betűk, számjegyek és írásjelek.
3. Válassza a CREATE gombot.
4. Most másolja ki a tokent. Csak egyszer jelenik meg.

WARNING

A készülék csak a token hash-ét tárolja, magát a tokent soha. A párbeszédablak bezárása után többé nem jeleníthető meg. Ha elveszíti, vonja vissza, és hozzon létre újat.

Küldje el a tokent minden API-kéréssel, pontosan úgy, mint egy bejelentkezési tokent:

Authorization: Bearer <token>

A hosszú élettartamú token ugyanolyan hozzáférést ad az API-hoz, mint egy bejelentkezett rendszergazda — őrizze olyan gondosan, mint a jelszót.

Token visszavonása

Válassza a token melletti kuka ikont, és erősítse meg. Minden, ami ezt a tokent használja, azonnal elveszíti a hozzáférést. Ha hosszú élettartamú tokennel jelentkezik ki, az nem vonja vissza a tokent.

A gyári visszaállítás minden tokent töröl. A jelszó módosítása nem.

Meter simulator

A valódi mérőóra-kommunikációt IEC 62056-21 protokollal előállított adatokra váltja. Azért van, hogy a készülék többi részét — a hálózatot, a Home Assistantot, a Zigbee-t és az API-t — mérőóra nélkül is tesztelni lehessen.

WARNING

A bekapcsolt szimulátorral keletkezett értékek nem valódiak. Kapcsolja ki, mielőtt bármilyen következtetést von le az energiafelhasználásáról.

Diagnostic

Támogatási esetekhez.

Vezérlő	Hatás
DOWNLOAD	Titkosított diagnosztikai jelentést ment le a készülékről
Log meter transmission	A mérőórával folytatott nyers optikai kommunikációt kiírja az USB soros konzolra

WARNING

Ez két különböző dolog. A mérőóra-kommunikáció naplója nem része a diagnosztikai jelentésnek — a soros konzolra kerül, így a rögzítéséhez USB-C kábel és terminálprogram szükséges.

Küldje el a jelentést a támogatásnak. Mérőóra-probléma esetén rögzítse a naplót is — lásd: Diagnosztikai adatok gyűjtése.

Device reset

Gomb	Hatás
REBOOT	Újraindítja a készüléket. A beállítások megmaradnak.
FACTORY RESET	Visszaállítja a gyári értékeket: törli a Wi-Fi hozzáférési adatokat, eltávolítja a Zigbee-párosítást, visszaállítja a rendszergazdai jelszót, törli a hozzáférési tokeneket, és visszahelyezi a gyári HTTPS-tanúsítványt. A firmware-t nem érinti.

WARNING

A gyári visszaállítás minden meglévő kapcsolatot megszakít. A készülék utána csak a saját hozzáférési pontján lesz elérhető.

Megfelelő API-végpontok

Szakasz	Végpontok
Device, Software version	/system/version
Clock	/system/clock, /system/timezone
Upgrade	/system/ota
Power saving	/system/power_mode
Change password	/system/password
HTTPS certificate	/system/certificate, /system/certificate/reset
Long-lived access tokens	/system/tokens
Device reset	/system/reboot, /system/factory_reset
Diagnostic	/system/diagnostic
Meter simulator	/iec62056/control