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

04 · Anschluss

Dieses Kapitel behandelt den physischen Anschluss des rbAmp-Moduls an einen Arduino-kompatiblen Host: die Niederspannungsbelegung, die Anforderungen an die Stromversorgung, die Pegelkompatibilität des I²C, die Buslänge und Verdrahtungspläne für bestimmte Arduino-Boards (UNO, Mega, ESP32, ESP8266, STM32duino, RP2040).

Der Niederspannungsteil (Versorgung + I²C + optional DRDY) ist von den Netzklemmen getrennt. Die Netzklemmen und die Verdrahtung des Stromwandlers sind mit dem Netz verbunden — siehe die Warnung unter „Netzseitige Verdrahtung“ unten.

Belegung der Niederspannungsseite

Das Modul arbeitet mit 3.3-V-I²C-Logik und ist auf den Signalleitungen 5-V-tolerant. Alle LV-Pins sind vollständig galvanisch vom Netz getrennt.

Pin Signal Funktion
VCC +5 V (4.5..5.5 V) Modulversorgung; mindestens 4.5 V für korrekten Betrieb
GND Masse Mit dem Master geteilt — verpflichtend
SDA I²C SDA I²C-Daten
SCL I²C SCL I²C-Takt
DRDY Data-ready (optional) Open-Drain, LOW-Impuls ca. 10 µs etwa alle 100 ms

Der Niederspannungs-Stecker des rbAmp-Moduls: VCC, GND, SDA, SCL und der optionale DRDY-Pin mit dem, was jeder benötigt.

Leistung

VCC-Parameter

  • Nennspannung: 5 V DC
  • Zulässiger Bereich: 4.5..5.5 V
  • Stromaufnahme: typisch ca. 15 mA, Spitze ca. 25 mA beim Flash-Schreiben
  • Welligkeit: < 50 mV Spitze-Spitze (für die Messgenauigkeit)

Das Modul hat einen integrierten Regler, einen RC-Filter, Keramikkondensatoren und eine Ferritperle — der Anwender muss keine zusätzliche Filterung vornehmen. Das Modul kann über die +5V-Schiene jedes Arduino-Boards (UNO, ESP32 DevKitC usw.) versorgt werden.

I²C-Pegelkompatibilität

  • SDA / SCL arbeiten mit 3.3-V-Logik (die integrierten Pull-ups ziehen die Leitungen auf 3.3 V).

  • Die Leitungen sind 5-V-tolerant: ein 5-V-Master (Arduino UNO / Nano) liest HIGH (~3.3 V) korrekt und kann den Bus ohne Pegelwandler ansteuern.

  • Für einen Bus, der vollständig mit 5-V-Pegeln läuft — deaktivieren Sie die eingebauten Pull-ups (siehe unten) und fügen Sie auf Masterseite externe Pull-ups nach +5 V hinzu.

Verhalten beim Einschalten

  • Kaltstart: ca. 250 ms bis zum ersten gültigen Ergebnis.
  • Nach einem Reset (Software oder Brown-out): ca. 250 ms bis zur Wiederherstellung.
  • Bis zum ersten gültigen Ergebnis liefern die Register 0 und DATA_VALID = 0.

Die Bibliothek wartet innerhalb von dev.begin(), bis das Modul bereit ist — Ihr Code ruft einfach begin() auf und fährt fort.

Isolation

Der Niederspannungsteil (I²C, Versorgung, DRDY) ist von den Netzklemmen galvanisch getrennt. Behandeln Sie die Netzklemmen und die Verdrahtung des Stromwandlers als spannungsführend.

  • Das GND des Moduls ist nicht mit der Netzleitung oder dem Neutralleiter verbunden.
  • Berühren Sie die L/N-Klemmen oder den Zangenleiter nicht, solange der Stromkreis unter Spannung steht.
Sicherheit

⚠ Öffnen Sie das Modulgehäuse nicht — dies hebt die Werkskalibrierung auf.

Integrierte Pull-up-Widerstände

Wichtig: Jedes rbAmp-Modul wird mit eingebauten 4.7-kΩ-Pull-up-Widerständen an SDA und SCL gegen 3.3 V ausgeliefert. Bei einem einzelnen Modul am Bus sind keine externen Pull-ups nötig — verbinden Sie den Master direkt.

Wann die integrierten Pull-ups abzuschalten sind

Hat der Bus mehrere rbAmp-Module (oder andere I²C-Geräte mit eigenen Pull-ups), ergibt die Parallelschaltung einen zu niedrigen effektiven Widerstand, was dazu führt, dass:

  • Erhöht die Busbelastung
  • Kann den maximalen Senkenstrom der Ausgangsstufe des I²C-Masters überschreiten (typisch ≤ 3 mA bei 3.3-V-Logik)

  • Erhöht die kapazitive Last auf einem langen Bus, verbessert die Störfestigkeit aber kaum

