rbAmp
IT
Negozio
Docs
Aggiornato · Modifica su GitHub [Edit on GitHub]

11 · Changelog

La storia completa e dettagliata è nel CHANGELOG.md alla radice del repository; questo capitolo ne riporta la versione breve.

1.6.2 — l'energia STD resta sui contatori, righe del registro dei modelli, errore di modulo bloccato

  • STD, immagini con contatori e banchi di latch: un modulo del genere ora mantiene readPeriodSnapshot() / energy() sui suoi contatori persistenti (prima passava in silenzio all'energia integrata sull'host dal banco 0). Le chiamate ai banchi stdArmBanks() / stdLatch() / stdReadLatch() restano disponibili e sono regolate solo dalla capacità dei banchi. La libreria 1.6.2 è il minimo per un'immagine del genere; vedi Fonte dell'energia e versione minima della libreria.

  • Nuovo esempio 12_StdBanks: due periodi temporizzati dal master sui propri banchi di snapshot.

  • Registro dei modelli di sensore: le pinze 2000:1 per 50 A (codice 11) e 100 A (codice 13) sono accettate.

  • setCTModelChForce() su un modulo BASIC accoppiato in fabbrica fuori dalla modalità di fabbrica (firmware 1.4.22+) restituisce RB_ERR_MODE ("configurazione bloccata") e non salva nulla; una scrittura forzata funziona solo in modalità di fabbrica.

1.6.1 — energia STD a micro-risoluzione, correzione della portata SCT-013, guardia della configurazione del sensore

