rbAmp
FR
Boutique
Docs
Mis à jour · Modifier sur GitHub [Edit on GitHub]

03 · Choix du capteur de courant

Installation de la pince CT : serrez uniquement le fil L, flèche orientée vers la charge.

Ce chapitre répond à deux questions :

  1. Quel capteur de courant choisir pour une charge donnée.
  2. Comment indiquer au module rbAmp votre choix afin que l'étalonnage d'usine pour cette combinaison se charge automatiquement.

Le raccordement physique du capteur (orientation de la pince, contrôle de la polarité L/N) est traité dans 04_hardware.md. Ce chapitre porte sur le choix du modèle et l'appel de l'API.

Classe de capteur

Les modules rbAmp fonctionnent avec des pinces de courant de la famille SCT-013. La classe de capteur d'une pince SCT-013 à clipser que vous installez vous-même se définit une fois avec setSensorClass(Sct013), avant de choisir le modèle. Si votre module est livré avec son TC déjà raccordé, sautez les appels de configuration de ce chapitre.

Choisir un modèle SCT-013

Dans la famille SCT-013, sept modèles sont pris en charge (codes {1, 2, 3, 4, 5, 6, 7}).

code Modèle Plage de courant Statut Usage typique
1 SCT-013-005 0…5 A ✅ caractérisé Petites charges — lampes, électronique basse consommation, un simple interrupteur
2 SCT-013-010 0…10 A ✅ caractérisé Un appareil de puissance moyenne — réfrigérateur, lave-linge, climatiseur jusqu'à 2 kW
3 SCT-013-030 0…30 A ✅ caractérisé Arrivée de service domestique de taille moyenne — jusqu'à ~7 kW
4 SCT-013-050 0…50 A ✅ caractérisé Grande arrivée de service — chauffage électrique, borne de recharge VE, maison individuelle avec pointes de charge
5 SCT-013-100 0…100 A ✅ caractérisé Entrée de service principale d'un foyer ou d'un petit bureau
6 SCT-013-020 0…20 A ✅ caractérisé Entrée de service moyenne — appareils de 3 à 4 kW, gros appareils domestiques
7 SCT-013-060 0…60 A ✅ caractérisé Sous-compteur industriel
Remarque

Codes acceptés — {1, 2, 3, 4, 5, 6, 7}. Un code hors de cet ensemble (par exemple 0 ou 8) passé à dev.setCTModel(...) (ou à configureChannels(...)) renvoie false avec lastError() == RB_ERR_PARAM — la bibliothèque n'envoie pas l'écriture à l'appareil (garde côté client).

Les codes 0x06 et 0x07 ne sont pas monotones selon le calibre — ils ont été ajoutés après l'ensemble d'origine 0x01..0x05. Choisissez toujours selon le calibre dont vous avez besoin, et non selon l'ordre des codes.

Comment choisir le bon modèle

La règle de base :

  1. Déterminez le courant maximal pouvant circuler dans le circuit (plus grosse charge + marge de 30 %).

  2. Lisez le modèle sur l'étiquette imprimée sur la pince.

  3. Une seule règle : choisissez la plus petite pince au calibre supérieur à votre plus grand courant attendu. Une pince de calibre trop petit écrête aux pointes et lit trop bas ; une pince de calibre bien trop grand lit de façon bruitée aux faibles courants (un SCT-013-100 sur un circuit de 5 A fonctionne, mais avec une mauvaise résolution).

Comment choisir une pince SCT-013 : prenez le plus grand courant attendu plus une marge de 30 %, choisissez la plus petite pince de calibre supérieur, et réglez son code de modèle.

Marge

Une pince SCT-013 fonctionne sans saturation dans sa plage nominale. Les brèves pointes (démarrage de compresseur, charge inductive) peuvent dépasser le calibre de 5 à 7× — c'est normal, la pince le supporte physiquement, mais la mesure devient non linéaire au-delà du calibre.

