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 banchistdArmBanks()/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+) restituisceRB_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 (immagine0x0001007Bo 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 classeWiredCT/BuiltinCTnon 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 restituisconoRB_ERR_PARAM); i test unitari sull'host (extras/host_tests) eseguono i sorgenti reali contro un bus simulato. -
RbAmpStdEnergyha 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 nuovereadReactivePower()/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()) restituisconoRB_ERR_NOT_IMPLEMENTEDsu 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 comeRB_ERR_PARAM(il canale mantiene il modello precedente). -
readCTModelCh()copre tutti i canali. -
Registro generato dei modelli di sensore
RbAmpSensorModels.h(defineRBAMP_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_CHANNELSportato da 3 a 7. Gli sketch esistenti che usano arrayRbAmpSnapshotcresceranno — è necessario ricompilare (nessuna modifica al sorgente se non si sono dimensioni di array scritte nel codice). -
03_MultiModuleBroadcastriscritto 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()eprovision()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) ereadCTModelCh()(lettura speculare del modello applicato). -
Primitive di flotta a bordo del dispositivo:
enableGc(),setGroupId(),readGroupId(),readGcTick(),readFleetConfig(),readLabel(),writeLabel(),saveUserConfig(), staticabroadcastLatchGroup(). -
Esempio
08_FleetSync(scansione → sincronizzazione GC → aggregazione). RbAmpSnapshot.implausiblemaschera per campo: un campo che non supera il filtro di plausibilità fisica viene impostato aNaNe 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_msdiagnostico 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 —
Sct013accetta{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 condoublea 32/64 bit (ESP32, SAMD, STM32, RP2040). -
Bus marginale / ESP32: il
Wiredi 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)