Rilasciata insieme alla 1.6.0 (la linea STD) come prima versione pubblica della libreria a due linee.

  • Linea STD: contatori di energia a micro-risoluzione (µWh / µvarh), corrente di avvio per l'energia (stdSetEnergyStartCurrent() / stdReadEnergyStartCurrent()), angolo di fase di tensione (RbAmpStdVoltage::angle_deg) e sequenza di fase (stdReadPhaseSequence()) — per i moduli la cui immagine li pubblica (immagine 0x0001007B o successiva); i moduli più vecchi si comportano esattamente come prima. stdEnergyDelta() copre i nuovi campi.

  • Linea BASIC — correzione della portata SCT-013: sul firmware fino alla 1.4.19 un canale commutato su un altro modello SCT-013 viene letto rispetto al guadagno che il modulo applica. begin() legge ogni canale e scala corrente / potenza / potenza di periodo (e l'energia da essa derivata); fattore di potenza e tensione restano invariati. Novità: sctRatingRefresh(), sctRating(), sctRatingScale(), sctPresetGain(). Il firmware 1.4.20 e successivi si corregge da solo. I setter del modello riavviano il modulo dopo il salvataggio sul firmware che lo richiede (un ~0.5 s in più per chiamata).

  • I setter di classe del sensore / modello CT leggono prima di scrivere (setSensorClass(), setCTModel(), configureChannels()): una configurazione memorizzata può essere riapplicata a ogni avvio senza toccare la calibrazione del modulo. Un modulo di classe WiredCT / BuiltinCT non viene riconfigurato (RB_ERR_MODE); setCTModelChForce() è il percorso di assistenza. Nuovi: readSensorClass(), RbAmp::sensorModel() / RbAmp::sensorModelRatedA() (ricerche nel registro con i limiti attuali del modello).

  • SCT-013-060 e -100 sono accettati (in precedenza rifiutati lato client come riservati); i limiti di clip del modello di sensore aggiornati ai valori misurati.

  • Entrambe le linee: la finestra di misura / la cadenza di pubblicazione è documentata a 100 ms (200 ms conservati solo come nota per le immagini più vecchie); il numero di canali non può mai superare RBAMP_MAX_CHANNELS (i canali oltre questo limite restituiscono RB_ERR_PARAM); i test unitari sull'host (extras/host_tests) eseguono i sorgenti reali contro un bus simulato.

  • RbAmpStdEnergy ha acquisito campi in questa versione: se la sua applicazione lo salva come blob binario grezzo, memorizzi solo i campi che servono nel proprio formato fisso.

1.6.0 — Linea STD (modello di registri a 16 bit)

Una libreria per entrambe le linee di prodotto: begin() rileva se il modulo parla il modello a registri BASIC (8 bit) o STD (16 bit, virgola fissa) e instrada ogni chiamata internamente — la superficie dei metodi è la stessa su entrambe le linee.

  • line() (RbAmpLine::Basic / RbAmpLine::Std); letture unificate su STD (readVoltage(phase), readCurrent(), readPower() …) più le nuove readReactivePower() / readApparentPower() (solo STD).

  • L'API a blocchi STD: stdInfo(), stdReadChannel(), stdReadTotals(), stdReadVoltage(), stdReadHealth(), stdReadConfig(), stdSetHarmonics(), stdCalThdFloor(); banchi di latch (stdArmBanks(), stdLatch(), stdReadLatch(), stdLatchWh()); contatori di vita utile (stdReadEnergy(), stdEnergyDelta()).

  • Sorgente del periodo scelta in base alle capacità del modulo (banchi di latch o contatori persistenti); l'energia del latch sopravvive a un reset del modulo; lo snapshot del periodo ha guadagnato avg_p_total, wh_net, module_restarted.

  • Identità, orologio, cronologia: stdIdentify(), RbAmp::stdProbe(), stdReadImageVersion(), stdReadBoardId(), stdSetTime() / stdReadTime(), stdHistInfo() / stdHistRead() / stdHistReadRaw() / stdEventRead() / stdHistFlush(), stdCommand() / stdWaitIdle() / stdLocate(), RbAmp::stdSetAddressByUid().

  • La configurazione e i comandi funzionano su STD (setSensorClass(), setCTModel(), configureChannels(), saveUserConfig(), saveGains(), cambio di indirizzo); ogni comando attende che il modulo segnali il completamento e ne verifica il verdetto. Su STD il modello CT è solo un'etichetta di riferimento.

  • Aggiornamento firmware via I²C: stdOtaBegin() → stdOtaWritePage() → stdOtaCommit() → stdOtaActivate(), stdOtaWritePreparedImage() (immagini preparate dal produttore), stdOtaDiag(), stdOtaAbort(), stdOtaBoardOk().

  • Linea di data-ready ed eventi su entrambe le linee: setDrdyPin(), waitDataReady(), readAllReady(), readDataSeq(), beginEventFlags(), setEventMask() / readEventMask(), setEventThresholds(); readEventFlags() / clearEventFlags() / hasError() funzionano sui moduli STD che forniscono il blocco eventi.

  • Chiamate riservate al BASIC (factoryReset(), chiamate generali e helper per le etichette, readCapability(), readCommitSeq(), readPeriodLatchMs()) restituiscono RB_ERR_NOT_IMPLEMENTED su un'istanza STD. Nessuna modifica all'API BASIC.

  • Esempio 11_StdLine.

1.5.0 — Modelli CT per canale + registro dei modelli di sensore

  • setCTModel(channel, code) / configureChannels() associano qualsiasi canale, inclusi i canali 3 e successivi dello SKU di fascia alta (attraverso la finestra dei canali); ogni scrittura è confermata da una rilettura, e un modello che il modulo non accetta viene segnalato come RB_ERR_PARAM (il canale mantiene il modello precedente).

  • readCTModelCh() copre tutti i canali.

  • Registro generato dei modelli di sensore RbAmpSensorModels.h (define RBAMP_CT_*, descrittori, rbamp_sensor_model_lookup()); la validazione del modello TA è guidata dal registro (il client rifiuta solo i codici assenti dal registro — l'accettazione la decide il modulo). RbAmpCTModel è un alias congelato per i sette codici SCT-013.

  • Il modello del sensore di corrente / la classe del sensore ora restano memorizzati sui moduli di produzione (CMD_SAVE_USER_CONFIG).

  • Esempio 10_PerChannelModels.

1.4.0 — Supporto degli SKU senior (UI5/UI7)

Aggiunge il supporto ai moduli senior a 7 canali (UI5, UI7) e aggiorna l'esempio di broadcast GC. Verificato a livello di silicio su una flotta eterogenea (UI1/UI2/UI3/UI5/UI7), contratto firmware bd2ad8e.

Aggiunto

  • Esempio 09_SeniorSku — polling a 7 canali e integrazione dell'energia per i moduli UI5/UI7.

  • readCommitSeq() — lettura di ritorno della sequenza di commit del firmware.

Modificato

  • RBAMP_MAX_CHANNELS portato da 3 a 7. Gli sketch esistenti che usano array RbAmpSnapshot cresceranno — è necessario ricompilare (nessuna modifica al sorgente se non si sono dimensioni di array scritte nel codice).

  • 03_MultiModuleBroadcast riscritto per il latch broadcast General-Call della v1.3 (sincronizzazione coerente con un solo frame che sostituisce il vecchio latch sequenziale per dispositivo).

  • Intestazioni dei registri rigenerate (contratto v1.4.0).

  • Energy/Snapshot: crescita dell'array per gli SKU senior + invio in base al numero di canali.

1.3.0 — Flotta + protocollo v1.3

Ha portato la libreria Arduino in linea con il contratto di filo rbAmp v1.3 e con il modello di riferimento multipiattaforma (STM32 HAL / ESP-IDF / Python). Validata su hardware con una flotta eterogenea (UI1 + I2 + I3) tramite l'API pubblica con verità di terra a livello di registro (suite di copertura completa 38/38 + test di resistenza esteso con WDT dell'app).

Aggiunto

  • RbAmpFleet — gestore multimodulo: scan() del bus (con rilevamento delle collisioni), pollAll() a raffica, totalPower() / totalEnergyWh() / pollErrors() su tutta la flotta, sincronizzazione General-Call (enableGcAll() / gcLatch() / checkSync()), assignAddress(), checkConflict() e provision() per portare sul bus un modulo nuovo di fabbrica.

  • Identità / capacità: readVariant(), readCapability(), readProductId(), readUid().

  • Canale eventi: readEventFlags(), clearEventFlags(), hasError(), clearError(), readLastError().

  • Configurazione CT per canale: configureChannels() (in blocco, un solo salvataggio in flash) e readCTModelCh() (lettura speculare del modello applicato).

  • Primitive di flotta a bordo del dispositivo: enableGc(), setGroupId(), readGroupId(), readGcTick(), readFleetConfig(), readLabel(), writeLabel(), saveUserConfig(), statica broadcastLatchGroup().

  • Esempio 08_FleetSync (scansione → sincronizzazione GC → aggregazione).

  • RbAmpSnapshot.implausible maschera per campo: un campo che non supera il filtro di plausibilità fisica viene impostato a NaN e segnalato, mentre il resto dello snapshot resta utilizzabile (la lettura completa fallisce solo in caso di errore di trasporto).

Modificato

  • L'energia è integrata sull'orologio di parete del master, mai sul latch_ms diagnostico del chip (un timer diagnostico del modulo, non per l'energia). Su un'ancora di periodo non aggiornata l'integrazione viene trattenuta — il periodo valido successivo non viene sottostimato.

  • I codici del modello CT seguono l'insieme accettato per classe della v1.3 — Sct013 accetta {005, 010, 030, 050, 100, 020, 060}. REG_CT_MODEL è pura predisposizione: si associa tramite il comando per canale, le associazioni multi-canale sono indipendenti dall'ordine e non sovrascrivono mai il canale 0.

  • Il cambio di indirizzo è un commit magico in due fasi, adatto alla produzione; la modalità di fabbrica non è richiesta.

  • Il rilevamento della variante legge REG_HW_VARIANT; il suggerimento di topologia del costruttore è ora un ripiego per il firmware precedente alla v1.3. Il suggerimento predefinito è Single (sicuro — nessuna lettura spuria dai canali assenti).

  • Le scritture I²C condividono ora la stessa disciplina di ripetizione dei NACK delle letture (una scrittura di configurazione che cade in silenzio su un bus conteso sarebbe altrimenti invisibile).

  • setSensorClass() rifiuta lato client le classi fuori dall'enum (il firmware accetta in silenzio una classe errata, quindi la guardia lato client è l'unica salvaguardia).

Note

  • AVR: double è a 32 bit (== float) sulla toolchain AVR classica, quindi l'accumulatore Wh perde precisione durante le registrazioni di lunga durata — azzerarlo periodicamente oppure usare un core con double a 32/64 bit (ESP32, SAMD, STM32, RP2040).

  • Bus marginale / ESP32: il Wire di Arduino-ESP32 incapsula un driver che può bloccarsi su un bus tenuto basso, a un livello sotto la libreria. Usare pull-up esterni da ~4.7 kΩ adeguati, evitare il debugger/NRST in produzione e attivare un task-watchdog a livello di app sul task di polling come percorso di recupero.

1.0.0 — Prima versione

Misura RT su singolo dispositivo (U / I / P / PF / frequenza RMS), integrazione dell'energia di periodo (Wh), configurazione modello TA + classe del sensore e cambio dell'indirizzo I²C.


Sorgente e problemi: rb-amp/rbamp-arduino · questa pagina nel repo: docs/11_changelog.md (v1.6.2)