Lösung: auf der Unterseite der Platine, nahe den Pull-up-Widerständen, befinden sich Lötbrücken (Siebdruck Pull-Up). Trennen Sie sie mit einer scharfen Klinge, um einen Pull-up zu deaktivieren:

  • Lassen Sie die Pull-ups nur an einem Modul aktiv (oder führen Sie sie zu einem einzelnen Punkt nahe dem Master).

  • Trennen Sie die Brücken auf den übrigen Modulen.

  • Sind auf der Masterplatine bereits Pull-ups vorhanden — trennen Sie die Brücken auf allen rbAmp-Modulen.

Faustregel

rbAmp-Module am Bus Pull-ups
1 Belassen (die eingebauten 4.7 kΩ funktionieren)
2 Auf einem belassen, auf dem anderen trennen
3 Auf allen Modulen trennen, ein externes Paar 2.7…3.3 kΩ nahe am Master einsetzen
4…6 Auf allen Modulen trennen, ein externes Paar 2.2…2.7 kΩ nahe am Master
7…16 Auf allen Modulen trennen, ein externes Paar 1.5…2.2 kΩ nahe am Master; Buskapazität prüfen (≤ 400 pF), bei Bedarf die Busgeschwindigkeit senken

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.

Im Zweifel

: Widerstand zwischen SDA und VCC bei unbestromten Geräten messen. Er sollte im Bereich 1.5..4.7 kΩ liegen. Darunter bedeutet es zu viele aktive Pull-ups parallel.

Wie viele Module am Bus hängen und welche I²C-Pull-ups bleiben: Behalten Sie die eingebauten Paare bei ein bis drei Modulen auf einem Bus bis 15 cm; ab vier Modulen oder auf einem längeren Bus trennen Sie alle und verwenden ein einziges externes Paar.

I²C-Busparameter

  • Standardadresse: 0x50 (7-Bit)
  • Adressbereich: 0x08..0x77 (neu zugewiesen über den zweiphasigen Adress-Commit, produktionstauglich)
  • Geschwindigkeit: UNO / Mega / STM32 / RP2040 100 kHz; ESP32 / ESP8266 50 kHz. Verwenden Sie nicht 400 kHz.
  • Automatisches Inkrement des Zeigers: nur bei Lesezugriffen. Ein Burst-Lesezugriff + N bytes liefert N aufeinanderfolgende Bytes ab addr. Schreibzugriffe erfolgen NICHT mit automatischem Inkrement: Ein Burst-Schreibzugriff verwirft die Bytes 1..N, und nur das erste landet. Mehrbyte-Register werden Byte für Byte in getrennten Einzelbyte-Transaktionen geschrieben. Siehe 09 · API-Referenz — "Mehrbyte-Schreibzugriffe".

Buslänge

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

Kabel Maximale Länge Geschwindigkeit
Standard-JST / flache 4-adrige Leitung bis 0.15 m 100 kHz
Verdrillte UTP-Doppelleitung (Cat 5/5e/6) — SDA+GND und SCL+GND in getrennten Paaren bis 1 m 100 kHz
Verdrillte Doppelleitung + I²C-Puffer (PCA9515 / TCA9617) bis 3 m 100 kHz
Differenzieller Bus (PCA9615 / LTC4332) bis 100 m 100 kHz
Sicherheit

Bei Längen über 0.15 m ist verdrillte Doppelleitung Pflicht: SDA und SCL müssen in verschiedenen Paaren liegen, jedes mit eigener Masse (z. B. Blau + Blau-Weiß für SDA, Grün + Grün-Weiß für SCL). SDA und SCL in einem einzigen Paar erzeugen eine Kreuzkopplungskapazität, die die Flanken verzerrt.

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

Verdrahtung auf der Netzseite (Sensoren)

Sicherheit

⚠ Netzspannung kann tödlich sein. Trennen und sichern Sie den Stromkreis, bevor Sie die L/N-Klemmen anschließen oder die Zange anbringen; lassen Sie Netzverdrahtung und jede Arbeit im Verteilerkasten von einer Fachkraft ausführen. Umschließen Sie NUR EINEN Leiter (L) — niemals das ganze Kabel (L und N heben sich auf ca. 0 auf). Sichern Sie die L-Abzweigung gemäß den örtlichen Vorschriften ab.

Spannungssensor (UI*-Varianten)

Die Platine stellt die Klemmen L (Außenleiter) und N (Neutralleiter) bereit. Die Polarität ist wichtig für das Vorzeichen der Wirkleistung:

  • Korrekt (L → L, N → N): P > 0 bedeutet Verbrauch (Strom vom Netz in die Last), P < 0 bedeutet Einspeisung ins Netz (Erzeugung).

  • Vertauscht (L und N vertauscht): das Vorzeichen von P kehrt sich um — Verbrauch wird als negative Leistung gezählt.

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.

