rbAmp
IT
Negozio
Docs
Aggiornato

05 · Risoluzione dei problemi

Questo capitolo è un riferimento rapido per i problemi più comuni e le loro soluzioni. Ogni voce segue la struttura:

  • Sintomo — cosa osserva l'utente
  • Cause — perché può succedere
  • Cosa controllare / fare— azioni concrete
    Diagramma di flusso per restringere un problema a partire dal sintomo.

Bus I²C

1. NACK / nessuna risposta dal modulo

Sintomo: Wire.endTransmission() restituisce un valore diverso da zero; i2cdetect non mostra l'indirizzo su Linux; rb_read_u8() restituisce 0xFF.

Cause e verifiche:

  • ❌ L'alimentazione del modulo manca o è instabile — misuri VCC con un multimetro; deve essere entro 4.5…5.5 V.
  • ❌ Nessuna massa comune — l'errore più frequente in assoluto. La massa del master e la massa del modulo devono essere collegate insieme.
  • ❌ SDA e SCL scambiati — verifichi con lo schema di cablaggio in hardware-connection.md.
  • ❌ Nessuna pull-up sul bus — se le pull-up integrate sono state tagliate su un modulo e non ne sono state installate di esterne, il bus è inattivo. Con tutto spento, misuri SDA↔VCC: deve leggere 1.5–4.7 kΩ.
  • ❌ Troppi pull-up in parallelo — i pull-up integrati sono ancora attivi su molti moduli (quattro o più), più i pull-up del master, che abbassano l'equivalente sotto ~1 kΩ. Il master non riesce a portare il bus a LOW. Scolleghi i pull-up integrati da tutti i moduli tranne uno.
  • ❌ Cavo lungo senza doppino intrecciato o buffer — oltre ~0.15 m i fili paralleli si accoppiano capacitivamente e i fronti si arrotondano. Usi un UTP cat-5 (fino a 1 m) o un buffer PCA9515 (fino a 3 m). Vedi hardware-connection.md → Lunghezza del bus.
  • ❌ Indirizzo slave errato — il modulo potrebbe essere stato riassegnato. Esegua una scansione I²C:
C++
void i2c_scan() {
  for (uint8_t addr = 0x08; addr < 0x78; addr++) {
    Wire.beginTransmission(addr);
    if (Wire.endTransmission() == 0) {
      Serial.printf("Found device at 0x%02X\n", addr);
    }
  }
}
  • ❌ Velocità I²C troppo alta per la lunghezza del cavo. Scenda a 50 kHz: Wire.setClock(50000);.

2. Timeout intermittenti di lettura/scrittura

Sintomo: le transazioni a volte riescono, altre volte falliscono — soprattutto in ambienti elettricamente rumorosi o vicino a carichi induttivi.

Causes:

  • ❌ Cavo lungo senza doppino intrecciato
  • ❌ Cavo instradato in parallelo ai cavi di rete → accoppiamento a 50 Hz / 100 Hz
  • ❌ Massa rumorosa dal lato master (per esempio un regolatore separato senza capacità di accumulo)
  • ❌ Capacità parassita tra SDA e GND > 100 pF (ad es. una giunzione con derivazioni lunghe)

