System

Identità del dispositivo, firmware, orologio, risparmio energetico, password, certificato HTTPS, token di accesso e reset.

Device

Identificazione dell'esemplare.

Campo	Note
Manufacturer	ZiggyMeter
Model	Modello hardware, per es. ZG-400
Serial Number	Identificativo univoco di questo esemplare

Software Version

Campo	Note
Firmware	La versione del firmware in esecuzione — vedi Numerazione delle versioni
Zigbee Firmware ID	Il numero di build comunicato al coordinatore Zigbee

Controllala prima di applicare un aggiornamento o di chiedere assistenza.

Clock

Le letture del contatore hanno un'indicazione oraria, quindi l'orologio conta.

Controllo	Significato
Sincronizzato / Non sincronizzato	Se il dispositivo ha un orario valido
Local Time	Ora attuale del dispositivo nel fuso orario configurato
Daylight Saving	Se al fuso scelto si applica l'ora legale, e quando cambierà la prossima volta
Set timezone	Scegli il fuso orario e la sua regola per l'ora legale
SYNC TIME	Imposta subito l'orologio del dispositivo in base al browser

Come viene impostato l'orologio

Ci sono tre fonti:

Fonte	Imposta l'ora	Imposta il fuso orario
Zigbee — il cluster Time sul coordinatore	Sì	A volte, vedi sotto
NTP — via Wi-Fi	Sì	No
Manualmente — SYNC TIME qui, dall'orologio del browser	Sì	Facoltativo, vedi sotto

Il fuso orario è un'impostazione separata dall'ora stessa. Set timezone in questa scheda lo imposta a mano, qualunque sia la fonte dell'ora — così puoi sempre correggerlo o sovrascriverlo.

INFO

Con Wi-Fi e Zigbee entrambi attivi, si usa Zigbee e NTP non viene avviato. In seguito il dispositivo si risincronizza al massimo una volta ogni 24 ore — il suo quarzo deriva di meno di due secondi al giorno, quindi sincronizzarlo più spesso non servirebbe a nulla.

TIP

Alla prima sincronizzazione Zigbee, se non è configurato alcun fuso orario, il dispositivo lo ricava dagli attributi dell'ora legale del coordinatore. Non tutti i coordinatori li pubblicano — Zigbee2MQTT no — quindi potresti comunque doverlo impostare a mano.

INFO

L'orologio non è alimentato a batteria: si perde all'accensione e dopo un'interruzione di corrente, e finché non viene impostato le indicazioni orarie partono dal 1970. La sospensione profonda non lo cancella, quindi un dispositivo a batterie mantiene l'ora esatta tra una lettura e l'altra.

Upgrade

Controllo	Effetto
CHECK FOR UPDATES	Cerca online un firmware più recente
UPGRADE FROM WEB	Lo scarica e lo installa
UPGRADE FROM FILE	Installa un file .ota dal tuo computer

TIP

Per cercare gli aggiornamenti solo il tuo browser ha bisogno di internet — ZiggyMeter non deve raggiungere internet.

Dopo un aggiornamento riuscito il dispositivo si riavvia. Procedura completa e significato di ciascun errore: Aggiornamento del firmware.

Power Saving Mode

Stabilisce se il dispositivo dorme tra una lettura e l'altra.

Modalità	Comportamento
Auto	Predefinita. Risparmia energia a batterie, prestazioni piene su USB o da rete.
Always	Risparmia sempre energia, anche su USB. Utile con un power bank.
Never	Non dorme mai. Il dispositivo resta reattivo ma scarica le batterie molto in fretta.

Vedi Alimentazione e batterie.

Change Admin Password

1. Inserisci la password di amministratore attuale.
2. Inserisci la nuova password e ripetila per conferma.
3. Seleziona CHANGE PASSWORD.

L'hai dimenticata? Un ripristino delle impostazioni di fabbrica è l'unico modo per rientrare.

HTTPS Certificate

Il certificato che il dispositivo presenta quando apri la sua interfaccia web via HTTPS. Ogni dispositivo esce di fabbrica con un proprio certificato; puoi sostituirlo con uno tuo — per esempio uno emesso dalla CA di casa, così il browser smette di segnalare la connessione come non sicura.

Campo	Significato
Factory / Custom	Quale certificato è installato
Valid Until	Fine del periodo di validità, con la data di inizio sotto — oppure Expired
Key	Tipo e dimensione della chiave, per es. EC 256, e il numero di certificati nella catena
Subject / Issuer	A chi è stato rilasciato il certificato, e da chi

Pulsante	Effetto
UPLOAD	Installa il tuo certificato e riavvia il dispositivo
RESTORE FACTORY	Rimette il certificato di fabbrica e riavvia il dispositivo. Disponibile solo quando è installato un certificato personalizzato.

Installare un certificato proprio