Die richtige Polung ist entscheidend für:

  • Korrekte Abrechnung auf der Stufe BASIC (BASIC zählt nur max(P, 0); bei vertauschter Polarität bleibt der Energiezähler auf null).

  • Korrekte Trennung von Verbrauch und Erzeugung auf der STANDARD-(STD)-Linie.

Schnellprüfung

: bei einer rein ohmschen Last (Wasserkocher, Heizung, Glühlampe) gilt P > 0 und PF ≈ 1.0. Ist P bei einer verbrauchenden Last negativ — tauschen Sie L und N auf der Platine.

Stromsensor — SCT-013-Stromzange

Externe CT-Zangen werden über eine Buchse 3.5 mm mit dem Modul verbunden. Der Stecker ist verpolungssicher — Sie müssen keine Verdrahtungsentscheidungen treffen.

Ein Pfeil auf dem Zangengehäuse zeigt die Stromrichtung für die "normale" Ausrichtung. Regeln:

  • Legen Sie die Zange nur um den zum Verbraucher führenden Außenleiter (L).
  • Der Pfeil auf der Zange muss in Stromrichtung zur Last zeigen (vom Schutzschalter zur Last).

  • Die Zange muss vollständig schließen — ohne Spalt zwischen den Hälften des Magnetkerns. Rasten die Hälften nicht vollständig ein, geht Genauigkeit verloren.

Sicherheit

⚠ Führen Sie L und N nie gleichzeitig durch eine einzelne Zange. Ihre magnetischen Flüsse sind gleich groß und entgegengesetzt, sie heben sich also auf — der Sensor misst auch unter Last annähernd null.

Mehr zur Wahl des SCT-013-Modells (5 A / 10 A / 30 A / 50 A / 100 A) und zur Angabe an das Modul über dev.setCTModel(code) — siehe 03_sensor_selection.md.

Sicherheit

⚠ Die Polung der CT-Zange ist bei BASIC entscheidend: Zeigt der Zangenpfeil von der Last weg (oder sind L/N an den Klemmen vertauscht), liest P_real bei Verbrauch negativ — und die BASIC-Stufe begrenzt max(P, 0), sodass der Wh-Zähler bei null bleibt. Drehen Sie die Zange physisch am Leiter; kehren Sie sie nicht in der Software um.

Netzseitiger Anschluss im Verteiler: Stromwandler am L-Leiter nach dem Hauptschalter, N außerhalb der Zange, abgesicherter L-Abgriff und N als Spannungsreferenz.

DATA_READY (DRDY)

Ein optionaler Pin zur Optimierung der Abfrage. Fragt die Anwendung das Modul nicht häufiger als alle 100 ms ab, kann DRDY unverbunden bleiben.

Elektrische Parameter

  • Ausgangstyp: Open-Drain (kein aktiver Pull-up gegen VCC)
  • Ruhepegel: HIGH (erfordert einen Pull-up auf der Masterseite — den integrierten Pull-up des MCU oder einen externen Widerstand)

  • Bereitschaftsimpuls: LOW für ca. 10 µs, nachdem die RT-Register (0x86..0xCF) mit neuen Daten aktualisiert wurden

  • Impulsfrequenz: ca. 10 Hz (ein Impuls je ca. 100 ms RT-Fenster)

Die Bibliothek kann die Leitung für Sie nutzen: dev.setDrdyPin(pin) hängt sie an (interner Pull-up, Interrupt auf der fallenden Flanke), und dev.waitDataReady() / dev.readAllReady() warten auf den nächsten Snapshot des Moduls — siehe 09 · API-Referenz. Mehrere Module können eine DRDY-Leitung teilen (Wired-OR); eine dauerhaft auf LOW gehaltene Leitung bedeutet, dass ein Modul ein maskiertes Ereignis (Alarm) anstehen hat. Ohne Leitung fragen dieselben Aufrufe ab.

Semantik

Eine fallende Flanke an DRDY garantiert, dass alle RT-Register synchronisiert und veröffentlicht sind (die Firmware aktualisiert sie atomar in einer ISR, bevor sie den Pin auf LOW zieht). Nach der fallenden Flanke kann der Master die Register 0x86..0xCD ohne Gefahr eines geteilten Samples lesen.

Verwenden auf Arduino

  • Externer Interrupt (attachInterrupt auf der fallenden Flanke) — weckt den Master und löst ein Lesen aus.

  • Pull-up: entweder INPUT_PULLUP am MCU oder ein externer 10-kΩ-Widerstand nach 3.3 V. Bei UNO / Nano (AVR) einen externen 10-kΩ-Widerstand nach 3.3 V verwenden — der integrierte Pull-up (ca. 40 kΩ) ist für lange DRDY-Leitungen zu schwach.

