rbAmp
FR
Boutique

Projet · · lecture de 13 min

Énergie par circuit dans le tableau de bord Énergie de Home Assistant, en un après-midi — avec ESPHome et rbAmp

Ajoutez une énergie réelle et étalonnée par appareil au tableau de bord Énergie de Home Assistant — un ESP32, ESPHome et un module rbAmp sur deux fils I²C. Ni UART, ni PZEM.

Le problème que cela résout

Il existe une voie plus courte. Un module rbAmp Basic communique en I²C — deux fils de signal — et est livré comme composant ESPHome natif. Vous posez un TC autour d'un conducteur, collez une douzaine de lignes de YAML, et Home Assistant adopte un appareil avec la tension, le courant, la puissance et l'énergie cumulée réels — sans mobiliser de port série. Ce guide va d'une boîte non ouverte à une tuile en direct dans le tableau de bord Énergie. Et lorsque vous voudrez un second circuit, vous ajouterez un autre petit module sur les mêmes deux fils — pas un autre ESP32.

Ce que vous aurez à la fin

L'entité d'énergie rbAmp alimentant le tableau de bord Énergie de Home Assistant
Consommation par appareil dans le tableau de bord Énergie de HA, directement depuis un module rbAmp via ESPHome.

Pourquoi c'est meilleur qu'un PZEM

La configuration rapide est agréable, mais quelques différences d'architecture sont la vraie raison de construire ainsi — et elles gagnent en valeur à mesure que le module tourne plus longtemps et que vous ajoutez des circuits.

  • Fenêtres de période qui se ferment atomiquement. Au-delà du total à vie, rbAmp peut fermer une fenêtre de mesure et en ouvrir une autre — par seconde, par heure, par jour, ou une période tarifaire à la demande — atomiquement, en une seule écriture I²C. À réception, le module fige les accumulateurs de cette période et démarre la suivante au même instant sur le fil : pas de boucle de lecture, pas d'écart. Pour obtenir la même énergie fenêtrée d'un PZEM, il faudrait lire et remettre à zéro son accumulateur via l'UART à chaque intervalle — du temps CPU et série sur une liaison qui lutte déjà avec le Wi-Fi de l'ESP, avec un infime écart entre la lecture et la remise à zéro qui tombe dans aucune des deux fenêtres. Verrou matériel contre contournement logiciel. (Diffusé à plusieurs modules à la fois, ce même verrou garde un tableau entier synchronisé — le prochain projet de cette série.)

  • L'énergie est mesurée sur l'appareil, non devinée dans Home Assistant. Le module rbAmp effectue la mesure de puissance et remet à l'ESP une puissance moyenne cohérente à chaque période ; le composant ESPHome l'intègre en wattheures et les sauvegarde dans la NVS, de sorte que HA reçoit un total déjà intégré. Cela vous tient à l'écart de la plus grande source de mauvaises données d'énergie dans HA — le laisser lui intégrer la puissance en énergie par une somme de Riemann entre deux échantillons, ce qui est à l'origine des pics de −200 kWh et des journées 10 fois trop élevées que l'on voit partout sur les forums.

  • Le module fait le plus dur — votre hôte peut donc être modeste. Tout l'échantillonnage, le RMS vrai, la correction de phase et l'étalonnage tournent sur le processeur du rbAmp ; l'ESP lit simplement des valeurs finies via I²C. Un hôte modeste suffit — un ESP8266 ou un ESP32-C2/C3 a une marge largement suffisante — ce qui laisse vos cartes plus puissantes pour les tâches plus lourdes.

  • C'est un bus, pas une liaison point à point. I²C signifie que plusieurs modules rbAmp partagent les mêmes deux fils de signal — et les modules existent en variantes 1, 2 et 3 canaux aujourd'hui (avec des modules 5 et 7 canaux prévus), donc un seul module peut mesurer plusieurs circuits depuis un point d'installation unique. Un ESP32 peut lire tout un tableau — réseau général, chauffe-eau, climatisation, borne de recharge VE, éclairage — et lorsque les modules fonctionnent sur un maître commun, ils peuvent être verrouillés au même instant pour que leurs sous-totaux s'additionnent à l'alimentation. Un PZEM occupe un UART par appareil ; on manque de ports série (et de patience) au-delà de deux. Ajouter un circuit ici coûte un petit module sur le bus, pas un autre microcontrôleur. (C'est le prochain projet de cette série.)

Nomenclature