Si votre charge a un courant crête supérieur au calibre de la pince, choisissez le calibre supérieur : la plus petite pince au calibre supérieur à la crête, avec une marge de 30 %. Par exemple, pour un lave-linge avec un courant d'appel de 12 A (et 2-3 A en fonctionnement), 12 A × 1.3 = 15.6 A : choisissez un SCT-013-020 (et non un SCT-013-005, qui saturerait à la crête).

Indiquer votre choix au module

Deux appels dans le bon ordre sont requis — d'abord setSensorClass(), puis setCTModel(). Si vous appelez setCTModel() avant setSensorClass(), le module renvoie une erreur RB_ERR_PARAM et le préréglage NE sera PAS chargé.

Remarque

Le modèle de TC est un préréglage fonctionnel, pas une étiquette. Écrire le modèle de TC applique immédiatement l'étalonnage d'usine de cette pince au pipeline de mesure du module ; les lectures de courant changent. Modifier la sensor_class remet le modèle de TC à la valeur par défaut (0) et impose de le redéfinir.

C++
#include 
#include 

RbAmp dev(Wire, 0x50);

void setup() {
    Wire.begin();
    while (!dev.begin()) { delay(500); }

    // Step 1: select the sensor family. REQUIRED before setCTModel().
    if (!dev.setSensorClass(RbAmpSensorClass::Sct013)) {
        // setSensorClass failed — check the connection, power, and address.
        return;
    }

    // Step 2: select the model within the family.
    if (!dev.setCTModel(RbAmpCTModel::Sct013_030)) {
        // Possible causes (any → RB_ERR_PARAM):
        //  1. setSensorClass() was not called before setCTModel()
        //  2. code not in the per-class accept-set (for Sct013: {1,2,3,4,5,6,7})
        //  3. no factory preset for the selected class
        //     (applies to WiredCT / BuiltinCT in the current firmware)
        //  4. communication error (RB_ERR_IO, not RB_ERR_PARAM — a separate code)
        return;
    }
}
Remarque

La bibliothèque n'appelle volontairement PAS setSensorClass() à votre place. Si cette étape est omise, setCTModel() renvoie false avec RB_ERR_PARAM sans rien écrire en flash. Cela garde un comportement prévisible et explicite — aucune « magie » dans l'API publique.

Après ces deux appels :

  • Le module stocke les deux valeurs en flash — le réglage survit à une réinitialisation, à une coupure d'alimentation et à un reflashage du firmware.

  • Les coefficients de calibration pour cette combinaison précise (classe de capteur + modèle) sont chargés depuis la table de préréglages d'usine. Vous n'avez besoin de toucher à aucun registre de calibration manuel.

  • Le prochain appel à dev.readCurrent(0) renvoie déjà une valeur en ampères, correctement mise à l'échelle.

Durée totale des deux appels : environ 1.4 seconde (deux opérations d'écriture en flash × ~700 ms chacune, limitées par le temps d'effacement de la page flash). Elle n'est faite qu'une fois à la première installation ; le réglage est stocké en flash et n'est pas répété.

Remarque

Si vous avez déjà sélectionné le capteur au premier démarrage et redémarrez simplement le contrôleur, il n'est pas nécessaire de répéter les appels setSensorClass() et setCTModel() — le module garde le choix précédent. Cela ne fait pas de mal non plus : rappeler avec la même valeur réécrit simplement le même octet.

Vérifier la configuration

Une vérification simple après setCTModel() :

C++
void setup() {
    Wire.begin();
    while (!dev.begin()) { delay(500); }
    dev.setSensorClass(RbAmpSensorClass::Sct013);
    dev.setCTModel(RbAmpCTModel::Sct013_030);

    Serial.print(F("Ready. Connect a purely resistive load "));
    Serial.println(F("(for example, an incandescent lamp)."));
    Serial.println(F("Expect a steady PF ≈ 1.0 and positive P."));
}

