05 · Interrogazione in tempo reale
Come leggere i valori live da un modulo STD senza perdere o contare due volte una finestra. Dettaglio a livello di registro: Modello di misura ed energia e Uscita data-ready ed eventi.
La finestra di misura
I campioni si aggregano in finestre di cicli di rete interi vicini a 100 ms — 5 cicli a 50 Hz, 6 a 60 Hz. Ogni finestra conclusa viene pubblicata in modo atomico come istantanea completa (tutti i canali e i totali), e WIN_SEQ (0x0016) avanza di esattamente 1. Ciò corrisponde a circa dieci istantanee al secondo. Interrogare più velocemente restituisce gli stessi dati.
Senza rete il modulo continua a pubblicare su un ciclo di riserva più lento (500 ms) che aggiorna stato e orologio; su quel ciclo WIN_SEQ avanza ma non c'è alcun impulso DRDY.
Opzione 1 — interrogare WIN_SEQ
- Leggere
WIN_SEQ. Se non è cambiato dall'ultima lettura, non c'è nessuno snapshot nuovo. - Se è cambiato, leggere i blocchi necessari — una transazione per blocco, fino a 128 byte; i campi in una transazione provengono da una sola pubblicazione e non possono essere spezzati.
Opzione 2 — reagire al fronte di DRDY
DRDY è un'uscita open-drain senza pull-up sul modulo; quando si usa DRDY, montare un pull-up lato master — si consigliano 10 kΩ verso l'alimentazione logica a 3.3 V del master. A riposo è alta e produce un impulso basso di ~10 µs per ogni nuova finestra, dopo che i registri sono stati aggiornati — una lettura attivata dal fronte di discesa vede sempre lo snapshot aggiornato.
- A ogni fronte servito, verificare che
WIN_SEQsia avanzato di esattamente 1; un passo maggiore indica fronti persi. - Modalità allarme: un bit di evento impostato sia in
EVENT_FLAGSsia inEVENT_MASKtiene DRDY basso finché il flag non viene azzerato o smascherato. Ancora basso dopo ~100 µs significa allarme — leggereEVENT_FLAGS.
Che cosa offre un'istantanea
Per canale di tensione: tensione RMS. Per canale di corrente: corrente RMS, potenza attiva (con segno; positiva = importazione), potenza reattiva (positiva = induttiva), potenza apparente, fattore di potenza (con segno). Per dispositivo: frequenza e totali (k = 0 totale, k = 1..3 per fase). Unità e scale sono nella mappa dei registri.
Sotto circa 20 mA la corrente pubblicata viene anche livellata su alcuni secondi per una lettura stabile; potenza ed energia non sono influenzate.
Dopo un riavvio
Rilevare un riavvio con UPTIME (0x08A0, in calo) o BOOT_COUNT (0x00CE, a passi). Poi: riarmare la maschera e le soglie degli eventi, reimpostare di nuovo l'ora e ri-ancorare i delta di energia. Subito dopo l'avvio WIN_SEQ legge 0 per circa una finestra, FREQ legge 0 per ~2 s e le prime ~3 finestre non aggiungono energia; attendere ~1 s prima di giudicare la salute.
Nelle librerie client
readAll() restituisce un'unica istantanea coerente su entrambe le linee di prodotto; le librerie la associano per voi a DRDY o a WIN_SEQ. Vedere Esempi. Su un modulo con banchi di istantanee e contatori di energia usare Arduino 1.6.2 o successiva oppure ESP-IDF 1.7.3 o successiva.