rbAmp
DE
Shop
Docs
Aktualisiert · Auf GitHub bearbeiten (Edit on GitHub)

03 · Auswahl des Stromsensors

Zangeninstallation: Der CT umschließt nur den L-Draht, mit dem Pfeil zur Last hin

Dieses Kapitel beantwortet zwei Fragen:

  1. Welchen Stromsensor Sie für eine bestimmte Last wählen.
  2. 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
Hinweis

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

Auswahl einer SCT-013-Zange: Nehmen Sie den größten erwarteten Strom plus eine 30-%-Reserve, wählen Sie die kleinste Nennzange darüber und stellen Sie dann deren Modellcode ein.

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:

Text
REG_SENSOR_CLASS is UNSET;
call dev.set_sensor_class(RbAmpSensorClass.SCT_013) first
Hinweis

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.

Python
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:

Python
dev.set_sensor_class(RbAmpSensorClass.SCT_013)  # explicit enum form
dev.set_sensor_class(1)                          # numeric (equivalent)
Hinweis

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] (oder dev.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.

Hinweis

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():

Python
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 stabil
  • PF ≈ 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):

Python
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)
Hinweis

✅ 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

Hinweis

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

Python
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:

Python
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 Zangen unterschiedlicher Nennwerte auf demselben L-Draht, beide Pfeile zur Last hin

Hinweis

⚙ 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:

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

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

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

Rücklesen ≠ Persistenz

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

Python
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)