void loop() {
    Serial.print(F("U=")); Serial.print(dev.readVoltage(), 1);
    Serial.print(F("V  I=")); Serial.print(dev.readCurrent(0), 2);
    Serial.print(F("A  P=")); Serial.print(dev.readPower(0), 1);
    Serial.print(F("W  PF=")); Serial.println(dev.readPowerFactor(0), 2);
    delay(2000);
}

Sur une charge purement résistive (lampe à incandescence, bouilloire électrique, élément chauffant), attendez-vous à :

  • U ≈ 220–240 V (pour un secteur 230 V)
  • I ≈ correspondant à la puissance de la charge (P / U)
  • P > 0 et stable
  • PF ≈ 1.0 (franchement positif)

Si quelque chose ne concorde pas, voir 10_troubleshooting.md.

Modules à plusieurs canaux de courant

La gamme de références — ce qui convient à la tâche

SKU Canaux I Canal U Usage typique
UI1 1 oui Une seule charge avec calcul complet de puissance (P, PF, Q, Wh) — un compteur secteur type
UI2 2 oui Deux charges indépendantes sur une même phase avec puissance par canal
UI3 3 oui 1 U + 3 I — trois charges sur une phase avec puissance par canal (P, FP, Q, Wh)
I1 1 non Sous-compteur sans calcul de puissance (courant seul) — lorsqu'un UI1 séparé assure le comptage du secteur
I2 2 non Sous-compteur de courant à deux canaux — répartition par circuit
I3 3 non Sous-compteur de courant à trois canaux — répartition par circuit / topologie à double TC

Ce que mesure chaque canal

  • Canal U (UI uniquement) : U_rms, U_peak, fréquence. Un* par module.
  • Canaux I :
  • sur les variantes UI — chaque canal fournit I_rms, I_peak, P (puissance active), PF, avg_p sur la période.
  • sur les variantes I — courant seul (I_rms, I_peak). La puissance active et le PF ne sont pas calculés — ils exigent une tension, que la variante I n'a pas. Les registres power[]/powerFactor[] des variantes I renvoient 0.
  • Module monophasé : tous les canaux I doivent être sur la même phase que celle à laquelle le canal U est raccordé.

Modèle de CT par canal — calibration indépendante de chaque canal

Sur les modules multi-canaux (I2, I3), chaque canal de courant a une sélection de modèle SCT-013 indépendante. Vous pouvez, par exemple, brancher un SCT-013-005 sur le canal 0 (une seule prise), un SCT-013-030 sur le canal 1 (un circuit de cuisinière) et un SCT-013-020 sur le canal 2 (l'arrivée de service).

C++
uint8_t models[3] = {1, 3, 6};   // ch0=SCT-013-005, ch1=SCT-013-030, ch2=SCT-013-020
dev.configureChannels(RbAmpSensorClass::Sct013, models, 3);

Un seul appel configure la classe de capteur + tous les canaux en une seule opération avec une seule sauvegarde SAVE_USER_CONFIG. Mesuré au banc : ~1.4 seconde pour 1 SAVE contre ~3.5 secondes pour 3 cycles de sauvegarde séparés (setCTModel() + sauvegarde manuelle). Point clé — l'usure du cycle flash est 3× plus faible sur la même page flash.

Méthode 2 : setCTModel(channel, code) par canal — ordre quelconque

L'API de sélection par canal est setCTModel(channel, code) :

C++
dev.setSensorClass(RbAmpSensorClass::Sct013);   // once for all channels

// v1.3: binding order is arbitrary.
dev.setCTModel(0, 1);   // SCT-013-005
dev.setCTModel(1, 3);   // SCT-013-030
dev.setCTModel(2, 6);   // SCT-013-020

dev.saveUserConfig();    // explicit save at the end (3-SAVE alternative, slower)
Sécurité

✅ L'ordre des liaisons est indifférent (v1.3). Écrire REG_CT_MODEL (0x05) prépare la valeur mais ne l'applique à aucun canal automatiquement. L'application ne se fait que par la commande par canal CMD_SET_CT_MODEL_CHn, qui prend la valeur préparée actuelle et l'écrit dans son canal. Les canaux peuvent être configurés dans n'importe quel ordre (setCTModel(0, ...) en premier, en dernier ou entrelacé — cela ne change rien) ; aucun écrasement ne se produit. Toute mention de « croissant / décroissant / lier ch0 en dernier » dans les anciens documents et codes renvoie au comportement antérieur à v1.3 — elle peut être supprimée.

Cela dit, la liaison de chaque canal reste en deux étapes au niveau du protocole filaire (préparation REG_CT_MODEL → liaison CMD_SET_CT_MODEL_CHn) ; setCTModel(channel, code) de la bibliothèque encapsule les deux étapes.

Si tous les canaux reçoivent le même modèle, l'ordre n'a pas d'importance (l'effet de bord est idempotent) :

