rbAmp
FR
Boutique
Docs
Mis à jour le

05 · Dépannage

Ce chapitre est une référence rapide pour les problèmes courants et leurs solutions. Chaque entrée suit la structure :

  • Symptôme — ce que l'utilisateur observe
  • Causes — pourquoi cela peut arriver
  • Quoi vérifier / faire— actions concrètes
    Organigramme pour cerner un problème à partir du symptôme.

Bus I²C

1. NACK / pas de réponse du module

Symptôme : Wire.endTransmission() renvoie une valeur non nulle ; i2cdetect n'affiche pas l'adresse sous Linux ; rb_read_u8() renvoie 0xFF.

Causes et vérifications :

  • ❌ Alimentation du module absente ou instable — mesurez VCC avec un multimètre ; elle doit être comprise entre 4.5 et 5.5 V.
  • ❌ Pas de masse commune — l'erreur la plus fréquente, de loin. La masse du maître et celle du module doivent être reliées ensemble.
  • ❌ SDA et SCL inversés — vérifiez avec le schéma de câblage dans hardware-connection.md.
  • ❌ Aucun pull-up sur le bus — si les pull-ups intégrés ont été coupés sur un module et qu'aucun pull-up externe n'est installé, le bus est inopérant. Hors tension, mesurez SDA↔VCC : la valeur doit être de 1.5 à 4.7 kΩ.
  • ❌ Trop de résistances de rappel en parallèle — les résistances intégrées restent actives sur de nombreux modules (quatre ou plus), plus celles du maître, ce qui fait tomber l'équivalent sous ~1 kΩ. Le maître ne peut pas tirer le bus au niveau BAS. Déconnectez les résistances intégrées sur tous les modules sauf un.
  • ❌ Long câble sans paire torsadée ni tampon — au-delà de ~0.15 m, les fils parallèles se couplent capacitivement et les fronts s'arrondissent. Utilisez un UTP cat-5 (jusqu'à 1 m) ou un tampon PCA9515 (jusqu'à 3 m). Voir hardware-connection.md → Longueur du bus.
  • ❌ Mauvaise adresse d'esclave — le module a peut-être été réadressé. Lancez un scan 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);
    }
  }
}
  • ❌ Vitesse I²C trop élevée pour la longueur du câble. Ramenez-la à 50 kHz : Wire.setClock(50000);.

2. Dépassements de délai de lecture/écriture intermittents

Symptôme : les transactions réussissent parfois, échouent d'autres fois — surtout dans des environnements électriquement bruités ou près de charges inductives.

Causes:

  • ❌ Câble long sans paire torsadée
  • ❌ Câble posé en parallèle avec le câblage secteur → couplage 50 Hz / 100 Hz
  • ❌ Masse bruitée côté maître (par ex. un régulateur séparé sans capacité de découplage)
  • ❌ Capacité parasite entre SDA et GND > 100 pF (par ex. une épissure avec de longs bouts)

