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 |
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/SCLarbeiten 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
0undDATA_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
GNDdes 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.
⚠ Ö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.
: 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.
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
liefert N aufeinanderfolgende Bytes ab+ N bytes 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 |
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)
⚠ 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 > 0bedeutet Verbrauch (Strom vom Netz in die Last),P < 0bedeutet 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.
: 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.
⚠ 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.
⚠ 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.
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 (
attachInterruptauf der fallenden Flanke) — weckt den Master und löst ein Lesen aus. -
Pull-up: entweder
INPUT_PULLUPam 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.
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 |
#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 |
#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).
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:
#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:
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) |
#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 |
#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 |
#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.
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)
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)
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-ModulRB_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 zuRBAMP_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).
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.
Methode 1 — RbAmpFleet::provision() (empfohlen)
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)
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)
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
✅ 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 |
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
Für die Tarifmessung müssen alle Module ihren Snapshot über dasselbe Intervall nehmen. Zwei Strategien:
Strategie 1 — sequentielle Momentaufnahme + gemeinsame Einschwingzeit (jede Firmware):
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:
addr=0x00 | A5 27 (5 bytes)
Versatz = 0 (atomar). Vorkonfiguration (einmal auf jedem Modul der Flotte):
- Setzen Sie
REG_FLEET_CONFIG.bit0 = 1überCMD_SAVE_USER_CONFIG. CMD_RESET— der GC-Empfang wird beim Booten aktiviert.- Nach dem Reset sendet der Master den 5-Byte-Rahmen an
0x00. - 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 mitREG_GROUP_ID = Nnehmen 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
- 02 · Modulstufen — Firmwareverhalten je Stufe
-
03 · Auswahl des Stromsensors — welches SCT-013-Modell und wie Sie es dem Modul mitteilen
-
05 · Schnellstart — Ihr erster funktionierender Sketch
- 10 · Fehlerbehebung — was zu tun ist, wenn der Bus nicht funktioniert / I_rms instabil ist / das Vorzeichen von P falsch ist
Quelle und Probleme: rb-amp/rbamp-arduino · diese Seite im Repository: docs/04_hardware.md (v1.6.2)