rbAmp
FR
Boutique

Projet · · lecture de 8 min

Surveillance de l'énergie triphasée dans Home Assistant : 3× rbAmp UI sur un seul ESP32

Surveillance d'énergie triphasée (3 phases) cohérente par phase dans Home Assistant : trois modules rbAmp UI sur un ESP32 via I²C, avec le câblage et la configuration ESPHome complète.

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)
Sécurité

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

Sécurité

⚠️ 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 :

Text
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 :

  1. Ne branchez que le module dont vous changez l'adresse.
  2. Flashez une configuration de test avec address: 0x50 et new_address: 0x51 (puis 0x52 pour le troisième).
  3. Surveillez le journal de démarrage ESPHome pour confirmer le changement, puis réglez address: 0x51, supprimez la ligne new_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 :

YAML
# 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: 1 placent 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 les update_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

  1. 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].

  2. 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.

  3. 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 :
Text
[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.


À lire ensuite