11 · Changelog
Cronologia delle versioni del componente esterno rbamp per ESPHome. Questa pagina riflette CHANGELOG.md nel repository, che è la fonte canonica.
Le release pubbliche riprendono con la v1.9.0; le versioni intermedie elencate sotto sono state rilasciate solo internamente.
Contents:
- v1.9.1 — 2026-11-01
- v1.9.0 — 2026-10-21
- v1.8.1 — 2026-10-18
- v1.8.0 — 2026-10-17
- v1.7.0 — 2026-09-30
- v1.6.0 — 2026-09-04
- v1.5.0 — 2026-08 (solo interno)
- v1.4.0
- v1.3.0
- Politica di deprecazione
- Guida all'aggiornamento
v1.9.1 — 2026-11-01
Banchi di snapshot STD nel YAML, i modelli di pinza da 50 A e 100 A, e un messaggio chiaro quando un modulo accoppiato in fabbrica rifiuta una scrittura di configurazione.
Aggiunto
-
Banchi di snapshot (
period_banks:) per i moduli che li dichiarano (linea a 16 bit, immagine 0x7E e successive): potenza media, energia, picchi e durata del periodo, per ciascuno degli otto banchi del modulo, bloccati da uninterval:e/o dalla nuova azionerbamp.latch_bank. I valori di energia per periodo sono per periodo (state_class: measurement), non contatori. Il primo blocco dopo l'avvio o il riavvio del modulo si limita ad avviare il periodo. Esempio:example/std_banks.yaml. -
Test sull'host per la logica dei banchi:
tests/host/test_std_bank.cpp(g++semplice, senza framework). -
Registro dei modelli di sensore: i codici 11 (50 A, 33 Ω) e 13 (100 A, 20 Ω) sono ora caratterizzati e accettati senza il suggerimento "riservato".
Fisso
- Sul firmware 1.4.22 e successivi un modulo accoppiato in fabbrica (classe
WIRED_CT/BUILTIN_CT) rifiuta le scritture di classe e modello in funzionamento normale, anche conct_model_force: true(la forzatura funziona solo in modalità di fabbrica). Il componente ora segnala "factory-paired module: configuration locked" [modulo accoppiato in fabbrica: configurazione bloccata] invece di un generico errore di parametro, e una scrittura singola rifiutata dict_model:non viene più salvata né seguita dalla correzione del valore nominale.
v1.9.0 — 2026-10-21
Le release pubbliche riprendono con questa versione; le versioni intermedie sono state rilasciate solo internamente.
Cambio della portata SCT senza perdere la precisione di fabbrica (linea a 8 bit), oltre ai rilasci di protezione 1.8.x incorporati in questa release pubblica.
Aggiunto
- 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.
-
Correzione del cambio di portata SCT (moduli con classe di sensore SCT-013, firmware ≤ 1.4.19). Ogni modulo SCT è calibrato in fabbrica con il sensore -030; selezionare un altro
ct_model:lasciava corrente, potenza ed energia sulla scala -030. Ora il componente completa la scrittura del modello con il riavvio del modulo richiesto dalla procedura (salvataggio → reset → nuova identificazione con verifica dell'UID), legge il guadagno effettivamente applicato dal modulo e scala corrente, potenza attiva e reattiva e l'integrazione dell'energia sulla portata del sensore selezionato — il trim di fabbrica per unità viene preservato. Tensione e fattore di potenza non ne sono influenzati. Un riavvio del modulo (proprio o esterno) viene rilevato e la correzione viene ricalcolata automaticamente. Se il guadagno applicato è fuori dal ±5 % del valore del modello di calibrazione, il componente emette un avviso e non scala. Non serve alcuna modifica al YAML. -
Il firmware 1.4.20+ esegue il cambio di portata sul dispositivo e lo annuncia — il componente lo rileva e lascia invariate le letture (scrittura semplice del modello, senza riavvio).
-
Test host per la logica di decisione della correzione:
tests/host/test_sct_rating.cpp(g++semplice, senza framework).
v1.8.1 — 2026-10-18
Fisso
-
Protezione della calibrazione di fabbrica per
sensor_class:/ct_model:(linea a 8 bit). Il firmware cancella i modelli di canale e le forme di linearità a ogni scrittura della classe del sensore (anche con un valore invariato) e riapplica il preset generico a ogni scrittura del modello TA — il componente ora non scrive mai un valore che il dispositivo ha già e rifiuta i cambi di classe/modello dal YAML su un modulo calibrato in coppia con il sensore montato (classiWIRED_CT/BUILTIN_CT), con una riga di log esplicita. La nuova opzione di servizioct_model_force: trueriapplica deliberatamente il preset; lo schema la rifiuta senza una chiave di modello, così non può restare armata nel YAML. -
Lettura fuori dai limiti sui moduli a 5/7 canali (UI5/UI7): il ciclo di pubblicazione di ripristino all'avvio indicizzava gli array di esportazione a 3 slot fino al canale 6 e poteva pubblicare un valore spazzatura nel sensore adiacente. Corretto con lo stesso controllo di canale che già avevano tutti gli altri punti di esportazione; le dimensioni degli array sono ora fissate da asserzioni in fase di compilazione.
-
Documentazione/commenti allineati alla finestra di misura della famiglia di 100 ms (firmware v1.2+; 200 ms solo sulle immagini più vecchie).
v1.8.0 — 2026-10-17
Energia cumulativa integrata nel dispositivo per la linea a 16 bit.
Aggiunto
-
Energia dai contatori on-device (moduli a mappa a 16 bit che li pubblicizzano nella bitmap di capacità): il componente smette di integrare autonomamente i Wh e accumula i contatori propri del modulo — i totali sopravvivono ai riavvii sia dell'ESP32 sia del modulo, senza deriva di integrazione. Risoluzione micro (µWh/µvarh) sul firmware che la pubblica, con ricaduta automatica su una risoluzione più grossolana altrimenti. Ogni snapshot viene letto in un'unica transazione I²C coerente, e le somme pubblicate restano monotone tra i riavvii del modulo e i reset dei contatori.
-
Nuovi sensori di totale complessivo:
energy_total,energy_exported_total,energy_net(importata − esportata, può diminuire),reactive_energy,reactive_energy_exported. -
start_current_ua:chiave di configurazione (0 = disattivata, 10..2540 a passi di 10 µA): sotto questa corrente un canale non accumula energia — a vuoto la potenza misurata è rumore di segno variabile che altrimenti si insinuerebbe sia nell'importazione sia nell'esportazione. Le letture non ne sono influenzate. Validata dallo schema; memorizzata sul dispositivo con un salvataggio verificato. -
Superfici trifase:
voltage_angle_b/voltage_angle_c(gradi, rispetto alla fase A) ephase_sequence(1 diretta · 2 inversa · 3 anomala), pubblicate sui firmware che le forniscono; altrimenti «sconosciuto». -
Accessori lambda:
get_std_image_version(),get_phase_sequence_str(),read_start_current_ua().
v1.7.0 — 2026-09-30
Supporto per la nuova linea di moduli con mappa dei registri a 16 bit, rilevata automaticamente con lo stesso YAML.
Aggiunto
-
Supporto a doppia linea: una sonda di identità all'avvio rileva i moduli con mappa a 16 bit e cambia il trasporto (puntatore big-endian, letture a raffica con auto-incremento). Il numero di canali, la variante e le funzionalità provengono dal blocco di discovery del dispositivo —
topology:e i conteggi di slot nel YAML non servono più per dimensionare la superficie delle entità. I moduli a 8 bit si comportano esattamente come prima. -
I sensori in tempo reale sulla linea a 16 bit vengono pubblicati dai registri a virgola fissa del dispositivo; l'energia usa gli snapshot di blocco atomici del dispositivo con integrazione sul clock master e la stessa persistenza NVS.
-
Le chiavi di configurazione (
sensor_class:,ct_model:,new_address:) funzionano sulla linea a 16 bit tramite il suo blocco di configurazione in staging con un salvataggio verificato in modo sincrono. Lect_models:per canale su questa linea richiedono che il dispositivo pubblicizzi mappe persistenti per canale (bit di capacità); il componente rifiuta rumorosamente invece di perdere la scrittura in silenzio. -
Ripristino automatico dopo un riavvio del modulo durante l'esecuzione: il componente rileva la caduta dell'accumulatore, lo riarma e lo riavvia, saltando una finestra invece di interrompere in silenzio l'accumulo di energia.
-
Flush NVS allo spegnimento pulito (riavvio/OTA non perde più fino all'ultimo intervallo di salvataggio di energia).
v1.6.0 — 2026-09-04
ct_models: per canale su tutti i canali (da 0 a 15), registro dei modelli di sensore e correzione della persistenza. Firmware: richiesta la v1.4.18+ per i canali senior 3+.
v1.5.0 — 2026-08 (solo interno)
Aggiunto
- Supporto degli SKU senior UI5/UI7: canali 3–6 letti tramite la finestra di accesso ai canali (metriche in tempo reale ed energia per periodo per canale), slot energia NVS estesi a 7 canali.
Aggiunto
-
Modelli TA per canale su tutti i canali.
ct_models:nel YAML accetta ora fino a 16 voci. Il rilevamento della variante del modulo determina quante ne vengono applicate; le voci in eccesso producono un avviso, non un errore. -
Registro dei modelli di sensore — l'elenco dei modelli proviene da un unico registro. Le due liste fisse (dizionario
CT_MODELS+CT_MODEL_ALLOWED_PER_CLASS) sono sostituite da un'unica ricerca nel registro. Aggiungere un nuovo SKU di TA è ora una modifica al registro — nessuna release della libreria necessaria.
Fisso
- La v1.6.0 aggiunge il SALVATAGGIO dopo il ciclo di applicazione. Le versioni precedenti usavano un percorso di persistenza vincolato alla fabbrica per il modello TA e la classe del sensore — su un modulo di produzione il legame veniva applicato in RAM ma andava perso al riavvio. La v1.6.0 persiste tramite
CMD_SAVE_USER_CONFIG(senza vincoli). Gli utenti delle versioni precedenti in produzione hanno perso in silenzio il legame con il modello TA ad ogni riavvio — aggiornare prima di spedire i dispositivi.
v1.4.0
Rilevamento delle varianti senior (5/7 canali), finestra di accesso ai canali per le metriche in tempo reale e la chiave facoltativa latch_interval: che disaccoppia la cadenza di latch/energia dalla cadenza di lettura (update_interval:). L'energia resta monotona e accurata: l'integrazione usa il tempo reale effettivo tra gli eventi di latch.
v1.3.0
Prima release pubblica. Multi-canale e flotta multi-modulo con sincronizzazione dei latch general-call (fleet_gc_enable: + group_id:), commit dell'indirizzo in due fasi (produzione-OK, senza modalità di provisioning di fabbrica), avvio con lettura-confronto-scrittura, rilevamento delle funzioni condizionato dalle capacità, superficie di identità per le lambda (get_variant_str(), get_uid_hex(), ...), persistenza dell'energia in NVS.
Politica di deprecazione
Ciò che il componente promette di non rompere senza preavviso, e ciò che può fare:
| Superficie | Stabilità | Cosa garantiamo |
|---|---|---|
Chiavi YAML del blocco rbamp: |
Stabile | La rimozione o la rinomina sono possibili solo con un incremento di versione maggiore. Un avviso di deprecazione compare nel log prima della rimozione. broadcast_latch: e topology: restano nello schema per compatibilità all'indietro. |
Chiavi YAML di sensor.platform: rbamp (slot) |
Stabile | Stesse regole. I nomi voltage/current/power/energy/frequency/power_factor sono fissi come contratto con la dashboard Energia di HA. |
L'insieme delle entità HA e i loro device_class / state_class |
Stabile | Non lo cambieremo senza un annuncio; influisce sull'entity_id in HA. |
Metodi RbAmpComponent::* accessibili da Lambda |
Instabile | Questi valori possono cambiare nelle release minori. Se scrivi azioni lambda su di essi, fissa la versione del componente (ref: in external_components:). |
| Formato della struttura NVS | Versionata | Le modifiche arrivano con un incremento della versione del layout — i vecchi dati vengono scartati, mai letti in modo errato. |
Nomi e comportamento del blocco i2c: |
Esterno | Questo è il core di ESPHome, non il nostro — segui la policy a monte. |
Guida all'aggiornamento
Alla v1.9.0 (da qualsiasi versione precedente)
- Imposta
ref: v1.9.0inexternal_components:. - Non serve alcuna modifica al YAML. Lo stesso YAML funziona per entrambe le linee di moduli; il componente riconosce il modulo collegato all'avvio.
topology:non è necessario. - Se si vogliono i totali di energia su tutti i canali su un modulo STANDARD (STD), aggiungere
energy_total/energy_exported_total/energy_net(vedere 09 §2.3). - Se il YAML imposta
sensor_class:oct_model:su un modulo fornito calibrato insieme al suo sensore montato, il componente ora rifiuta la modifica e la registra. Per tali moduli rimuovere queste chiavi. - Se si è cambiato il valore nominale SCT tramite
ct_model:, le letture ora restano accurate; un riavvio del modulo durante il cambio è normale sul firmware fino a 1.4.19. ct_model_force: trueè solo un'opzione di servizio; lo schema lo rifiuta senzact_model:/ct_models:.- I valori di energia NVS per canale sono conservati all'aggiornamento; i nuovi sensori di totale generale partono da 0 al primo avvio e poi accumulano (il loro slot NVS è separato).
Dalla v1.3 / v1.4
- Aggiorna
ref:. SCT_013_100(codice 5) eSCT_013_060(codice 7) sono accettati.- Facoltativamente aggiungi
fleet_gc_enable:/group_id:per snapshot sincronizzati in un'installazione con più moduli (moduli BASIC).
Fonte e segnalazioni: rb-amp/rbamp-esphome · questa pagina nel repository: docs/11_changelog.md (v1.9.1)