rbAmp
DE
Shop
Docs
Aktualisiert · Auf GitHub bearbeiten [Edit on GitHub]

04 · Anschluss

Dieses Kapitel behandelt die physische Verdrahtung von rbAmp mit einem ESP32: GPIO-Auswahl, Pull-up-Regeln, den Mehrmodul-Bus, Stromversorgung, die optionale DRDY-Leitung und die Adressprovisionierung.

Sicherheit

Kanonische Installation — eine Flotte mit mehreren Modulen an einem Bus. 80 % der Feldinstallationen bestehen aus 1× UI1 (Netz) + N× I2/I3 (Unterzähler) an einem ESP32-I²C-Bus, mit den Pull-ups gemäß der Tabelle unten. Siehe 01_overview.md für das Bild der Flotte. Ein einzelnes Modul ist der Minimalfall, nicht der Kanon. Dieses Kapitel behandelt beide Topologien; die Topologie mit mehreren Modulen ist in den betreffenden Abschnitten als „primäre Topologie“ gekennzeichnet.

STANDARD-Module (STD). Verdrahtung, Pull-up-Regeln, Stromversorgung und die optionale DRDY-Leitung sind bei BASIC- und STANDARD-Modulen gleich, und dasselbe YAML funktioniert für beide — die Komponente erkennt das angeschlossene Modul beim Start. new_address: funktioniert bei beiden Modulreihen. Die Gruppensynchronisation der Flotte über General-Call (fleet_gc_enable: / group_id:) gilt nur für BASIC-Module; bei einem STANDARD-Modul werden diese Schlüssel mit einer Protokollzeile ignoriert.

GEFAHR: Die Klemmen L/N führen Netzspannung. Schalten Sie den Stromkreis spannungsfrei und sichern Sie ihn gegen Wiedereinschalten, bevor Sie anschließen; lassen Sie Netzverdrahtung und alle Arbeiten im Schaltschrank nur von einer Elektrofachkraft ausführen; klemmen Sie NUR EINEN Leiter (L) ein, und lassen Sie die CT-Zange nie an einem Leiter, wenn die CT-Buchse nicht gesteckt ist.

Leitung und Sicherung. Für den Spannungsanschluss ist kein dicker Draht nötig: AWG26–22 genügt, weil der Spannungssensor kaum Strom zieht. Eine Sicherung im L-Leiter ist Pflicht, Nennwert bis 0.1 A.

Netzseite auf einen Blick. Netz L und N gehen an die beiden Klemmen des Moduls (sie liefern die Spannungsmessung); die CT-Klemme steckt in der CT-Buchse und umschließt nur den L-Leiter, Pfeil zur Last. Alles andere in diesem Kapitel ist die Niederspannungsseite.

Verdrahtung im Schaltschrank: die CT-Klemme auf dem L-Draht hinter dem Hauptschalter, die Referenzabgriffe für L und N gehen zum Modul.

Belegung der Niederspannungsseite

Die Niederspannungsseite des Moduls stellt fünf Signale bereit. Alle sind galvanisch vom Netz getrennt — der Pin GND ist die GND des ESP32, nicht der Netz-Nullleiter.

Pin Signal Beschreibung
VCC +4.5..+5.5 V DC Modulversorgung. 5 V nominal; unter 4.5 V können die Messwerte unzuverlässig werden.
GND Allgemein Gemeinsame Masse mit dem Master. Erforderlich.
SDA I²C-Daten 3.3-V-Logik; 5-V-tolerant.
SCL I²C-Takt 3.3-V-Logik; 5-V-tolerant.
DRDY Daten bereit (optional) Open-Drain-Ausgang. Ca. 10 µs LOW-Impuls alle ~100 ms, nachdem die Momentanregister aktualisiert wurden.

Die fünf Niederspannungs-Pins des rbAmp-Moduls und was jeder davon benötigt.

GPIO-Auswahl am ESP32