C++
const int PIN_DRDY = 15;
volatile bool data_ready = false;

#if defined(ESP32) || defined(ESP_PLATFORM)
void IRAM_ATTR on_drdy() { data_ready = true; }   // ESP32 — ISR in IRAM
#else
void on_drdy() { data_ready = true; }             // AVR / STM32duino / RP2040 / SAMD
#endif

void setup() {
    Wire.begin();
    while (!dev.begin()) { delay(500); }

    // Raise the pull-up + attach the ISR AFTER dev.begin() — this
    // guarantees the module is already ready and the pull-up edge will not
    // cause a spurious interrupt before the first RT window is captured.
    // INPUT_PULLUP is fine for most cases; for long
    // lines or AVR hosts add an external 10 kΩ to 3.3 V.
    pinMode(PIN_DRDY, INPUT_PULLUP);
    attachInterrupt(digitalPinToInterrupt(PIN_DRDY), on_drdy, FALLING);
}

void loop() {
    if (!data_ready) return;     // sleep until the next RT window
    data_ready = false;
    float p = dev.readPower(0);
    // ...integration / transmit...
}

DRDY ist optional — Abfrage mit jeder Rate ≤ 10 Hz funktioniert ohne sie. Die Bibliothek hängt nicht von DRDY ab; setDrdyPin() / waitDataReady() sind optionale Hilfsfunktionen.

Anschluss an verschiedene Arduino-Hosts

Das Modul arbeitet mit jedem Arduino-kompatiblen Board über das Standard-Wire. Unten stehen die Standard-Pins gängiger Varianten.

Arduino UNO / Nano (5-V-Logik)

rbAmp Arduino-Pin
VCC +5V
GND GND
SDA A4
SCL A5
DRDY (opt.) beliebiger digitaler Pin, z. B. D2
C++
#include 
#include 

RbAmp dev(Wire, 0x50);

void setup() {
    Wire.begin();          // SDA=A4, SCL=A5 by default
    Wire.setClock(100000); // 100 kHz — no 50 kHz clamp needed on AVR
    while (!dev.begin()) { delay(500); }
}

Der UNO ist ein Host mit 5 V, kein Pegelwandler nötig (die SDA-/SCL-Leitungen des Moduls sind 5-V-tolerant). Die integrierten Pull-ups des Moduls ziehen die Leitungen auf 3.3 V, was ein 5-V-Master korrekt als HIGH liest.

Arduino Mega 2560 (5-V-Logik)

rbAmp Mega-Pin
VCC +5V
GND GND
SDA D20
SCL D21
DRDY (opt.) beliebiger digitaler Pin, z. B. D18 (unterstützt Interrupts)

Im Code identisch mit dem UNO, nur die physischen Pins unterscheiden sich. Kein Pegelwandler nötig.

ESP32 / ESP32-S3 / ESP32-C3 (3.3-V-Logik)

rbAmp ESP32-DevKitC-Pin
VCC +5V (versorgt über USB-5V am DevKitC)
GND GND
SDA GPIO21
SCL GPIO22
DRDY (opt.) beliebiger freier GPIO, z. B. GPIO4
C++
#include 
#include 

RbAmp dev(Wire, 0x50);

void setup() {
    Wire.begin(21, 22);    // SDA=21, SCL=22 (or Wire.begin() with board defaults)
    Wire.setClock(50000);  // ESP32: 50 kHz
    while (!dev.begin()) { delay(500); }
}

Der ESP32 ist ein 3.3-V-Host, direkte Verbindung zum Modul. Die VCC-Versorgung kommt vom +5V-Pin des DevKitC (der direkt mit USB-5V verbunden ist).

Hinweis

ESP32-50-kHz-Takt — das empfohlene Muster. Statt eines expliziten Aufrufs Wire.setClock(50000) definieren Sie das Opt-in-Makro vor dem Include — begin() wendet den Takt intern an:

C++
#define RBAMP_ESP32_CLAMP_HZ 50000
#include 

Das Makro ist opt-in (nicht standardmäßig aktiv), damit ausdrückliche Anwenderaufrufe von Wire.setClock() (z. B. wenn ein OLED den Bus teilt) erhalten bleiben. Beide Formen funktionieren — wählen Sie die, die sich in Ihrem Sketch besser liest.

Bietet Ihr ESP32-Board keinen 5-V-Pin (einige kompakte ESP32-S3- / C3-Module kommen nur mit Vin oder gar keinem 5 V aus), versorgen Sie rbAmp aus einer externen 5-V-Quelle (z. B. Netzteil-USB-Ladegerät + Breakout), wobei GND mit dem ESP32 gemeinsam ist.

Ein gesonderter Hinweis zum Zurücksetzen des Moduls:

Hinweis