Élément Pourquoi Prix Où
rbAmp BASIC SCT-UI1 (V + I, 1 canal) le compteur — lit la tension, le courant, la puissance, l'énergie voir la page produit BASIC SCT-UI1
Transformateur de courant SCT-013 (30 A recommandé) pince split-core autour du conducteur voir la page produit TC SCT-013
N'importe quelle carte de développement ESP32 Hôte Wi-Fi qui communique avec Home Assistant vous en possédez probablement un —
4 fils de liaison (F–F) le bus I²C : SDA, SCL, 3V3, GND — —
Quel TC ?

Adaptez le calibre du SCT-013 à ce que vous mesurez — et notez que les charges isolées sont plus petites qu'il n'y paraît : un climatiseur de pièce ne tire qu'environ 2–3 A, une bouilloire électrique jusqu'à environ 10 A. Une pince de 5 A ou 10 A résout finement ces valeurs ; 30 A couvre un circuit mural chargé ; 50 A une alimentation d'appartement entier. (Pour dimensionner une arrivée principale plus forte — environ 30 A pour un étage, 100 A pour une maison avec atelier et garage — c'est un travail sur l'ensemble du tableau : la plage SCT-013 de rbAmp s'arrête à 50 A, donc les arrivées plus fortes utilisent un TC de plage supérieure et la configuration du tableau complet.) Pour un appareil isolé, 10–30 A est le réglage sûr par défaut. Le module rbAmp connaît les préréglages SCT-013, donc l'étalonnage est une valeur de configuration unique (ct_model:, ci-dessous) — ni réglage, ni calcul de résistance de charge. Voir Choix du TC / capteur. (La pince s'achète séparément, donc le module ne peut pas la connaître à l'avance — une ligne de configuration ci-dessous suffit.)

La sécurité d'abord — lisez ceci avant de toucher à un tableau électrique

Sécurité

⚠️ Le côté mesure se branche au secteur. Une pince split-core se place autour de l'extérieur d'un conducteur isolé — vous ne coupez, ne dénudez ni n'épissez jamais un fil sous tension pour l'installer. Pour toute intervention dans un tableau électrique, faites appel à un électricien qualifié.

Câblage

Quatre cavaliers entre l'ESP32 et le module rbAmp Basic :

Broche ESP32 Broche du module rbAmp
3V3 3V3
GND GND
GPIO21 (SDA) SDA
GPIO22 (SCL) SCL

Posez ensuite la pince split-core autour de un seul conducteur isolé de l'appareil à mesurer — la phase ou le neutre, l'un ou l'autre, pas les deux — et branchez-la sur la prise jack 3.5 mm du module. Le module fait le reste.

Remarque

Sur un ESP32-S3, utilisez GPIO8 (SDA) / GPIO9 (SCL) ; sur un ESP32-C3, utilisez GPIO4 / GPIO5. Adaptez le bloc i2c: du YAML ci-dessous à votre carte.

[schéma de câblage — emplacement média : ESP32-DevKitC ↔ module rbAmp Basic, 4 fils, TC posé sur un conducteur]

Flasher l'ESP32 avec ESPHome

Le tout tient dans un seul fichier — une douzaine de lignes utiles. Copiez-le, renseignez vos identifiants Wi-Fi, c'est terminé.

YAML
esphome:
  name: rbamp-energy

esp32:
  board: esp32dev
  framework:
    type: arduino

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

api:
ota:
  - platform: esphome
logger:

# I²C bus to the rbAmp module. GPIO21/22 are the default pins on a classic ESP32-DevKitC.
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.

# Pull the rbAmp component from GitHub, pinned to the v1.3.0 release.
external_components:
  - source: github://rb-amp/rbamp-esphome@v1.4.0
    components: [rbamp]

# The module itself — 0x50 is the factory-default I²C address.
rbamp:
  id: meter
  address: 0x50
  update_interval: 60s
  # One-time CT setup for the SCT-013 module: tell it which clamp is fitted. This pins the
  # 30 A SCT-013 preset and is written ONCE to the module's flash (idempotent — safe to leave
  # in the config; it only re-writes when the value changes). Match it to YOUR clamp:
  # SCT_013_005 / _010 / _020 / _030 / _050.
  ct_model: SCT_013_030

# Voltage · current · active power · cumulative energy → Home Assistant entities.
# The energy sensor is auto-tagged device_class=energy + state_class=total_increasing,
# and its Wh counter is checkpointed to the ESP's NVS on every publish — so it survives
# reboots and power cycles instead of restarting from zero.
sensor:
  - platform: rbamp
    rbamp_id: meter
    voltage:
      name: "rbAmp Voltage"
    current:
      name: "rbAmp Current"
    power:
      name: "rbAmp Power"
    energy:
      name: "rbAmp Energy"
Remarque