C++
dev.setSensorClass(RbAmpSensorClass::Sct013);
dev.setCTModel(0, RbAmpCTModel::Sct013_005);
dev.setCTModel(1, RbAmpCTModel::Sct013_005);   // ch0 is rewritten with the same value — no effect
dev.setCTModel(2, RbAmpCTModel::Sct013_005);
Compatibilité ascendante

: la surcharge entière setCTModel(uint8_t code) est conservée. Correspondance v1.3 : 1=Sct013_005, 2=Sct013_010, 3=Sct013_030, 4=Sct013_050, 5=Sct013_100, 6=Sct013_020, 7=Sct013_060. L'énumération typée RbAmpCTModel::Sct013_NNN est la forme recommandée (le compilateur détecte les valeurs invalides avant l'appel au bus). Sur les modules multi-canaux, le setCTModel(code) à un seul argument s'applique au canal 0 — équivalent à setCTModel(0, code).

Modules multi-canaux — I2 et I3 (courant seul)

Le matériel actuel pour la topologie multi-canaux est I2 (deux canaux de courant) et I3 (trois canaux de courant). Ces deux modules n'ont pas de canal U : le calcul de P / PF / Q côté module est donc impossible — ils fournissent le courant par canal (I_rms, I_peak sur chaque canal) et rien de plus.

UI2 (1 U + 2 I) et UI3 (1 U + 3 I) ajoutent le canal de tension à la même disposition multi-canaux, de sorte que la puissance par canal est calculée sur le module lui-même. Lorsque la puissance côté module n'est pas nécessaire, utilisez I2/I3 comme sous-compteurs de courant associés à un UI1 séparé à l'arrivée de service, qui fournit l'énergie du réseau et la tension.

Lecture des canaux (I2 / I3)

C++
float i0 = dev.readCurrent(0);   // ch0
float i1 = dev.readCurrent(1);   // ch1
float i2 = dev.readCurrent(2);   // ch2 — I3 only

// On an I variant readPower(...) returns 0.0 — this is by design.
float p_dummy = dev.readPower(0);  // = 0.0f

Si vous avez besoin de la puissance active sur chaque sous-ligne, installez un UI1 à l'arrivée de service et répartissez sa puissance totale proportionnellement au courant par canal I[k] issu de I2/I3. C'est un déploiement domestique typique (voir le chapitre 06 · Exemples, scénario 1).

Remarque

Il s'agit d'une approximation : la répartition par courant fonctionne lorsque le FP est à peu près le même pour toutes les charges. Pour un comptage précis de la puissance par charge, utilisez une variante UI sur chaque ligne (une fois les UI2/UI3 disponibles).

Applications I2 / I3

  • Sous-comptage de courant : répartition du courant par circuit, un seul point d'installation au tableau au lieu d'un module par ligne.

  • Désagrégation couplée à UI1 : UI1 fournit l'énergie / la puissance du secteur, I2/I3 répartissent la consommation par branche (voir le chapitre 06, scénario 1).

  • Surveillance du courant sans comptage de puissance : contrôle de surcharge, détection de mise en marche / arrêt de charge, profil I(t).

  • Double TC + un troisième canal (I3) : une grande pince sur le canal 0 pour une plage large, une petite pince sur le canal 1 pour la précision aux faibles courants, et le troisième canal pour une ligne auxiliaire distincte. Voir la section « Configuration avancée : deux pinces de calibres différents » ci-dessous.

