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

03 · Choix du capteur de courant

Installation de la pince : le CT serre uniquement le fil L, avec sa 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 câblage 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 les appels d'API.

Classe de capteur

Les modules rbAmp fonctionnent avec des pinces CT de la famille SCT-013. La classe de capteur est déterminée par la révision matérielle du module et réglée en usine ; l'utilisateur indique son choix via dev.set_sensor_class() avant de sélectionner un modèle de pince CT précis.

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 charges de pointe
5 SCT-013-100 0…100 A ✅ caractérisé Arrivée de service principale
6 SCT-013-020 0…20 A ✅ caractérisé Entrée de service moyenne — appareils de 3 à 4 kW, gros équipements domestiques
7 SCT-013-060 0…60 A ✅ caractérisé Sous-compteur industriel
Remarque

Codes acceptés — {1, 2, 3, 4, 5, 6, 7}. Appeler dev.set_ct_model_ch(ch, code) avec un code hors de cet ensemble, par exemple 0 ou 8 (ou passer un tel code à dev.configure_channels(...)) lève RbAmpParamError — la bibliothèque n'envoie pas l'écriture à l'appareil (garde côté client _validate_ct_code, REG_ERROR sur l'appareil reste à 0x00).

Ensembles admis par classe : - RbAmpSensorClass.SCT_013 → {1, 2, 3, 4, 5, 6, 7} - RbAmpSensorClass.WIRED_CT → {1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12} (série de pinces appairées en usine ; les codes 11 et 13 ne sont pas disponibles) - RbAmpSensorClass.BUILTIN_CT → ∅ (CT intégré, aucun code)