Jedes Paar von GPIOs, das I²C unterstützt, funktioniert. Die Peripheriematrix des ESP32 erlaubt, I²C auf fast jeden Pin zu legen. Praktische Einschränkungen:

  • GPIO0 und GPIO2 sind Bootstrap-Pins. Ein LOW-Pegel an ihnen beim Einschalten blockiert den Start. Nicht verwenden.
  • GPIO 6..11 sind auf den meisten ESP32-WROOM-Modulen mit dem integrierten Flash oder PSRAM verbunden. Nicht verfügbar.
  • GPIO 34..39 sind nur Eingänge. Nicht geeignet für I²C (das bidirektionalen Antrieb benötigt).
  • Verbinden Sie keinen GPIO des ESP32 mit einer Reset-Leitung des Moduls — das Modul wird per I²C-Befehl zurückgesetzt; auf Masterseite sind keine Hardware-Reset-Pins nötig.

Empfohlene Standardbelegung, die auf den meisten ESP32-DevKitC-Boards funktioniert:

Signal GPIO Hinweis
SDA GPIO21 Standard in allen Beispiel-YAML
SCL GPIO22 Standard in allen Beispiel-YAML
DRDY GPIO15 Optional; jeder eingabefähige Pin funktioniert

Sind GPIO21/22 belegt, wählen Sie ein anderes gültiges Paar und passen den Block i2c: im YAML an.

Verdrahtung eines einzelnen Moduls

Die vollständige Verdrahtung des ESP32 zeigt das Referenzschema unten.

Für ein einzelnes Modul sind keine externen Pull-up-Widerstände nötig — die rbAmp-Platine hat bereits eingebaute 4.7-kΩ-Pull-ups an SDA und SCL gegen 3.3 V.

Mehrmodul-Bus (primäre Topologie)

Die meisten rbAmp-Installationen sind eine Flotte aus mehreren Modulen an einem einzigen I²C-Bus des ESP32: ein UI1 am Netz und mehrere I2/I3 an Teilzweigen. Das ist die primäre Topologie, für die die Komponente entworfen wurde; die Pull-up-Konfiguration unten ist darauf optimiert.

Mehrere rbAmp-Module an einem I²C-Bus mit den eingebauten, abgetrennten Pull-ups und einem externen Paar am Master sowie den DRDY-Optionen.

Teilen sich zwei oder mehr Module (oder andere I²C-Geräte mit eigenen Pull-ups) einen Bus, addieren sich ihre Pull-ups parallel. Der kombinierte Widerstand sinkt unter das wirksame Minimum — was führt zu:

  • Übermäßige Busbelastung.
  • Mögliche Überlastung der Open-Drain-Ausgänge des ESP32 (typisch ≤ 3 mA bei 3.3 V).
  • Höhere kapazitive Last auf einem langen Bus.

Auf der Unterseite jeder rbAmp-Platine befinden sich Lötbrücken mit der Beschriftung Pull-Up. Wird die Leiterbahn mit einer scharfen Klinge durchtrennt, wird das eingebaute 4.7-kΩ-Paar dieses Moduls abgetrennt.

Module am Bus Pull-up-Konfiguration Wirksamer R
1 Das eingebaute Paar belassen. Kein externes nötig. ~4.7 kΩ
2 Nur am ersten belassen; den zweiten abtrennen. ~4.7 kΩ
3 Auf allen trennen. Ein externes Paar von 2.7..3.3 kΩ am ESP32. 2.7..3.3 kΩ
4..6 Auf allen abtrennen. Ein externes Paar von 2.2..2.7 kΩ am ESP32. 2.2..2.7 kΩ
7..16 Auf allen abtrennen. Ein externes Paar von 1.5..2.2 kΩ am ESP32 + eine Prüfung der Buskapazität (siehe unten). 1.5..2.2 kΩ
Der ESP32 liefert bereits Pull-ups Auf allen Modulen abtrennen. Die internen Pull-ups des ESP32 (≥50 kΩ) sind schwach — ein langer Bus braucht weiterhin externe 2.2..4.7 kΩ. wie oben

Die externen Werte sind Empfehlungen (berechnet aus der I²C-Spezifikation: Senkenstrom ≤ 3 mA bei 3.3 V, Buskapazität ≤ 400 pF). Schließen Sie die externen Pull-ups an 3.3 V (den Logikpegel des Busses) an, nicht an die 5-V-Versorgung VCC.

I²C-Pull-up-Regeln für ein bis drei Module an einem kurzen Bus und für vier oder mehr, mit dem Lötbrücken auf dem Modul und der Bus-Geschwindigkeit je Host.