Solutions:

  • Usi un doppino intrecciato (SDA + GND in una coppia, SCL + GND nell'altra)
  • Evitare di far passare l'I²C in parallelo ai cavi di alimentazione nello stesso condotto
  • Riduca la velocità a 50 kHz / aggiunga 100 nF tra VCC e GND del modulo vicino al connettore
  • Per tratte lunghe fuori da un contenitore, aggiunga protezione ESD (diodi TVS su SDA e SCL)
Nelle librerie client

— lo stesso compito senza accesso ai registri:

Libreria Chiamata Cosa fa
Arduino RbAmp::retryExhaustionCount() / RbAmp::sanityRejectCount() ha esaurito i tentativi di bus e ha scartato letture
ESP-IDF rbamp_retry_exhaustion_count() / rbamp_sanity_reject_count() ha esaurito i tentativi di bus e ha scartato letture
Python dev.sanity_reject_count / contatori di MachineI2CBackend conta le letture scartate; contatori di tentativi sul backend MicroPython
ESPHome — nessun contatore diagnostico esposto

3. DATA_VALID (0xCE) non diventa mai 1

Sintomo: il master legge 0xCE e ottiene sempre 0x00. Anche altri registri possono restare a zero.

Causes:

  • ❌ Il modulo non ha ancora terminato l'avvio (normale per i primi ~250 ms dopo l'accensione)
  • ❌ Errore di inizializzazione del firmware — legga REG_ERROR (0x02):
  • 0xFB (ERR_FLASH_PARAMS_BAD) — il blocco dei parametri in flash è danneggiato; il modulo funziona con i valori predefiniti. Ricalibri / riconfiguri.
  • 0xFA (ERR_LUT_BAD) — la tabella di calibrazione di fabbrica è danneggiata. Non fatale — le misure proseguono; la precisione può essere ridotta. Chieda al fornitore di ricalibrare.
  • ❌ Guasto del clock MCU (raro) — riavvii il modulo spegnendo e riaccendendo

Solutions:

  • Attenda 300 ms dopo l'accensione prima di interrogare 0xCE.
  • Se DATA_VALID = 1 non compare dopo più di 1 s — riavvii il modulo spegnendolo e riaccendendolo.
  • Se il problema persiste dopo un ciclo di alimentazione — controlli l'alimentazione (ondulazione, brown-out).
Nelle librerie client

— lo stesso compito senza accesso ai registri:

Libreria Chiamata Cosa fa
Arduino RbAmp::waitReady(timeout_ms) / RbAmp::readLastError() attenda il flag di pronto; legga il codice di errore del dispositivo
ESP-IDF rbamp_wait_ready() / rbamp_read_last_error() attenda il flag di pronto; legga il codice di errore del dispositivo
Python dev.wait_ready(timeout_ms=1000) / dev.read_last_error() attenda il flag di pronto (solleva un errore al timeout); legga il codice di errore del dispositivo
ESPHome update() verifica di prontezza / get_last_error_str() le letture vengono pubblicate quando il modulo segnala di essere pronto; il codice di errore come testo

Calibrazione e precisione

4. I_rms vicino a 0 mentre un carico è in funzione

Sintomo: la lampada è accesa, lo scaldabagno è caldo, ma I_rms mostra 0.001 A oppure oscilla tra 0 e pochi mA.

Cause (in ordine decrescente di frequenza):

  • ❌ Pinza CT non sul filo — il conduttore passa accanto alla pinza invece di attraversarla.
  • ❌ Pinza CT su L e N allo stesso tempo — i flussi di fase e neutro si annullano, il sensore legge quasi zero. Vedi hardware-connection.md → Sensore di corrente. La pinza deve stare su un solo conduttore (fase/L).
  • ❌ Pinza non chiusa completamente — uno spazio > 0.1 mm tra le metà del nucleo aumenta molto la riluttanza magnetica, quindi l'uscita del sensore scende ben al di sotto del normale. Sganci e richiuda finché non scatta. Sporco o ossido nello spazio è una causa comune — pulisca le superfici di contatto.
  • ❌ Jack da 3.5 mm allentato — estragga e reinserisca la spina.
  • ❌ REG_CT_MODEL non impostato — il modulo non conosce la sensibilità del sensore. Vedi initialization.md → Impostare la classe del sensore e il modello CT. Il registro 0x05 deve contenere il codice modello corretto.
  • ❌ Codice modello errato scritto — per esempio un sensore SCT-013-030 con il codice SCT-013-010 → la corrente mostrata sarà ~3× inferiore alla realtà (e viceversa, un codice troppo grande legge alto). Verifichi la marcatura sul corpo del sensore rispetto al codice modello.
  • ❌ Corrente sotto la soglia di rumore — per carichi molto piccoli (< ~10 mA su una pinza da 30 A) l'uscita del sensore è vicina alla soglia di rumore. Il firmware applica la sottrazione del rumore in quadratura: I_corrected = √(I_raw² − NF²). Se I_raw ≤ NF, il risultato viene portato a 0. È il comportamento previsto.

5. I_rms sbagliato di un fattore elevato