Solutions:

  • Utilisez une paire torsadée (SDA + GND dans une paire, SCL + GND dans l'autre)
  • Évitez de faire passer l'I²C en parallèle avec le câblage de puissance dans le même conduit
  • Réduisez la vitesse à 50 kHz / ajoutez 100 nF entre VCC et GND du module, près du connecteur
  • Pour les longs tronçons hors boîtier, ajoutez une protection ESD (diodes TVS sur SDA et SCL)
Dans les bibliothèques clientes

— la même tâche sans accès aux registres :

Bibliothèque Appel Ce qu'il fait
Arduino RbAmp::retryExhaustionCount() / RbAmp::sanityRejectCount() a épuisé les nouvelles tentatives de bus et rejeté des lectures
ESP-IDF rbamp_retry_exhaustion_count() / rbamp_sanity_reject_count() a épuisé les nouvelles tentatives de bus et rejeté des lectures
Python dev.sanity_reject_count / compteurs de MachineI2CBackend compter les lectures rejetées ; compteurs de nouvelles tentatives sur le backend MicroPython
ESPHome — aucun compteur de diagnostic exposé

3. DATA_VALID (0xCE) ne passe jamais à 1

Symptôme : le maître lit 0xCE et obtient toujours 0x00. D'autres registres peuvent aussi rester à zéro.

Causes:

  • ❌ Le module n'a pas fini de démarrer (normal pendant les ~250 ms suivant la mise sous tension)
  • ❌ Erreur d'initialisation du firmware — lisez REG_ERROR (0x02) :
  • 0xFB (ERR_FLASH_PARAMS_BAD) — le bloc de paramètres flash est corrompu ; le module fonctionne avec les valeurs par défaut. Recalibrer / reprovisionner.
  • 0xFA (ERR_LUT_BAD) — la table d'étalonnage d'usine est défectueuse. Non bloquant — les mesures continuent ; la précision peut être réduite. Demandez au fournisseur un recalibrage.
  • ❌ Défaillance de l'horloge MCU (rare) — couper et rétablir l'alimentation du module

Solutions:

  • Attendez 300 ms après la mise sous tension avant d'interroger 0xCE.
  • Si DATA_VALID = 1 n'apparaît pas après > 1 s — coupez puis rétablissez l'alimentation.
  • Si le problème persiste après une coupure d'alimentation — vérifiez l'alimentation (ondulation, creux de tension).
Dans les bibliothèques clientes

— la même tâche sans accès aux registres :

Bibliothèque Appel Ce qu'il fait
Arduino RbAmp::waitReady(timeout_ms) / RbAmp::readLastError() attendre l'indicateur prêt ; lire le code d'erreur du périphérique
ESP-IDF rbamp_wait_ready() / rbamp_read_last_error() attendre l'indicateur prêt ; lire le code d'erreur du périphérique
Python dev.wait_ready(timeout_ms=1000) / dev.read_last_error() attendre le drapeau de disponibilité (lève une erreur au délai) ; lire le code d'erreur de l'appareil
ESPHome Vérification de disponibilité de update() / get_last_error_str() les lectures sont publiées dès que le module signale qu'il est prêt ; le code d'erreur en texte

Étalonnage et précision

4. I_rms proche de 0 alors qu'une charge fonctionne

Symptôme : la lampe est allumée, le chauffage est chaud, mais I_rms affiche 0.001 A ou oscille entre 0 et quelques mA.

Causes (par ordre de fréquence décroissante) :

  • ❌ Pince CT pas sur le fil — le conducteur passe à côté de la pince au lieu de la traverser.
  • ❌ Pince CT sur L et N en même temps — les flux de la phase et du neutre s'annulent, le capteur lit une valeur proche de zéro. Voir hardware-connection.md → Capteur de courant. La pince doit être sur un seul conducteur (phase/L).
  • ❌ Pince non entièrement fermée — un jeu > 0.1 mm entre les moitiés du noyau augmente fortement la réluctance magnétique, donc la sortie du capteur chute bien en dessous de la normale. Déclipsez et reclipsez jusqu'à la fermeture complète. La saleté ou l'oxyde dans l'entrefer est une cause fréquente — essuyez les surfaces de contact.
  • ❌ Prise jack 3.5 mm mal enfoncée — retirez et réinsérez la fiche.
  • ❌ REG_CT_MODEL non réglé — le module ne connaît pas la sensibilité du capteur. Voir initialization.md → Régler la classe de capteur et le modèle CT. Le registre 0x05 doit contenir le bon code de modèle.
  • ❌ Mauvais code de modèle écrit — par exemple, un capteur SCT-013-030 avec le code SCT-013-010 → le courant affiché sera ~3× plus faible que la réalité (et inversement, un code trop grand affiche une valeur haute). Vérifiez le marquage du capteur par rapport au code de modèle.
  • ❌ Courant sous le plancher de bruit — pour de très faibles charges (< ~10 mA sur une pince de 30 A), la sortie du capteur est proche du plancher de bruit. Le firmware applique une soustraction quadratique du bruit : I_corrected = √(I_raw² − NF²). Si I_raw ≤ NF, le résultat est ramené à 0. C'est le comportement voulu.

5. I_rms faux d'un facteur important

Symptôme : la charge réelle est d'environ 10 A (selon le compteur de référence), le module affiche 3 A ou 30 A.

Causes:

  • ❌ Mauvais code de modèle CT — le cas le plus fréquent. Voir #4.
  • ❌ Mauvais modèle de pince installé — quelqu'un a monté une pince de 100 A là où la configuration prévoit une pince de 30 A (ou l'inverse).
  • ❌ Pince non entièrement fermée (voir #4) — lit typiquement 5–20 % trop bas.
  • ❌ Dérive d'étalonnage d'usine suspectée — si tout ce qui précède est écarté et que l'écart persiste sur une charge de référence connue, contactez votre fournisseur de modules ; le recalibrage est une opération d'usine.

6. Le signe de P_real est faux (la consommation apparaît comme injection)

Symptôme : la charge consomme clairement (chauffage chaud, lampe allumée), mais P_real < 0.

Causes et solutions :

  • ❌ L et N inversés sur les bornes de tension — la cause la plus fréquente. Voir hardware-connection.md → Capteur de tension. Inversez L et N sur le circuit imprimé.
  • ❌ Pince CT montée à l'envers — la flèche de la pince doit pointer dans le sens du courant, vers la charge (tableau → charge). Si elle pointe dans l'autre sens, déclipsez la pince et retournez-la.
  • ❌ L'inversion physique est impraticable — sur BASIC l'accumulateur de période (PERIOD_AVG_P_W) ramène à zéro les échantillons négatifs ; avec une polarité inversée, le registre d'énergie reste à 0 tant que la polarité physique n'est pas corrigée — corriger en code maître (p_corrected = -p_raw) ne corrige que votre propre intégration RT, jamais les données de période du module. Corrigez le câblage.

7. Le total d'énergie diffère de quelques pour cent d'un compteur de référence

Symptôme : E_Wh sur une heure diffère du compteur du distributeur de 2–10 %.

Causes probables (par ordre décroissant) :

  • ❌ Pince non entièrement fermée (jeu) — typiquement −5 à −20 % en dessous. La cause la plus fréquente. Déclipsez, nettoyez les surfaces de contact, puis reclipsez jusqu'à fermeture complète.
  • ❌ Pince posée sur un fil « secondaire » — à l'intérieur du tableau électrique, sur un court bout après un disjoncteur. Les champs parasites des disjoncteurs voisins introduisent des erreurs. Déplacez la pince sur l'arrivée principale ou sur une section isolée du conducteur.
  • ❌ Près de fortes charges réactives — à proximité de transformateurs, de moteurs asynchrones, d'onduleurs. Les champs magnétiques des inductances voisines créent un signal parasite. Éloignez la pince d'au moins 10 cm de tout composant ferromagnétique.
  • ❌ Facteur de puissance faible (≤ 0.5) — les charges réactives importantes exigent une compensation de phase précise. La précision est spécifiée pour des charges résistives (PF ≈ 1) ; elle n'est pas spécifiée pour des charges fortement réactives. Si la précision sur un profil de PF précis est critique, contactez votre fournisseur de modules pour un conseil.
  • ❌ Tension secteur déformée (micro-creux, harmoniques d'ordre élevé) — le calcul RMS et de la moyenne est plus robuste que la détection de crête, mais la précision n'est pas spécifiée pour une tension secteur fortement déformée ; contactez votre fournisseur si cela importe pour votre installation.
  • ❌ Câble de pince CT endommagé ou prise desserrée — circuit ouvert ou soudure froide dans la fiche. Vérifiez au multimètre, prise débranchée du module (la pince CT est un transformateur abaisseur ; l'enroulement secondaire doit mesurer 50–200 Ω selon le modèle).

8. avg_P_W est nettement inférieur à la valeur attendue

Symptôme : un radiateur de 1000 W fonctionne, RT P_real ≈ 1000 W, mais PERIOD_AVG_P_W affiche ~200 W sur une période d'une minute.

Causes:

  • ❌ La charge est en réalité intermittente (thermostat à cycle, élément pulsé) — avg_P_W donne correctement la moyenne temporelle. Vérifiez avec PERIOD_MAX_P_W (0xE0) pour voir le pic dans n'importe quelle fenêtre de mesure.
  • ❌ Si la charge est stable et que RT P_real ≈ avg_P_W n'est pas vérifié :
  • En niveau BASIC : vérifiez le signe RT de P_real. Si P est parfois négatif (un onduleur solaire qui réinjecte, par exemple), les échantillons négatifs sont exclus de PERIOD_AVG_P_W, ce qui tire la moyenne vers le bas. Voir period-metering.md → niveau BASIC.

9. PERIOD_VALID = 0 après un instantané

Symptôme : le maître envoie CMD_LATCH_PERIOD, lit 0x07 et obtient 0. L'instantané n'est pas récent.

Causes:

  • ❌ Instantanés trop rapprochés — aucune fenêtre RT (~100 ms depuis la v1.2 ; 200 ms avant) ne s'est terminée entre deux instantanés. L'accumulateur est vide, l'instantané est jeté.
  • ❌ Course avec une validation temps réel — rare : le maître a écrit la commande à l'instant exact où le firmware validait l'accumulateur en direct. Possible avec des maîtres très rapides.

Solution — le schéma de nouvelle tentative (voir period-metering.md → Cycle de 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
}
Dans les bibliothèques clientes

— la même tâche sans accès aux registres :

Bibliothèque Appel Ce qu'il fait
Arduino RbAmp::isPeriodValid() / RbAmp::readPeriodSnapshot() vérifier le bit d'instantané prêt ; prendre et valider un instantané de période
ESP-IDF rbamp_is_period_valid() / rbamp_read_period_snapshot() vérifier le bit d'instantané prêt ; prendre et valider un instantané de période
Python dev.is_period_valid() / dev.read_period_snapshot() vérifier le bit d'instantané prêt ; prendre et valider un instantané de période
ESPHome Instantané de période non valide ce que le composant journalise lorsque l'indicateur de validité vaut 0 ; le premier instantané après démarrage est écarté

Problèmes multi-modules

10. Collision d'adresses

Symptôme : plusieurs modules ajoutés au bus — certains « disparaissent » ou renvoient des données aberrantes. La même adresse répond avec des valeurs différentes.

Cause : deux modules ou plus partagent la même adresse → arbitrage / collision I²C. Fréquent juste après le déballage, quand tous les modules sont sur l'adresse d'usine 0x50.

Forme plus subtile : l'adresse répond de façon stable, mais l'UID lu à 0x5C (ch. 11 §4.8) ne correspond à aucun module connu. Deux modules répondent ensemble — le bus fait un ET filaire de leurs sorties, produisant un UID stable mais fictif. Si un hub voit un « UID inconnu » à une adresse qu'il a attribuée, suspectez une collision avant de suspecter un module étranger.

Solution:

  1. Déconnecter chaque module.
  2. Reconnectez un à la fois — ne changez jamais l'adresse de deux modules en configuration d'usine sur le bus ; changez l'adresse de chacun vers une adresse unique.
  3. Après avoir réadressé tous les modules, reconnectez-les en parallèle et vérifiez chaque adresse en lisant son UID.

Voir initialization.md → Flux de travail recommandé.

Dans les bibliothèques clientes

— la même tâche sans accès aux registres :

Bibliothèque Appel Ce qu'il fait
Arduino RbAmpFleet::checkConflict() / RbAmpFleet::scan() vérifier une adresse pour un second appareil ; scanner le bus à la recherche de modules
ESP-IDF rbamp_fleet_check_conflict() / rbamp_fleet_scan() vérifier une adresse pour un second appareil ; scanner le bus à la recherche de modules
Python fleet.check_conflict(addr) / fleet.scan() vérifier une adresse pour un second appareil ; scanner le bus à la recherche de modules
ESPHome rbamp: liste un bloc par module, chacun avec son propre id et address

11. La DRDY en collecteur ouvert commun se déclenche plusieurs fois de suite

Symptôme : avec un DRDY en OU câblé, l'EXTI du maître se déclenche toutes les 1–5 ms, plusieurs fois de suite.

Cause : les modules ne sont pas parfaitement synchronisés — chacun a son propre quartz, et les périodes de fenêtre RT diffèrent légèrement (99.9 ms contre 100.1 ms). Sur la durée de la fenêtre, les modules tirent la ligne à des instants légèrement différents.

C'est normal. Solutions :

  • Ignorez les déclenchements « doubles » : après le premier déclenchement, lisez tous les modules ; supprimez les déclenchements suivants dans les ~10 ms.
  • Utilisez l'instantané de diffusion (voir period-metering.md → Approche 2) pour une synchronisation précise — mais uniquement pour les instantanés de période, pas pour le temps réel.
  • Passer à DRDY par module — chaque module sur sa propre broche GPIO.

12. Bus I²C occupé quand DRDY se déclenche

Symptôme : DRDY se déclenche alors que le maître est déjà dans une transaction avec un autre module. Le gestionnaire EXTI est retardé.

C'est normal. Les registres RT restent valides jusqu'au prochain commit (une fenêtre, ~100 ms, plus tard). Le maître :

  • Termine la transaction en cours.
  • Traite l'EXTI différé et lit le module suivant.
  • Latence : 1–10 ms en général — sans importance critique.

13. Dérive d'horloge multi-modules lors d'essais longs

Symptôme : l'énergie cumulée diverge entre modules de fractions de pour cent sur une semaine.

Cause : chaque rbAmp a son propre quartz avec une dérive de ±50 ppm (1–5 s/jour).

Solution — intégrée à l'architecture : le maître utilise sa propre horloge pour multiplier par dt. Tous les modules partagent la même référence temporelle, de sorte que le total Wh à l'échelle du système ne diverge pas.

Pour mesurer la dérive de la puce à des fins d'assurance qualité, comparez PERIOD_LATCH_MS (0xEC) avec le dt du maître :

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);

Seuil d'acceptation pour PERIOD_LATCH_MS : une sous-estimation allant jusqu'à 30 % est normale sous charge (rapport descendant jusqu'à ~0.70). La base de temps de diagnostic interne du module affiche une valeur trop courte lorsque le module est occupé — c'est volontaire. L'enveloppe de 30 % est une propriété de la base de temps du module, pas un défaut. Appliquez ce seuil de façon uniforme à toutes les références et à tous les niveaux.

Le seuil historique de 3 % de la documentation antérieure est faux pour la v1.3 et rejettera en masse des modules sains ; ne l'utilisez pas.

Cette dérive n'affecte que le registre de diagnostic côté puce ; la précision énergétique n'est pas affectée car les Wh sont calculés côté maître comme avg_P × master_dt (voir period-metering.md). Si master_dt lui-même dérive (l'horloge du MCU maître se décale), appliquez la correction NTP/SNTP propre au maître — PERIOD_LATCH_MS n'est pas la bonne référence.

Dans les bibliothèques clientes

— la même tâche sans accès aux registres :

Bibliothèque Appel Ce qu'il fait
Arduino RbAmp::readPeriodLatchMs() lire la longueur de période côté module (diagnostic uniquement)
ESP-IDF rbamp_read_period_latch_ms() lire la longueur de période côté module (diagnostic uniquement)
Python dev.read_period_latch_ms() lire la longueur de période côté module (diagnostic uniquement)
ESPHome — non exposé

Alimentation et flash

14. Coupure d'alimentation pendant une commande d'écriture flash → écriture flash partielle

Symptôme : après une coupure de courant pendant une commande d'écriture en flash (CMD_SAVE_USER_CONFIG, CMD_COMMIT_ADDR), le module démarre avec REG_ERROR = 0xFB (ERR_FLASH_PARAMS_BAD) et EVENT_FLAGS.bit3 positionné.

Ce qui s'est passé : le firmware a détecté un échec de CRC dans le bloc de configuration utilisateur en flash, a chargé les valeurs d'usine et les a réécrites.

Solution:

  • Les valeurs d'usine sont restaurées — le module fonctionne, mais son adresse personnalisée et sa configuration de capteur sont perdues.
  • Réappliquez la configuration : réglez SENSOR_CLASS + liez CT_MODEL par canal + lancez CMD_SAVE_USER_CONFIG (et refaites le changement d'adresse si nécessaire).
  • Pour l'éviter à l'avenir : ne coupez pas l'alimentation pendant au moins 1 seconde après toute commande d'écriture en flash. La fenêtre d'effacement et d'écriture de la flash elle-même dure ~700 ms ; prévoyez une marge.

15. Le module est chaud

Symptôme : le boîtier paraît nettement chaud.

Normal : au courant secteur jusqu'au nominal (selon la référence), un léger échauffement du côté BT (régulateur LDO) jusqu'à ~40 °C est attendu.

Pas normal : boîtier chaud (≥ 60 °C), odeur de brûlé, décoloration du plastique.

Causes:

  • ❌ Surtension côté basse tension (VCC > 5.5 V) — vérifiez l'alimentation.
  • ❌ Dommage interne côté secteur (court-circuit dans le diviseur ou le circuit CT).
  • ❌ Pince CT externe en surcharge (courant au-delà de la plage du capteur).

Action : coupez immédiatement l'alimentation, isolez le module, contactez le fournisseur.

Câblage du capteur — erreurs critiques

16. Contrôle de cohérence — ce que signifie « câblé correctement »

Après installation ou réinstallation d'un module, lancez un test de fonctionnement avec une charge purement résistive connue (ampoule à incandescence, bouilloire électrique, élément chauffant) — par exemple une ampoule de 100 W sur 230 V.

Expected:

  • U_rms ≈ 220..240 (selon le secteur local)
  • I_rms ≈ 100 W / 230 V ≈ 0.43 A
  • P_real ≈ +100 W (positif, consommation)
  • PF ≈ 0.998..1.000 (charge résistive)
  • Q ≈ 0 (pas de contenu réactif)

Si P_real est négatif : voir #6 — L/N inversés ou pince montée à l'envers. Si |I_rms − expected| > 10 % : voir #5 — mauvais modèle CT ou pince non fermée. Si |P_real − U × I| > 5 % à PF = 1 : la compensation de phase peut être décalée — contactez le fournisseur.

17. Liste de contrôle avant mise en service

Avant de mettre un module sous tension dans un système en production :

  • [ ] L relié à la borne L du circuit imprimé (non inversé avec N)
  • [ ] Pince CT sur le conducteur L (pas sur N, ni sur les deux à la fois)
  • [ ] Flèche de la pince CT pointant vers la charge
  • [ ] Pince CT entièrement fermée (sans jeu ni mou — la clipser jusqu'à ce qu'elle claque)
  • [ ] Câble CT intact, prise jack bien enfoncée dans la douille
  • [ ] VCC alimenté entre 4.5 et 5.5 V, masse propre
  • [ ] Résistances de rappel I²C vérifiées (voir hardware-connection.md → Résistances de rappel I²C)
  • [ ] Pour les modules BASIC de la série SCT : REG_CT_MODEL écrit et sauvegardé pour correspondre au capteur installé
  • [ ] Test de fonctionnement avec une charge résistive effectué — les cinq valeurs (U, I, P, PF, Q) dans les plages attendues

Si un point n'est pas coché, attendez-vous à des valeurs étranges. Les causes les plus fréquentes d'erreurs de mesure sont des problèmes d'installation du capteur, et non des défauts de firmware ou d'électronique.

Série CT (pinces appairées en usine)

  • ❌ Les valeurs semblent fausses sur un canal — la pince n'est pas sur son propre canal ou a été remplacée. Rebranchez la pince marquée du numéro de ce canal ; une pince qui appartient à un autre canal donne une valeur fausse.
  • ❌ Une écriture de la classe ou du modèle de capteur renvoie ERR_PARAM (0xFE) — attendu sur le firmware 1.4.22 et ultérieur : un module de la série CT refuse ces écritures. Ne les écrivez pas (voir démarrage sans configuration).
  • ❌ Une pince ou un canal est endommagé — ils ne sont pas remplaçables sur site ; contactez le service après-vente de l'usine.
  • ❌ Le courant est négatif / l'énergie va dans le mauvais sens — la pince est inversée : la flèche doit pointer vers la charge.

Codes d'erreur (REG_ERROR = 0x02)

Code Nom Signification Action
0x00 ERR_OK Normal — la dernière écriture a réussi —
0xF9 ERR_CLONE Réservé — non levé Si cela se produit, contactez le fournisseur.
0xFA ERR_LUT_BAD échec du CRC de la table d'étalonnage d'usine ; le module fonctionne avec une approximation linéaire Pas fatal. Les mesures continuent ; la précision peut être réduite. Faites recalibrer par le fournisseur.
0xFB ERR_FLASH_PARAMS_BAD Bloc de paramètres flash corrompu ; valeurs par défaut restaurées Reconfigurez l'adresse / SENSOR_CLASS / CT_MODEL puis lancez CMD_SAVE_USER_CONFIG (0x32). Normal sur un module vierge (voir chapitre 11 §6.5) — n'interrompez pas le premier provisionnement sur 0xFB.
0xFC ERR_NOT_READY La première fenêtre RT n'est pas encore terminée après le démarrage Attendre 300 ms.
0xFD ERR_SENSOR_OVERFLOW Écrêtage du signal d'entrée (pleine échelle dépassée) Réduisez le courant ou utilisez une pince plus grosse.
0xFE ERR_PARAM Code de commande invalide ou valeur hors plage Vérifiez la commande et la plage de valeurs.
0xFF ERR_UNHANDLED HardFault ou condition non gérée Coupure d'alimentation. Si cela se reproduit, contactez le fournisseur.

Sémantique — REG_ERROR n'est PAS persistant (v1.3)

REG_ERROR contient le résultat de la dernière transaction d'écriture. Chaque écriture suivante — réussie ou non — l'écrase. Il n'est pas nécessaire d'effacer REG_ERROR entre deux tentatives ; en fait, le lire plus tard que immédiatement après l'écriture en échec peut montrer un résultat plus récent d'une opération suivante.

Si vous avez besoin d'un signal d'erreur durable qui survit aux écritures suivantes, utilisez EVENT_FLAGS.bit3 (ERROR_OCCURRED) — il se verrouille en W1C et ne s'efface que lorsque le maître écrit 1 dans ce bit. Voir le chapitre 11 §5.3 pour le modèle d'erreur complet.

Effacement explicite (rarement nécessaire) : CMD_CLEAR_ERROR (code d'opération 0x31) remet REG_ERROR à zéro.

Dans les bibliothèques clientes

— la même tâche sans accès aux registres :

Bibliothèque Appel Ce qu'il fait
Arduino RbAmp::readLastError() / RbAmp::clearError() lire le code d'erreur de la dernière écriture ; l'effacer
ESP-IDF rbamp_read_last_error() / rbamp_clear_error() lire le code d'erreur de la dernière écriture ; l'effacer
Python dev.read_last_error() / dev.clear_error() lire le code d'erreur de la dernière écriture ; l'effacer
ESPHome get_last_error_str() / write_clear_error() le code d'erreur en texte ; effacer l'erreur

Quand contacter le fournisseur

Symptômes justifiant une intervention :

  • Le module ne quitte pas DATA_VALID = 0 après trois coupures d'alimentation
  • ERR_UNHANDLED (0xFF) se répète
  • Dérive d'étalonnage suspectée — écart > 5 % avec un compteur de référence sur une charge résistive connue, persistant après la liste de contrôle diagnostique du point 17
  • Le boîtier est chaud ou sent le matériau brûlé
  • Écart avec un compteur de référence > 5 % malgré la liste de contrôle du point 17 satisfaite
  • Un nouveau module démarre avec ERR_LUT_BAD (0xFA) à la première mise sous tension

Suivant