06 · Energia e periodi
Come ottenere l'energia da un modulo STD: contatori cumulativi, storico orario, registro eventi e gli otto banchi di snapshot. Regole complete: Modello di misura ed energia.
Contatori cumulativi
Il modulo conserva contatori di energia di vita che sopravvivono allo spegnimento: importazione, esportazione e netto attivi in Wh, mWh e µWh; importazione ed esportazione reattive in varh e µvarh. Leggerli in una sola transazione su 0x0800–0x0843 (e 0x08D0–0x08F7 per il set a risoluzione fine).
Rules:
-
Leggere l'energia dal modulo; mai integrare P·dt sull'host. L'integrale del modulo è compensato dai vuoti e sopravvive ai riavvii.
-
L'energia di intervallo è la differenza di due letture ai confini dell'intervallo. Un confine mancato unisce due intervalli senza perdere nulla.
-
Dopo un riavvio i contatori riprendono dall'ultimo valore salvato; possono mancare fino all'ultimo secondo circa di energia. Prendere la differenza come
max(0, nuovo − ultimo)e ri-ancorare — non scartare il periodo. -
LT_GEN(0x0840) avanza a ogni reset o adozione dei contatori. Se è cambiato, non calcolare la differenza: riallineare e controllare il registro eventi. -
Corrente di avviamento (
CFG_START_UA, predefinito 400 µA): sotto tale valore un canale non aggiunge energia a nessun contatore, il che arresta lo scorrimento a vuoto. Le letture non sono influenzate.
Storico orario
Il modulo conserva gli ultimi 7 record orari (energia e un riepilogo elettrico per ogni ora) in memoria non volatile (HIST_CAP, 0x0C08, indica il numero di record). I record sopravvivono al riavvio; un archivio più lungo è conservato dal master.
- I record vengono scritti solo dopo che il master ha impostato l'ora, e il master la reimposta dopo ogni riavvio del modulo: non esiste un orologio con batteria (vedere Primi passi).
- Un record si chiude quando l'orologio del modulo supera il confine dell'ora. Un record di mezz'ora (l'ora è stata impostata a metà ora, oppure il modulo si è acceso a metà ora) porta un flag.
- Del periodo di 15 minuti è disponibile solo l'ultimo riepilogo concluso (valori elettrici, nessuna energia). È conservato in RAM e va perso al riavvio.
Interfaccia di interrogazione: mappa dei registri.
Registro eventi
Il registro eventi contiene azzeramenti e adozioni di contatori, salvataggi di taratura, aggiornamenti firmware e record rifiutati, con valori prima/dopo; svuotarlo periodicamente.
Banchi di snapshot
Quando CAPABILITIES bit 8 = 1, il modulo ha otto banchi di snapshot indipendenti: ogni master congela il periodo di cui ha bisogno, e più consumatori non si disturbano a vicenda. Usarli quando più moduli devono tagliare lo stesso periodo nello stesso istante; per un solo modulo le differenze dei contatori sopra sono più semplici.
-
Armare. Scrivere
PERIOD_ARM(0x0063): il bit b = 1 fa accumulare il banco b. Un banco appena armato parte vuoto. -
Snapshot. Scrivere
LATCH_BANK(0x0062) = b, poi il comando0x03(LATCH_PERIOD). Il taglio viene effettuato al confine della finestra successiva; il banco riparte da zero. Su un bus Modbus le stesse scritture possono essere inviate in broadcast (unit 0) per un taglio unico tra più moduli. -
Attendere. Dopo i passi di
CMD_SEQ, attendere cheWIN_SEQsia avanzato di 2 (circa 200 ms). - Lettura. Il banco si trova a
0x2000 + b·0x800(input Modbus0x7000 + b·0x100): P / Q / S mediate sul periodo, energia con segno, numero di finestre, picchi ed energia per canale. Il campoPD_VALID, bit b, indica che il banco contiene uno snapshot; resta impostato e non è un indicatore di freschezza.
I banchi sono in RAM: un reset li azzera. Un banco istantaneo durante le prime 3 finestre dopo l'avvio contiene zeri con WIN_CNT = 0. Struttura e unità: mappa dei registri.
Nelle librerie client
— lo stesso compito senza accesso ai registri:
| Libreria | Chiamata | Cosa fa |
|---|---|---|
| Arduino | stdArmBanks, stdLatch, stdReadLatch, stdLatchWh |
armare i banchi, eseguire uno snapshot, leggerlo e convertirlo in Wh; disponibile quando il modulo riporta i banchi (bit 8) |
| ESP-IDF | rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch, rbamp_std_latch_wh |
lo stesso nel componente ESP-IDF; il banco 0 appartiene alla libreria, usare i banchi 1 e successivi (esempio std_meter) |
| ESPHome | period_banks:, rbamp.latch_bank |
dichiarare i banchi da bloccare in YAML, su un interval: e/o tramite l'azione (dalla v1.9.1) |
| Python | std_arm_banks, std_latch, std_read_latch, std_latch_wh |
le stesse chiamate nel client Python (dalla v1.6.1); la validità di un banco è persistente, leggere un banco almeno 300 ms dopo l'armamento |
Vedere Esempi.