Letture del contatore
Una lettura è una conversazione completa con il contatore. ZiggyMeter apre il collegamento ottico, identifica il contatore, raccoglie tutti i dati che è configurato a richiedere, chiude il collegamento e pubblica il risultato.
Nulla viene trasmesso in continuo: il contatore viene interrogato, e ciò che vedi è sempre il risultato dell'ultima lettura.
Cosa avvia una lettura
| Avvio | Dove |
|---|---|
| Pianificazione | Automatica, vedi sotto |
| Pulsante | Una singola pressione breve |
| Interfaccia web | Contatore → Letture → |
| REST API | GET /api/v1/iec62056/read |
| Zigbee | Interruttore On/Off sull'endpoint 2 |
Pianificazione
Si configura in Meter → Schedule. Una pianificazione ha tre parti: un'unità, un periodo e un orario di avvio che indica al dispositivo in quale punto del periodo leggere.
| Unità | Periodi disponibili | Campi orari usati |
|---|---|---|
| Minuti | 1, 5, 10, 15, 30 | nessuno — legge ogni n minuti |
| Ore | 1, 2, 4, 8, 12 | minuto all'interno dell'ora |
| Giorni | 1, 7, 14, 28 | ora e minuto |
| Mesi | 1, 2, 3, 6 | giorno del mese (1–28), ora e minuto |
Per esempio: unità ore, periodo 4, minuto di avvio 0 legge alle 00:00, 04:00, 08:00 e così via. Unità mesi, periodo 1, giorno 1, ora 06:00 legge una volta al mese, il primo giorno alle sei del mattino.
INFO
Il giorno del mese è limitato a 1–28, così una pianificazione mensile scatta in ogni mese, febbraio compreso.
Scegliere la frequenza
Il compromesso è tra risoluzione e consumo.
| Situazione | Punto di partenza consigliato |
|---|---|
| Alimentazione da USB-C o da rete | 1 ora |
| Funzionamento a batterie tramite Zigbee | 24 ore |
| Prima configurazione o risoluzione di problemi | 1 minuto, da ridurre quando funziona |
Ogni lettura risveglia la radio, quindi a batterie la frequenza delle letture è il fattore principale della durata delle pile. Vedi Alimentazione e batterie.
WARNING
Una pianificazione al minuto a batterie scarica rapidamente una coppia di pile AAA. Usala per verificare che il collegamento ottico funzioni, poi imposta un periodo realistico.
Cosa contiene una lettura
Ogni valore è contrassegnato da un codice OBIS, l'identificativo standard usato in tutta la metrologia europea. Una tipica lettura monofase si presenta così:
| OBIS | Significato | Esempio |
|---|---|---|
1-0:1.8.0 | Energia attiva prelevata, totale | 4244,88 kWh |
1-0:2.8.0 | Energia attiva immessa, totale | 4134,77 kWh |
1-0:1.7.0 | Potenza attiva prelevata istantanea | 0,076 kW |
1-0:11.7.0 | Corrente istantanea | 0,324 A |
1-0:12.7.0 | Tensione istantanea | 234,98 V |
Quali codici compaiono dipende interamente dal tuo contatore e da come l'ha configurato il distributore. I codici che terminano in .8.1 e .8.2 sono registri tariffari (fasce orarie). I valori possono includere un indicatore del periodo di fatturazione come *101.
La pagina Meter → Readings mostra il valore grezzo, il numero interpretato con la sua unità e una descrizione nella lingua dell'interfaccia.
Dove vanno le letture
| Destinazione | Comportamento |
|---|---|
| Interfaccia web | Ultima lettura, conservata nella memoria del dispositivo |
| REST API | /iec62056/last restituisce gli stessi dati senza leggere di nuovo |
| Home Assistant | Inviate alla REST API di Home Assistant dopo ogni lettura |
| Zigbee | Mappate su attributi ZCL e riportate al coordinatore |
INFO
Le letture non vengono archiviate sul dispositivo. ZiggyMeter conserva solo l'ultima lettura. Lo storico a lungo termine appartiene al sistema che riceve i dati — Home Assistant, InfluxDB, il tuo database.
Mappatura Zigbee
Per Zigbee, ogni codice OBIS è mappato su un cluster e un attributo ZCL. I valori predefiniti coprono i codici più comuni:
| OBIS | Cluster / attributo | Significato |
|---|---|---|
1-0:1.8.0 | 0x0702 / 0x0000 | Energia totale prelevata dalla rete |
1-0:2.8.0 | 0x0702 / 0x0001 | Energia totale immessa in rete |
1-0:1.7.0 | 0x0B04 / 0x050B | Potenza attiva, fase A |
1-0:11.7.0 | 0x0B04 / 0x0508 | Corrente efficace, fase A |
1-0:12.7.0 | 0x0B04 / 0x0505 | Tensione efficace, fase A |
Per cambiarne una, fai doppio clic sulla cella Mapping della riga in Meter → Readings e scegli un'altra destinazione dall'elenco a discesa. Il salvataggio è immediato.
Le destinazioni disponibili e l'alternativa tramite API sono in Integrazioni → Zigbee.
L'orologio
Ogni lettura riceve un'indicazione oraria. L'orologio viene impostato da una di tre fonti — il cluster Time di Zigbee, NTP via Wi-Fi, oppure manualmente dal browser — e Zigbee ha la precedenza quando entrambe le radio sono attive. Imposta il fuso orario in System → Clock perché gli orari locali siano corretti; vedi come viene impostato l'orologio.
L'orologio non è alimentato a batteria, quindi si perde all'accensione e dopo un'interruzione di corrente. La sospensione profonda non lo cancella: un dispositivo a batterie mantiene l'ora esatta tra una lettura e l'altra.
Finché l'orologio non è valido, le indicazioni orarie partono dal 1970 — un segnale utile nel log seriale che non è ancora stato impostato.