rbAmp
FR
Boutique

Projet · · lecture de 7 min

Une alternative au PZEM-004T pour Home Assistant : migrez vers rbAmp et conservez tout votre historique

Vous avez dépassé votre PZEM-004T ? Passez à rbAmp sur I²C sans perdre un seul graphique — mêmes identifiants d'entités, historique intact, UART libéré, de la place pour ajouter d'autres circuits. Une migration en une seule modification YAML.

Pourquoi remplacer un PZEM qui fonctionne ?

  • Il occupe un UART. Le PZEM communique par liaison série — un UART matériel que vous préféreriez utiliser autrement, ou SoftwareSerial, dont la cadence devient instable sous charge Wi-Fi. Un compteur, un port série.

  • Il ne passe pas à l'échelle. Vous voulez un second circuit ? Il faut un second UART (vous en avez un ou deux) ou un second ESP. Il n'y a pas d'« ajout » propre — exactement le mur contre lequel on bute quand on veut mesurer plus d'un ou deux circuits.

rbAmp communique en I²C — un bus — vous libérez donc l'UART, gagnez une mesure étalonnée en usine et compensée en phase, et pouvez ajouter plus tard d'autres modules sur les mêmes deux fils (c'est le projet tableau complet). Ce qui empêche la plupart des gens de migrer, c'est la crainte de perdre leur historique Home Assistant — des années de graphiques, le tableau de bord Énergie, tout. Vous n'êtes pas obligé. Bien fait, HA ne remarque jamais que le matériel a changé.

Ce que vous conservez, ce que vous gagnez

Conservé : vos identifiants d'entités, chaque graphique d'historique, vos tableaux de bord et votre configuration du tableau de bord Énergie — intacts. Gagné :

  • Un UART libéré — les GPIO utilisés par le PZEM vous sont rendus.
  • De la place pour grandir — ajoutez des modules sur le bus I²C sans autre ESP (tableau complet sur un ESP32).
  • Puissance active réelle, étalonnée en usine et compensée en phase — mesurée, non estimée (voir comment la mesure fonctionne réellement).

  • Wattheures embarqués — accumulés sur le module et remis à HA comme total, de sorte que vous ne comptez pas sur l'intégration de la puissance par HA entre deux échantillons (la source des pics classiques du tableau de bord Énergie).

Nomenclature

Élément Pourquoi Où
rbAmp BASIC SCT-UI1 remplace la tête PZEM, sur I²C BASIC SCT-UI1
Un nouveau TC SCT-013 (calibre adapté au circuit) la pince TC SCT-013
votre ESP32 existant réutilisé — vous libérez son UART —
4 fils de liaison le bus I²C —
Sécurité

Ne réutilisez pas la pince du PZEM. Le TC d'un PZEM-004T est généralement de calibre 100 A (hors préréglages d'étalonnage de rbAmp), utilise une prise mono 2.5 mm (rbAmp attend du 3.5 mm), et son type de sortie n'est pas garanti compatible. Un SCT-013 neuf coûte quelques euros et supprime ces trois difficultés — et comme vous remplacez déjà la tête du module, cela reste une opération propre « remplacer, ne pas adapter ».

⚠️ Reposer un TC implique un travail dans le tableau. Un TC se place autour d'un fil isolé — vous ne le coupez ni ne le dénudez jamais. Pour toute intervention dans un tableau électrique, faites appel à un électricien qualifié.

Le remplacement : une modification YAML

Le secret pour garder votre historique est simple : Home Assistant identifie les entités par leur entity_id, et ESPHome le dérive du nom du nœud et du name: du capteur. Gardez les deux identiques à votre ancienne configuration PZEM et HA voit les mêmes entités — alimentées simplement par un meilleur matériel. Voici la configuration « après » (votre bloc UART du PZEM disparaît ; l'I²C prend sa place) :

YAML
esphome:
  name: energy-monitor          # ← MUST match your PZEM node name, byte-for-byte

esp32:
  board: esp32dev
  framework:
    type: arduino

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

api:
ota:
  - platform: esphome
logger:

# The rbAmp side of the swap — I²C replaces the old UART pins.
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]

rbamp:
  id: meter
  address: 0x50
  update_interval: 60s
  ct_model: SCT_013_030         # match to YOUR fitted CT

sensor:
  - platform: rbamp
    rbamp_id: meter
    # ⚠ Each name: MUST match your old PZEM sensor names byte-for-byte → same entity_id → history preserved.
    voltage: { name: "PZEM Voltage" }
    current: { name: "PZEM Current" }
    power:   { name: "PZEM Power" }
    energy:  { name: "PZEM Energy" }   # ← the Energy Dashboard entity — preserved

(Garder les noms littéraux "PZEM Voltage" etc. n'a d'importance que si c'est ce que votre ancienne configuration utilisait — reprenez ce que vous aviez. L'essentiel est l'identité à l'octet près.)

