rbAmp
IT
Negozio
Docs
Aggiornato il

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.

  1. Armare. Scrivere PERIOD_ARM (0x0063): il bit b = 1 fa accumulare il banco b. Un banco appena armato parte vuoto.

  2. Snapshot. Scrivere LATCH_BANK (0x0062) = b, poi il comando 0x03 (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.

  3. Attendere. Dopo i passi di CMD_SEQ, attendere che WIN_SEQ sia avanzato di 2 (circa 200 ms).

  4. Lettura. Il banco si trova a 0x2000 + b·0x800 (input Modbus 0x7000 + b·0x100): P / Q / S mediate sul periodo, energia con segno, numero di finestre, picchi ed energia per canale. Il campo PD_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

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.