03 · Auswahl des Stromsensors
rbAmp misst den Strom über eine externe CT-Zange (Stromwandler) und die Spannung über einen eingebauten Spannungswandler (bei UI*-SKUs). Dieses Kapitel erklärt, wie Sie die Zange für Ihre Last wählen und dem Modul über YAML mitteilen, welches Modell installiert ist.
Sensorfamilie (sensor_class:)
Die Hardware-Revision des Moduls bestimmt, welche Stromsensor-Familie unterstützt wird. Bei aktuellen SKUs ist nur eine verfügbar:
| Klasse | YAML-Wert | Zustand |
|---|---|---|
| SCT-013 (Split-Core-CT) | SCT_013 |
Jetzt verfügbar, Standard |
| WIRED_CT (Modul mit eigenem fest verbautem Wandler) | WIRED_CT |
Werkseitig gepaart: zusammen mit seinem Sensor kalibriert |
| BUILTIN_CT (Modul mit eingebautem Sensor) | BUILTIN_CT |
Werkseitig gepaart: zusammen mit seinem Sensor kalibriert |
Die Klasse wird einmal gesetzt und im Flash des Moduls gespeichert:
rbamp:
id: meter1
sensor_class: SCT_013 # defaults to SCT_013, can be omitted
Bei Firmware v1.2+ wird dieser Wert zur Voraussetzung für das Schreiben des CT-Modells: Das Modul verweigert es, wenn die Klasse nicht gesetzt ist. Die Komponente schreibt nie eine Klasse, die das Modul bereits hat.
Schreibschutz: Lesen-Vergleichen-Schreiben (v1.3+) und Werksschutz (v1.8.1+)
Beim Start liest die Komponente die aktuelle Sensorklasse des Moduls und vergleicht sie mit dem im YAML angeforderten Wert. Stimmen sie überein, findet das Schreiben in den Flash nicht statt (ein Schreiben der Klasse auf dem Modul würde auch die Kanalmodelle löschen, daher wird ein unveränderter Wert nie neu geschrieben). Das bedeutet:
-
Der YAML-Block kann
sensor_class: SCT_013dauerhaft behalten — ein erneuter Start löst kein Löschen des Flash aus (~0 ms statt ~700 ms). -
Der alte Rat,
sensor_class:nach dem ersten Start aus dem YAML zu entfernen, ist überholt — die Konfiguration ist idempotent.
Dasselbe Verhalten gilt für ct_model: / ct_models: (siehe unten).
Werkseitig gepaarte Module (WIRED_CT / BUILTIN_CT). Ein Modul, das zusammen mit seinem eigenen eingebauten Sensor geliefert wird, ist als Paar mit diesem Sensor kalibriert. Die Komponente schützt diese Kalibrierung: Eine Änderung von sensor_class: oder ct_model: aus dem YAML bei einem solchen Modul wird mit einer expliziten Protokollzeile verweigert (der Schreibvorgang würde die individuelle Kalibrierung durch eine generische Einstellung ersetzen). Lassen Sie bei diesen Modulen beide Schlüssel aus dem YAML heraus. Für SCT-013-Klemmen (SCT_013, der Standard) funktionieren die Schlüssel wie unten beschrieben.
Wahl des SCT-013-Modells
Das Modul akzeptiert jedes der sieben Modelle der SCT-013-Reihe. Ihre elektrische Ausgabe unterscheidet sich, daher muss das Modul wissen, welches eingebaut ist — die Werkskoeffizienten werden für das jeweilige Modell geladen.
Welches Modell habe ich? Lesen Sie die Nennstufe vom Etikett am Klemmenkörper ab: SCT-013-030 bedeutet 30 A, also schreiben Sie ct_model: SCT_013_030. Nehmen Sie das Modell, dessen Nennwert zum Etikett passt, nicht das, das Ihrer Last „am ähnlichsten aussieht“.
| Code | YAML-Name | Nennstrom | Typische Last | Maximum bei 230 V | v1.3-Status |
|---|---|---|---|---|---|
| 1 | SCT_013_005 |
5 A | LED-Beleuchtung, einzelne Geräte, Laptops | ca. 1.15 kW | Produktion |
| 2 | SCT_013_010 |
10 A | Desktop-PCs, kleine Klimaanlage, einzelner Stromkreis | ca. 2.3 kW | Produktion |
| 6 | SCT_013_020 |
20 A | Warmwasserbereiter, mittlere Abzweige, ~3–5 kW | ~4.6 kW | Produktion |
| 3 | SCT_013_030 |
30 A | Messung des gesamten Hauses bei typischem Verbrauch | ca. 6.9 kW | Produktion (Standard-SKU) |
| 4 | SCT_013_050 |
50 A | E-Auto-Ladung, große Klimaanlage, Induktionsherd | ca. 11.5 kW | Produktion |
| 7 | SCT_013_060 |
60 A | Industrielle Unterzähler, große Abzweige | ca. 13.8 kW | Produktion |
| 5 | SCT_013_100 |
100 A | Hauptanschluss, große Einspeisungen | ca. 23 kW | Produktion |
SCT_013_060 (60 A) und SCT_013_100 (100 A) werden akzeptiert; wählen Sie die Klemme, deren Nennwert zu Ihrem Maximalstrom passt.
Der Bürdenwiderstand ist bereits auf der Modulplatine verbaut — zwischen den Ausgangsleitungen der Zange müssen keine externen Widerstände ergänzt werden.
Auswahlbaum
Allgemeine Regel: Wählen Sie die Klemme mit der niedrigsten Nennstufe, deren maximal messbarer Wert die Spitzenlast mit ca. 30 % Reserve abdeckt. Eine überdimensionierte Klemme an einer kleinen Last senkt die Signalamplitude relativ zum Rauschen — die Genauigkeit sinkt. Eine Klemme unterhalb der Spitzenlast sättigt den Magnetkern und liefert grob falsche Werte.
Klassenspezifische CT-Validierung (neu in v1.3)
Der Schema-Validator _validate_ct_model_per_class lehnt ungültige Kombinationen aus sensor_class: × ct_model: bereits in der Phase esphome config ab, vor Flash und Start. Die erlaubten Mengen sind nicht zusammenhängend — das ist ausdrücklicher Kanon, kein Fehler:
| sensor_class | Erlaubte Codes | YAML-Namen | Verhalten bei Abweichung |
|---|---|---|---|
SCT_013 |
{1, 2, 3, 4, 5, 6, 7} | SCT_013_005/010/030/050/100/020/060 |
cv.Invalid mit einem Hinweis |
WIRED_CT |
{1–10, 12} | WIRED_CT_ |
cv.Invalid |
BUILTIN_CT |
{} (keine) | — | cv.Invalid (jedes ct_model wird abgewiesen) |
UNSET |
{} | — | cv.Invalid (Klasse nicht gesetzt) |
Specifically:
-
SCT_013nicht zusammenhängend: Die akzeptierten Codes sind{1, 2, 3, 4, 5, 6, 7}(SCT_013_005,_010,_030,_050,_100,_020,_060); die Codereihenfolge entspricht nicht der Nennwertreihenfolge. -
WIRED_CTist die Klasse der Module, die mit ihrem eigenen fest verbauten Wandler geliefert werden; das Schema akzeptiert dafür die Codes 1/2/3. Das Modul ist werkseitig mit diesem Sensor kalibriert, daher verweigert die Komponente, Klasse oder Modell daran zu ändern (siehe den Hinweis zu werkseitig gepaarten Modulen oben). -
BUILTIN_CTist die Klasse der Module mit eingebautem Sensor;ct_model:wird weder benötigt noch vom Schema akzeptiert. Die Deklaration vonBUILTIN_CTohne passende Hardware ist sinnlos.
Rutscht das YAML am Validator vorbei (altes Schema + neue Firmware, manuelle Übersteuerung), liefert die Firmware REG_ERROR = 0xFE DEV_ERR_PARAM — das Modul schreibt keinen nicht unterstützten Code: Es meldet DEV_ERR_PARAM, und die Spiegel bleiben beim vorherigen Wert.
Wie Sie das Modul erkennen
Es gibt zwei Schlüssel im YAML — Sie wählen je nach dem, ob alle Kanäle dieselbe Klemme haben oder unterschiedliche. Der syntaktische Übergang ist von einem skalaren Wert zu einer YAML-Liste (Array):
Schritt 1 — eine Zange für alle Kanäle (ct_model:, Skalar)
Wenn Sie ein UI1 (ein Stromkanal) oder ein UI3 mit identischen Klemmen an allen drei Kanälen haben — eine Zeile:
rbamp:
id: meter1
ct_model: SCT_013_030 # ← scalar value, one model for all channels
Das ist der häufigste Fall. Die meisten Installationen beginnen mit einem einzigen Klemmenmodell und gehen nie über diese Linie hinaus.
Schritt 2 — verschiedene Zangen auf verschiedenen Kanälen (ct_models:, Liste)
Wenn Sie ein UI2 / UI3 haben und verschiedene Zangen an die Kanäle hängen möchten (zum Beispiel eine kleine Zange an einer Standby-Leitung, eine große an der Netzeinspeisung) — ersetzen Sie ct_model: durch ct_models: (mit abschließendem s) und verwenden eine YAML-Liste in eckigen Klammern:
rbamp:
id: meter_ui3
ct_models: [SCT_013_005, SCT_013_030, SCT_013_020]
# ↑ ↑ ↑
# channel 0 channel 1 channel 2
#
# This is a standard YAML list (1..16 elements; only as many as the module has channels are applied).
# Order matters: the position in the list = the channel index.
# Mixed codes such as [1, 3, 6] are each kept on their own channel.
Hier stolpern Leute beim Ändern von Mehrkanal-Systemen am häufigsten. Denken Sie daran: ct_model: (ohne s) ist ein skalarer Wert für ein einziges Modell; ct_models: (mit s) ist eine Liste von Werten in eckigen Klammern, einer pro Kanal. Angewendet werden nur so viele Einträge, wie das Modul Kanäle hat (1 bei UI1, 2 bei UI2, 3 bei UI3); zusätzliche Einträge werden mit einer Warnung ignoriert.
Kanalweise Modelle werden nur von Modulen gespeichert, die sie über einen Stromausfall hinweg behalten. Speichert das angeschlossene Modul sie nicht, verweigert die Komponente laut (Warnung, Schlüssel werden ignoriert), statt einen Wert zu schreiben, der sich still zurücksetzen würde — verwenden Sie dort das einzelne ct_model:.
⚠ Gegenseitig ausschließend. Wenn ct_model: UND ct_models: gleichzeitig deklariert werden, ist das ein Schema-Validierungsfehler (cv.Invalid). Verwenden Sie nur einen der beiden.
Eine UI3-Installation mit unterschiedlichen Klemmengrößen
Das kanonische Szenario für ein Haus mit eigener Erzeugung oder mit gemischten Lasttypen:
- Kanal 0 — kleine Verbraucher (LED-Beleuchtung, Standby-Betrieb, Elektronik). Eine SCT_013_005-Zange (5 A) liefert maximale Auflösung bei kleinem Strom.
- Kanal 1 — Hauptlasten (Kochfeld, Warmwasserbereiter). Eine SCT_013_030-Zange (30 A) deckt die typische Haushalts-Spitzenlast ab.
- Kanal 2 — ein Zweig mit mittlerer Leistung (Warmwasserbereiter, ~3–5 kW). Eine SCT_013_020-Klemme (20 A) ist der optimale Kompromiss zwischen Genauigkeit und Reserve für einen typischen Unterzähler.
In einem einzelnen YAML-Block rbamp: genügt es, Folgendes zu deklarieren:
rbamp:
id: home_meter
ct_models: [SCT_013_005, SCT_013_030, SCT_013_020]
sensor:
- platform: rbamp
rbamp_id: home_meter
voltage:
name: "Mains Voltage"
current:
name: "Lighting Current" # SCT_013_005, channel 0
current_1:
name: "Appliances Current" # SCT_013_030, channel 1
current_2:
name: "Boiler Current" # SCT_013_020, channel 2
# ...power_0/_1/_2, energy_0/_1/_2 likewise
Die Komponente selbst weist jedem Kanal beim Start das exakte Modell zu.
Was der Schlüssel im Hintergrund bewirkt
Ab Firmware v1.2 lädt das atomare Schreiben von ct_model: / ct_models: die werkseitigen Koeffizienten (Rauschboden + Verstärkung) für das gewählte Modell in den RAM des Moduls und speichert sie im Flash. Auf Ihrer Seite sind keine weiteren Kalibrierschritte nötig — das Modul wird werkseitig mit allen erforderlichen Koeffiziententabellen ausgeliefert.
Bei älterer Firmware wird der Wert als Modellmarkierung gespeichert.
Lesen-Vergleichen-Schreiben (v1.3+) — warum der Start jetzt „sofort“ ist
Beim Start liest die Komponente v1.3 die aktuellen REG_CT_MODEL_CH0/1/2 (spiegeln 0x51–0x53) und vergleicht sie mit den im YAML angeforderten Werten. Stimmen sie überein, wird der Flash-Schreibvorgang vollständig übersprungen.
| Startszenario | v0.4.0 (immer schreiben) | v1.3 (Lesen-Vergleichen-Schreiben) |
|---|---|---|
| Konfiguration bereits übernommen (Spiegel stimmen überein) | ~700 ms × N Kanäle Flash-Löschung | 0 ms (nur I²C-Rücklesen) |
| Konfiguration geändert (ein Modell) | ~700 ms | ca. 700 ms (nur Delta) |
| UI3 mit drei verschiedenen Modellen (Kaltinstallation) | ~2.8 s Stromausfall | ca. 2.1 s (3 × 700 ms + Prüfung) |
| UI3 mit denselben Modellen (Warmstart) | jedes Mal ca. 2.8 s Stromausfall | ~0 ms |
In der Praxis: ct_model: / ct_models: dauerhaft im YAML belassen — die Konfiguration ist idempotent und belastet den Flash bei wiederholten Starts nicht.
Der Wechsel des SCT-Nennwerts erhält die Genauigkeit
Bei einem STD-Modul ist ct_model nur eine Bezeichnung und setzt keine Verstärkung. Der Rest dieses Abschnitts beschreibt BASIC-Module.
Jedes SCT-Modul ist werkseitig mit dem SCT-013-030 kalibriert. Wählen Sie eine andere Nennstufe (z. B. ct_model: SCT_013_010), bleiben Strom, Leistung und Energie genau — die werkseitige Kalibrierung je Einheit bleibt erhalten:
-
Bei Modul-Firmware bis 1.4.19 schließt die Komponente das Schreiben des Modells mit dem Modul-Neustart ab, den das Verfahren erfordert (speichern, zurücksetzen, erneut erkennen), und skaliert Strom, Wirk- und Blindleistung sowie Energie auf den gewählten Sensor anhand der tatsächlich angewendeten Verstärkung des Moduls. Der Neustart erscheint im Log und ist normal; Sensoren können einen Zyklus auslassen. Ein späterer Neustart des Moduls (Ihrer oder externer Auslöser) wird erkannt, und die Skalierung wird automatisch neu berechnet.
-
Bei neuerer Firmware (1.4.20+) führt das Modul den Wechsel selbst durch; die Komponente erkennt dies und lässt die Messwerte unverändert (reines Modell-Schreiben, kein Neustart).
-
Spannung und Leistungsfaktor sind nicht betroffen.
- Weicht die von dem Modul angewendete Verstärkung um mehr als ±5 % vom erwarteten Wert ab, protokolliert die Komponente eine Warnung und skaliert nicht.
Dafür ist keine YAML-Änderung nötig.
Bindung über mehrere Kanäle
Die Komponente bindet die Kanäle nacheinander; die Reihenfolge spielt keine Rolle. Gemischte Modelle an einem Modul (z. B. die Codes [1, 3, 6] an einem Dreikanal-Modul) bleiben jeweils auf ihrem eigenen Kanal.
Die Komponente selbst füttert den Watchdog (App.feed_wdt()) während jedes Flash-Schreibfensters — das übliche setup()-Budget von ESPHome von 15 s wird selbst bei einer UI3-Erstinstallation nicht überschritten.
Überprüfung der Installation
Prüfen Sie nach dem ersten Start die Messwerte an einer rein ohmschen Last — einer Glühlampe, einem Wasserkocher, einem Heizelement. Eine ohmsche Last liefert eine bekannte Signalform:
- Der Leistungsfaktor (
power_factor) sollte nahe 1.00 liegen (dauerhaft > 0.95). - Die Wirkleistung (
power) sollte positiv und stabil sein. - Der Effektivstrom (
current) sollteP / Umit vernünftiger Genauigkeit entsprechen.
Wenn die Messwerte nicht zusammenpassen:
currentbleibt bei laufender Last ständig ~0 → Polarität prüfen und ob die Zange genau einen Leiter umschließt (siehe unten)powerdurchgehend negativ → Klemme am Leiter umdrehen (Pfeil in die andere Richtung)power_factor~0.5..0.7 an einer Glühlampe → vielleicht gibt es eine induktive Last in der Nähe, oder die Zange ist falsch montiert
Detaillierte symptomorientierte Diagnose finden Sie in 10_troubleshooting.md.
Polarität der CT-Zange
Das Zangengehäuse trägt einen Pfeil, der die Richtung des „normalen“ Energieflusses zeigt (Verbrauch, zur Last hin). Bei korrekter Montage (Pfeil zeigt in Stromrichtung zur Last):
P_real > 0— Verbrauch.P_real < 0— Export (nur STANDARD (STD)).
Ist die Wirkleistung negativ, während ein Verbraucher läuft, drehen Sie die Zange physisch am Leiter um. Korrigieren Sie die Polarität nicht in der Software: Das verdeckt Richtungsfehler in nachgelagerten Automationen.
Die Zange muss sich vollständig um einen einzigen Leiter schließen. Führen Sie weder L noch N gemeinsam durch eine Zange — ihre Magnetfelder heben sich auf, und der Sensor zeigt nahezu null an.
Spannungskanal
UI*-SKUs enthalten einen eingebauten Spannungswandler. Die Primärwicklung liegt über die Klemmenblöcke des Moduls an Netz L und N, und das Modul misst sie intern.
Die werkseitige Konfiguration des Wandlers ist auf der Platinenrevision festgelegt — der Nutzer hat hier nichts einzustellen. Der Sensor voltage ist sofort einsatzbereit.
Nur-I-SKUs (I1 / I2 / I3) haben keinen Spannungskanal. Der Slot voltage liefert auf ihnen 0 und darf nicht zusammen mit power: oder energy: deklariert werden (der Schema-Validator prüft diese Abhängigkeit).
Module mit mehreren Kanälen
Bei UI2 / UI3 ist jeder Kanal ein eigener, unabhängiger Messkreis, kein gemeinsamer Magnetkern. Das erlaubt Ihnen:
- Ein einziges CT-Modell für alle Kanäle setzen (
ct_model:) — die typische Konfiguration für gleichmäßige Lasten. - Verschiedene Modelle auf verschiedene Kanäle legen (
ct_models:) — um die Genauigkeit bei gemischten Installationen zu optimieren (siehe oben). - Widmen Sie einen Kanal dem Verbrauch und einen anderen dem Solar-Export — die Polarität jedes Kanals wird unabhängig durch die physische Richtung der Zange festgelegt.
Wie es weitergeht
- 04_hardware.md — physische Verdrahtung, GPIO-Auswahl, der Bus mit mehreren Modulen
- 05_quickstart.md — erster Start in 5 Minuten mit bereits konfigurierter Klemme
- 10_troubleshooting.md — symptomorientierte Installationsdiagnose
Quelle & Probleme: rb-amp/rbamp-esphome · diese Seite im Repo: docs/03_sensor_selection.md (v1.9.1)