Auswahllogik: Der wirksame R_pullup ist die Parallelschaltung aller aktiven Pull-ups. Der Zielbereich liegt bei 1.5..4.7 kΩ (die Untergrenze ergibt sich aus dem Senkenstrom des ESP32 ≤ 3 mA bei 3.3 V; die Obergrenze aus der RC-Zeitkonstante des Busses). Formel: 1/R_eff = N/R_unit. Für das eingebaute 4.7-kΩ-Paar: 2 Module = 2.35 kΩ, 3 = 1.57 kΩ, 4 = 1.18 kΩ — bei 3 Modulen ergibt sich 1.57 kΩ parallel, was noch im Bereich liegt; ein 3-Modul-Bus bis 15 cm gilt als zuverlässig gemessen (15-cm-Leitungen, 50 kHz), daher lässt die Tabelle die eingebauten Brücken bei 2 und 3 Modulen bestehen. Ab 4 Modulen oder bei einem längeren Bus früher trennt man sie alle und setzt ein einzelnes externes Paar.

Diagnoseprüfung: Messen Sie bei ausgeschalteter Stromversorgung den Widerstand zwischen SDA und VCC. Der Wert sollte im Bereich 1.5..4.7 kΩ liegen. Unter 1.0 kΩ bedeutet zu viele aktive Pull-ups parallel; über 10 kΩ bedeutet kein aktiver Pull-up (prüfen Sie die Brücken).

Buskapazität (bei ≥ 7 Modulen oder einer Gesamtverdrahtungslänge > 50 cm): Die I²C-Spezifikation begrenzt die Gesamtkapazität C_b auf ≤ 400 pF. Ein kurzer Bus mit 2–3 Modulen liegt typischerweise bei 50..100 pF; ein 1-m-Bus mit 10 Modulen kann 300..400 pF erreichen. Bei Annäherung an die Grenze wechseln Sie auf frequency: 50kHz (falls noch auf 100 kHz) oder verwenden einen aktiven Pull-up-Baustein (zum Beispiel den PCA9517).

Bus-Geschwindigkeit

Setzen Sie frequency: 50kHz im Block i2c: von ESPHome. Auf der aktuellen Firmware ist das für einen zuverlässigen Betrieb mit ESP-IDF v5 zwingend:

YAML
i2c:
  sda: GPIO21
  scl: GPIO22
  frequency: 50kHz    # recommended on ESP32 — ESP-IDF i2c_master driver interaction, see below

Das Modul meldet bei Lesevorgängen vom ESP32 mit 100 kHz regelmäßig NACKs (ein merklicher Anteil der Transaktionen). Ursache ist das Zusammenspiel des Timings des ESP-IDF-v5-Treibers i2c_master mit dem Wiederherstellungsfenster nach STOP der I²C-Peripherie des Moduls. Bei 50 kHz treten NACKs deutlich seltener auf, und die Wiederholung pro Byte in der Komponente stellt > 99 % der gültigen Lesungen wieder her.

Die Firmware hat die I²C-Wiederherstellung des Moduls gehärtet (ausgeliefert in v1.1 und v1.3), was den Anteil des Moduls verringert hat — 50 kHz bleibt aber die empfohlene Einstellung auf ESP-IDF-basierten Mastern, weil das Zusammenspiel der Treiber-Timings bei 100 kHz bestehen bleibt. Betrachten Sie das als dauerhafte Empfehlung für den ESP32, nicht als vorübergehende Notlösung bis zu einer Korrektur.

Andere I²C-Master betreiben dieses Modul sauber mit 100 kHz: STM32 HAL, RP2040 SDK, Raspberry Pi smbus2 (Linux-Kernel-I²C) und Nicht-ESP32-Arduino (AVR / STM32duino). Beachten Sie, dass die Achse der Treiber ist, nicht das Board: Arduino auf einem ESP32 nutzt denselben Treiber i2c_master von ESP-IDF und braucht daher ebenfalls 50 kHz — nur Nicht-ESP32-Arduino läuft mit 100 kHz.

Referenzschema — ein ESP32 + ein rbAmp

Referenzverdrahtung zwischen einem ESP32-Entwicklungsboard und einem rbAmp-Modul, mit der CT-Klemme am L-Leiter und einer optionalen DRDY-Leitung.