Configuration avancée : deux pinces de calibres différents sur un même fil

Remarque

⚙ Un schéma avancé, pas un schéma de base. Cette section décrit une technique facultative pour améliorer la résolution aux faibles courants. Pour la plupart des installations, une seule pince adaptée à la plage de charge suffit. N'utilisez le double TC que si vous avez une exigence de précision précise pour des courants < 1 A.

Quand cela s'applique

  • Modules multi-canaux I2 / I3 (matériel actuel).
  • Le même fil doit être mesuré avec la même qualité pour les petites charges (≤ 1 A) et les pointes (≥ 5 A).

  • Un exemple typique : une arrivée de service d'appartement avec 50 à 100 W de veille en journée et une pointe de bouilloire ou de plaque de 3+ kW le soir.

L'idée

Deux pinces SCT-013 de calibres différents sont montées sur le même fil :

  • Canal 0 — une petite pince (par exemple SCT-013-005, 5 A) : voit les petits courants avec une meilleure résolution et un plancher de bruit plus bas.

  • Canal 1 — une grande pince (par exemple SCT-013-030 ou plus) : gère les courants au-delà du seuil de surcharge de la petite pince sans saturer.

Le maître choisit lui-même le canal à utiliser selon la valeur de courant : tant que la petite pince reste dans sa plage linéaire, sa mesure est plus précise ; au-delà, il passe à la grande.

Configuration (ordre quelconque — v1.3)

