Ce que vous allez construire
- Tension, courant, puissance active, énergie (kWh) et facteur de puissance par phase pour L1 / L2 / L3.
- Une puissance active triphasée totale cohérente (les trois phases additionnées sur un même verrouillage synchronisé).
- Tout sur un seul ESP32 via un bus I²C unique — pas de second microcontrôleur, pas de conversion ADC en tourniquet.
- Le tout dans le tableau de bord Énergie de Home Assistant.
Nomenclature
| Élément | Qté | Remarques |
|---|---|---|
| rbAmp BASIC SCT-UI1 | 3 | une par phase — tension + courant + puissance réelle sur puce · produit |
| Transformateur de courant SCT-013 | 3 | une par phase, calibre adapté à la capacité de chaque phase · produit |
| Carte de développement ESP32 | 1 | toute carte de classe esp32dev |
| Fils de liaison | — | le bus I²C partagé (SDA/SCL/3V3/GND) |
Chaque module UI1 a besoin de sa propre tension de phase en plus de son TC. Câblez l'entrée de tension de chaque module sur la phase qu'il mesure (L1→module A, L2→module B, L3→module C) — c'est cet appariement de tension par phase qui rend la mesure cohérente. Lisez la section sécurité ci-dessous avant de câbler quoi que ce soit — les prises de tension sont des raccordements sur conducteur sous tension, pas des pinces à clipser.
La sécurité d'abord — les prises de tension sont des travaux sur conducteur sous tension
⚠️ Ce montage raccorde aussi des entrées de tension au secteur. L'entrée de tension de chaque module se raccorde à une phase (L) sous tension et au neutre, avec un fusible sur L comme le précisent les documents des modules. Le côté courant reste non invasif : le SCT-013 se place autour de son conducteur de phase — vous ne coupez ni ne dénudez jamais un fil sous tension. Étiquetez chaque TC et chaque câble de tension par rapport à sa phase. Pour toute intervention dans un tableau électrique, faites appel à un électricien qualifié.
Câblage du bus
Les trois modules partagent un seul bus I²C issu de l'ESP32 :
ESP32 GPIO21 (SDA) ─┬── UI1 phase-A (CT on L1, voltage tap on L1)
├── UI1 phase-B (CT on L2, voltage tap on L2)
└── UI1 phase-C (CT on L3, voltage tap on L3)
ESP32 GPIO22 (SCL) ─┘ + shared 3V3 and GND to all three
- Posez la pince de chaque module autour d'un conducteur de phase, flèche vers la charge.
- Tirages intégrés : gardez-les actifs sur le premier module dans l'ordre physique du câblage et désactivez-les sur les deux autres — une seule paire de tirage par bus, jamais en externe. (Voir la documentation matérielle du module.)
Donnez une adresse propre à chaque module
Tous les modules sortent d'usine à l'adresse I²C 0x50. Trois sur un même bus nécessitent trois adresses — 0x50, 0x51, 0x52. Attribuez la deuxième et la troisième une seule fois chacune, un module à la fois, les autres débranchés pour éviter tout conflit. Sur le micrologiciel actuel, c'est une opération en mode production — ni mode usine, ni outil supplémentaire :
- Ne branchez que le module dont vous changez l'adresse.
- Flashez une configuration de test avec
address: 0x50etnew_address: 0x51(puis0x52pour le troisième). - Surveillez le journal de démarrage ESPHome pour confirmer le changement, puis réglez
address: 0x51, supprimez la lignenew_address:et passez au module suivant.
(Mécanique complète : référence de l'API ESPHome → new_address.)
La configuration ESPHome
Trois modules UI1 à 0x50 / 0x51 / 0x52, un parc synchronisé, données par phase en direct plus le total cohérent. Réglez les tailles de vos TC et les secrets Wi-Fi, puis flashez :
# Three-phase energy monitoring: 3× rbAmp UI1 on one ESP32, one I²C bus.
# GPIO21 SDA ─┬─ UI1 @0x50 (phase A: V+I on L1)
# ├─ UI1 @0x51 (phase B: V+I on L2)
# └─ UI1 @0x52 (phase C: V+I on L3)
# Each module computes its phase's real power on-chip; fleet_gc_enable + group_id
# latch all three on one broadcast instant (<10 µs skew).
# Compile-verified: ESPHome 2026.5.3, github://rb-amp/rbamp-esphome@v1.4.0.
esphome:
name: rbamp-3phase
esp32:
board: esp32dev
framework:
type: arduino
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
api:
ota:
- platform: esphome
logger:
i2c:
sda: GPIO21
scl: GPIO22
frequency: 50kHz # ESP-IDF i2c_master driver + the module's I²C recovery window interact at
# 100 kHz → intermittent read NACKs on ESP32. 50 kHz is the robust setting.
# STM32 / RP2040 / Linux-SBC masters run this module at 100 kHz fine.
scan: true
external_components:
- source: github://rb-amp/rbamp-esphome@v1.4.0
components: [rbamp]
# ─── Three UI1 modules in the same GC-LATCH fleet ────────────────────────────
rbamp:
- id: phase_a
address: 0x50
update_interval: 10s
latch_interval: 60s
ct_model: SCT_013_050 # mains phase — pick to match your service capacity
fleet_gc_enable: true
group_id: 1
- id: phase_b
address: 0x51
update_interval: 10s
latch_interval: 60s
ct_model: SCT_013_050
fleet_gc_enable: true
group_id: 1
- id: phase_c
address: 0x52
update_interval: 10s
latch_interval: 60s
ct_model: SCT_013_050
fleet_gc_enable: true
group_id: 1
# ─── HA entities — per-phase real V/I/P/Wh/PF + 3-phase total ────────────────
sensor:
# ══ Phase A (L1) ═════════════════════════════════════════════════════════
- platform: rbamp
rbamp_id: phase_a
voltage:
name: "Phase A Voltage"
current:
name: "Phase A Current"
power:
name: "Phase A Power"
id: p_phase_a
energy:
name: "Phase A Energy" # ← per-phase kWh accumulator
power_factor:
name: "Phase A Power Factor"
frequency:
name: "Phase A Frequency" # publish freq from phase A only
# ══ Phase B (L2) ═════════════════════════════════════════════════════════
- platform: rbamp
rbamp_id: phase_b
voltage:
name: "Phase B Voltage"
current:
name: "Phase B Current"
power:
name: "Phase B Power"
id: p_phase_b
energy:
name: "Phase B Energy"
power_factor:
name: "Phase B Power Factor"
# ══ Phase C (L3) ═════════════════════════════════════════════════════════
- platform: rbamp
rbamp_id: phase_c
voltage:
name: "Phase C Voltage"
current:
name: "Phase C Current"
power:
name: "Phase C Power"
id: p_phase_c
energy:
name: "Phase C Energy"
power_factor:
name: "Phase C Power Factor"
# ── 3-phase total active power (Σ per-phase real P) ───────────────────────
# All three modules latch on the same broadcast instant (fleet_gc_enable),
# so the summed instantaneous P values are coherent. Reads happen
# sequentially after the latch, but the frozen P values reflect the same
# wire moment. Skew: <10 µs chip-side; negligible for any real load.
- platform: template
name: "Total 3-Phase Active Power"
device_class: power
state_class: measurement
unit_of_measurement: W
accuracy_decimals: 1
update_interval: 10s
lambda: |-
float total = 0;
if (id(p_phase_a).has_state()) total += id(p_phase_a).state;
if (id(p_phase_b).has_state()) total += id(p_phase_b).state;
if (id(p_phase_c).has_state()) total += id(p_phase_c).state;
return total;
Deux réglages qui méritent d'être compris :
-
fleet_gc_enable: true+group_id: 1placent les trois modules dans un même parc synchronisé. Une fois par minute, l'ESP32 envoie une seule trame General-Call « verrouiller maintenant » et chaque module fige sa période d'accumulation au même instant (écart inférieur à 10 µs) — c'est ce qui rend le total triphasé cohérent plutôt que trois valeurs échantillonnées indépendamment. -
latch_interval: 60s(rbAmp ESPHome v1.4) découple le VERROUILLAGE synchronisé de la cadence de lecture en direct : le tableau de bord rafraîchit tension / courant / puissance toutes lesupdate_interval(10 s), tandis que la rafale cohérente de verrouillage d'énergie ne tourne qu'une fois par minute. Les kWh restent exacts dans les deux cas — le maître intègre sur le temps mural réel. Supprimez la ligne pour le comportement v1.3 à cadence unique.
Ajoutez-le à Home Assistant
-
Flashez et laissez le nœud démarrer — Home Assistant le découvre automatiquement via l'API ESPHome. Vous verrez les entités par phase plus Puissance active triphasée totale [Total 3-Phase Active Power].
-
Paramètres → Appareils et services → Énergie [Settings → Devices & Services → Energy]. Ajoutez le capteur Énergie de chaque phase (
Phase A/B/C Energy) comme source de consommation réseau — le tableau de bord les additionne pour la consommation du logement. -
Créez une vue Lovelace rapide avec les trois puissances par phase et le total pour une image en direct par circuit.
Vérifiez que le câblage est correct
- Le balayage I²C du journal de démarrage doit lister les trois adresses :
[i2c] Found i2c device at address 0x50
[i2c] Found i2c device at address 0x51
[i2c] Found i2c device at address 0x52
- Sous une charge monophasée connue sur une phase, seule la puissance de cette phase doit varier.
- Les trois puissances par phase doivent additionner la Puissance active triphasée totale (Total 3-Phase Active Power) à chaque mise à jour.
- Si une phase affiche une fraction suspicieusement ronde de ce que vous attendez, vérifiez que sa prise de tension est sur la même phase que son TC — l'appariement cohérent est tout l'enjeu (voir la physique).
Pourquoi c'est précis
Chaque module mesure sa phase en tension et en courant simultanément et calcule la puissance active réelle directement sur puce ; le verrouillage synchronisé fige les trois sur un même instant. C'est une intégration cohérente phase par phase — le palier sous 1 %, contre l'erreur de 15 à 50 % de la mesure d'une seule phase multipliée par trois. Le raisonnement complet figure dans l'article associé : pourquoi trois compteurs monophasés ne peuvent pas mesurer votre puissance 3 phases.
Vous préférez une seule carte ? Une variante monocarte dédiée (U3I3 — les trois phases sur une seule carte, une seule adresse I²C) est en développement. Elle est prévue sur la feuille de route, pas encore livrée ; abonnez-vous ci-dessous et nous annoncerons sa sortie. D'ici là, ce parc de trois modules est la voie aux chiffres honnêtes que vous pouvez construire dès aujourd'hui.