Notes:

  • Der 10-kΩ-Widerstand am DRDY liegt auf Master-Seite (nahe am GPIO), nicht auf Modulseite. DRDY ist Open-Drain ohne internen Pull-up.
  • Die CT-Buchse muss vollständig eingesteckt sein; die Klemme umschließt genau einen Leiter, der Pfeil zeigt zur Last.
  • Die L/N-Polarität an den Klemmen beeinflusst das Vorzeichen von P (siehe 03_sensor_selection.md).

Leistung

Modulversorgung (VCC)

Das Modul benötigt +4.5..+5.5 V DC. Stromaufnahme:

Modus Typisch
Stationäre Messung ~15 mA
Flash-Schreibvorgang (bei ct_model: / Adressprovisionierung) ~25 mA Spitze, ~700 ms
Aufwärmen beim Start (~250 ms) ~15 mA

Der 5-V-Pin eines ESP32-DevKitC (meist mit USB-VBUS verbunden) kann das Modul direkt versorgen — der USB-Host muss den gesamten Strom des ESP32 (~200 mA) + rbAmp (~15 mA Spitze) = ~215 mA liefern. Bei Installationen, in denen der ESP32 aus einem externen 5-V-Schaltnetzteil gespeist wird, verbinden Sie VCC mit derselben 5-V-Schiene.

Brownout am ESP32

Der Brownout-Detektor des ESP32 schlägt bei ca. 2.43 V an VDD an. Dann bleibt der I²C-Bus untätig, während das Modul selbstständig weiter misst (es hat seine eigene 5-V-Versorgung). Wenn sich der ESP32 erholt, stellt setup() die akkumulierte Energie aus dem NVS vor dem ersten update() wieder her. HA sieht im Energiediagramm weder eine Lücke noch einen Reset.

Optionaler DRDY

Der DRDY-Pin des Moduls ist Open-Drain. Er zieht etwa alle 100 ms für ca. 10 µs auf LOW, direkt nachdem der Block der Momentanwert-Register aktualisiert wurde. Beim Periodensnapshot löst er nicht aus.

Kontinuierliche 100-ms-Messfenster, ein DRDY-Impuls pro Fenster und der Master-Burst-Lesezugriff auf den atomaren Ergebnisblock.

Bei update_interval: 60s können Sie DRDY weglassen — die Komponente prüft das Statusregister zu Beginn jedes update() und überspringt die Lesung, wenn das Modul nicht bereit ist. Die Komponente protokolliert den DRDY-Pin; das Lesen wird vom Timer gesteuert (update_interval).

DRDY-Verdrahtung

DRDY ist Open-Drain: Es zieht auf LOW, kann aber nicht auf HIGH treiben. Es braucht einen externen Pull-up:

Text
  rbAmp DRDY  ──────────────────┬── ESP32 GPIO (input)
                                 |
                               [10K]
                                 |
                               3.3V

10 kΩ gegen 3.3 V. DRDY nicht an 5 V anschließen, auch wenn SDA/SCL 5-V-tolerant sind — DRDY ist ein eigenes Signal, und der absolute Maximalwert eines GPIO-Eingangs am ESP32 beträgt 3.6 V.

Deklarieren Sie den Pin im YAML:

YAML
rbamp:
  id: meter1
  drdy_pin: GPIO15

Mehrmodul-DRDY

Die DRDY-Signale mehrerer Module können auf einen einzigen GPIO des ESP32 verodert werden (Open-Drain-Ausgänge kombinieren sich natürlich). Das gemeinsame Signal geht LOW, sobald ein Modul seine Momentanregister aktualisiert hat. Die Komponente protokolliert nur den Pin; sie sagt nicht, welches Modul ausgelöst hat.

Brauchen Sie getrennte Signale, führen Sie das DRDY jedes Moduls auf einen eigenen GPIO und deklarieren drdy_pin: in jedem Block rbamp: einzeln.

Adressvergabe auf einem Bus mit mehreren Modulen

Alle rbAmp-Module werden ab Werk auf die Adresse 0x50 gesetzt. Bevor Sie mehrere Module an einen Bus anschließen, braucht jedes eine eindeutige Adresse. Bei Firmware v1.3 kann dies im Produktivbetrieb ohne Werks-Provisionierungsmodus erfolgen — dank des Zwei-Phasen-Commit-Protokolls.