1. Prepara la catena di certificati — prima il certificato del server, poi gli eventuali intermedi — e la relativa chiave privata, in formato PEM. Puoi unirli in un unico file, oppure tenerli in due file e selezionarli entrambi insieme.
2. Seleziona UPLOAD, scegli il file o i file e conferma.
3. Il dispositivo verifica il certificato, lo installa e si riavvia. Quando è di nuovo raggiungibile, ricarica la pagina.

Requisiti:

Formato	Testo PEM, al massimo 12 KiB in tutto tra catena e chiave
Chiave privata	Non cifrata e corrispondente al certificato del server. Le chiavi protette da password vengono rifiutate.
Tipo di chiave	EC o RSA. EC prime256v1 è fortemente consigliata — il dispositivo la accelera in hardware.
Utilizzo della chiave	Se il certificato ne limita l'utilizzo, deve consentire firma digitale e autenticazione server TLS
Nome	Includi nel Subject Alternative Name il nome con cui raggiungi il dispositivo — ZiggyMeter-XXXX, il suo indirizzo IP o entrambi — altrimenti il browser continuerà a mostrare l'avviso

Il dispositivo non controlla il periodo di validità, quindi installa anche un certificato già scaduto o non ancora valido. Tieni d'occhio il campo Valid Until e sostituisci il certificato per tempo.

INFO

Il caricamento richiede HTTPS. Il file contiene una chiave privata, quindi il dispositivo lo rifiuta attraverso il semplice HTTP usato in modalità punto di accesso. Collega prima il dispositivo alla tua rete Wi-Fi.

Se il dispositivo rifiuta il file, non viene modificato nulla e ne viene mostrato il motivo — per esempio Private key does not match the (first) certificate. Se un certificato installato dovesse diventare illeggibile, al successivo avvio il dispositivo ripristina quello di fabbrica.

TIP

Il certificato di fabbrica non viene mai sovrascritto, quindi si può sempre ripristinare. Anche un ripristino delle impostazioni di fabbrica rimuove un certificato personalizzato — dopo dovrai caricarlo di nuovo.

Long-Lived Access Tokens

Token per script e integrazioni che usano la REST API. Un normale token di login scade dopo 30 minuti; questi invece non scadono mai, quindi un programma può usarne uno senza gestire la password né ripetere il login.

La scheda elenca i token esistenti con nome e data di creazione. Possono esistere al massimo tre token alla volta.

Creare un token

1. Seleziona CREATE TOKEN.
2. Inserisci un nome che ti ricordi dove viene usato il token — fino a 32 caratteri tra lettere latine, cifre e segni di punteggiatura.
3. Seleziona CREATE.
4. Copia subito il token. Viene mostrato una sola volta.

WARNING

Il dispositivo conserva solo un hash del token, mai il token stesso. Una volta chiusa la finestra di dialogo non è più possibile visualizzarlo. Se lo perdi, revocalo e creane uno nuovo.

Invia il token con ogni richiesta API, esattamente come un token di login:

Authorization: Bearer <token>

Un token a lunga durata concede lo stesso accesso all'API di un amministratore che ha effettuato il login — custodiscilo con la stessa cura della password.

Revocare un token

Seleziona l'icona del cestino accanto al token e conferma. Qualunque cosa usi quel token perde subito l'accesso. Effettuare il logout con un token a lunga durata non lo revoca.

Un ripristino delle impostazioni di fabbrica elimina tutti i token. Il cambio della password no.

Meter Simulator

Sostituisce la comunicazione reale con il contatore con dati generati secondo il protocollo IEC 62056-21. Esiste per poter provare il resto del dispositivo — rete, Home Assistant, Zigbee, API — senza un contatore collegato.

WARNING

I valori prodotti con il simulatore attivo non sono reali. Disattivalo prima di trarre qualsiasi conclusione sui tuoi consumi.

Diagnostic

Per le richieste di assistenza.

Controllo	Effetto
DOWNLOAD	Salva un rapporto diagnostico cifrato dal dispositivo
Log meter transmission	Stampa la conversazione ottica grezza con il contatore sulla console seriale USB

WARNING

Sono due cose separate. Il log della trasmissione con il contatore non è incluso nel rapporto diagnostico — va sulla console seriale, quindi per catturarlo servono un cavo USB-C e un terminale.

Invia il rapporto all'assistenza. Per un problema con il contatore, cattura anche il log — vedi Raccogliere i dati di diagnostica.

Device Reset

Pulsante	Effetto
REBOOT	Riavvia il dispositivo. La configurazione viene mantenuta.
FACTORY RESET	Ripristina le impostazioni di fabbrica: cancella le credenziali Wi-Fi, rimuove l'associazione Zigbee, reimposta la password di amministratore, elimina i token di accesso e ripristina il certificato HTTPS di fabbrica. Il firmware non viene toccato.

WARNING

Un ripristino di fabbrica interrompe ogni connessione esistente. Il dispositivo torna a essere raggiungibile solo attraverso il proprio punto di accesso.

Equivalenti API

Sezione	Endpoint
Device, Software Version	/system/version
Clock	/system/clock, /system/timezone
Upgrade	/system/ota
Power Saving Mode	/system/power_mode
Change Admin 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