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
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:
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)
— 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 = 1non 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).
— 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_MODELnon impostato — il modulo non conosce la sensibilità del sensore. Vedi initialization.md → Impostare la classe del sensore e il modello CT. Il registro0x05deve 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²). SeI_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_Wriporta correttamente la media nel tempo. Verifichi conPERIOD_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_Wnon regge: - Sul livello BASIC: verifichi il segno RT di
P_real. SePè occasionalmente negativa (per esempio quando un inverter solare immette in rete), i campioni negativi vengono esclusi daPERIOD_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):
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
}
— 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:
- Scolleghi ogni modulo.
- 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.
- 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.
— 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:
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.
— 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+ associCT_MODELper canale + emettaCMD_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 AP_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_MODELscritto 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.
— 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 = 0dopo 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
- arduino-examples.md — esempi con gestione degli errori
- Per le integrazioni di domotica (ESPHome / Home Assistant, Python), vedi la tabella delle librerie client nel README