Für einen Software-Reset des Moduls verwenden Sie dev.reset() — die Bibliothek sendet den Befehl, und das Modul startet in ca. 100 ms neu. Wenn Sie einen harten Reset brauchen (zum Beispiel um aus einem Brick-Zustand zu kommen), trennen Sie VCC für 1 s oder länger von der Stromversorgung.

ESP8266 (Wemos D1 mini / NodeMCU, 3.3-V-Logik)

rbAmp ESP8266-Pin (NodeMCU)
VCC Vin oder +5V
GND GND
SDA D2 (GPIO4)
SCL D1 (GPIO5)
DRDY (opt.) D5 (GPIO14)
C++
#include 
#include 

RbAmp dev(Wire, 0x50);

void setup() {
    Wire.begin(D2, D1);      // SDA=GPIO4, SCL=GPIO5
    Wire.setClock(50000);    // ESP8266 software I²C: 50 kHz for consistency with ESP32
    while (!dev.begin()) { delay(500); }
}

Der ESP8266 ist ein Host mit 3.3 V, direkter Anschluss.

STM32duino (STM32F1-Entwicklungsboard F103 / Black Pill F411, 3.3-V-Logik)

rbAmp STM32-Pin (STM32F1-Entwicklungsboard)
VCC +5V
GND GND
SDA PB7 (I²C1_SDA)
SCL PB6 (I²C1_SCL)
DRDY (opt.) beliebiger GPIO mit EXTI, z. B. PA0
C++
#include 
#include 

RbAmp dev(Wire, 0x50);

void setup() {
    Wire.begin();           // SDA=PB7, SCL=PB6 by default for I²C1
    Wire.setClock(100000);  // the STM32 HAL I²C needs no 50 kHz clamp
    while (!dev.begin()) { delay(500); }
}

STM32duino unterstützt mehrere Wire-Instanzen (Wire1, Wire2 für einen zweiten I²C-Bus). Ist der primäre Bus belegt, verwenden Sie den zweiten I²C-Controller.

RP2040 / SAMD (Raspberry Pi Pico, arduino-pico)

rbAmp RP2040-Pin (Pico)
VCC VBUS (5 V vom USB) oder +5V
GND GND
SDA GP4
SCL GP5
DRDY (opt.) beliebiger GP
C++
#include 
#include 

RbAmp dev(Wire, 0x50);

void setup() {
    Wire.setSDA(4);
    Wire.setSCL(5);
    Wire.begin();
    Wire.setClock(100000);  // the RP2040 hardware I²C needs no 50 kHz clamp
    while (!dev.begin()) { delay(500); }
}

Der RP2040 ist ein 3.3-V-Host mit direkter Verbindung. Auf SAMD-Boards (Arduino Zero, MKR) funktioniert Wire.begin() mit den Standardwerten gleich — die konkreten Pins hängen vom Board ab.

Hinweis

Pico über VSYS (Akku / externe Versorgung): Der Pin VBUS ist nur vorhanden, wenn über USB versorgt wird. Läuft der Pico über VSYS von einem Akku oder einer externen Quelle — dann führt VBUS nichts. Führen Sie 5 V aus einer externen Quelle direkt dem VCC des Moduls zu, mit GND gemeinsam mit dem Pico.

Referenz-Verdrahtungsplan (ESP32 + einzelnes Modul)

Referenzverdrahtung eines ESP32-Boards an ein einzelnes rbAmp-Modul, mit der CT-Zange am L-Leiter.

In dieser Konfiguration:

  • Externe Pull-up-Widerstände für I²C sind NICHT nötig (sie sind im Modul integriert).
  • DRDY ist optional; wie auf dem Bild, verwenden Sie einen externen 10-kΩ-Pull-up nach 3.3 V (INPUT_PULLUP am ESP32-Pin funktioniert auch bei kurzen Leitungen).
  • Der SCT-013-Stecker sitzt vollständig eingesteckt.
  • Die Zange ist auf dem L-Leiter vollständig geschlossen, Pfeil zur Last.

Referenz-Verdrahtungsplan (Arduino UNO + einzelnes Modul)

Referenzverdrahtung eines Arduino UNO an ein einzelnes rbAmp-Modul, mit der CT-Zange an der L-Leitung.

In dieser Konfiguration:

  • Externe Pull-ups für I²C sind NICHT nötig.
  • Das UNO arbeitet mit 5-V-Logik; SDA/SCL des Moduls sind 5-V-tolerant, ein Pegelwandler ist nicht erforderlich.
  • DRDY hat einen 3.3-V-Pegel — am UNO liest ein TTL-Eingang dies als HIGH (VIH_TTL ≥ 2.0 V, 3.3 V > 2.0 V). Ein Pull-up für DRDY wird ausdrücklich gegen 3.3 V empfohlen: Sind die internen Schutzschaltungen des DRDY-Pins nicht 5-V-tolerant (getrennt von den I²C-Leitungen, deren 5-V-Verträglichkeit bestätigt ist), würde ein Pull-up gegen 5 V einen kleinen Leckstrom über die ESD-Dioden in die 3.3-V-Schiene des Moduls erzeugen. Gegen 3.3 V — nie ein Problem.