La ligne que l'on oublie : ct_model. Un module SCT-013 sort vierge — il faut lui indiquer quelle pince vous avez installée, sinon ses lectures sont mal mises à l'échelle. Définir ct_model: SCT_013_030 le fait une seule fois ; le module le stocke dans sa propre flash et n'en a plus besoin (la ligne est idempotente, la laisser dans la configuration ne pose donc aucun problème). Changez la pince, changez la valeur. La pince se vend séparément, donc le module ne peut pas la connaître à l'avance — cette seule ligne constitue toute la configuration.

Steps:

  1. Installer l'interface en ligne de commande ESPHome(à passer si vous l'avez déjà — ou utilisez le module complémentaire ESPHome dans Home Assistant ; le même YAML s'applique) :

    Bash
    pip install esphome
    

  2. Mettez vos identifiants Wi-Fi dans secrets.yamlà côté de la configuration, pour qu'ils n'atterrissent jamais par erreur dans un dépôt Git :

    YAML
    wifi_ssid: "YOUR_SSID"
    wifi_password: "YOUR_PASSWORD"
    

  3. Premier flash par USB (replace /dev/ttyUSB0avec votre port —COM3 / COM4sous Windows) :

    Bash
    esphome run rbamp-basic-ui1.yaml --device /dev/ttyUSB0
    

ESPHome télécharge le composant rbAmp, compile, téléverse et diffuse le journal de démarrage. Vous devriez voir un balayage I²C lister l'adresse 0x50, puis rbAmp v1.3.0 initialised et des publications de capteurs périodiques.

Ensuite, les mises à jour se font par voie hertzienne — plus besoin de débrancher quoi que ce soit :

Bash
esphome run rbamp-basic-ui1.yaml
Remarque

À quelle fréquence doit-il interroger ? (update_interval) La configuration utilise 60s, ce qui convient au tableau de bord Énergie. Vous pouvez aller plus vite ou plus lentement : le minimum accepté est 1s (tout ce qui est plus court est rejeté — le module ne rafraîchit ses échantillons qu'environ 5 fois par seconde, donc une interrogation sous la seconde ne fait que saturer le bus), et 300s (5 min) est un plafond confortable pour un capteur calme à faible trafic. Ne dépassez pas 3600s (1 heure) — le tableau de bord Énergie a besoin d'au moins une mise à jour par heure pour tracer des barres horaires propres. Vous voulez plutôt une lecture de puissance en direct et nerveuse ? Descendez à 2s — voir Au-delà du tableau de bord ci-dessous.

Voyez-le dans Home Assistant

Home Assistant découvre automatiquement les appareils ESPHome via mDNS.

Les entités rbAmp vivent dans Home Assistant après adoption

  1. Ouvrez Paramètres → Appareils et services [Settings → Devices & Services]. Une bannière apparaît : « ESPHome — Découvert — rbamp-energy. » Cliquez sur Configurer, confirmez l'invite de clé de chiffrement (laissez vide si vous n'avez pas défini le chiffrement de api:), et l'appareil est adopté.

  2. Ouvrez le nouvel appareil rbamp-energy — quatre entités vous attendent :

Entité Unité device_class HA Remarques
sensor.rbamp_voltage V voltage Tension secteur efficace (RMS)
sensor.rbamp_current A current Courant RMS à travers le TC
sensor.rbamp_power W power Puissance active (P)
sensor.rbamp_energy Wh energy Cumulée — jamais remise à zéro

Les quatre entités rbAmp avec valeurs en direct dans Home Assistant

L'entité d'énergie porte déjà state_class: total_increasing, et son compteur est sauvegardé dans la NVS de l'ESP à chaque publication. Débranchez puis rebranchez : la valeur en Wh reprend là où elle s'était arrêtée. C'est exactement ce qu'attend le tableau de bord Énergie.

  1. Rien à configurer par capteur — le composant livre chaque device_class, state_class et unité au niveau de la plateforme, donc HA les récupère à la découverte.

Ajoutez-le au tableau de bord Énergie [Energy Dashboard]

Ajout de sensor.rbamp_energy comme appareil individuel dans les paramètres Énergie de HA

  1. Ouvrez Paramètres → Tableaux de bord → Énergie (ou Paramètres → Énergie sur les versions récentes de HA).
  2. Sous Appareils individuels, cliquez sur Ajouter un appareil et choisissez sensor.rbamp_energy. Home Assistant filtre la liste sur les entités device_class: energy + state_class: total_increasing — le capteur d'énergie rbAmp répond aux deux, il apparaît donc immédiatement, sans indicateur supplémentaire.

  3. Enregistrez. Le tableau de bord a besoin d'environ une heure pour tracer sa première barre lisible ; les totaux horaires et journaliers se construisent ensuite.

Basic ou Standard.