Zweiphasiger Adress-Commit (v1.3+, produktionstauglich)

Mit new_address: führt die Komponente folgende Sequenz aus:

  1. Prüft, ob die Firmware den Zwei-Phasen-Commit unterstützt. Ist das der Fall, wird der Produktionsmodus genutzt. Andernfalls greift der Rückfall auf den einphasigen Ablauf mit Werks-Provisionierungs-Sperre (Firmware v1.0-v1.2).

  2. Schreibt die neue Adresse in REG_I2C_ADDRESS (vorgemerkt, noch nicht aktiv).

  3. Schreibt das „Magic Word“ 0xA5 nach REG_ADDR_COMMIT_MAGIC — eine ausdrückliche Bestätigung der Absicht, die vor einem versehentlichen Schreiben nach REG_I2C_ADDRESS schützt.

  4. Sendet den Opcode CMD_COMMIT_ADDR — das Modul übernimmt die vorgemerkte Adresse atomar, speichert sie im Flash und führt einen Soft-Reset aus.

  5. Nach ~700 ms bindet die Komponente ihr i2c_address-Handle an die neue Adresse neu und prüft die Neuaufzählung mit einem Probe-Read.

Die zweiphasige Adressänderung: vormerken, scharfschalten, committen, warten, zurücksetzen, warten und an der neuen Adresse prüfen.

Schlägt ein Schritt fehl, kehrt das Modul zur vorherigen Adresse zurück, ohne einen „halb angewendeten“ Zustand zu hinterlassen. Ein Hin- und Rückweg 0x50 → 0x60 → 0x50 wird in unter einer Sekunde neu aufgezählt.

Die Provisionierung adressiert jeweils ein Neumodul am Bus, dann folgt das nächste.

Mehrere Module gleichzeitig am Bus vor der Provisionierung ergeben eine Adresskollision (alle auf 0x50). Daher erfolgt die Provisionierung nacheinander, ein Modul nach dem anderen:

  1. Verbinden Sie nur Modul 1 mit dem ESP32 (allein am Bus).
  2. Flashen Sie die Konfiguration aus example/address_change.yaml mit address: 0x50 und new_address: 0x51. Beim Start erkennt die Komponente die Abweichung → führt den Zwei-Phasen-Commit aus (siehe oben).

  3. Den Erfolg in den ESPHome-Protokollen bestätigen (Neuaufzählung unter der neuen Adresse). YAML aktualisieren: address: 0x51, new_address: entfernen.

  4. Modul 1 trennen. Modul 2 anschließen (noch auf der Werksadresse 0x50).

  5. Wiederholen Sie dies für 0x52, 0x53 usw. MUSS: nur ein unprovisioniertes Modul gleichzeitig am Bus — sonst antworten beide auf 0x50, was zu Buskonflikten führt.

  6. Wenn alle Module eindeutige Adressen haben, verbinden Sie sie alle mit dem Bus und setzen die Pull-ups gemäß der Tabelle in Bus mit mehreren Modulen (2 Module: ein Paar behalten; 3 oder mehr: alle abtrennen und ein externes Paar ergänzen).

Hinweis

Gefahr gleichzeitiger Provisionierung: Liegen zwei Neumodule auf 0x50, bestätigen beide das Adressbyte und ziehen SDA in der Datenphase gegeneinander → Buskonflikt und undefinierte Daten. Immer nur ein Neumodul gleichzeitig.

Beispiel-YAML für mehrere Module

YAML
i2c:
  sda: GPIO21
  scl: GPIO22
  frequency: 50kHz
  scan: true

rbamp:
  - id: meter_house
    address: 0x50
    update_interval: 60s
  - id: meter_solar
    address: 0x51
    update_interval: 60s
    bidirectional: true
  - id: meter_evcharger
    address: 0x52
    update_interval: 60s

