03 · Choix du capteur de courant
Ce chapitre répond à deux questions :
- Quel capteur de courant choisir pour une charge donnée.
- 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 |
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
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 :
REG_SENSOR_CLASS is UNSET;
call dev.set_sensor_class(RbAmpSensorClass.SCT_013) first
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.
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 :
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # explicit enum form
dev.set_sensor_class(1) # numeric (equivalent)
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](oudev.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é.
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() :
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 stablePF≈ 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) :
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)
✅ 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
⚙ 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.
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 :
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
⚙ 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é :
-
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.
-
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.
-
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.
. 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 :
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)