Mehrphasen-Modelle und die Linie STANDARD (STD)

Mehrkanal- und Mehrphasen-SKUs behalten dieselbe LV-Belegung (VCC / GND / SDA / SCL / DRDY). Nur die Netzseite ändert sich — mehr L-Klemmen und mehr CT-Buchsen.

STANDARD-(STD)-Module verwenden dieselbe I²C-Verdrahtung wie BASIC-Module — dieselben vier Signalleitungen, dieselben Pull-up- und Busregeln wie oben. An der Verbindung ändert sich nichts; dev.begin() erkennt, welche Linie angeschlossen ist (dev.line()), und derselbe Sketch bedient beide. Hinweise:

  • Aufrufe, die nur auf der STD-Linie existieren (die Familie std*, Blind- und Scheinleistung), liefern auf einem BASIC-Modul RB_ERR_NOT_IMPLEMENTED (auf BASIC stellt diese Bibliothek keine Blindleistung bereit).

  • Einige STD-Funktionen hängen von der Image-Version des Moduls ab: Energiezähler mit Mikroauflösung, der Anlaufstrom für Energie, Spannungsphasenwinkel und die Phasenfolge benötigen ein Image von mindestens 0x0001007B (dev.stdReadImageVersion()). Bei einem älteren Image werden sie als "nicht verfügbar" gemeldet.

  • Die Anzahl der Spannungs- und Stromkanäle kommt vom Modul (dev.stdInfo()); die Bibliothek stellt bis zu RBAMP_MAX_CHANNELS (7) Stromkanäle bereit.

Mehrmodul-Bus — die primäre Topologie

Der kanonische Anwendungsfall der Bibliothek sind mehrere rbAmp-Module auf einem I²C-Bus, verwaltet von einem einzigen Arduino / ESP32 über RbAmpFleet. Alle folgenden Regeln und Optimierungen sind genau für diese Topologie ausgelegt; ein einzelnes Modul ist ein Sonderfall (derselbe Handle, aber die Fleet-Aufrufe werden zu trivialen).

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

Typische Installationen

Szenario Konfiguration Anzahl der Module
80-%-Regel: Hauseinspeisung + Unterzähler 1× UI1 (Einspeisung, Netzenergie) + 3–6× UI1/I1 (Lasten) 4-7
Unterverteilung mit Stromaufschlüsselung 1× UI1 (Einspeisung) + 1-2× I2/I3 (Strom je Stromkreis) 3-5
Industrielle Unterzählung 1× UI1 (Einspeisung) + N× I2/I3 (je Maschine, Stromaufschlüsselung) bis zu ~16

Elektrische Grenzwerte

  • Modulanzahl: bis etwa 16 (gesamte Buskapazität ≤ 400 pF bei 100 kHz; bei 50 kHz ist mehr Reserve vorhanden).
  • Pull-ups für den Fleet-Bus (wichtig): Jedes Modul bringt integrierte 4.7 kΩ mit. Auf einem Mehrmodul-Bus arbeiten N Pull-ups parallel → die Senke wird überlastet, und der Bus kann nicht sicher auf LOW ziehen. Ab 4 Modulen (oder früher bei einem Bus länger als 15 cm) trennen Sie die integrierten Pull-ups auf allen Modulen außer einem — bei 2–3 Modulen auf einem Bus bis 15 cm lassen Sie sie in Ruhe, dieser Fall ist gemessen (oder trennen Sie sie auf allen und behalten Sie nur externe Pull-ups (2.7…3.3 kΩ bei 3 Modulen, niedriger bei größeren Bussen — siehe die Tabelle oben) gegen 3.3 V an einem einzigen Punkt des Busses — empfohlen für lange Leitungen / Störungen / ESP32 als Master).
  • Die internen Pull-ups des ESP32 (~45 kΩ) sind für einen Mehrmodul-Bus mit realen Leitungslängen zu schwach — externe Pull-ups sind nötig (Werte: siehe Tabelle oben). Dies ist Teil der dreistufigen Minderung gegen Bus-Festhänger auf einem grenzwertigen Bus — siehe 10 · Fehlerbehebung, den Abschnitt "ESP32-Projekt hängt".

Adressierung — Provisionierung und Austausch im Feld (produktionstauglich)