Les codes 0x06 et 0x07 ne sont pas monotones selon la valeur nominale (ajoutés après les codes d'origine 0x01..0x05). Choisissez selon la valeur nominale dont vous avez besoin.

Comment choisir le bon modèle

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

La seule règle : choisissez la plus petite pince de calibre supérieur à votre courant maximal attendu plus une marge de 30 %. Une pince surdimensionnée (par exemple une pince 100 A sur un circuit qui ne dépasse jamais 5 A) fonctionne encore, mais donne une faible résolution et une grande erreur aux valeurs typiques.

Marge

Une pince SCT-013 fonctionne sans saturation dans sa plage nominale. Des pics de courte durée (appel de courant au démarrage d'un compresseur, charge inductive) peuvent dépasser le calibre — la pince les supporte, mais la mesure devient non linéaire au-dessus du calibre.

Comptez un appel d'appoint habituel dans votre « courant maximal attendu ». 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, donc la plus petite pince nominale au-dessus est la SCT-013-020 (code 6).

Comment indiquer votre choix au module

Deux appels dans le bon ordre sont obligatoires — d'abord dev.set_sensor_class(), puis dev.set_ct_model(). Si vous appelez dev.set_ct_model() avant dev.set_sensor_class(), le paquet lève RbAmpModeError :

Text
REG_SENSOR_CLASS is UNSET;
call dev.set_sensor_class(RbAmpSensorClass.SCT_013) first
Remarque

Modèle de CT — un préréglage fonctionnel, pas une étiquette. Écrire le modèle de CT applique immédiatement la ligne de base NF, le gain et le facteur de forme — les lectures de courant changent. Modifier sensor_class remet CT_MODEL à sa valeur par défaut et exige de le régler à nouveau.

Python
from rbamp import RbAmp, RbAmpSensorClass, RbAmpModeError

with RbAmp(bus, 0x50) as dev:
    # Step 1: sensor class. MANDATORY before set_ct_model().
    try:
        dev.set_sensor_class(RbAmpSensorClass.SCT_013)
    except RbAmpModeError as e:
        # Possible causes: communication failure (see 10 · Troubleshooting),
        # invalid argument (cls outside the known values)
        print("set_sensor_class failed:", e)
        raise SystemExit(1)

    # Step 2: model within the family.
    # 1 = SCT-013-005, 2 = SCT-013-010, 3 = SCT-013-030,
    # 4 = SCT-013-050, 5 = SCT-013-100, 6 = SCT-013-020, 7 = SCT-013-060.
    try:
        dev.set_ct_model(3)   # e.g. SCT-013-030
    except RbAmpModeError:
        print("Sensor class must be set first")
    except ValueError:
        print("Code not in per-class accept-set (SCT_013: {1,2,3,4,5,6,7})")

set_sensor_class() accepte soit une énumération, soit un entier simple — les deux formes sont équivalentes :

Python
dev.set_sensor_class(RbAmpSensorClass.SCT_013)  # explicit enum form
dev.set_sensor_class(1)                          # numeric (equivalent)
Remarque

Le paquet n'appelle PAS set_sensor_class() à votre place. Si cette étape est omise, set_ct_model() lève RbAmpModeError sans rien écrire en flash. C'est voulu : le comportement reste prévisible et explicite — pas de « magie » dans l'API publique.

Après ces deux appels :

  • Le module enregistre 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.

  • La lecture suivante de dev.current[0] (ou dev.read_current(0)) renvoie déjà une valeur en ampères, à la mise à l'échelle correcte.

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 page flash). Effectué une seule fois à la première installation ; le réglage est enregistré en flash et n'est pas répété.

Remarque

Si vous avez déjà choisi le capteur au premier lancement et redémarrez simplement le script, vous n'avez pas besoin de répéter les appels set_sensor_class() et set_ct_model() — le module garde le choix précédent. Mais ce n'est pas nocif : rappeler avec la même valeur réécrit simplement le même octet.

Changement de modèle et redémarrage. Sur le firmware du module jusqu'à 1.4.19, un changement de modèle redémarre le module une fois (environ une seconde) ; à partir de 1.4.20, le module se corrige lui-même. La correction de calibre SCT ne met à l'échelle que le courant, la puissance et l'énergie, jamais la tension ni le facteur de puissance.

Vérifier la configuration

Un contrôle de cohérence simple après set_ct_model() :

Python
import time
from rbamp import RbAmp, RbAmpSensorClass

def sanity_check(dev):
    print("Ready. Connect a purely resistive load",
          "(e.g. an incandescent lamp).")
    print("Expect a stable PF ~= 1.0 and a positive P.")

    while True:
        u  = dev.voltage              # property — one I²C transaction
        i  = dev.read_current(0)
        p  = dev.read_power(0)
        pf = dev.read_power_factor(0)
        print(f"U={u:.1f} V  I={i:.2f} A  P={p:.1f} W  PF={pf:.2f}")
        time.sleep(2)

with RbAmp(bus, 0x50) as dev:
    dev.set_sensor_class(RbAmpSensorClass.SCT_013)
    dev.set_ct_model(3)
    sanity_check(dev)

Sous MicroPython, remplacez time.sleep(2) par time.sleep_ms(2000).

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

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

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

Modules à plusieurs canaux de courant

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

SKU Canaux I Canal U Usage typique
UI1 1 oui Une charge avec calcul complet de la puissance (P, PF)
UI2 2 oui Deux charges indépendantes sur la même phase (arrivée de service + un gros consommateur)
UI3 3 oui Trois charges indépendantes sur la même phase
I1 1 non Sous-compteur sans calcul de puissance (courant seul)
I2 2 non Deux sous-compteurs, ou une topologie à double CT sur une seule ligne
I3 3 non Trois sous-compteurs, ou double CT + un troisième canal de courant

Ce que mesure chaque canal

  • Canal U (UI uniquement) : U_rms, U_peak, fréquence. Un* par module.
  • Voies I (toutes les références) : chaque voie indépendamment — I_rms, I_peak, P (puissance active), PF, avg_p par période.
  • Variantes I : I1/I2/I3 n'ont pas de voie U — le calcul de P/PF n'est pas possible sur l'appareil (seulement I_rms par voie).
  • Module monophasé : les courants UI2/I2/I3 sont monophasés. Tous les canaux I doivent être sur la même phase (ou, pour les variantes I, sur la même phase également si vous voulez calculer P correctement côté maître).

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

Sur les modules UI2, I2 et I3, chaque voie de courant a une sélection de modèle SCT-013 indépendante. Vous pouvez brancher, par exemple, un SCT-013-005 sur la voie 0 (une seule prise), un SCT-013-030 sur la voie 1 (une ligne de cuisinière) et un SCT-013-020 sur la voie 2 (une arrivée moyenne — I3 seulement).

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

Python
dev.set_sensor_class(RbAmpSensorClass.SCT_013)   # once for all channels

# Binding order does NOT matter.
dev.set_ct_model_ch(0, 1)   # channel 0: SCT-013-005
dev.set_ct_model_ch(1, 3)   # channel 1: SCT-013-030
dev.set_ct_model_ch(2, 6)   # channel 2: SCT-013-020 (I3 only)
Remarque

✅ L'ordre de liaison des voies n'a pas d'importance. L'écriture de REG_CT_MODEL (0x05) prépare la valeur mais ne l'applique plus automatiquement à la voie 0. L'application ne se fait que via CMD_SET_CT_MODEL_CHn. Vous pouvez donc configurer les voies dans n'importe quel ordre, sans écrasement.

La forme à argument unique dev.set_ct_model(code) est une forme pratique pour les références mono-voie (appliquée à la voie 0). Sur les modules multi-voies, elle équivaut à dev.set_ct_model_ch(0, code).

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

Remarque

⚙ Un schéma complémentaire, pas le 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 CT que si vous avez une exigence de précision précise pour des courants < 1 A.

Quand ça s'applique

  • Modules multi-canaux UI2 / I2 / I3 (au moins 2 canaux I).
  • Le même fil doit être mesuré à la fois pour les petites charges (≤ 1 A) et pour les pointes (≥ 5 A) avec une qualité égale.

  • Exemple type : une arrivée d'appartement où, le jour, il y a 50–100 W de veille, et le soir une bouilloire ou une plaque en appel de courant de 3+ kW.

L'idée

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

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

  • Canal 1 — la grande pince (par ex. SCT-013-030 ou plus) : elle traite les courants au-dessus du point de surcharge de la petite pince sans saturation.

Le maître choisit lui-même le canal à utiliser selon la valeur du courant — tant que la petite pince reste dans sa plage linéaire, sa lecture est plus précise ; une fois cette plage dépassée, il bascule sur la grande.

Configuration (indépendante de l'ordre)

D'abord la classe de capteur une fois, puis les modèles par canal dans n'importe quel ordre. Sur le firmware actuel, écrire REG_CT_MODEL (0x05) ne fait que mettre en attente la valeur ; la liaison à un canal précis se fait exclusivement via le code opération par canal CMD_SET_CT_MODEL_CHn. Le contournement « ordre décroissant » exigé sur le firmware v1.2 n'est plus nécessaire.

Python
dev.set_sensor_class(RbAmpSensorClass.SCT_013)   # once

# Any order is valid — each call binds its own channel.
dev.set_ct_model_ch(0, 1)   # ch0 = SCT-013-005 (0..5 A)
dev.set_ct_model_ch(1, 3)   # ch1 = SCT-013-030 (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 :

Python
import math

def read_combined_current(dev):
    """Read the combined current — picks low-CT when in its linear range,
    otherwise falls back to the high-CT.
    """
    i_low  = dev.read_current(0)   # the small clamp
    i_high = dev.read_current(1)   # the large clamp

    # While the small clamp is far from saturation, it gives better
    # accuracy at low currents. Switch to the large one when
    # approaching the overload point.
    #
    # The 4.5 A threshold for SCT-013-005 is an example value;
    # pick the switch-over point for your own installation.
    if not math.isnan(i_low) and i_low < 4.5:
        return i_low
    return i_high

Deux pinces de calibres différents sur le même fil L, les deux flèches orientées vers la charge

Remarque

⚙ Chiffres de la double pince. Les chiffres pour l'usage en double pince à faible courant ne sont pas publiés (comportement au voisinage du seuil, dérive thermique, écart des deux pinces dans la plage de recouvrement). Considérez la double pince comme un schéma pilote ; pour les applications critiques, une pince unique dimensionnée sur la borne haute de la plage de charge est préférable.

Approches pour améliorer la sensibilité aux faibles courants

Si votre charge a une grande 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 la pince au plus fort courant attendu (la règle ci-dessus). L'erreur la plus courante est de placer une SCT-013-100 (100 A) sur une prise domestique dont la consommation typique est de 0.5–10 A. Le signal se situe dans les 1–10 % inférieurs de la plage d'entrée, là où le bruit devient comparable au signal. Pour un scénario domestique (prise 16 A), la SCT-013-030 est optimale ; pour un seul appareil (≤ 5 A), la SCT-013-005.

  2. Topologie à double CT (nécessite une référence UI2/UI3) : une petite pince pour la plage basse + une grande pour la plage haute, le maître choisissant par seuil. Voir la section « Topologie à double CT » ci-dessus — le schéma est un schéma pilote ; les chiffres pour le double CT à faible courant ne sont pas publiés.

  3. Le plancher de bruit est traité côté usine. Côté utilisateur, il n'y a rien à faire au-delà de set_sensor_class() + set_ct_model(). Les chiffres pour l'usage du double CT à faible courant 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.

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 (validation d'adresse en deux phases, voir 04 · Câblage)
CMD_RESET (0x01) ✅ OK — (réinitialisation logicielle)
CMD_LATCH_PERIOD (0x27) ✅ OK — (instantané de période)
CMD_CLEAR_ERROR ✅ OK —
CMD_SAVE_GAINS (0x26) ❌ BLOQUÉ en production (renvoie DEV_ERR_PARAM ; le redémarrage annule) — réservé à l'usine gains / NF / phase (calibration d'usine)
CMD_FACTORY_RESET ❌ BLOQUÉ en production —

En mode production, les écritures de calibration d'usine sont rejetées par le firmware — une protection contre l'effacement accidentel des coefficients d'usine.

Relecture ≠ persistance

. Le garde de production accepte l'écriture en RAM (une lecture ultérieure renvoie ce qui a été écrit), mais la sauvegarde en flash peut être rejetée. La seule façon valable de confirmer la persistance est de redémarrer le module via CMD_RESET puis de relire :

Python
dev.set_ct_model(code)
dev.reset()                     # CMD_RESET 0x01, works in production
time.sleep(0.3)                 # boot complete (300 ms)
check = dev.read_reg(0x05)
assert check == code            # ONLY now is persistence confirmed

L'adresse est une exception : REG_I2C_ADDRESS lit l'adresse active au démarrage. Après la mise en attente, elle renvoie le candidat jusqu'à CMD_COMMIT_ADDR + réinitialisation.

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

Suite

  • 04 · Câblage — connexion physique de la pince, orientation de la flèche, polarité L/N

  • 05 · Démarrage rapide — le script de premier allumage complet pour les deux environnements

  • 06 · Exemples — scénarios de travail pour différents usages

  • 10 · Dépannage — que faire si les lectures semblent étranges (PF négatif, I instable, etc.)


Source et signalements : rb-amp/rbamp-python · cette page dans le dépôt : docs/03_sensor_selection.md (v1.6.1)