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.
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.
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. |
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.
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.
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:
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
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.
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:
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:
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:
-
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).
-
Schreibt die neue Adresse in
REG_I2C_ADDRESS(vorgemerkt, noch nicht aktiv). -
Schreibt das „Magic Word“
0xA5nachREG_ADDR_COMMIT_MAGIC— eine ausdrückliche Bestätigung der Absicht, die vor einem versehentlichen Schreiben nachREG_I2C_ADDRESSschützt. -
Sendet den Opcode
CMD_COMMIT_ADDR— das Modul übernimmt die vorgemerkte Adresse atomar, speichert sie im Flash und führt einen Soft-Reset aus. -
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.
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.
Sequenzielle Provisionierung (empfohlener Ablauf)
Mehrere Module gleichzeitig am Bus vor der Provisionierung ergeben eine Adresskollision (alle auf 0x50). Daher erfolgt die Provisionierung nacheinander, ein Modul nach dem anderen:
- Verbinden Sie nur Modul 1 mit dem ESP32 (allein am Bus).
-
Flashen Sie die Konfiguration aus
example/address_change.yamlmitaddress: 0x50undnew_address: 0x51. Beim Start erkennt die Komponente die Abweichung → führt den Zwei-Phasen-Commit aus (siehe oben). -
Den Erfolg in den ESPHome-Protokollen bestätigen (Neuaufzählung unter der neuen Adresse). YAML aktualisieren:
address: 0x51,new_address:entfernen. -
Modul 1 trennen. Modul 2 anschließen (noch auf der Werksadresse
0x50). -
Wiederholen Sie dies für
0x52,0x53usw. MUSS: nur ein unprovisioniertes Modul gleichzeitig am Bus — sonst antworten beide auf 0x50, was zu Buskonflikten führt. -
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).
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
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.
⚠ 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.
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
- 05_quickstart.md — erster Lauf
- 06_examples.md — vollständige Szenarien: UI1 / UI3 / Mehrmodul / Adressprovisionierung
- 10_troubleshooting.md — symptomorientierte Diagnose
Quelle & Probleme: rb-amp/rbamp-esphome · diese Seite im Repo: docs/04_hardware.md (v1.9.1)