00 · Vue d'ensemble
rbAmp est un module matériel compact pour la mesure des paramètres du secteur alternatif via une interface I²C. Il est livré avec un étalonnage stocké en usine.
Qu'est-ce que rbAmp
Du point de vue de l'intégrateur, rbAmp se comporte comme un esclave I²C standard : mettez sous tension, lisez les registres — vous recevez des valeurs prêtes à l'emploi en unités physiques (volts, ampères, watts). Aucun traitement du signal n'est requis côté maître.
Ce qu'il mesure
BASIC fournit les grandeurs ci-dessous sous forme de valeurs à virgule flottante en unités de base. La gamme STD fournit ses grandeurs, avec des compteurs d'énergie embarqués, dans la documentation STD.
| Grandeur | BASIC |
|---|---|
| Tension RMS, U_rms | float32, V |
| Tension de crête, U_peak | float32, V |
| Courant RMS, I_rms | float32, A |
| Courant de crête, I_peak | float32, A |
| Puissance active, P | float32, W, signé |
| Puissance réactive, Q | float32, variable, non signée (≥ 0) |
| Facteur de puissance, PF | float32, −1…+1 |
| Fréquence de ligne | u8, Hz : 50 ou 60 (détecté, non mesuré) |
| Puissance moyenne sur une période | float32, W ; un instantané (P moyenne et crête) |
| Énergie | non conservée sur le module — l'hôte (bibliothèque) l'intègre |
La précision ne fait pas partie de ce tableau : pour BASIC avec un capteur SCT-013, voir le tableau de caractéristiques SCT-013 ci-dessous ; les spécifications des modules individuels figurent avec les descriptions de modèles. La carte de registres BASIC se trouve dans realtime-polling.md, period-metering.md et api-reference.md.
Précision des canaux de courant avec capteurs SCT-013
Modules BASIC (série SCT-UI) avec votre propre capteur SCT-013 — charge résistive, mesurée à 50 Hz. (Les modules avec pince CT appairée en usine, et les modules STD, sont spécifiés séparément — ce tableau ne s'applique pas à eux.)
| Caractéristique | SCT-013-005 | SCT-013-010 | SCT-013-020 | SCT-013-030 | SCT-013-050 | SCT-013-060 | SCT-013-100 |
|---|---|---|---|---|---|---|---|
| Plancher détectable (la lecture sans charge) | ~3 mA | 6–9 mA | ~10 mA | ~13 mA | ~25 mA | ~30 mA | ~60 mA |
| Plancher lisible (erreur ≤ 10 % ; 0.5 % du calibre) | 25 mA | 50 mA | 0.10 A | 0.15 A | 0.25 A | 0.30 A | 0.50 A |
| Classe proche du plancher, UI1 / UI2 / UI3 (±1 % de la moyenne, à partir d'environ 0.7 % du calibre) | à partir de 35 mA | à partir de 70 mA | à partir de 0.14 A | à partir de 0.21 A | à partir de 0.35 A | à partir de 0.42 A | à partir de 0.70 A |
| Classe proche du plancher, UI5 / UI7 (±0.5 %, à partir de 2 % du calibre) | à partir de 0.10 A | à partir de 0.20 A | à partir de 0.40 A | à partir de 0.60 A | à partir de 1.0 A | à partir de 1.2 A | à partir de 2.0 A |
| Classe dans la plage de fonctionnement (5–100 % du calibre, de la moyenne) | ≤ 0.5 % | 0.16–0.35 % | ≤ 0.5 % | 0.53 % | ≤ 0.5 % | ≤ 0.5 % | 0.47 % |
| Tolérance de l'unité de capteur (ajoutée à la classe) | ≤ 0.8 % | 0.5–1.0 % | 0.8 % | 1.2 % | 0.7 % | 0.3–0.4 % | 0.45 % |
| Pas d'une valeur instantanée | 4.1 mA | 8.1 mA | 16 mA | 24 mA | 41 mA | 49 mA | 83 mA |
| Haut de gamme (écrêtage, sinusoïde) | ~6.0 A | 11.9 A | ~24 A | 35 A | ~60 A | ~72 A | ~117 A |
Source : vérifié dans plusieurs essais en laboratoire. À noter que les capteurs SCT-013 réels ont une erreur réelle d'environ 1 %, qui peut croître avec le temps ou la température. Si vous avez besoin d'une bonne qualité de mesure à petits courants, choisissez un capteur de calibre plus faible.
- Pas d'une valeur instantanée d'environ 0.08 % de la plage. La mesure RMS est calculée sur toute la fenêtre de 100 ms et renvoyée sous forme de nombre fractionnaire, donc elle est plus fine que le pas : par exemple, avec la pince 5 A, la lecture à vide est d'environ 3 mA alors que le pas est de 4.1 mA. La résolution réelle est limitée par le bruit, non par le pas.
- Près du plancher : une seule lecture (une fenêtre de 100 ms) à 1 % du calibre est bruitée de 0.6 à 2 %. La moyenne sur une période et l'énergie restent dans la classe indiquée dans le tableau.
- UI5 / UI7 en dessous de 2 % du calibre : l'écart entre modules atteint ±5 %, donc pour ces modules la classe près du plancher commence à 2 % du calibre.
- « Moyenne » = la moyenne de plusieurs fenêtres de mesure de 100 ms, telle qu'utilisée pour l'énergie et la puissance moyenne.
- L'écrêtage est une propriété du capteur SCT-013 (son niveau de sortie au courant nominal) ; restez sous le calibre pour des mesures fiables.
- Changer de modèle de capteur revient à écrire le code du modèle dans le module — aucune étape de recalibrage.
Applications
- Comptage tarifaire — comptabilité de l'énergie par intervalles d'1 min, 15 min, 1 heure, jour, mois ou année
- Maison connectée — suivi de la consommation de toute la maison, sous-comptage par charge, suivi de la production
- Contrôle de charge — signal de retour pour les appareils de régulation de puissance (chauffe-eau, charges résistives, onduleurs)
- Équilibrage énergétique — comptabilité séparée de la consommation et de la production dans les foyers équipés de solaire
- Surveillance de la qualité du réseau — côté consommateur comme côté distributeur
Variantes de module
Gamme BASIC actuelle : SCT-UI1, SCT-UI2, SCT-UI3, SCT-UI5, SCT-UI7, SCT-I1, SCT-I2, SCT-I3. Dans le code, UIn signifie une entrée de tension et n canaux de courant ; In signifie n canaux de courant seulement. Les modules sont fournis sans capteur ; les caractéristiques de chaque calibre SCT-013 figurent dans le tableau SCT-013. Les autres gammes de modules ont une composition différente ; un tableau pour chaque gamme sera ajouté ici à mesure de leur mise en vente.
BASIC — pour capteurs de type SCT-013
| Module | U | Canaux I | P | Quand le choisir |
|---|---|---|---|---|
| SCT-UI1 | oui | 1 | oui | point de comptage unique — compteur général de la maison, chauffe-eau, onduleur unique |
| SCT-UI2 | oui | 2 | oui | deux sous-compteurs sur une même phase (éclairage + prises, production + consommation) |
| SCT-UI3 | oui | 3 | oui | trois flux sur une phase |
| SCT-UI5 / SCT-UI7 | oui | 5 / 7 | oui | surveillance de phases à grand nombre de canaux (grands tableaux, bancs de laboratoire) |
| SCT-I1 | non | 1 | non | moniteur de courant seul (le maître calcule P avec sa propre source U) |
| SCT-I2 | non | 2 | non | moniteur de courant à deux canaux |
| SCT-I3 | non | 3 | non | moniteur de courant à trois canaux |
BASIC — avec pinces CT appairées en usine (série CT)
| Module | U | Canaux I | P | Quand le choisir |
|---|---|---|---|---|
| CT-UI1 | oui | 1 | oui | un point de mesure avec une pince étalonnée et prête |
| CT-UI2 | oui | 2 | oui | deux sous-compteurs sur une phase |
| CT-UI3 | oui | 3 | oui | trois flux sur une phase |
| CT-UI5 / CT-UI7 | oui | 5 / 7 | oui | mesure par phase à grand nombre de canaux |
Un module de la série CT est livré avec une pince de courant sur chaque canal. La pince et le canal sont étalonnés ensemble en usine et marqués du numéro du canal : il n'y a rien à sélectionner ni à configurer. Les calibres des pinces sont 1, 5, 10, 20, 30, 50 ou 100 A. L'entrée de tension est la même que sur la série SCT. Voir Modules de la série CT : démarrage sans configuration.
Sur les variantes à courant seul, la puissance active n'est pas calculée (P_real = 0) et PERIOD_AVG_P_W renvoie 0. Le maître doit fournir sa propre source de tension pour le calcul de puissance, ou n'utiliser que les données de courant.
Niveaux de produit
rbAmp est proposé en deux niveaux de produit. Chaque niveau est une combinaison complète de révision matérielle et firmware — et non un simple indicateur firmware. Passer d'un niveau à l'autre exige un changement physique de référence, pas une mise à jour firmware.
BASIC — gamme de produits d'entrée de gamme
- Matériel : étage analogique à bas coût, adapté aux charges résidentielles typiques.
- Firmware : mesure unidirectionnelle de la consommation. L'accumulateur par période ramène à zéro chaque échantillon de puissance active par fenêtre avant intégration : seule l'énergie consommée (positive) est comptée, comme un compteur mécanique à disque qui ne tourne que vers l'avant.
PERIOD_AVG_P_West toujours ≥ 0 ; les événements de flux inverse sont écartés de l'accumulateur de période.- Cas d'usage : foyers sans production sur site ; sous-comptage de consommateurs purs (chauffages, moteurs, appareils).
STD — une gamme de produits distincte
STD est une gamme de produits distincte : modules mono- et triphasés avec compteurs d'énergie embarqués et Modbus RTU. Elle possède sa propre carte de registres et sa propre documentation — voir la documentation STD.
Où le niveau apparaît dans cette documentation
Cette documentation décrit la carte de registres 8 bits BASIC (0x00..0xCF). Les modules STD utilisent une carte de registres 16 bits différente et sont décrits dans la documentation STD ; sur STD, ces fonctions fonctionnent différemment.
Principales caractéristiques
- Esclave I²C : 50 kHz sur les hôtes ESP32 et ESP8266 (limitation du pilote ESP-IDF), 100 kHz sur les autres hôtes ; 400 kHz n'est pas recommandé.
- Adresse : 7 bits
0x50par défaut, réaffectable dans la plage0x08..0x77via validation en deux phases (voir initialization.md). - DATA_READY (DRDY) : broche optionnelle en collecteur ouvert, impulsion LOW d'environ 10 µs à chaque fenêtre de mesure (~100 ms à partir de la v1.2 ; 200 ms avant), qui marque l'instant où les registres temps réel sont cohérents.
- Instantané de période atomique : la commande
0x27fige la puissance moyenne par période ; une seule écriture ferme et ouvre — aucun échantillon perdu ou dupliqué à la frontière. - Instantané de diffusion General Call : l'adresse
0x00est réservée à un instantané simultané sur tous les modules partageant un bus. Activation module par module viaFLEET_CONFIG.bit0(par défaut DÉSACTIVÉ). Lorsqu'il est désactivé, les trames GC sont refusées au niveau du bus (NACK) — les maîtres le détectent et se rabattent sur un instantané séquentiel module par module (décalage sur un bus à 50 kHz : ~1 ms × N, ≪ 0.03 % d'une période de 60 s). Voir period-metering.md pour la séquence d'activation et le format de trame. - Horloge murale côté maître : l'énergie est calculée côté maître comme
avg_P × dt_master; le registre d'horodatage de période côté puce (0xEC) est réservé au diagnostic (peut sous-compter jusqu'à ~30 % sous charge — par conception). Supprime la dérive de quartz entre modules dans les systèmes multi-modules. - Étalonnage en flash : l'étalonnage d'usine est stocké sur le module ; aucun étalonnage utilisateur n'est requis. Sur les modules BASIC de la série SCT, le maître n'écrit que
SENSOR_CLASSetCT_MODELpar canal pour le capteur SCT-013 connecté. Sur les modules de la série CT, l'hôte n'écrit rien — voir démarrage sans configuration. - Configuration automatique : le module commence à mesurer dès la mise sous tension (~250 ms jusqu'au premier résultat valide, ~700 ms de plus pour la première écriture persistante).
Ce que rbAmp ne fait pas
- N'intègre pas l'énergie (Wh) en interne — l'accumulation d'énergie relève du maître (voir period-metering.md)
- Ne pilote pas de charges, ne contient pas de logique d'automatisation et n'exécute pas de règles programmables
- Ne dispose d'aucun affichage intégré
Suivant
- hardware-connection.md — connexion, alimentation, câblage
- initialization.md — première mise sous tension