Un module Basic mesure la consommation — la puissance qui entre dans l'appareil. Il ne distingue pas l'import de l'export ; il se place donc dans les emplacements appareil / consommation du tableau de bord Énergie, et non dans « Retour au réseau. ». Pour une mesure bidirectionnelle du réseau (injection d'un onduleur solaire, export batterie), il faut un module de la série Standard avec sa détection de tension matérielle isolée — voir la présentation des gammes. Basic est une mesure de qualité surveillance et étalonnée, mais ce n'est pas un compteur de facturation certifié.

Au-delà du tableau de bord : mesure en temps réel

Le tableau de bord Énergie attend des wattheures lents et cumulés — mais le module mesure beaucoup plus et se rafraîchit en interne environ cinq fois par seconde. Si vous voulez une jauge de puissance en direct, une lecture de tension ou un facteur de puissance pour des automatisations, ajoutez les capteurs supplémentaires et interrogez plus vite. Descendez update_interval à 2s (nerveux : vous verrez une bouilloire s'enclencher en moins d'une seconde) ou 5s (tendance lissée), et exposez l'ensemble complet :

YAML
rbamp:
  id: meter
  address: 0x50
  update_interval: 2s     # live real-time — override the 60s Energy-Dashboard default
  ct_model: SCT_013_030

sensor:
  - platform: rbamp
    rbamp_id: meter
    voltage:        { name: "rbAmp Voltage" }
    current:        { name: "rbAmp Current" }
    power:          { name: "rbAmp Active Power" }
    power_factor:   { name: "rbAmp Power Factor" }
    apparent_power: { name: "rbAmp Apparent Power" }
    reactive_power: { name: "rbAmp Reactive Power" }
    frequency:      { name: "rbAmp Frequency" }
    energy:         { name: "rbAmp Energy" }

Vous pouvez maintenant créer une carte de puissance en direct, alerter sur une chute de tension ou surveiller l'affaissement du facteur de puissance au démarrage d'un moteur. Deux points à connaître pour que vos automatisations se comportent correctement :

  • La fréquence affiche 0 pendant une coupure (le détecteur a besoin d'une forme d'onde en direct), donc protégez toute automatisation « fréquence chutée » contre 0 / unavailable.

  • Le facteur de puissance est brièvement unavailable à vide — sans courant significatif il n'y a pas de phase à calculer. Laissez vos automatisations tolérer unavailable pendant les deux premières secondes après le démarrage.

(Import/export — séparer la consommation du réseau de l'injection solaire — nécessite unStandardmodule à détection de tension bidirectionnelle ; ce n'est pas une capacité Basic, donc il est omis ici.)

Découpez par tarif (heures pleines / heures creuses)

Avec un tarif heures pleines/heures creuses, vous voudrez savoir combien de wattheures tombent dans la fenêtre pleine par rapport aux heures creuses — sans rien acheter de plus. Home Assistant le fait nativement : pointez son utility_meter intégré sur l'unique entité d'énergie rbAmp et laissez HA la découper en sous-compteurs tarifaires. Cela va dans le configuration.yaml de HA, et non dans le YAML ESPHome :

YAML
utility_meter:
  rbamp_energy_tou:
    source: sensor.rbamp_energy
    tariffs: [peak, off_peak]
    cycle: monthly

Ajoutez ensuite une petite automatisation qui bascule le tarif actif aux bornes de vos plages horaires — par exemple peak à 07:00 et off_peak à 22:00 — en appelant utility_meter.select_tariff. HA tient un total courant distinct pour chaque tarif, en plus du compteur Wh unique que fournit le module. Un seul compteur, autant de tranches tarifaires que votre contrat en demande — et cela fonctionne avec n'importe quel capteur d'énergie ESPHome.

Suite

Vous disposez maintenant d'un circuit honnête dans Home Assistant. La suite :

  • Tout le tableau sur un seul ESP32. Placez un module multicanal (ou plusieurs modules monocanaux) sur les mêmes deux fils I²C — réseau général, cuisinière, chauffe-eau, climatisation, éclairage — un ESP32, un seul YAML. Ajouter un départ coûte un petit module, pas un autre microcontrôleur. (Prochain de cette série.)

  • Vous migrez depuis un PZEM ? Conservez votre historique Home Assistant, libérez l'UART et gagnez des wattheures qui survivent aux redémarrages. (Prochain de cette série.)

  • Traquez les consommations fantômes. Une fois chaque circuit mesuré, le plancher de veille — les ~35 W qui ne dorment jamais — devient visible et maîtrisable. (Prochain de cette série.)

Pour la théorie sous-jacente à tout cela — comment un TC transforme un champ magnétique en kilowattheures — voir le démarrage rapide ESPHome et le guide complet d'intégration Home Assistant.


À lire ensuite