Préserver votre historique — les étapes exactes

  1. Notez vos identifiants d'entités actuels. Paramètres → Appareils et services [Settings → Devices & Services] → votre nœud PZEM → notez les entity_id des capteurs (ex. sensor.pzem_voltage, sensor.pzem_energy) et vérifiez lequel alimente le tableau de bord Énergie (Paramètres → Énergie).

  2. Installez le rbAmp à côté du PZEM ; posez la nouvelle pince SCT-013 autour du même conducteur ; câblez le bus I²C vers l'ESP32. (Vous pouvez laisser le PZEM physiquement branché — la bascule se fait dans le logiciel.)

  3. Écrasez votre ancien YAML avec la configuration ci-dessus, en modifiant uniquement : le esphome: name: pour votre ancien nom de nœud, chaque name: de capteur pour vos anciens noms de capteurs à l'octet près, et ct_model: pour votre TC.

  4. Flashez-le — esphome run energy-monitor.yaml. HA voit le même nœud/API revenir avec des données ; pas de bannière « nouvel appareil trouvé », pas de nouvelle adoption.

  5. Vérifiez sous 60 s — les entités doivent avoir les mêmes identifiants (pas ..._2). Si vous voyez un suffixe _2, un nom ne correspond pas à l'octet près ; corrigez et reflashez.

Une fois la substitution stabilisée, les libellés PZEM … ne servent qu'à correspondre à l'ancien entity_id. Vous pouvez renommer les noms conviviaux dans l'interface de Home Assistant quand vous voulez (ouvrez l'entité → renommer) — l'entity_id et son historique restent exactement tels quels.

Une réserve honnête.

Après la substitution, vos graphiques d'historique et le tableau de bord Énergie restent intacts — les statistiques à long terme se poursuivent et les nouvelles lectures s'ajoutent à la même série. Mais la carte de Wh en valeur courante affichera 0 puis comptera à partir de là : c'est le compteur rbAmp neuf qui démarre, pas une perte de données. La gestion total_increasing de HA raccorde l'ensemble à votre cumul existant en coulisse. La carte en direct va redémarrer ; votre historique, non.

Ce que vous verrez dans Home Assistant :

Avant la substitution — vos entités PZEM, exactement telles qu'elles sont aujourd'hui :

Les entités PZEM avant la substitution

Après le flash — les mêmes identifiants d'entités, désormais alimentés par rbAmp (la carte d'énergie lit un nouveau comptage, selon la mise en garde ci-dessus) :

Les mêmes identifiants d'entités après la substitution, désormais alimentés par rbAmp

Et l'essentiel : la puissance traverse la substitution sans rupture ni chute à zéro. Votre historique est intact :

Puissance continue lors de la substitution PZEM → rbAmp — sans coupure ni remise à zéro

Faites-lui confiance d'abord : mesurez les deux côte à côte (facultatif)

Pas prêt à vous engager à l'aveugle ? Faites fonctionner les deux compteurs sur le même ESP32 pendant une journée et vérifiez qu'ils concordent, puis supprimez le bloc PZEM. Cette configuration garde le PZEM sur son UART et ajoute rbAmp sur I²C, avec des noms distincts pour que HA trace les deux :

YAML
# PZEM (reference) on the existing UART
uart:
  rx_pin: GPIO16
  tx_pin: GPIO17
  baud_rate: 9600
sensor:
  - platform: pzemac
    voltage: { name: "PZEM Ref Voltage" }
    current: { name: "PZEM Ref Current" }
    power:   { name: "PZEM Ref Power" }
    energy:  { name: "PZEM Ref Energy" }
# rbAmp (new) on I²C
i2c:
  sda: GPIO21
  scl: GPIO22
  frequency: 50kHz   # 50 kHz on ESP32 — see the note in the single-meter config above (ESP-IDF i2c_master driver).
external_components:
  - source: github://rb-amp/rbamp-esphome@v1.4.0
    components: [rbamp]
rbamp:
  id: meter
  address: 0x50
  ct_model: SCT_013_030
sensor:
  - platform: rbamp
    rbamp_id: meter
    voltage: { name: "rbAmp New Voltage" }
    current: { name: "rbAmp New Current" }
    power:   { name: "rbAmp New Power" }
    energy:  { name: "rbAmp New Energy" }

Superposez les deux séries de puissance dans une carte d'historique ; sur le même conducteur, elles restent à un pour cent ou deux l'une de l'autre. Satisfait ? Flashez la configuration mono-compteur ci-dessus (en reprenant vos anciens noms) et vous êtes migré — historique compris.

Ce que vous y gagnez

Retour arrière

Si quelque chose semble anormal, reflashez votre YAML PZEM d'origine sur le même ESP32 — les mêmes identifiants d'entités reprennent et le compteur EEPROM du PZEM reprend là où il s'était arrêté. Rien n'est grillé.


À lire ensuite