03 · Auswahl des Stromsensors
Dieses Kapitel beantwortet zwei Fragen:
- Welchen Stromsensor Sie für eine bestimmte Last wählen.
- So teilen Sie dem rbAmp-Modul Ihre Wahl mit, damit die Werkskalibrierung für diese Kombination automatisch geladen wird.
Die physische Verdrahtung des Sensors (Ausrichtung der Zange, Prüfung der L/N-Polarität) behandelt 04_hardware.md. Dieses Kapitel befasst sich mit der Wahl des Modells und den API-Aufrufen.
Sensorklasse
rbAmp-Module arbeiten mit CT-Zangen aus der Familie SCT-013. Die Sensorklasse ergibt sich aus der Hardware-Revision des Moduls und wird werkseitig gesetzt — der Anwender teilt seine Wahl über dev.set_sensor_class() mit, bevor er ein bestimmtes CT-Zangenmodell wählt.
Wahl eines SCT-013-Modells
Innerhalb der SCT-013-Familie werden sieben Modelle unterstützt (Codes {1, 2, 3, 4, 5, 6, 7}).
code |
Modell | Strombereich | Status | Typische Anwendung |
|---|---|---|---|---|
| 1 | SCT-013-005 | 0…5 A | ✅ charakterisiert | Kleine Lasten — Lampen, leistungsschwache Elektronik, ein einzelner Schalter |
| 2 | SCT-013-010 | 0…10 A | ✅ charakterisiert | Ein Gerät mittlerer Leistung — Kühlschrank, Waschmaschine, Klimaanlage bis 2 kW |
| 3 | SCT-013-030 | 0…30 A | ✅ charakterisiert | Mittelgroßer Hausanschluss — bis etwa 7 kW |
| 4 | SCT-013-050 | 0…50 A | ✅ charakterisiert | Großer Hauptanschluss — Elektroheizung, E-Auto-Ladegerät, Einfamilienhaus mit Lastspitzen |
| 5 | SCT-013-100 | 0…100 A | ✅ charakterisiert | Hauptzuleitung |
| 6 | SCT-013-020 | 0…20 A | ✅ charakterisiert | Mittlerer Hausanschluss — 3–4-kW-Geräte, schwere Haushaltsgeräte |
| 7 | SCT-013-060 | 0…60 A | ✅ charakterisiert | Industrieller Unterzähler |
Akzeptierte Codes — {1, 2, 3, 4, 5, 6, 7}. Der Aufruf dev.set_ct_model_ch(ch, code) mit einem Code außerhalb dieser Menge, zum Beispiel 0 oder 8 (oder die Übergabe eines solchen Codes an dev.configure_channels(...)), löst RbAmpParamError aus — die Bibliothek sendet den Schreibvorgang nicht an das Gerät (clientseitige Prüfung _validate_ct_code; REG_ERROR auf dem Gerät bleibt 0x00).
Akzeptierte Mengen je Klasse: - RbAmpSensorClass.SCT_013 → {1, 2, 3, 4, 5, 6, 7} - RbAmpSensorClass.WIRED_CT → {1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12} (werkseitig gepaarte Zangenserie; Codes 11 und 13 sind nicht verfügbar) - RbAmpSensorClass.BUILTIN_CT → ∅ (eingebauter CT, keine Codes)
Die Codes 0x06 und 0x07 sind nach Nennwert nicht monoton (nachträglich nach 0x01..0x05 hinzugefügt). Wählen Sie nach dem benötigten Nennwert.
Wie man das richtige Modell auswählt
Die eine Regel: Wählen Sie die kleinste Nennzange oberhalb Ihres größten erwarteten Stroms plus einer 30-%-Reserve. Eine überdimensionierte Zange (etwa eine 100-A-Zange an einem Stromkreis, der nie über 5 A geht) funktioniert zwar, liefert aber eine geringe Auflösung und einen großen Fehler bei typischen Werten.
Reserve
Eine SCT-013-Zange arbeitet innerhalb ihres Nennbereichs ohne Sättigung. Kurzzeitige Spitzen (Verdichteranlauf, induktive Last) können die Nennlast überschreiten — die Zange hält das aus, aber die Messung wird oberhalb des Nennwerts nicht mehr linear.
Berücksichtigen Sie einen regelmäßigen Einschaltstrom als Teil Ihres „größten erwarteten Stroms“. Bei einer Waschmaschine mit 12 A Einschaltstrom (und 2–3 A im Betrieb) gilt zum Beispiel: 12 A × 1.3 = 15.6 A, also ist der kleinste passende Stromwandler darüber der SCT-013-020 (Code 6).
So teilen Sie dem Modul Ihre Wahl mit
Zwei Aufrufe in der richtigen Reihenfolge sind Pflicht — zuerst dev.set_sensor_class(), dann dev.set_ct_model(). Wenn Sie dev.set_ct_model() vor dev.set_sensor_class() aufrufen, wirft das Paket RbAmpModeError:
REG_SENSOR_CLASS is UNSET;
call dev.set_sensor_class(RbAmpSensorClass.SCT_013) first
CT-Modell — eine funktionale Voreinstellung, kein Etikett. Das Schreiben des CT-Modells wendet sofort die NF-Basislinie, die Verstärkung und den Formfaktor an — die Strommesswerte ändern sich. Ein Wechsel von sensor_class setzt CT_MODEL auf den Standardwert zurück und muss erneut gesetzt werden.
from rbamp import RbAmp, RbAmpSensorClass, RbAmpModeError
with RbAmp(bus, 0x50) as dev:
# Step 1: sensor class. MANDATORY before set_ct_model().
try:
dev.set_sensor_class(RbAmpSensorClass.SCT_013)
except RbAmpModeError as e:
# Possible causes: communication failure (see 10 · Troubleshooting),
# invalid argument (cls outside the known values)
print("set_sensor_class failed:", e)
raise SystemExit(1)
# Step 2: model within the family.
# 1 = SCT-013-005, 2 = SCT-013-010, 3 = SCT-013-030,
# 4 = SCT-013-050, 5 = SCT-013-100, 6 = SCT-013-020, 7 = SCT-013-060.
try:
dev.set_ct_model(3) # e.g. SCT-013-030
except RbAmpModeError:
print("Sensor class must be set first")
except ValueError:
print("Code not in per-class accept-set (SCT_013: {1,2,3,4,5,6,7})")
set_sensor_class() akzeptiert entweder eine Enum oder einen einfachen int — beide Formen sind gleichwertig:
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # explicit enum form
dev.set_sensor_class(1) # numeric (equivalent)
Das Paket ruft set_sensor_class() bewusst NICHT in Ihrem Namen auf. Wird dieser Schritt übersprungen, löst set_ct_model() RbAmpModeError aus, ohne in den Flash zu schreiben. Das ist Absicht, damit das Verhalten vorhersagbar und explizit ist — keine „Magie“ in der öffentlichen API.
Nach diesen beiden Aufrufen:
-
Das Modul speichert beide Werte im Flash — die Einstellung übersteht einen Reset, einen Stromausfall und ein erneutes Flashen der Firmware.
-
Die Kalibrierkoeffizienten für genau diese Kombination (Sensorklasse + Modell) werden aus der Werkstabelle geladen. Sie müssen keine manuellen Kalibrierregister anfassen.
-
Der nächste Lesevorgang von
dev.current[0](oderdev.read_current(0)) liefert bereits einen Wert in Ampere mit korrekter Skalierung.
Gesamtzeit für beide Aufrufe beträgt etwa 1.4 Sekunden (zwei Flash-Schreibvorgänge × je ~700 ms, begrenzt durch die Löschzeit der Flash-Seite). Dies geschieht einmalig bei der Erstinstallation; die Einstellung wird im Flash gespeichert und nicht wiederholt.
Wenn Sie den Sensor beim ersten Lauf schon gewählt haben und das Skript nur neu starten, müssen Sie set_sensor_class() und set_ct_model() nicht wiederholen — das Modul merkt sich die vorherige Auswahl. Es schadet aber auch nichts: Ein erneuter Aufruf mit demselben Wert schreibt dasselbe Byte nur neu.
Modellwechsel und Neustart. Bei Modul-Firmware bis 1.4.19 startet ein Modellwechsel das Modul einmal neu (etwa eine Sekunde); ab 1.4.20 korrigiert sich das Modul selbst. Die SCT-Nennwertkorrektur skaliert Strom, Leistung und Energie, niemals Spannung oder Leistungsfaktor.
Überprüfen der Einrichtung
Eine einfache Plausibilitätsprüfung nach set_ct_model():
import time
from rbamp import RbAmp, RbAmpSensorClass
def sanity_check(dev):
print("Ready. Connect a purely resistive load",
"(e.g. an incandescent lamp).")
print("Expect a stable PF ~= 1.0 and a positive P.")
while True:
u = dev.voltage # property — one I²C transaction
i = dev.read_current(0)
p = dev.read_power(0)
pf = dev.read_power_factor(0)
print(f"U={u:.1f} V I={i:.2f} A P={p:.1f} W PF={pf:.2f}")
time.sleep(2)
with RbAmp(bus, 0x50) as dev:
dev.set_sensor_class(RbAmpSensorClass.SCT_013)
dev.set_ct_model(3)
sanity_check(dev)
Unter MicroPython ersetzen Sie time.sleep(2) durch time.sleep_ms(2000).
Bei einer rein ohmschen Last (Glühlampe, Wasserkocher, Heizelement) erwarten Sie:
U≈ 220–240 V (bei 230-V-Netz)I≈ entspricht der Scheinleistung der Last (P / U)P> 0 und stabilPF≈ 1.0 (eindeutig positiv)
Wenn etwas nicht aufgeht, siehe 10_troubleshooting.md.
Module mit mehreren Stromkanälen
SKU-Programm — was zur Aufgabe passt
| SKU | I-Kanäle | U-Kanal | Typische Anwendung |
|---|---|---|---|
| UI1 | 1 | ja | Eine Last mit voller Leistungsberechnung (P, PF) |
| UI2 | 2 | ja | Zwei unabhängige Lasten auf derselben Phase (Hauptzuleitung + ein großer Verbraucher) |
| UI3 | 3 | ja | Drei unabhängige Lasten auf derselben Phase |
| I1 | 1 | nein | Sub-Zähler ohne Leistungsberechnung (nur Strom) |
| I2 | 2 | nein | Zwei Sub-Zähler oder eine Dual-CT-Topologie auf einer Leitung |
| I3 | 3 | nein | Drei Sub-Zähler oder Dual-CT + ein dritter Stromkanal |
Was jeder Kanal misst
- U-Kanal (nur UI): U_rms, U_peak, Frequenz. Ein* je Modul.
- I-Kanäle (alle SKUs): jeder Kanal einzeln — I_rms, I_peak, P (Wirkleistung), PF, avg_p pro Periode.
- I-Varianten: I1/I2/I3 haben keinen U-Kanal — die Berechnung von P/PF ist auf dem Gerät nicht möglich (nur I_rms je Kanal).
- Einphasiges Modul: die Ströme UI2/I2/I3 sind einphasig. Alle I-Kanäle müssen auf derselben Phase liegen (bei I-Varianten ebenso auf derselben Phase, wenn Sie P masterseitig korrekt berechnen wollen).
Kanalweises CT-Modell — unabhängige Kalibrierung
Bei UI2, I2 und I3 hat jeder Stromkanal eine unabhängige Auswahl des SCT-013-Modells. Sie können zum Beispiel eine SCT-013-005 an Kanal 0 (eine einzelne Steckdose), eine SCT-013-030 an Kanal 1 (eine Herdleitung) und eine SCT-013-020 an Kanal 2 (eine mittlere Einspeisung — nur I3) anschließen.
Die API für die kanalweise Auswahl ist dev.set_ct_model_ch(channel, code):
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # once for all channels
# Binding order does NOT matter.
dev.set_ct_model_ch(0, 1) # channel 0: SCT-013-005
dev.set_ct_model_ch(1, 3) # channel 1: SCT-013-030
dev.set_ct_model_ch(2, 6) # channel 2: SCT-013-020 (I3 only)
✅ Die Reihenfolge der Kanalbindung spielt keine Rolle. Das Schreiben von REG_CT_MODEL (0x05) legt den Wert nur bereit, wendet ihn aber nicht mehr automatisch auf ch0 an. Angewendet wird nur über CMD_SET_CT_MODEL_CHn. Dadurch können Sie die Kanäle in beliebiger Reihenfolge konfigurieren — ohne Überschreiben.
Die Einzelargument-Form dev.set_ct_model(code) ist eine Komfortform für Einkanal-SKUs (angewendet auf Kanal 0). Bei Mehrkanalmodulen entspricht sie dev.set_ct_model_ch(0, code).
Erweiterte Einrichtung: zwei Zangen unterschiedlicher Nennwerte an einer Leitung
⚙ Ein zusätzliches Muster, nicht das Grundmuster. Dieser Abschnitt beschreibt eine optionale Technik, um die Auflösung bei kleinen Strömen zu verbessern. Für die meisten Installationen reicht eine Zange, die zum Lastbereich passt. Verwenden Sie Dual-CT nur, wenn Sie eine bestimmte Genauigkeitsanforderung bei Strömen unter 1 A haben.
Wann es gilt
- Mehrkanal-Module UI2 / I2 / I3 (mindestens 2 I-Kanäle).
-
Dieselbe Leitung muss sowohl für kleine Lasten (≤ 1 A) als auch für Spitzenereignisse (≥ 5 A) mit gleicher Qualität gemessen werden.
-
Ein typisches Beispiel: ein Wohnungshauptanschluss, an dem tagsüber 50–100 W Bereitschaftsleistung anliegen und abends ein Wasserkocher oder Herd mit einem Einschaltstoß von 3+ kW.
Die Idee
Zwei SCT-013-Zangen mit unterschiedlichen Nennwerten werden am selben Leiter angebracht:
-
Kanal 0 — die kleine Zange (z. B. SCT-013-005, 5 A): erfasst kleine Ströme mit besserer Auflösung und geringerem Grundrauschen.
-
Kanal 1 — die große Zange (z. B. SCT-013-030 oder höher): verarbeitet Ströme oberhalb des Überlastpunkts der kleinen Zange, ohne zu übersteuern.
Der Master wählt den Kanal je nach aktuellem Strom selbst — solange der kleine Wandler in seinem linearen Bereich liegt, ist sein Messwert genauer; wird dieser überschritten, schaltet er auf den großen.
Konfiguration (reihenfolgeunabhängig)
Zuerst die Sensorklasse einmal, dann die Modelle je Kanal in beliebiger Reihenfolge. Bei aktueller Firmware bewirkt das Schreiben von REG_CT_MODEL (0x05) nur ein Staging des Wertes; die Bindung an einen bestimmten Kanal erfolgt ausschließlich über den kanalweisen Opcode CMD_SET_CT_MODEL_CHn. Die auf Firmware v1.2 nötige Legacy-Umgehung „absteigende Reihenfolge“ ist nicht mehr nötig.
dev.set_sensor_class(RbAmpSensorClass.SCT_013) # once
# Any order is valid — each call binds its own channel.
dev.set_ct_model_ch(0, 1) # ch0 = SCT-013-005 (0..5 A)
dev.set_ct_model_ch(1, 3) # ch1 = SCT-013-030 (0..30 A)
Endzustand: ch0 = SCT-013-005, ch1 = SCT-013-030. ✓
Aggregationslogik auf der Masterseite
Das einfachste Muster ist, bei einer Schwelle umzuschalten:
import math
def read_combined_current(dev):
"""Read the combined current — picks low-CT when in its linear range,
otherwise falls back to the high-CT.
"""
i_low = dev.read_current(0) # the small clamp
i_high = dev.read_current(1) # the large clamp
# While the small clamp is far from saturation, it gives better
# accuracy at low currents. Switch to the large one when
# approaching the overload point.
#
# The 4.5 A threshold for SCT-013-005 is an example value;
# pick the switch-over point for your own installation.
if not math.isnan(i_low) and i_low < 4.5:
return i_low
return i_high
⚙ Zwei-CT-Werte. Werte für den Einsatz zweier Zangen bei kleinen Strömen werden nicht veröffentlicht (Verhalten in der Nähe der Schwelle, Temperaturdrift, Abweichung der beiden Zangen im überlappenden Bereich). Behandeln Sie die Doppel-CT-Anordnung als Pilotmuster; für kritische Anwendungen ist eine einzelne Zange vorzuziehen, die auf das obere Ende des Lastbereichs abgestimmt ist.
Ansätze zur Verbesserung der Empfindlichkeit bei kleinen Strömen
Hat Ihre Last einen großen Dynamikbereich (zum Beispiel 1 W Bereitschaftsleistung eines Routers gegenüber einem 2000-W-Warmwasserbereiter an derselben Steckdose), verliert eine einzige Zange, die für die Obergrenze bemessen ist, die niedrigen Ströme im Rauschen.
Drei Strategien in aufsteigender Komplexität:
-
Dimensionieren Sie den CT auf den größten erwarteten Strom (die Regel oben). Der häufigste Fehler ist ein SCT-013-100 (100 A) an einer Haushaltssteckdose mit typischem Verbrauch von 0.5–10 A. Das Signal liegt dann in den unteren 1–10 % des Eingangsbereichs — dort wird das Rauschen mit dem Signal vergleichbar. Für ein Haushaltsszenario (16-A-Steckdose) ist der SCT-013-030 optimal; zum Anschluss eines einzelnen Geräts (≤ 5 A) der SCT-013-005.
-
Dual-CT-Topologie (erfordert eine UI2/UI3-SKU): ein kleiner Wandler für den unteren Bereich und ein großer für den oberen; der Master wählt über eine Schwelle. Siehe den Abschnitt „Dual-CT-Topologie“ oben — das Muster ist ein Pilotmuster; Messwerte für Dual-CT bei kleinen Strömen werden nicht veröffentlicht.
-
Das Rauschniveau wird auf der Werksseite behandelt. Auf Anwenderseite ist nichts weiter zu tun als
set_sensor_class()+set_ct_model(). Messwerte für den Dual-CT-Einsatz bei kleinen Strömen werden nicht veröffentlicht.
Produktions- vs. Werkmodus (Referenz zur Persistenz)
Das rbAmp-Modul arbeitet in zwei Modi, die sich darin unterscheiden, was genau im Flash gespeichert wird.
| Befehl (Opcode) | Produktion | Speichert dauerhaft |
|---|---|---|
CMD_SAVE_USER_CONFIG (0x32) |
✅ OK | ct_model / sensor_class / CT je Kanal / fleet_config / group_id / label |
CMD_COMMIT_ADDR (0x30, magisch scharf geschaltet) |
✅ OK | I²C-Adresse (Zwei-Phasen-Übernahme der Adresse, siehe 04 · Verdrahtung) |
CMD_RESET (0x01) |
✅ OK | — (Software-Reset) |
CMD_LATCH_PERIOD (0x27) |
✅ OK | — (Periodensnapshot) |
CMD_CLEAR_ERROR |
✅ OK | — |
CMD_SAVE_GAINS (0x26) |
❌ GESPERRT in der Produktion (liefert DEV_ERR_PARAM; ein Neustart setzt zurück) — nur werkseitig |
Verstärkungen / NF / Phase (Werkskalibrierung) |
CMD_FACTORY_RESET |
❌ GESPERRT in der Produktion | — |
Im Produktionsmodus werden Schreibvorgänge der Werkskalibrierung von der Firmware abgewiesen — Schutz davor, die Werkskoeffizienten versehentlich zu löschen.
. Der Produktionsschutz nimmt den Schreibvorgang in den RAM an (ein späteres Lesen liefert den geschriebenen Wert), das Speichern im Flash kann aber abgewiesen werden. Die einzig gültige Bestätigung der Persistenz ist ein Neustart des Moduls über CMD_RESET und ein erneutes Lesen:
dev.set_ct_model(code)
dev.reset() # CMD_RESET 0x01, works in production
time.sleep(0.3) # boot complete (300 ms)
check = dev.read_reg(0x05)
assert check == code # ONLY now is persistence confirmed
Die Adresse ist eine Ausnahme: REG_I2C_ADDRESS liest beim Booten die aktive Adresse. Nach dem Staging echoes es den Kandidaten, bis CMD_COMMIT_ADDR + Reset.
Querverweis: 09 · API-Referenz — Details zu einzelnen Opcodes, 10 · Fehlerbehebung — was zu tun ist, wenn die Speicherung nicht bestätigt wird.
Was als Nächstes kommt
-
04 · Verdrahtung — physische Anbindung der Zange, Pfeilausrichtung, Polarität L/N
-
05 · Schnellstart — das vollständige Erstlicht-Skript für beide Backends
-
06 · Beispiele — Arbeitsszenarien für verschiedene Anwendungsfälle
-
10 · Fehlerbehebung — was zu tun ist, wenn die Messwerte merkwürdig aussehen (negativer PF, instabiler Strom usw.)
Quelle & Probleme: rb-amp/rbamp-python · diese Seite im Repository: docs/03_sensor_selection.md (v1.6.1)