Sintomo: il carico reale è ~10 A (secondo il misuratore di riferimento), il modulo mostra 3 A o 30 A.

Causes:

  • ❌ Codice del modello CT errato — il caso più comune. Vedi #4.
  • ❌ Modello CT errato installato — qualcuno ha montato una pinza da 100 A dove la configurazione prevede una da 30 A (o viceversa).
  • ❌ Pinza non chiusa completamente (vedi #4) — tipicamente legge il 5–20 % in meno.
  • ❌ Sospetta deriva della calibrazione di fabbrica — se tutto quanto sopra è escluso e la discrepanza persiste su un carico di riferimento noto, contatti il fornitore del modulo; la ricalibrazione è un'operazione di fabbrica.

6. Il segno di P_real è errato (il consumo risulta come esportazione)

Sintomo: il carico sta chiaramente consumando (scaldabagno caldo, lampada accesa), ma P_real < 0.

Cause e soluzioni:

  • ❌ L e N invertiti sui morsetti di tensione — la causa più comune. Vedi hardware-connection.md → Sensore di tensione. Scambi L e N sulla PCB.
  • ❌ Pinza CT montata al contrario — la freccia sulla pinza deve puntare nella direzione della corrente verso il carico (quadro → carico). Se punta nell'altro senso, sganci e inverta la pinza.
  • ❌ L'inversione fisica non è pratica — sul BASIC l'accumulatore di periodo (PERIOD_AVG_P_W) azzera i campioni negativi, quindi con polarità invertita il registro dell'energia resta 0 finché la polarità fisica non viene corretta — invertire il segno nel codice del master (p_corrected = -p_raw) corregge solo la sua integrazione RT, mai i dati di periodo sul modulo. Corregga il cablaggio.

7. Il totale dell'energia differisce di qualche percento da un misuratore di riferimento

Sintomo: E_Wh in un'ora differisce dal contatore del gestore di 2–10 %.

Cause probabili (in ordine decrescente):

  • ❌ Pinza non chiusa completamente (spazio) — tipicamente −5 a −20 % in meno. La causa più frequente in assoluto. Sganci, pulisca le superfici di contatto, richiuda fino a chiuderla del tutto.
  • ❌ Pinza montata su un filo « secondario » — dentro il quadro di distribuzione, su un pigtail corto dopo un interruttore. I campi vaganti degli interruttori vicini introducono errori. Sposti la pinza sull'alimentazione principale o su un tratto isolato di conduttore.
  • ❌ Vicino a forti carichi reattivi — vicino a trasformatori, motori asincroni, UPS. I campi magnetici di induttori vicini creano un segnale spurio. Allontani la pinza di ≥ 10 cm da qualsiasi componente ferromagnetico.
  • ❌ Fattore di potenza basso (≤ 0.5) — i carichi reattivi elevati richiedono una compensazione di fase precisa. La precisione è specificata per carichi resistivi (PF ≈ 1); non è specificata per carichi fortemente reattivi. Se la precisione su un profilo PF specifico è critica, contatti il fornitore del modulo per una guida.
  • ❌ Tensione di rete distorta (micro-cali, armoniche di ordine elevato) — il calcolo di valore RMS e medio è più robusto della rilevazione di picco, ma la precisione non è specificata per una tensione di rete fortemente distorta; contatti il fornitore se questo è rilevante per la sua installazione.
  • ❌ Cavo della pinza CT danneggiato o connettore allentato — circuito aperto o saldatura fredda nella spina. Verifichi con un multimetro, con il connettore scollegato dal modulo (la pinza CT è un trasformatore riduttore; l'avvolgimento secondario dovrebbe misurare 50–200 Ω a seconda del modello).

8. avg_P_W è molto più basso del previsto

Sintomo: un riscaldatore da 1000 W è acceso, RT P_real ≈ 1000 W, ma PERIOD_AVG_P_W legge ~200 W su un periodo di un minuto.

Causes:

  • ❌ Il carico è realmente intermittente (termostato a cicli, elemento pulsante) — avg_P_W riporta correttamente la media nel tempo. Verifichi con PERIOD_MAX_P_W (0xE0) per vedere il picco all'interno di qualsiasi finestra di misura.
  • ❌ Se il carico è stabile e RT P_real ≈ avg_P_W non regge:
  • Sul livello BASIC: verifichi il segno RT di P_real. Se P è occasionalmente negativa (per esempio quando un inverter solare immette in rete), i campioni negativi vengono esclusi da PERIOD_AVG_P_W, abbassando la media. Vedi period-metering.md → livello BASIC.

9. PERIOD_VALID = 0 dopo uno snapshot

Sintomo: il master invia CMD_LATCH_PERIOD, legge 0x07 e ottiene 0. Lo snapshot non è recente.

Causes:

  • ❌ Snapshot troppo ravvicinati — nessuna finestra RT (~100 ms dalla v1.2; 200 ms prima) si è completata tra due snapshot. L'accumulatore è vuoto, lo snapshot viene scartato.
  • ❌ Corsa con un commit RT — rara: il master ha scritto il comando nell'istante esatto in cui il firmware stava confermando l'accumulatore live. Possibile su master molto veloci.

Soluzione — lo schema di ripetizione (vedi period-metering.md → Ciclo base):

C++
if ((rb_read_u8(0x50, 0x07) & 0x01) == 0) {
  delay(250);   // let at least one RT window complete
  rb_write_u8(0x50, 0x01, 0x27);
  delay(50);
  // retry read of PERIOD_VALID
}
Nelle librerie client

— lo stesso compito senza accesso ai registri:

Libreria Chiamata Cosa fa
Arduino RbAmp::isPeriodValid() / RbAmp::readPeriodSnapshot() controlli il bit di snapshot pronto; acquisisca e convalidi uno snapshot del periodo
ESP-IDF rbamp_is_period_valid() / rbamp_read_period_snapshot() controlli il bit di snapshot pronto; acquisisca e convalidi uno snapshot del periodo
Python dev.is_period_valid() / dev.read_period_snapshot() controlli il bit di snapshot pronto; acquisisca e convalidi uno snapshot del periodo
ESPHome Snapshot del periodo non valido ciò che il componente registra quando il flag di validità è 0; il primo snapshot dopo l'avvio viene scartato

Problemi con più moduli

10. Collisione di indirizzi

Sintomo: più moduli aggiunti al bus — alcuni « scompaiono » o restituiscono valori spazzatura. Lo stesso indirizzo risponde con valori diversi.

Causa: due o più moduli condividono lo stesso indirizzo → arbitraggio/collisione I²C. Frequente subito dopo l'apertura della confezione, quando ogni modulo è sull'indirizzo di fabbrica 0x50.

Forma più sottile: l'indirizzo risponde in modo stabile, ma la lettura dell'UID a 0x5C (cap. 11 §4.8) non corrisponde ad alcun modulo noto. Due moduli rispondono insieme — il bus fa un AND cablato delle loro uscite producendo un UID stabile ma fittizio. Se un hub vede un « UID sconosciuto » a un indirizzo che ha assegnato, sospetti una collisione prima di sospettare un modulo estraneo.

Solution:

  1. Scolleghi ogni modulo.
  2. Ricolleghi uno alla volta — non cambi mai indirizzo con due moduli in configurazione di fabbrica sul bus; cambi l'indirizzo di ciascuno in un indirizzo unico.
  3. Dopo aver reindirizzato tutti i moduli, li ricolleghi in parallelo e verifichi ogni indirizzo leggendo il suo UID.

Vedi initialization.md → Flusso di lavoro consigliato.

Nelle librerie client

— lo stesso compito senza accesso ai registri:

Libreria Chiamata Cosa fa
Arduino RbAmpFleet::checkConflict() / RbAmpFleet::scan() verifichi un indirizzo per un secondo dispositivo; esegua la scansione del bus alla ricerca di moduli
ESP-IDF rbamp_fleet_check_conflict() / rbamp_fleet_scan() verifichi un indirizzo per un secondo dispositivo; esegua la scansione del bus alla ricerca di moduli
Python fleet.check_conflict(addr) / fleet.scan() verifichi un indirizzo per un secondo dispositivo; esegua la scansione del bus alla ricerca di moduli
ESPHome rbamp: elenco un blocco per modulo, ciascuno con il proprio id e address

11. Il DRDY wired-OR scatta più volte in rapida successione

Sintomo: con DRDY wired-OR, l'EXTI del master scatta ogni 1–5 ms più volte di seguito.

Causa: i moduli non sono perfettamente sincronizzati — ciascuno ha il proprio quarzo, e i periodi delle finestre RT differiscono leggermente (99.9 ms contro 100.1 ms). Nell'arco della finestra, i moduli tirano la linea in istanti leggermente diversi.

È normale. Soluzioni:

  • Ignori i trigger « doppi »: dopo il primo trigger, legga tutti i moduli; sopprima ulteriori trigger entro ~10 ms.
  • Usi lo snapshot broadcast (vedi period-metering.md → Approccio 2) per una sincronizzazione precisa — ma solo per gli snapshot di periodo, non per il RT.
  • Passi a DRDY per modulo — ogni modulo sul proprio GPIO.

12. Bus I²C occupato quando scatta DRDY

Sintomo: DRDY scatta mentre il master è già in una transazione con un altro modulo. Il gestore EXTI viene ritardato.

È normale. I registri RT restano validi fino al commit successivo (una finestra, ~100 ms, più tardi). Il master:

  • Completa la transazione in corso.
  • Gestisce l'EXTI ritardato e legge il modulo successivo.
  • Latenza: tipicamente 1–10 ms — non critica.

13. Deriva del clock multi-modulo nei test lunghi

Sintomo: l'energia cumulativa diverge tra i moduli di frazioni di percento nel corso di una settimana.

Causa: ogni rbAmp ha il proprio quarzo con una deriva di ±50 ppm (1–5 s al giorno).

Soluzione — integrata nell'architettura: il master usa il proprio clock per moltiplicare per dt. Tutti i moduli condividono lo stesso riferimento temporale, quindi il totale Wh del sistema non diverge.

Per misurare la deriva del chip a fini di QA, confronti PERIOD_LATCH_MS (0xEC) con il dt del master:

C++
uint32_t chip_dt = rb_read_u32(0x50, 0xEC);
float ratio = (float)chip_dt / (float)master_dt;
printf("Chip drift: %.3f (1.000 = perfect)\n", ratio);

Soglia di accettazione per PERIOD_LATCH_MS: fino al 30 % di sottostima sotto carico è normale (rapporto fino a ~0.70). La base dei tempi diagnostica interna del modulo legge valori bassi quando il modulo è occupato — per progetto. Il margine del 30 % è una proprietà della base dei tempi del modulo, non un guasto. Applichi questa soglia in modo uniforme su tutte le SKU e i livelli.

La vecchia soglia del 3 % della documentazione precedente è errata per la v1.3 e scarterebbe in massa moduli sani; non la usi.

Questa deriva influisce solo sul registro diagnostico lato chip; la precisione dell'energia non è compromessa perché i Wh sono calcolati lato master come avg_P × master_dt (vedi period-metering.md). Se master_dt stesso deriva (il clock dell'MCU del master si sposta), applichi la correzione NTP/SNTP propria del master — PERIOD_LATCH_MS non è il riferimento giusto.

Nelle librerie client

— lo stesso compito senza accesso ai registri:

Libreria Chiamata Cosa fa
Arduino RbAmp::readPeriodLatchMs() legga la lunghezza del periodo lato modulo (solo diagnostica)
ESP-IDF rbamp_read_period_latch_ms() legga la lunghezza del periodo lato modulo (solo diagnostica)
Python dev.read_period_latch_ms() legga la lunghezza del periodo lato modulo (solo diagnostica)
ESPHome — non esposto

Alimentazione e flash

14. Caduta di alimentazione durante un comando di scrittura in flash → scrittura parziale in flash

Sintomo: dopo un'interruzione di alimentazione durante un comando di scrittura in flash (CMD_SAVE_USER_CONFIG, CMD_COMMIT_ADDR), il modulo si avvia con REG_ERROR = 0xFB (ERR_FLASH_PARAMS_BAD) e EVENT_FLAGS.bit3 impostato.

Cosa è successo: il firmware ha rilevato un errore CRC nel blocco flash della configurazione utente, ha caricato i valori di fabbrica e li ha riscritti.

Solution:

  • Vengono ripristinati i valori di fabbrica — il modulo funziona, ma l'indirizzo personalizzato / la configurazione del sensore sono andati persi.
  • Riapplichi la configurazione: imposti SENSOR_CLASS + associ CT_MODEL per canale + emetta CMD_SAVE_USER_CONFIG (e ripeta la modifica dell'indirizzo se necessario).
  • Per evitarlo in futuro: non tolga l'alimentazione per almeno 1 secondo dopo qualsiasi comando di scrittura flash. La finestra di cancellazione e scrittura della flash è di ~700 ms; lasci un margine.

15. Il modulo è caldo

Sintomo: il contenitore risulta chiaramente caldo.

Normale: con corrente di rete fino alla nominale (a seconda della SKU), è previsto un lieve riscaldamento del lato LV (regolatore LDO) fino a ~40 °C.

Non normale: contenitore caldo (≥ 60 °C), odore di bruciato, scolorimento della plastica.

Causes:

  • ❌ Sovratensione sul lato LV (VCC > 5.5 V) — controlli l'alimentazione.
  • ❌ Danno interno sul lato rete (cortocircuito nel partitore o nel circuito CT).
  • ❌ Pinza CT esterna sovraccarica (corrente oltre l'intervallo del sensore).

Azione: scolleghi subito l'alimentazione, isoli il modulo, contatti il fornitore.

Cablaggio del sensore — errori critici

16. Controllo di buon senso — cosa significa "cablato correttamente"

Dopo aver installato o reinstallato un modulo, esegua un test di funzionamento con un carico puramente resistivo noto (lampadina a incandescenza, bollitore elettrico, resistenza riscaldante) — per esempio una lampadina da 100 W a 230 V.

Expected:

  • U_rms ≈ 220..240 (dipende dalla rete locale)
  • I_rms ≈ 100 W / 230 V ≈ 0.43 A
  • P_real ≈ +100 W (positiva, assorbimento)
  • PF ≈ 0.998..1.000 (carico resistivo)
  • Q ≈ 0 (nessun contenuto reattivo)

Se P_real è negativa: vedi #6 — L/N scambiati o CT montata al contrario. Se |I_rms − atteso| > 10 %: vedi #5 — modello CT errato o pinza non chiusa. Se |P_real − U × I| > 5 % con PF = 1: la compensazione di fase potrebbe essere errata — contatti il fornitore.

17. Checklist di pre-messa in servizio

Prima di alimentare un modulo in un sistema di produzione:

  • [ ] L collegato al terminale L del PCB (non scambiato con N)
  • [ ] Pinza CT sul conduttore L (non su N, né su entrambi insieme)
  • [ ] Freccia sulla pinza CT rivolta verso il carico
  • [ ] Pinza CT completamente chiusa (senza spazi, senza gioco — la faccia scattare fino a sentire il clic)
  • [ ] Cavo CT integro, jack completamente inserito nella presa
  • [ ] VCC di alimentazione entro 4.5…5.5 V, massa pulita
  • [ ] Pull-up I²C verificati (vedi hardware-connection.md → Pull-up I²C)
  • [ ] Per i moduli BASIC della serie SCT: REG_CT_MODEL scritto e salvato in corrispondenza del sensore installato
  • [ ] Test di funzionamento con un carico resistivo completato — tutti e cinque i valori (U, I, P, PF, Q) entro gli intervalli attesi

Se una voce non è spuntata, si attenda letture strane. Le cause più comuni degli errori di misura sono problemi di installazione dei sensori, non guasti di firmware o di elettronica.

Serie CT (pinze accoppiate in fabbrica)

  • ❌ Le letture sembrano errate su un canale — la pinza non è sul proprio canale o è stata sostituita. Ricolleghi la pinza contrassegnata con quel numero di canale; una pinza che appartiene a un altro canale dà un valore errato.
  • ❌ Una scrittura della classe del sensore o del modello restituisce ERR_PARAM (0xFE) — atteso con il firmware 1.4.22 e successivi: un modulo della serie CT rifiuta queste scritture. Non le scriva (vedi avvio senza configurazione).
  • ❌ Una pinza o un canale è danneggiato — non sono sostituibili sul campo; contatti l'assistenza di fabbrica.
  • ❌ La corrente è negativa / l'energia va nel senso sbagliato — la pinza è invertita: la freccia deve puntare verso il carico.

Codici di errore (REG_ERROR = 0x02)

Codice Nome Significato Azione
0x00 ERR_OK Normale — l'ultima scrittura è riuscita —
0xF9 ERR_CLONE Riservato — non sollevato Se dovesse mai essere osservato, contatti il fornitore.
0xFA ERR_LUT_BAD tabella di calibrazione di fabbrica con CRC fallito; il modulo usa un'approssimazione lineare Non fatale. Le misure continuano; l'accuratezza può essere ridotta. Faccia ricalibrare dal fornitore.
0xFB ERR_FLASH_PARAMS_BAD Blocco dei parametri in flash danneggiato; valori di fabbrica ripristinati Riconfiguri indirizzo / SENSOR_CLASS / CT_MODEL ed emetta CMD_SAVE_USER_CONFIG (0x32). Normale su un modulo vergine (vedi capitolo 11 §6.5) — non interrompa la prima configurazione per 0xFB.
0xFC ERR_NOT_READY La prima finestra RT non è ancora completata dopo l'avvio Attenda 300 ms.
0xFD ERR_SENSOR_OVERFLOW Saturazione del segnale di ingresso (fondo scala superato) Riduca la corrente o usi una pinza CT più grande.
0xFE ERR_PARAM Codice comando non valido o valore fuori intervallo Controlli il comando e l'intervallo dei valori.
0xFF ERR_UNHANDLED HardFault o condizione non gestita Ciclo di alimentazione. Se si ripresenta, contatti il fornitore.

Semantica — REG_ERROR NON è persistente (v1.3)

REG_ERROR contiene l'esito dell'ultima transazione di scrittura. Ogni scrittura successiva — riuscita o meno — lo sovrascrive. Non serve azzerare REG_ERROR tra un tentativo e l'altro; anzi, leggerlo più tardi rispetto a subito dopo la scrittura fallita può mostrare un risultato più recente di un'operazione successiva.

Se ha bisogno di un segnale di errore durevole che sopravviva alle scritture successive, usi EVENT_FLAGS.bit3 (ERROR_OCCURRED) — si blocca con W1C e si azzera solo quando il master scrive 1 nel bit. Vedi il capitolo 11 §5.3 per il modello completo degli errori.

Azzeramento esplicito (raramente necessario): CMD_CLEAR_ERROR (opcode 0x31) azzera REG_ERROR.

Nelle librerie client

— lo stesso compito senza accesso ai registri:

Libreria Chiamata Cosa fa
Arduino RbAmp::readLastError() / RbAmp::clearError() legga il codice di errore dell'ultima scrittura; lo cancelli
ESP-IDF rbamp_read_last_error() / rbamp_clear_error() legga il codice di errore dell'ultima scrittura; lo cancelli
Python dev.read_last_error() / dev.clear_error() legga il codice di errore dell'ultima scrittura; lo cancelli
ESPHome get_last_error_str() / write_clear_error() il codice di errore come testo; cancella l'errore

Quando contattare il fornitore

Sintomi che richiedono assistenza:

  • Il modulo non esce da DATA_VALID = 0 dopo tre cicli di accensione e spegnimento
  • ERR_UNHANDLED (0xFF) si ripresenta
  • Sospetta deriva di calibrazione — la differenza superiore al 5 % rispetto a un misuratore di riferimento su un carico resistivo noto persiste dopo aver soddisfatto la checklist diagnostica del punto #17
  • Il contenitore è caldo o odora di materiale bruciato
  • Discrepanza superiore al 5 % rispetto a un misuratore di riferimento, nonostante la checklist del punto #17 sia soddisfatta
  • Un modulo nuovo si avvia con ERR_LUT_BAD (0xFA) alla prima accensione

Avanti