Die werkseitige Standardadresse ist 0x50. Jedes neue oder ersetzte Modul durchläuft einmalig die Provisionierung: Umzuweisung von 0x50 auf eine Arbeitsadresse und optional das Speichern der Konfiguration (CT-Modelle, group_id, Label) im Flash. Der Werkmodus ist nicht erforderlich — die Adressänderung funktioniert direkt in der Produktion über den zweiphasigen Adress-Commit.

Die Bereitstellung adressiert jeweils ein unberührtes Modul: Schließen Sie ein Modul an 0x50 an, führen Sie den Provisionierungsaufruf aus, prüfen Sie es unter der neuen Adresse und schließen Sie dann das nächste an.

C++
RbAmp* dev = nullptr;
if (RbAmpFleet::provision(Wire, /*desired=*/0x52, /*save=*/true, dev)) {
    fleet.add(dev);   // ready handle, now in the fleet
}

Ein einziger Aufruf scannt 0x50, führt den zweiphasigen Adress-Commit durch, setzt zurück, sucht das Modul im Startfenster unter der neuen Adresse und gibt (optional) SAVE_USER_CONFIG für die Speicherung aus. Gibt false bei einer Verletzung der Disziplin (siehe unten) oder einem Übertragungsfehler zurück.

Methode 2 — Low-Level-prepare/commitAddressChange (manuelle Form)

C++
dev.prepareAddressChange(0x52);   // candidate in RAM
dev.commitAddressChange();        // arms 0xA5 + COMMIT_ADDR + reset
delay(300);                        // boot window

Derselbe zweiphasige Mechanismus wie in provision(), ohne die Fleet-Hülle. Wird verwendet, wenn RbAmpFleet nicht erstellt wurde.

Drahtprotokoll im Hintergrund (zur Referenz)

Text
1. write candidate_addr → REG_I2C_ADDRESS (0x30, in RAM)
2. write 0xA5 → REG_ADDR_COMMIT_MAGIC (0x31, armed)
3. issue CMD_COMMIT_ADDR (opcode 0x30 in REG_COMMAND)
4. wait ~700 ms (flash erase + write)
5. issue CMD_RESET (opcode 0x01) — CMD_COMMIT_ADDR does not auto-reset
6. wait ~300 ms; the module responds at the new address
Sicherheit

✅ REG_I2C_ADDRESS (0x30) liefert beim Start die aktive Adresse (v1.3 addr-boot-sync). Nach dem Neustart nach dem Commit zeigt das Lesen von 0x30 die neue aktive Adresse. Das Verhalten des Staging-Echos bleibt bis CMD_COMMIT_ADDR + Reset bestehen.

⚠ Disziplin bei der Bereitstellung — es darf immer nur EIN neues Modul angeschlossen sein.

Die häufigste Ursache für Fehler bei der Bereitstellung ist, dass mehr als ein Modul mit der Werksadresse 0x50 am Bus hängt. Über I²C sind sie physisch nicht zu unterscheiden (Open-Drain-Bus: beide Module bestätigen identisch, und die zurückgelesenen Daten sind "zusammengeklebt").

Die Regel ist also streng (eine normative MUSS-Vorgabe, keine Empfehlung): In dem Moment, in dem Sie RbAmpFleet::provision() (oder prepareAddressChange()) aufrufen, muss genau ein Modul unter 0x50 vorhanden sein (ein neues oder eines, das über ein separates Werkzeug auf der Werkbank auf die Werkseinstellungen zurückgesetzt wurde). Kein "Ich bin sicher, dass diese zwei Module verschieden sind — ich trenne sie jetzt einfach" — das funktioniert nicht; die Kollision zeigt sich erst später, wenn Sie die Flotte bereits für sauber halten.

Wiederherstellungsweg bei Verdacht auf einen Verstoß gegen die Disziplin: 1. Alle Module aus- und wieder einschalten. 2. Alle bis auf ein „unkonfiguriertes“ Modul physisch trennen. 3. RbAmpFleet::provision() am Einzelmodul-Bus aufrufen. 4. Die übrigen Module einzeln hinzufügen und jedes einzeln provisionieren.

Leistungsbudget des Busses

Bei 50 kHz benötigt eine Lesetransaktion ca. 200–400 µs. Ein vollständiger RT-Block eines Kanals (U + I + P + PF) ≈ 5–8 ms je Kanal.

Konfiguration Busbelegung je Zyklus Bei 50 kHz Maximale Abfragerate
1× UI1, RT-Block ~5 ms < 5 ms 100+ Hz (das Modul aktualisiert aber mit 10 Hz)
1× UI3, RT-Block + Periode ca. 25 ms ca. 25 ms bis zu 10 Hz
5× UI1, RT-Block ca. 25 ms ca. 25 ms bis zu 10 Hz
16× UI3, RT + Periode ca. 400 ms 400 ms > 100 ms kommt mit dem Modul nicht mit (10 Hz); bestenfalls ~2 Hz
Hinweis

