04 · Anschluss
Dieses Kapitel behandelt den physischen Anschluss des rbAmp-Moduls an einen Python-Host: Pinbelegung der Niederspannungsseite, Anforderungen an die Versorgung, I²C-Pegelkompatibilität, Buslänge und die Standard-Pins für jeden Hosttyp. Unterstützte Hosts sind CPython auf Linux-SBCs und x86 + USB-I²C sowie MicroPython auf ESP32 / RP2040 / STM32 / Pyboard.
Der Anwender arbeitet nur mit der Niederspannungsseite (Versorgung + I²C + optional DRDY); alles, was das Netz berührt, bleibt im Gehäuse.
⚠ Netzsicherheit. Netzspannung kann tödlich sein. Trennen und sichern Sie den Stromkreis gegen Wiedereinschalten, bevor Sie die L/N-Klemmen anschließen oder die Zange anbringen; Arbeiten an der Netzverkabelung und im Inneren eines Verteilers überlassen Sie einer Elektrofachkraft. Klemmen Sie nur einen Leiter (L) — niemals das ganze Kabel (klemmen Sie L und N zusammen, zeigt die Messung etwa 0). Die Zange selbst arbeitet berührungslos.
Leitung und Sicherung (Spannungsanschluss). AWG 26–22 genügt — der Spannungssensor nimmt sehr wenig Strom auf. Eine Sicherung in der L-Leitung ist zwingend, Nennwert bis 0.1 A.
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 | Zweck |
|---|---|---|
VCC |
+5 V (4.5..5.5 V) | Modulversorgung; mindestens 4.5 V für korrekten Betrieb |
GND |
Masse | Gemeinsam mit dem Host — 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
- Versorgungsstrom: typisch ~15 mA, Spitze ~25 mA beim Schreiben ins Flash
- Welligkeit: < 50 mV Spitze-Spitze (für die Messgenauigkeit)
Das Modul enthält einen integrierten Regler, ein RC-Filter, Keramikkondensatoren und eine Ferritperle — eine zusätzliche Filterung ist vom Anwender nicht nötig. Sie können das Modul von der Schiene +5V oder 5V0 eines beliebigen Hosts versorgen (Raspberry Pi Pin 2/4, ESP32 DevKitC USB-5V, Pyboard V+ usw.).
I²C-Pegelkompatibilität
-
SDA/SCLarbeiten mit 3.3-V-Logik (die eingebauten Pull-ups ziehen die Leitungen auf 3.3 V). -
Die Leitungen sind 5-V-tolerant, aber alle unten genannten Hosts (Raspberry Pi / ESP32-Familie / RP2040 / STM32 / Pyboard) arbeiten bereits mit 3.3-V-Logik — es sind keine Pegelwandler nötig.
-
Der USB-I²C-Dongle
pyftdi(FT232H / MCP2221) arbeitet ebenfalls mit 3.3-V-Logik — direkte Verbindung.
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 lesen die Register
0und das FlagDATA_VALID= 0.
Das Paket wartet innerhalb von dev.begin() darauf, dass das Modul bereit ist — Anwendercode ruft einfach begin() auf (oder verwendet den Kontextmanager with RbAmp(bus, 0x50) as dev:, der begin() automatisch in __enter__ aufruft).
Isolation
Das Modul selbst ist vollständig Niederspannung — es gibt keine Hochspannungs-Messschaltung darauf. Der Strom wird von einem CT-Wandler gemessen, der magnetisch von außen durch den isolierten Leiter koppelt, ohne elektrischen Kontakt zum Netzdraht. Bei spannungsmessenden (UI-)Varianten ist die einzige Netzreferenz die L–N-Klemme, die einen galvanisch getrennten* Messteiler speist; reine Ampere-Varianten haben gar keinen Netzanschluss. Folgen:
- Die
GNDdes Moduls ist nicht verbunden mit Netzphase oder Neutralleiter. - Den Anschluss der Niederspannungsseite an den Python-Host ist sicher — es besteht keine Gefahr eines Kurzschlusses über Masse.
⚠ Öffnen Sie das Modulgehäuse nicht — dadurch erlischt die werkseitige Kalibrierung.
Eingebaute Pull-up-Widerstände — auf der Platine
Wichtig: Jedes rbAmp-Modul wird mit eingebauten 4.7-kΩ-Pull-up-Widerständen auf SDA und SCL gegen 3.3 V ausgeliefert. Für ein einzelnes Modul am Bus sind keine externen Pull-ups nötig — schließen Sie den Host direkt an.
Wann die integrierten Pull-ups abzuschalten sind
Befinden sich mehrere rbAmp-Module am Bus (oder andere I²C-Geräte mit eigenen Pull-ups), ergibt die Parallelschaltung einen zu niedrigen effektiven Widerstand, was:
- Erhöht die Stromaufnahme des Busses
- Kann die maximale Senkenstromstärke der Ausgangsstufe des I²C-Masters überschreiten
- Erhöht die kapazitive Last auf einem langen Bus, verbessert die Störfestigkeit aber kaum
Lösung: Auf der Unterseite der Platine jedes Moduls, neben den Pull-up-Widerständen, befinden sich Lötbrücken (Siebdruck Pull-Up). Trennen Sie sie mit einer scharfen Klinge:
-
Lassen Sie die Pull-ups nur an einem Modul aktiviert (oder führen Sie sie zu einem einzigen Punkt nahe am Host).
-
Trennen Sie die Lötbrücken an den übrigen Modulen.
Faustregel
| rbAmp-Module am Bus | Pull-ups |
|---|---|
| 1 | Belassen Sie es so (die eingebauten 4.7 kΩ genügen) |
| 2 | Auf dem einen behalten, auf dem anderen schneiden |
| 3 | An allen Modulen trennen, ein externes Paar 2.7…3.3 kΩ nahe am Host einsetzen |
| 4…6 | An allen Modulen trennen, ein externes Paar 2.2…2.7 kΩ nahe am Host |
| 7…16 | Auf allen Modulen trennen, ein externes Paar 1.5…2.2 kΩ nahe am Host; 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.
: Messen Sie den Widerstand zwischen SDA und VCC bei ausgeschalteten Geräten. Er sollte im Bereich 1.5..4.7 kΩ liegen. Darunter bedeutet das zu viele aktive Pull-ups parallel.
I²C-Busparameter
- Standardadresse:
0x50(7-Bit) - Adressbereich:
0x08..0x77(im Werk neu zuweisbar) -
Empfohlene Geschwindigkeit unter MicroPython + ESP32: 50 kHz — mildert das Grund-NACK-Muster mit Firmware v1 (siehe Abschnitt unten).
-
Empfohlene Geschwindigkeit auf CPython + Linux-SBC: 100 kHz (das NACK-Muster tritt über den Kernel-I²C-Treiber nicht auf — der Linux-smbus2-Pfad hat das für ESP-IDF beschriebene Wiederholungsproblem nicht).
-
Mehrbyte-Zugriff: Lesevorgänge dürfen als Burst erfolgen (mehrere Bytes in einer Transaktion); Schreibvorgänge erfolgen Byte für Byte, jeweils mit einer expliziten Registeradresse. Das Paket macht dies selbstständig richtig; Anwendercode sieht davon nichts.
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 Leitung Pflicht: SDA und SCL müssen in verschiedenen Paaren liegen, jedes mit eigener Masse. SDA und SCL im selben Paar erzeugen eine Kopplungskapazitä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.
Mehrmodul-Bus — die primäre Topologie
Der kanonische Anwendungsfall der Bibliothek sind mehrere rbAmp-Module an einem gemeinsamen I²C-Bus, verwaltet von einem ESP32 / Raspberry Pi / SBC über RbAmpFleet. Alle unten genannten Regeln und Optimierungen sind genau für diese Topologie ausgelegt; ein einzelnes Modul ist ein Sonderfall (dasselbe Handle, bei dem die Flottenaufrufe trivial werden).
Typische Installationen
| Szenario | Konfiguration | Anzahl der Module |
|---|---|---|
| 80-%-kanonisch: Hauptzuleitung des Hauses + Unterzähler | 1× UI1 (Eingang, Netzenergie) + 3–6× UI1/I1 (Lasten) | 4-7 |
| Unterverteilung mit Stromaufschlüsselung | 1× UI1 (Eingang) + 1–2× I2/I3 (je Stromkreis) | 3-5 |
| Industrielle Unterzählung | 1× UI1 (Eingang) + N× I2/I3 (je Maschine, Stromaufschlüsselung) | bis zu ~16 |
Elektrische Grenzwerte
- Anzahl der Module: bis etwa 16 (gesamte Buskapazität ≤ 400 pF bei 100 kHz; bei 50 kHz ist die Reserve größer).
- Pull-ups für den Flottenbus (wichtig): Jedes Modul bringt eingebaute 4.7 kΩ mit. Auf einem Bus mit mehreren Modulen arbeiten N Pull-ups parallel → die Senke ist überlastet, und der Bus kann nicht auf LOW ziehen. Ab 4 Modulen (oder früher bei einem Bus länger als 15 cm) trennen Sie die eingebauten Pull-ups an allen Modulen bis auf eines — bei 2–3 Modulen auf einem Bus bis 15 cm lassen Sie sie in Ruhe, dieser Fall ist gemessen (oder Sie trennen sie an allen und behalten nur ein externes Paar (2.7…3.3 kΩ für 3 Module, niedriger bei größeren Bussen — siehe die Tabelle oben) gegen 3.3 V an einer Stelle des Busses — empfohlen für lange Leitungen, Störungen und den ESP32 als Master).
- Die internen Pull-ups des ESP32 (~45 kΩ) sind bei einem Mehrmodul-Bus mit realer Leitungslänge zu schwach — externe Pull-ups sind nötig (Werte: siehe Tabelle oben). Das ist Teil der dreistufigen Abhilfe gegen den Busstillstand auf einem grenzwertigen Bus — siehe 10 · Fehlerbehebung, Abschnitt „Skript hängt / scheitert bei Timeout“.
Adressierung — Provisionierung und Austausch im Feld (produktionstauglich)
Die Werksadresse ist 0x50. Jedes neue oder Ersatzmodul durchläuft einmalig die Provisionierung: Umadressierung von 0x50 auf eine Arbeitsadresse plus optionales Speichern der Konfiguration (CT-Modelle, group_id, label) im Flash. Der Factory-Modus ist nicht erforderlich — die Adressänderung funktioniert direkt im Produktionsbetrieb über einen Zwei-Phasen-Commit.
Methode 1 — Low-Level-prepare_address_change / commit_address_change (aktuelle API):
dev.prepare_address_change(0x52) # arms candidate, 5 s window
dev.commit_address_change() # magic 0xA5 + CMD_COMMIT_ADDR + reset
time.sleep(0.3) # boot window
# dev.address is now == 0x52
Methode 2 — der RbAmpFleet-Wrapper (empfohlen für Flotten-Deployments):
from rbamp import RbAmpFleet
fleet = RbAmpFleet(bus)
fleet.scan()
fleet.assign_address(dev, 0x52) # two-phase + reset + handle rebind
Das zugrunde liegende Wire-Protokoll (zur Referenz):
1. write candidate_addr → REG_I2C_ADDRESS (0x30, in RAM)
2. write 0xA5 → REG_ADDR_COMMIT_MAGIC (0x31, armed; 5-second window)
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
✅ Rücklesen der Adresse: REG_I2C_ADDRESS (0x30) liest beim Start die aktive Adresse. Nach dem Neustart nach dem Commit zeigt 0x30 die neue aktive Adresse. Während der Vorbereitung gibt es den Kandidaten zurück, bis zum Commit. Die Bibliothek stellt über try/finally sicher, dass der Armierungszustand bei einem Teilfehler gelöscht wird — RbAmpTimeoutError, wenn das Zeitfenster abgelaufen ist.
⚠ Disziplin bei der Bereitstellung — es darf immer nur EIN neues Modul angeschlossen sein.
Die häufigste Ursache für Provisionierungsfehler ist, dass sich mehr als ein Modul mit der Werksadresse 0x50 am Bus befindet. Über I²C lassen sie sich physisch nicht unterscheiden (Open-Drain-Wired-AND — beide Module quittieren identisch, und die Datenrücklesung wird „verschmolzen“).
Daher ist die Regel streng (eine normative MUSS-Anforderung, keine Empfehlung): Wenn prepare_address_change() aufgerufen wird, muss am Bus genau ein Modul auf 0x50 sein (ein neues oder eines, das über ein separates Werkzeug auf den Auslieferzustand zurückgesetzt wurde).
Wiederherstellung, wenn Sie einen Verstoß gegen die Disziplin vermuten: 1. Alle Module stromlos schalten. 2. Alle bis auf ein „unberührtes“ Modul physisch trennen. 3. prepare_address_change() am Einzelmodul-Bus aufrufen. 4. Die übrigen Module nacheinander hinzufügen und jedes einzeln konfigurieren.
Energiebudget des Busses
Bei 50 kHz dauert eine einzelne Lesetransaktion ≈ 200–400 µs. Ein vollständiger RT-Block für einen Kanal (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) |
| 5× UI1, RT-Block | ca. 25 ms | ca. 25 ms | bis zu 10 Hz |
| 16× I3, RT + Periode | ca. 400 ms | 400 ms > 100 ms | kann mit dem Modul nicht Schritt halten (10 Hz); bestenfalls ~2 Hz |
Die Zahlen sind Schätzungen.
Regel: bei 50 kHz liegen die komfortablen Grenzen bei 8–10× I3 oder 15–16× UI1 bei 5 Hz Abfrage (jedes zweite Modulfenster) und etwa der Hälfte davon bei voll 10 Hz.
Periodensynchronisation — das Synchronisieren der Perioden
Mehrere Module — gleichzeitiger Snapshot (Periodenmessung) · 6.4 Periodensynchronisation — zwei Strategien (API-Referenz)
Für die Tarifmessung müssen alle Module dasselbe Intervall als Snapshot erfassen.
Strategie 1 — sequentielle Momentaufnahme + gemeinsame Einschwingzeit (jede Firmware):
import time
# Phase 1: sequential snapshot
for m in meters:
m.latch_period()
# Phase 2: common settle (≥ 50 ms)
time.sleep(0.050)
# Phase 3: read the snapshots with skip_latch=True
snaps = [m.read_period_snapshot(skip_latch=True) for m in meters]
Versatz: 16 Module × ~1 ms/Snapshot = ~16 ms bezogen auf eine 60-s-Periode = 0.027 %. Vernachlässigbar für typische Überwachung.
Strategie 2 — General-Call-Broadcast-Snapshot (erfordert die Aktivierung auf jedem Modul):
Alle Module nehmen ihren Snapshot über einen einzigen I²C-Frame an Adresse 0x00:
addr=0x00 | A5 27 (5 bytes)
Versatz = 0 (atomar). Vorkonfiguration (einmal auf jedem Flottenmodul):
dev.write_reg(0x27, 0x01)(setzt das FlagGC_ENABLEvon FLEET_CONFIG)dev.save_user_config()dev.reset()(Einschwingzeit ~300 ms)
Zeuge: Lesen Sie für jeden erwarteten Slave REG_PERIOD_VALID (0x07). !=1 → auf Strategie 1 zurückfallen.
⚠ GC-Opt-in (C.10): Ist GC in der gesamten Flotte deaktiviert, quittiert die GC-Adresse mit NACK. Der Master erhält einen harten Fehler (kein stiller Verlust) — das ist erkennbar, kein Fehler.
GC-Gruppenfilterung (Mehrmandanten-Bus)
REG_GROUP_ID (0x28) erlaubt mehrere GC-Domänen auf einem Bus:
group = 0x00→ Sammelaufruf an alle.group = N→ nur Module mitREG_GROUP_ID = Nnehmen den Snapshot auf.
Anwendungsfall — Trennung von Tarifgruppen.
Fehlerbilder
| Symptom | Ursache | Was zu tun ist |
|---|---|---|
i2c bus scan zeigt nach einem nachträglichen Einbau mehrere Module auf derselben Adresse |
Ein neues Modul auf 0x50 kollidiert |
Vorher separat neu adressieren, dann hinzufügen |
| Ein Modul quittiert NACK häufiger als die anderen | Kabelfehler / VCC-Einbruch | VCC unter Last prüfen |
| Nach einem GC-Frame nimmt ein Modul keinen Snapshot | GC_ENABLE von FLEET_CONFIG ist aus oder die Gruppe stimmt nicht überein |
Prüfen Sie REG_FLEET_CONFIG und REG_GROUP_ID |
Detaillierte Szenarien mit mehreren Modulen finden Sie unter 06 · Beispiele.
CPython-Hosts (Linux-SBC + x86)
Raspberry Pi (beliebiges Modell)
I²C-Bus 1 ist auf die 40-polige Stiftleiste geführt. Bei den meisten Modellen (1B+ / 2 / 3 / 4 / 5) sind die Pins gleich:
| rbAmp | RPi-40-Pin-Header | GPIO (BCM) |
|---|---|---|
VCC |
Pin 2 (+5 V) | — |
GND |
Pin 6 (oder ein beliebiges GND) | — |
SDA |
Pin 3 | GPIO 2 (SDA1) |
SCL |
Pin 5 | GPIO 3 (SCL1) |
DRDY |
(optional) | ein beliebiger freier GPIO mit IRQ-Unterstützung |
Aktivieren Sie den I²C-Treiber des Kernels: sudo raspi-config → 3 Interface Options → I2C → Yes. Oder bearbeiten Sie manuell /boot/firmware/config.txt (/boot/config.txt auf älteren Raspberry-Pi-OS-Versionen):
dtparam=i2c_arm=on
dtparam=i2c_arm_baudrate=100000 # 100 kHz (default 100 kHz)
Installieren Sie das Scan-Werkzeug und erlauben Sie Ihrem Benutzer, den Bus zu öffnen (danach ab- und wieder anmelden). Prüfen Sie dann, ob das Modul antwortet:
sudo apt install i2c-tools
sudo usermod -aG i2c $USER
i2cdetect -y 1 # should show 0x50
Verwendung aus Python:
from smbus2 import SMBus
from rbamp import RbAmp
with SMBus(1) as bus:
with RbAmp(bus, 0x50) as dev:
print(dev.voltage, "V")
smbus2 installieren: pip install smbus2 (oder das Systempaket sudo apt install python3-smbus).
Orange Pi 5 / Rock Pi 5 / andere Linux-SBCs
Dasselbe smbus2.SMBus(N), wobei N die Busnummer aus /dev/i2c-N ist. Üblich sind /dev/i2c-1 oder /dev/i2c-0. Prüfen:
ls /dev/i2c-*
i2cdetect -y 1 # should show 0x50
Die Pinbelegung hängt von der konkreten Platine ab — prüfen Sie deren Datenblatt.
x86 / Windows / macOS — über einen USB-I²C-Dongle
Auf x86-Hosts gibt es kein natives I²C. Die Lösung ist ein USB-I²C-Dongle (FT232H, MCP2221, Bus Pirate v4, CH341). pyftdi.i2c.I2cController hat für sich weder eine zu smbus2 kompatible Signatur (read_byte_data / write_byte_data) noch eine MicroPython-Signatur (readfrom_mem / writeto_mem) — Sie können es daher nicht direkt an RbAmp(...) übergeben; die automatische Buserkennung löst RbAmpParamError aus.
x86-Dongles benötigen eine dünne Wrapper-Klasse, die die Duck-Typed-Backend-Schnittstelle implementiert (read_byte / write_byte / register_acks / now_ms — siehe 09 · API-Referenz, Abschnitt „Bus-Autodetect“). Für andere Dongles schreiben Sie einen eigenen Wrapper nach dem Vorbild von _io_smbus.py / _io_micropython.py.
MicroPython-Hosts
ESP32 / ESP32-S2 / ESP32-S3 / ESP32-C3
from machine import I2C, Pin
from rbamp import RbAmp
# ESP32 DevKitC default I²C pinning
i2c = I2C(0, scl=Pin(22), sda=Pin(21), freq=50_000) # 50 kHz recommended on ESP32
with RbAmp(i2c, 0x50) as dev:
print(dev.voltage, "V")
| Chip | Standard-SDA / SCL (empfohlen) | I²C-Port |
|---|---|---|
| ESP32 (Original / WROOM / DevKitC) | GPIO 21 / GPIO 22 | I2C(0, ...) |
| ESP32-S2 | GPIO 21 / GPIO 22 (gleiche Konvention) | I2C(0, ...) |
| ESP32-S3 | GPIO 8 / GPIO 9 (Standard für das N16R8-Board) | I2C(0, ...) |
| ESP32-C3 | GPIO 5 / GPIO 6 | I2C(0, ...) |
Für andere Chips prüfen Sie die MicroPython-Firmware Ihres ESP32 (mpremote eval 'help(machine.I2C)').
Raspberry Pi Pico / Pico W (RP2040)
from machine import I2C, Pin
from rbamp import RbAmp
# Pico — two hardware I²C blocks (I2C0 and I2C1)
i2c = I2C(0, scl=Pin(1), sda=Pin(0), freq=100_000) # 100 kHz OK on RP2040
with RbAmp(i2c, 0x50) as dev:
print(dev.voltage, "V")
Der Pico ist vom Grund-NACK-Muster nicht betroffen — MachineI2CBackend erkennt den RP2040 automatisch und setzt den Wiederholungsstandard auf 1 Versuch.
STM32 / Pyboard / Nucleo (über MicroPython)
from machine import I2C
from rbamp import RbAmp
# Pyboard — soft-I²C or hardware I²C block
i2c = I2C(1, freq=100_000) # bus 1 — X9/X10 on the Pyboard
with RbAmp(i2c, 0x50) as dev:
print(dev.voltage, "V")
STM32 ist vom Basis-NACK-Muster nicht betroffen — MachineI2CBackend senkt auf diesen Boards den Wiederholungsstandard auf 1 Versuch.
MicroPython-Basis-NACK-Muster auf ESP32 — 50 kHz
Unter MicroPython auf ESP32 zeigt die aktuelle rbAmp-Firmware bei 100 kHz häufige NACKs, bei 50 kHz deutlich weniger. Dies ist spezifisch für den ESP-IDF-I²C-Stack, auf dem MicroPython auf dem ESP32 aufsetzt. Auf den anderen MicroPython-Ports (RP2040 / STM32 / Pyboard) tritt das Problem nicht auf.
Das Paket adressiert dies in zwei Schichten:
-
Standardgeschwindigkeit 50 kHz — übergeben Sie auf dem ESP32 am besten
freq=50_000anmachine.I2C(...). -
Wiederholung pro Byte in
MachineI2CBackend— standardmäßig 3 Versuche × 5 ms Pause. Konfigurierbar über die erweiterte API:
from rbamp._io_micropython import MachineI2CBackend
from rbamp import RbAmp
backend = MachineI2CBackend(i2c, retry_attempts=5, retry_gap_ms=5)
dev = RbAmp(backend, 0x50) # the address is a parameter of RbAmp, not of the backend
Zur Diagnose von Problemen auf Bus-Ebene siehe 10 · Fehlerbehebung. Die Zähler MachineI2CBackend.retry_exhaustion_count und RbAmp.sanity_reject_count stehen für die Beobachtung bei langen Dauertests zur Verfügung.
DATA_READY (DRDY)
Ein optionaler Pin zur Abfrageoptimierung. Fragt die Anwendung das Modul nicht öfter 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 Host-Seite — der eingebaute Pull-up des GPIO oder ein externer Widerstand; 10 kΩ gegen 3.3 V werden empfohlen)
-
Ready-Impuls: LOW für ~10 µs, nachdem die RT-Register mit frischen Daten aktualisiert wurden
-
Pulsrate: ~10 Hz (ein Impuls pro ~100-ms-RT-Fenster)
Semantik
Eine fallende Flanke an DRDY garantiert, dass alle RT-Register synchronisiert und veröffentlicht sind (die Firmware aktualisiert sie im ISR atomar, bevor sie den Pin auf Low zieht). Nach der fallenden Flanke kann der Master den RT-Block ohne Gefahr eines geteilten Samples lesen.
Interrupt-Muster auf MicroPython
from machine import Pin
import uasyncio as asyncio
from rbamp import RbAmp
DRDY_PIN = 15
drdy_event = asyncio.Event()
def drdy_irq(pin):
drdy_event.set() # ISR-safe — Event.set() is atomic on uPy
async def bidir_task(dev):
while True:
await drdy_event.wait()
drdy_event.clear()
try:
p = dev.read_power(0)
# ...integrate + publish...
except Exception as e:
print("read failed:", e)
# In main:
drdy = Pin(DRDY_PIN, Pin.IN, Pin.PULL_UP)
drdy.irq(trigger=Pin.IRQ_FALLING, handler=drdy_irq)
asyncio.run(bidir_task(dev))
Muster auf CPython (Linux-SBC)
Auf dem Raspberry Pi über gpiozero oder RPi.GPIO:
from gpiozero import Button
from threading import Event
from rbamp import RbAmp
drdy_event = Event()
drdy = Button(15, pull_up=True, bounce_time=None) # GPIO 15 as an example
drdy.when_pressed = lambda: drdy_event.set() # falling edge
while True:
drdy_event.wait()
drdy_event.clear()
try:
p = dev.read_power(0)
# ...integrate + publish...
except Exception as e:
print("read failed:", e)
DRDY ist optional — Abfrage in beliebiger Rate ≤ 10 Hz funktioniert auch ohne. Das Paket hängt in keinem seiner Pfade von DRDY ab.
STANDARD-(STD)-Module
STD-Module verwenden dieselbe I²C-Verdrahtung, Pull-up-Überlegungen, Adresse (Standard 0x50) und Busparameter wie in diesem Kapitel beschrieben und denselben Konstruktor RbAmp(bus, addr). Die Bibliothek erkennt die Modulreihe in begin(); zusätzliche Verdrahtung oder Konfiguration ist nicht nötig.
-
Nur für STD vorgesehene Aufrufe (Energie auf dem Gerät, Spannungswinkel, Anlaufstrom, ...) lösen bei einem BASIC-Modul
RbAmpNotSupportedErroraus. -
Einige STD-Funktionen brauchen ein hinreichend aktuelles Modul-Image; auf einem älteren Image löst der Aufruf
RbAmpNotSupportedError(„nicht verfügbar“) aus. -
Die Funktionen für Energie, Winkel und Anlaufstrom auf dem Gerät sind unter CPython (
smbus2) validiert. Der 16-Bit-Pfad unter MicroPython ist implementiert, aber noch nicht an Hardware validiert — verwenden Sie für diese Funktionen bevorzugt einen CPython-Host (Raspberry Pi und andere Linux-SBCs, siehe oben), bis eine Versionsnotiz etwas anderes sagt.
Siehe 09 · API-Referenz.
Links
-
05 · Schnellstart — das erste funktionierende Skript für beide Backends
-
06 · Beispiele — Arbeitsszenarien (einschließlich Mehrmodul-Bus + asynchrones Streaming)
-
09 · API-Referenz — Details zum Backend und Zugriffe auf Wiederholungs- und Plausibilitätszähler
-
10 · Fehlerbehebung — Fehlersuche auf Busebene, das NACK-Muster, Disziplin aus Wiederholung und Plausibilitätsprüfung
Quelle & Issues: rb-amp/rbamp-python · diese Seite im Repo: docs/04_hardware.md (v1.6.1)