sensor:
  - platform: rbamp
    rbamp_id: meter_house
    voltage: { name: "House Voltage" }
    current: { name: "House Current" }
    power:   { name: "House Power" }
    energy:  { name: "House Energy" }
  - platform: rbamp
    rbamp_id: meter_solar
    voltage: { name: "Solar Voltage", internal: true }
    current: { name: "Solar Current" }
    power:   { name: "Solar Power" }
    energy:  { name: "Solar Energy" }
    energy_exported: { name: "Solar Energy Exported" }
  - platform: rbamp
    rbamp_id: meter_evcharger
    voltage: { name: "EV Charger Voltage", internal: true }
    current: { name: "EV Charger Current" }
    power:   { name: "EV Charger Power" }
    energy:  { name: "EV Charger Energy" }

Die vollständige Version mit Anmerkungen steht in example/multi_module.yaml.

Buslänge

I²C ist ein Kurzstreckenprotokoll (standardmäßig ca. 15 cm). Viele Anwender verbinden Module mit minderwertigen Steckbrücken, die viel Rauschen aufnehmen und viele Übertragungen verlieren — daher die kurze Grenze. Empfohlene Längen für rbAmp:

Kabeltyp Maximale Länge Geschwindigkeit
Standard JST / 4-adrig flach 0.15 m 50 kHz
Verdrillte Doppelleitung (SDA+GND und SCL+GND in getrennten Paaren) 1 m 50 kHz
Verdrillte Doppelleitung + I²C-Puffer (PCA9515 / TCA9617) 3 m 50 kHz
Differenzieller Bus (PCA9615 / LTC4332) 100 m 50 kHz

Bei mehr als 0.15 m verwenden Sie verdrillte Leitungen, und SDA und SCL müssen in getrennten Paaren liegen (zum Beispiel blau + weiß-blau für SDA, grün + weiß-grün für SCL). Teilen sich SDA und SCL ein Paar, verzerrt die Kopplung die Flanken selbst bei 50 kHz.

Sicherheit

⚠ Im Schaltschrank den I2C-Kabel abschirmen. Starke Magnetfelder in der Nähe von Netzleitern, Schützen und Transformatoren induzieren Störungen in einem ungeschirmten Kabel. Halten Sie das Kabel so kurz wie möglich und fern von der Netzverdrahtung.

Werks-Provisionierungsmodus (Alt-Firmware v1.0–v1.2)

Bei v1.3-Firmware braucht eine Adressänderung keinen Werks-Provisionierungsmodus — sie läuft im Produktivbetrieb über den Zwei-Phasen-Commit (siehe oben). Dieser Abschnitt gilt nur für Alt-Firmware (v1.0-v1.2), bei der die einphasige Adressänderung einen Sondermodus brauchte.

Bei Legacy-Firmware erforderten einige Modul-Operationen (Änderung der I²C-Adresse, Zurücksetzen auf Werkseinstellungen) den Werks-Provisioning-Modus — einen Sondermodus für einmalige Provisionierungsaktionen. Serienmäßige Produktionsmodule wurden mit deaktiviertem Provisioning-Modus ausgeliefert: Ein Versuch, die Adresse zu ändern, gab einen Fehler zurück, der in den ESPHome-Logs beim Start als WARNING erschien.

Kompatibilitätsverhalten der Komponente v1.3:

  • Bei new_address: prüft die Komponente zuerst, ob die Firmware den zweiphasigen Commit unterstützt. Ja → Produktionspfad (zweiphasig, keine Werks-Provisioning-Sperre).

  • Falls nicht (Legacy-Firmware v1.0-v1.2) → Fallback auf das einphasige Schreiben, das nur im Werkseinstellungsmodus wirkt. Die Komponente protokolliert dies im Startlog als WARN_FACTORY_MODE_REQUIRED.

Haben Sie ein Modul mit Legacy-Firmware (das DUT wird über den Werksprüfstand aktualisiert, nicht über OTA im Feld), wenden Sie sich an Ihren Lieferanten für das Verfahren, den Provisioning-Modus vorübergehend zu aktivieren. Auf Firmware v1.3 tritt dieses Problem nicht auf.

Hinweis

Die Konfiguration des Stromsensors (ct_model: / ct_models:) erforderte nie den Werks-Provisioning-Modus — ein Modul auf beliebiger Firmware akzeptiert das Schreiben eines CT-Modells direkt (siehe 03_sensor_selection.md).

Was als Nächstes kommt


Quelle & Probleme: rb-amp/rbamp-esphome · diese Seite im Repo: docs/04_hardware.md (v1.9.1)