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

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

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 un interval: e/o dalla nuova azione rbamp.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 con ct_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 di ct_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 (classi WIRED_CT / BUILTIN_CT), con una riga di log esplicita. La nuova opzione di servizio ct_model_force: true riapplica 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) e phase_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. Le ct_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)

  1. Imposta ref: v1.9.0 in external_components:.
  2. 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.
  3. 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).
  4. Se il YAML imposta sensor_class: o ct_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.
  5. 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.
  6. ct_model_force: true è solo un'opzione di servizio; lo schema lo rifiuta senza ct_model: / ct_models:.
  7. 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

  1. Aggiorna ref:.
  2. SCT_013_100 (codice 5) e SCT_013_060 (codice 7) sono accettati.
  3. 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)