01 · Connexion matérielle
Ce chapitre décrit le raccordement physique de rbAmp à un appareil maître et les exigences d'alimentation. Le module est livré prêt à fonctionner. L'utilisateur ne travaille que côté basse tension (BT) — quatre fils pour I²C, une ligne DRDY optionnelle et (pour les références avec pince CT externe) une prise jack 3.5 mm pour la pince.
⚠ Côté secteur. Pour tout travail à l'intérieur d'un tableau électrique, faites appel à un électricien qualifié.
La pince se place sur un seul conducteur (L) — jamais sur tout le câble. Elle est sans contact, mais elle exige un conducteur à isolation intacte. La prise L nécessite un fusible (voir Fil et fusible ci-dessous).
Brochage côté basse tension
Le module fonctionne en logique 3.3 V et tolère la logique 5 V sur les lignes I²C. Toutes les broches côté basse tension sont entièrement isolées galvaniquement du secteur.
| Broche rbAmp | Signal | Fonction |
|---|---|---|
VCC |
+4.5 … +5.5 V (alimentation) | Alimentation du module ; 4.5 V minimum requis pour un fonctionnement correct |
GND |
Terre | Masse commune avec le maître — obligatoire |
SDA |
SDA I²C | données I²C |
SCL |
SCL I²C | Horloge I²C |
DRDY |
Données prêtes (facultatif) | Impulsion LOW en collecteur ouvert d'environ 10 µs à chaque fenêtre de mesure (~100 ms, v1.2 et ultérieures) |
Résistances de rappel I²C — installées sur la carte
Important : chaque module rbAmp embarque des résistances de pull-up de 4.7 kΩ sur SDA et SCL vers 3.3 V. Pour un bus à un seul module, aucun pull-up externe n'est requis — connectez le maître directement.
Quand désactiver les résistances de rappel intégrées
Avec quatre modules rbAmp ou plus (ou d'autres périphériques I²C avec leurs propres résistances de rappel) sur le bus, ou sur un bus plus long, leur combinaison en parallèle donne une résistance effective trop faible, ce qui :
- Augmente la consommation du bus
- Peut dépasser le courant d'absorption maximal de l'étage de sortie du maître I²C (typiquement ≤ 3 mA en logique 3.3 V)
- Ajoute une charge capacitive sur les longs bus, tout en contribuant peu à l'immunité au bruit
Avec deux ou trois modules sur un bus de 15 cm maximum, ne touchez pas aux pull-ups intégrés (voir le tableau ci-dessous). Sinon : chaque module possède des coupures de soudure (solder-jumper) au dos du circuit imprimé, à côté des résistances de pull-up. La sérigraphie indique Pull-Up. Coupez la piste avec une lame bien tranchante pour déconnecter le pull-up :
- Avec quatre modules ou plus, ou sur un bus plus long, laissez les pull-ups activés sur un seul module du bus (ou déplacez-les en un point unique près du maître).
- Coupez les straps sur les modules restants.
- Si la carte maître fournit déjà les pull-ups du bus et que le bus compte quatre modules ou plus (ou est plus long), coupez les cavaliers sur tous les modules rbAmp. Avec deux ou trois modules, mesurez d'abord (voir En cas de doute ci-dessous) et ne coupez que si la mesure est inférieure à ~1 kΩ.
Règle empirique
| modules rbAmp sur le bus | Résistances de rappel |
|---|---|
| 1 | Ne rien faire (résistance intégrée de 4.7 kΩ) |
| 2 | Ne rien toucher sur les deux (bus jusqu'à 15 cm) |
| 3 | Ne rien toucher sur les trois (bus jusqu'à 15 cm) |
| 4…6 | Coupure sur tous les modules, paire externe 2.2…2.7 kΩ près du maître |
| 7…16 | Coupure sur tous les modules, paire externe 1.5…2.2 kΩ près du maître ; vérifiez la capacité totale du bus (≤ 400 pF) et réduisez la vitesse du bus si nécessaire |
Ce sont des valeurs recommandées calculées à partir de la spécification I²C (courant d'absorption de la résistance de rappel ≤ 3 mA sous 3.3 V, capacité du bus ≤ 400 pF) — et non une garantie mesurée pour chaque câble et chaque maître. Reliez les résistances externes à 3.3 V (le niveau logique du bus), et non à l'alimentation 5 V VCC. Pour un maître 5 V : voir Compatibilité de tension I²C ci-dessous.
La ligne à 3 modules est mesurée (fils de 15 cm, 50 kHz) ; les autres lignes sont calculées à partir de la spécification I²C.
: mesurez la résistance entre SDA et VCC, tous les appareils hors tension. Pour un bus à un seul module, la valeur typique est ~4.7 kΩ (un pull-up intégré) ; sur un bus multi-modules, la combinaison en parallèle descend dans la plage de 1.5–4.7 kΩ selon le nombre de pull-ups intégrés restant actifs. En dessous de ~1 kΩ, cela signifie que trop de pull-ups actifs sont en parallèle — voir le tableau ci-dessus.
Puissance
Paramètres de VCC
- Tension nominale : 5 V CC
- Plage acceptable : 4.5 … 5.5 V
- Consommation : ~15 mA typique, ~25 mA en pointe pendant l'écriture flash
- Ondulation : < 50 mV crête à crête (pour la précision de mesure)
⚠ Respectez la polarité d'alimentation. L'inversion de polarité sur l'entrée 5 V n'est pas prise en charge — vérifiez le câblage VCC/GND avant la mise sous tension. Vérifiez la convention de couleurs de votre faisceau avant la première mise sous tension, surtout si vous sertissez vos propres câbles.
Compatibilité des niveaux de tension I²C
- SDA/SCL fonctionnent en logique 3.3 V (les résistances intégrées les relient à 3.3 V).
- Les lignes tolèrent le 5 V, donc un maître 5 V (Arduino UNO / Nano) lit correctement le niveau HAUT (~3.3 V) et peut piloter le bus.
- Configuration standard : pull-ups vers 3.3 V. Ce n'est que si vous voulez délibérément des niveaux de bus 5 V que vous désactivez les pull-ups intégrés et ajoutez des pull-ups externes vers +5 V côté maître.
Comportement à la mise sous tension
- Démarrage à froid : ~250 ms jusqu'au premier résultat de mesure valide.
- Après RESET (logiciel ou creux de tension) : ~250 ms pour se rétablir.
- Avant le premier résultat valide, les registres valent 0 et
DATA_VALID(0xCE) vaut 0.
Isolation
Le module lui-même est entièrement basse tension — il n'y a aucun circuit de mesure haute tension. Le courant est lu par une pince CT qui se couple magnétiquement depuis l'extérieur du conducteur isolé, sans contact électrique avec le fil du secteur. Sur les variantes de mesure de tension (UI), l'unique référence secteur est la borne L–N, qui alimente un diviseur de détection galvaniquement isolé* ; les variantes à courant seul n'ont aucune connexion au secteur. Par conséquent :
- La masse du module n'est pas reliée à la phase ou au neutre du secteur.
- Connecter le côté BT à un maître 5 V est sans danger — pas de risque de court-circuit par la masse.
N'ouvrez pas le boîtier — cela annulerait l'étalonnage d'usine.
Bus I²C
Paramètres
- Adresse par défaut :
0x50(7 bits) - Plage d'adresses :
0x08..0x77(reprogrammable par commit à deux phases, voir initialization.md) - Vitesse (recommandation ; le choix appartient à l'utilisateur) : 50 kHz sur les hôtes ESP32 et ESP8266 (une limitation du pilote I²C ESP-IDF, et non du module) ; 100 kHz sur les autres hôtes ; n'utilisez pas 400 kHz. 100 kHz est aussi praticable sur ESP32/ESP8266 avec une reprise au niveau applicatif.
- Auto-incrémentation en LECTURE : OUI — lecture en rafale prise en charge (registres multi-octets, bloc RT V03, fenêtre DIGEST).
- Auto-incrément en ÉCRITURE : NON — chaque octet écrit nécessite une adresse de registre explicite, y compris pour les champs multi-octets (écrire l'octet faible, puis l'octet fort séparément).
- Étirement d'horloge : non utilisé par le module comme mécanisme de contrôle de flux. Le maître doit observer un intervalle entre transactions (
tBUF) d'au moins 100 µs.
Longueur du bus
I²C est, par défaut, un bus court (~15 cm). Beaucoup d'utilisateurs connectent les modules avec des fils de liaison de mauvaise qualité, qui captent beaucoup de bruit et perdent beaucoup de transferts — d'où la limite courte. Topologies recommandées pour rbAmp :
| Topologie des câbles | Longueur maximale | Vitesse |
|---|---|---|
| Câble plat JST / 4 fils standard | jusqu'à 0.15 m | 100 kHz |
| Paire torsadée UTP (cat-5/5e/6) — SDA+GND et SCL+GND dans des paires séparées | jusqu'à 1 m | 100 kHz |
| Paire torsadée UTP + tampon I²C (PCA9515 / TCA9617) | jusqu'à 3 m | 100 kHz |
| Bus différentiel (PCA9615 / LTC4332) | jusqu'à 100 m | 100 kHz |
Les durées ci-dessus sont données pour 100 kHz ; la recommandation de 50 kHz pour les maîtres ESP32/ESP8266 (§Paramètres) s'applique à toutes les topologies — la vitesse plus basse n'ajoute que de la marge.
Pour les tronçons de plus de 0.15 m, une paire torsadée est requise : SDA et SCL doivent être dans des paires séparées, chacune avec sa propre masse (par exemple bleu + bleu-blanc pour SDA, vert + vert-blanc pour SCL). Mettre SDA et SCL dans la même paire provoque une diaphonie qui déforme les fronts.
⚠ Dans une armoire électrique, blindez le câble I2C. Les champs magnétiques intenses près des conducteurs secteur, des contacteurs et des transformateurs induisent du bruit dans un câble non blindé. Gardez le câble aussi court que possible et à l'écart du câblage secteur.
Bus multi-modules
Plusieurs modules rbAmp peuvent partager un seul bus I²C :
- Nombre de modules : jusqu'à ~16 (limité par la capacité totale du bus — ≤ 400 pF à 100 kHz)
- Adresses : chaque module a sa propre adresse 7 bits. Tous les modules sortent d'usine sur
0x50; réadressez-les un par un avant de les connecter en parallèle (voir initialization.md → Changement d'adresse). - Pull-ups : suivez le tableau du nombre de modules ci-dessus (valeurs recommandées) — avec 2 à 3 modules sur un bus de 15 cm maximum, laissez les pull-ups intégrés tranquilles ; avec 4 modules ou plus, coupez-les tous et utilisez une paire externe unique dimensionnée selon le nombre de modules.
- Retrait d'un module : pour retirer un module d'un bus partagé, déconnectez ses fils de bus (ou le module entier), pas seulement son alimentation : un module non alimenté charge SDA et SCL et peut bloquer le bus pour les autres modules.
Connexions du capteur (côté secteur)
Capteur de tension (variantes UI*)
Le circuit imprimé expose les bornes L (phase) et N (neutre). La polarité compte pour le signe de la puissance active :
- Câblage correct (L → L, N → N) :
P > 0signifie consommation (courant entrant dans la charge depuis le réseau),P < 0signifie injection vers le réseau (production). - Câblage inversé (L et N échangés) : le signe de P est inversé — la consommation est affichée en puissance négative.
Câble et fusible. Un câble épais n'est pas nécessaire pour la connexion de tension : AWG26–22 suffit, car le capteur de tension consomme très peu de courant. Un fusible sur la ligne L est obligatoire, calibre jusqu'à 0.1 A.
La bonne polarité est essentielle pour :
- Comptabilité précise en niveau BASIC (BASIC ne compte que
max(P, 0); une polarité inversée annule le total d'énergie). - Séparation correcte de la consommation et de la production sur la gamme STD.
: avec une charge purement résistive (bouilloire électrique, radiateur, ampoule à incandescence), P > 0 et PF ≈ 1.0. Si P est négatif alors que la charge consomme, échangez L et N sur le circuit imprimé.
Capteur de courant — SCT-013 (pour les références avec pince externe)
Les pinces SCT-013 se connectent au module par une prise jack 3.5 mm. Le connecteur est détrompé pour une polarité correcte dès l'achat ; aucun choix de câblage n'est nécessaire. Caractéristiques de chaque calibre SCT-013 (planchers, classe, tolérance, écrêtage) : voir le tableau SCT-013.
Rules:
- Serrez le capteur autour du fil de phase (L) allant vers le consommateur.
- La flèche sur la pince doit pointer dans le sens du courant vers la charge (du tableau électrique vers la charge).
- La pince doit se fermer complètement — aucun écart entre les deux moitiés du noyau magnétique. Un écart > 0.1 mm augmente fortement la réluctance magnétique et dégrade la précision.
⚠️ Attention : ne passez pas à la fois L et N dans la même pince. Leurs flux magnétiques sont égaux et opposés, donc ils s'annulent — le capteur indique un courant proche de zéro même sous charge réelle.
Repères de canaux sur le circuit imprimé
Chaque prise du circuit imprimé porte le nom du canal (I0, I1, I2, …) et un repère de couleur. Les câbles SCT-013 sont électriquement symétriques — l'orientation se détermine par la flèche sur la pince et son placement sur le fil, et non par l'extrémité du câble branchée dans la prise.
Polarité et signe de P
- Flèche dans le bon sens + polarité L/N correcte →
P > 0pour la consommation,P < 0pour l'injection. - Pince montée à l'envers (flèche contre le sens du courant) → le signe de P est inversé.
Pinces de courant — série CT
Chaque canal d'un module de la série CT dispose de sa propre pince sur un câble de 1 m. Le câble arrive déjà connecté au module et porte le numéro du canal ; branchez-le au connecteur enfichable de ce canal. Gardez chaque pince sur son propre canal, y compris lorsque vous recâblerez le tableau plus tard : une pince sur un autre canal donne des mesures fausses, et le module ne le signale pas.
- Ne déplacez pas une pince vers un autre canal et ne branchez pas une autre pince : l'étalonnage appartient à la paire.
- Posez la pince sur le conducteur L, la flèche pointant vers la charge (le consommateur) ; le conducteur doit traverser la fenêtre et la pince doit se fermer complètement.
- La taille de la fenêtre suit le calibre : 6 mm pour 1–10 A, 10 mm pour 20–50 A, 16 mm pour 100 A. Le conducteur avec son isolant doit tenir dans la fenêtre.
- Alimentation et bus, résistances de rappel, vitesse du bus, fil de tension et fusible : comme pour tout module BASIC (voir les sections ci-dessus). L'entrée de tension est la même que sur les modules SCT-UI : fil AWG26–22, fusible sur la ligne L jusqu'à 0.1 A.
DATA_READY (DRDY)
Broche optionnelle pour une interrogation optimisée. Si votre application se contente d'interroger à intervalle fixe (100 ms ou plus lent), vous pouvez laisser DRDY déconnectée.
Paramètres électriques
- Type de sortie : drain ouvert (pas de rappel actif vers VCC)
- Niveau de repos : HAUT (nécessite une résistance de rappel côté maître — soit une résistance interne du MCU, soit une résistance externe ; 10 kΩ vers 3.3 V recommandé)
- Impulsion de disponibilité : LOW pendant ~10 µs, après la mise à jour des registres temps réel (
0x86..0xCF) - Fréquence des impulsions : ~10 Hz (une impulsion par fenêtre RT d'environ 100 ms ; ~5 Hz sur les images antérieures à la v1.2)
Sémantique
Le front descendant de DRDY garantit que tous les registres temps réel sont cohérents et fraîchement publiés (le firmware les met à jour atomiquement dans une ISR avant d'abaisser la broche). Le maître peut lire 0x86..0xCD immédiatement sur le front descendant, sans risque d'échantillon coupé.
Utilisation côté maître
- Interruption EXTI / GPIO sur le front descendant — réveille le maître et déclenche une lecture.
- Utilisez n'importe quelle GPIO capable d'entrée — les numéros de broche des exemples (par ex. GPIO 15) sont illustratifs, ce n'est pas une obligation.
- Résistance de rappel 10 kΩ vers 3.3 V côté maître.
- Les DRDY de plusieurs modules peuvent être combinés en OU câblé (voir realtime-polling.md → DRDY multi-module).
Applicabilité
- DRDY ne se déclenche que sur les mises à jour temps réel (chaque fenêtre de mesure, ~100 ms depuis la v1.2).
- DRDY ne se déclenche pas sur les instantanés de période (ceux-ci sont mis à jour par la commande d'instantané que le maître déclenche — il sait donc déjà quand lire).
- Pour les maîtres qui interrogent lentement (toutes les 1 s ou 60 s), DRDY peut être ignorée.
— la même tâche sans accès aux registres :
| Bibliothèque | Appel | Ce qu'il fait |
|---|---|---|
| Arduino | RbAmp::setDrdyPin(pin) / RbAmp::waitDataReady(timeout_ms, ev) |
reliez la broche DRDY ; attendez la fenêtre publiée suivante |
| ESP-IDF | rbamp_set_drdy_gpio() / rbamp_wait_data_ready() |
reliez la broche DRDY ; attendez la fenêtre publiée suivante |
| Python | — | la bibliothèque n'utilise pas la broche DRDY |
| ESPHome | drdy_pin: |
entrée DRDY facultative ; seulement journalisée, non utilisée comme déclencheur de lecture |
Exemple de câblage de référence (ESP32, module unique)
Autres variantes de module
Les autres variantes de module utilisent le même brochage côté basse tension (VCC / GND / SDA / SCL / DRDY) ; seul le côté secteur diffère.
Suivant
- initialization.md — première connexion, test de fonctionnement, changement d'adresse
- troubleshooting.md → pince CT & polarité — que faire si le signe de P est faux ou si I_rms est instable