La classe de capteur d'abord une seule fois, puis les modèles par canal dans n'importe quel ordre. Sur le firmware v1.3, écrire REG_CT_MODEL ne fait qu'préparer une valeur ; la liaison passe par la commande par canal CMD_SET_CT_MODEL_CHn, de sorte que les canaux ne s'écrasent jamais entre eux. (Le contournement « ordre décroissant » ne s'appliquait qu'au firmware antérieur à v1.3 et n'est plus requis.)

C++
dev.setSensorClass(RbAmpSensorClass::Sct013);  // once

// Order is arbitrary — staging is decoupled from binding.
dev.setCTModel(0, RbAmpCTModel::Sct013_005);   // ch0 (range 0..5 A)
dev.setCTModel(1, RbAmpCTModel::Sct013_030);   // ch1 (range 0..30 A)

État final : ch0 = SCT-013-005, ch1 = SCT-013-030. ✓

Logique d'agrégation côté maître

Le schéma le plus simple consiste à commuter sur un seuil :

C++
float read_combined_current(RbAmp& dev) {
    const float i_low  = dev.readCurrent(0);   // small clamp
    const float i_high = dev.readCurrent(1);   // large clamp

    // While the small clamp is well clear of saturation, it gives
    // better accuracy at low currents. We switch to the large one as
    // it approaches the overload point.
    //
    // The 4.5 A threshold for the SCT-013-005 is PROVISIONAL; the exact
    // value will be determined by bench validation (see below).
    // Behavior in the vicinity of the threshold is a matter of
    // measurement, not estimation.
    if (!isnan(i_low) && i_low < 4.5f) {
        return i_low;
    }
    return i_high;
}

Installation à double CT : deux pinces sur un même fil L, une de plage basse et une de plage haute, les deux flèches orientées vers la charge.

Remarque

⚙ Limite. Les chiffres pour l'usage du double TC à faible courant (comportement près du seuil, dérive thermique, divergence des deux pinces dans la plage de recouvrement) ne sont pas publiés. Traitez le double TC comme un schéma pilote ; pour les applications critiques, une seule pince adaptée à la limite haute de la plage de charge est préférable.

Approches pour améliorer la sensibilité aux faibles courants

Si votre charge a une large plage dynamique (par exemple 1 W de veille pour un routeur contre un chauffe-eau de 2000 W sur la même prise), une seule pince dimensionnée pour la limite haute perd les faibles courants dans le bruit.

Trois stratégies, par ordre croissant de complexité :

  1. Dimensionnez le TC au maximum, pas « avec de la marge ». L'erreur la plus courante est de placer un SCT-013-100 (100 A) sur une prise domestique consommant typiquement 0.5–10 A. Le signal se situe dans les 1 à 10 % inférieurs de la plage du capteur — là où le bruit devient comparable au signal. Pour un scénario domestique (prise de 16 A), un SCT-013-030 est optimal ; pour brancher un seul appareil (≤ 5 A), un SCT-013-005.

  2. Topologie à double CT (nécessite une référence I2/I3 — deux canaux de courant sur un même module) : une petite pince pour la plage basse + une grande pour la plage haute, le maître choisissant selon un seuil. Voir la section « Topologie à double CT » ci-dessus — ce schéma est un pilote, et ses chiffres ne sont pas publiés.

  3. Plancher de bruit calibré en usine : la calibration du module prend déjà en compte son plancher de bruit. Côté utilisateur, il n'y a rien à faire au-delà de setSensorClass() + setCTModel(). Les chiffres de précision précis aux faibles courants ne sont pas publiés.

Mode production et mode usine (référence de persistance)

Le module rbAmp fonctionne selon deux modes qui diffèrent par ce qui est exactement enregistré en flash. Le mode actuel se lit dans le registre d'état correspondant.

Commande (opcode) Production Persiste
CMD_SAVE_USER_CONFIG (0x32) ✅ OK ct_model / sensor_class / TC par canal / fleet_config / group_id / label
CMD_COMMIT_ADDR (0x30, armé par magic) ✅ OK Adresse I²C (voir 04 · Raccordement — modification de l'adresse)
CMD_RESET (0x01) ✅ OK — (réinitialisation logicielle)
CMD_LATCH_PERIOD (0x27) ✅ OK — (instantané de période)
CMD_CLEAR_ERROR ✅ OK —
CMD_SAVE_GAINS ❌ BLOQUÉ en production (rejet silencieux ; REG_ERROR=0xFE ; le redémarrage annule) gains / NF / phase (calibration d'usine)
CMD_FACTORY_RESET ❌ BLOQUÉ en production —

En mode production, les écritures de calibration d'usine (CMD_SAVE_GAINS, CMD_FACTORY_RESET) sont rejetées par le firmware — ceci protège contre l'écrasement accidentel des coefficients d'usine. Le passage en mode usine est une opération côté fabricant.

La relecture n'est pas une persistance.

La garde de production accepte une écriture en RAM (une lecture ultérieure renvoie ce qui a été écrit), mais la sauvegarde en flash peut être rejetée. Après un redémarrage, la valeur revient à son ancienne valeur. La seule façon valide de confirmer la persistance est de redémarrer le module via CMD_RESET puis de relire :

C++
dev.setCTModel(code);
dev.reset();                     // CMD_RESET 0x01, works in production
delay(300);                      // boot complete
uint8_t check = dev.ctModel(0);
assert(check == code);           // ONLY now is persistence confirmed

✅ REG_I2C_ADDRESS (0x30) lit l'adresse ACTIVE au démarrage (v1.3). Après un redémarrage suivant le commit, la lecture de 0x30 affiche la nouvelle adresse active. L'écho de préparation (après une écriture de l'hôte) reste conforme à la conception jusqu'à CMD_COMMIT_ADDR + réinitialisation.

Renvoi : 09 · Référence de l'API — détails sur des opcodes précis, 10 · Dépannage — que faire si la persistance n'est pas confirmée.

Suite


Sources et problèmes : rb-amp/rbamp-arduino · cette page dans le dépôt : docs/03_sensor_selection.md (v1.6.2)