Die Zahlen sind Schätzungen (200–400 µs je Transaktion, abhängig vom MCU). Die Zahlen sind Schätzungen und hängen vom Host-MCU ab.

Regel: bei 50 kHz liegen die komfortablen Grenzen bei 8–10× UI3 oder 15–16× UI1 bei 5 Hz Abfrage (jedes zweite Modulfenster), und etwa die Hälfte davon bei voller 10 Hz.

Periodensynchronisation

Periodensynchronisation über Module hinweg: sequenzieller Snapshot mit kleinem Versatz gegenüber einem einzigen General-Call-Rahmen an Adresse 0x00.

Für die Tarifmessung müssen alle Module ihren Snapshot über dasselbe Intervall nehmen. Zwei Strategien:

Strategie 1 — sequentielle Momentaufnahme + gemeinsame Einschwingzeit (jede Firmware):

C++
RbAmp meters[N];   // array of initialized modules

void period_cycle() {
    // Phase 1: sequential snapshot
    for (auto& m : meters) m.latchPeriod();

    // Phase 2: common settle (≥ 50 ms)
    delay(50);

    // Phase 3: read the snapshots with skip_latch=true
    for (auto& m : meters) {
        RbAmpSnapshot snap;
        m.readPeriodSnapshot(snap, /*skip_latch=*/true);
    }
}

Versatz zwischen Modulen: 16 Module × ~1 ms je Momentaufnahme = ~16 ms über eine Periode von 60 s. Für Energiesummen vernachlässigbar.

Strategie 2 — General-Call-Broadcast-Snapshot (erfordert Aktivierung):

Alle Module nehmen ihren Snapshot mit einem einzigen I²C-Rahmen an Adresse 0x00:

Text
addr=0x00 | A5 27      (5 bytes)

Versatz = 0 (atomar). Vorkonfiguration (einmal auf jedem Modul der Flotte):

  1. Setzen Sie REG_FLEET_CONFIG.bit0 = 1 über CMD_SAVE_USER_CONFIG.
  2. CMD_RESET — der GC-Empfang wird beim Booten aktiviert.
  3. Nach dem Reset sendet der Master den 5-Byte-Rahmen an 0x00.
  4. Kontrolle: Lesen Sie für jedes erwartete Modul REG_V03_PERIOD_VALID (0x07). !=1 → auf Strategie 1 zurückfallen.

Welche verwenden:

  • < 8 Module: Strategie 1 (einfacher, keine Aktivierung nötig).
  • ≥ 8 Module oder enge Synchronisierung: Strategie 2.

GC-Gruppenfilterung (Mehrmandanten-Bus)

REG_GROUP_ID (0x28) erlaubt mehrere GC-Domänen auf einem Bus:

  • group = 0x00 → All-Call (alle Module mit aktiviertem GC nehmen eine Momentaufnahme).
  • group = N → nur Module mit REG_GROUP_ID = N nehmen eine Momentaufnahme.

Anwendungsfall — Trennung von Tarifgruppen (Tag und Nacht) auf einem gemeinsamen Bus.

Fehlerbilder

Symptom Ursache Was zu tun ist
i2c bus scan zeigt nach einer Nachrüstung im Feld mehrere Module unter einer Adresse Ein neues Modul unter 0x50 kollidiert mit einem bereits adressierten Adressieren Sie das neue Modul separat neu, bevor Sie es hinzufügen
Ein Modul quittiert NACK häufiger als die anderen Kabelfehler / VCC-Einbruch VCC unter Last prüfen
Die Wh-Werte eines Moduls weichen dauerhaft ab Die eigene Uhr des Moduls weicht von der des Masters ab Die Energie wird über die Masteruhr integriert; vergleichen Sie mit master_dt_ms, nicht mit latch_ms
Nach einem GC-Rahmen nimmt ein Modul keine Momentaufnahme FLEET_CONFIG.bit0 = 0 oder Gruppe stimmt nicht überein Prüfen Sie REG_FLEET_CONFIG und REG_GROUP_ID

Hinweise zum Bus-Design

  • Clock-Stretching: Die Momentaufnahme des Moduls hält es nur für Mikrosekunden an; SCL wird nicht nennenswert gedehnt. Für den Raspberry Pi BCM283x (bekannter Hardwarefehler beim Stretching): Die übliche Vorsichtsmaßnahme ist 50 kHz + Wiederholung.
  • Länge bei mehr als 4 Modulen: Ziehen Sie einen I²C-Puffer (PCA9515) ab 8 Modulen + einer Länge über 1 m in Betracht.

Ausführliche Mehrmodul-Szenarien — in 06 · Beispiele.

Was als Nächstes kommt


Quelle und Probleme: rb-amp/rbamp-arduino · diese Seite im Repository: docs/04_hardware.md (v1.6.2)