05 · Störungsbehebung
Dieses Kapitel ist eine Kurzreferenz für häufige Probleme und ihre Lösungen. Jeder Eintrag folgt dem Aufbau:
- Symptom — was der Anwender beobachtet
- Ursachen — warum es auftreten kann
- Was zu prüfen bzw. zu tun ist— konkrete Aktionen
I²C-Bus
1. NACK / keine Antwort vom Modul
Symptom: Wire.endTransmission() liefert einen Wert ungleich null; i2cdetect zeigt die Adresse unter Linux nicht an; rb_read_u8() liefert 0xFF.
Ursachen und Prüfungen:
- ❌ Modulversorgung fehlt oder ist instabil — messen Sie VCC mit einem Multimeter; er muss im Bereich 4.5…5.5 V liegen.
- ❌ Keine gemeinsame Masse — der mit Abstand häufigste Fehler. Master-GND und Modul-GND müssen verbunden sein.
- ❌ SDA und SCL vertauscht — mit dem Verdrahtungsplan in hardware-connection.md abgleichen.
- ❌ Keine Pull-ups am Bus — wenn die eingebauten Pull-ups auf einem Modul getrennt wurden und keine externen installiert sind, ist der Bus tot. Messen Sie bei allen unbestromten Geräten SDA↔VCC: Der Wert muss 1.5–4.7 kΩ betragen.
- ❌ Zu viele Pull-ups parallel — eingebaute Pull-ups sind bei vielen Modulen (vier oder mehr) noch aktiv, dazu die Master-Pull-ups; der Ersatzwiderstand sinkt unter etwa 1 kΩ. Der Master kann den Bus nicht auf LOW ziehen. Die eingebauten Pull-ups an allen bis auf ein Modul entfernen.
- ❌ Langes Kabel ohne verdrillte Doppelader oder Puffer — ab etwa 0.15 m koppeln parallele Leitungen kapazitiv und die Flanken werden abgerundet. Verwenden Sie UTP Cat-5 (bis 1 m) oder einen PCA9515-Puffer (bis 3 m). Siehe hardware-connection.md → Buslänge.
- ❌ Falsche Slave-Adresse — das Modul wurde möglicherweise neu adressiert. Führen Sie einen I2C-Scan durch:
void i2c_scan() {
for (uint8_t addr = 0x08; addr < 0x78; addr++) {
Wire.beginTransmission(addr);
if (Wire.endTransmission() == 0) {
Serial.printf("Found device at 0x%02X\n", addr);
}
}
}
- ❌ I²C-Takt für die Kabellänge zu hoch. Auf 50 kHz senken:
Wire.setClock(50000);.
2. Zeitüberschreitungen beim Lesen/Schreiben mit Unterbrechungen
Symptom: Transaktionen gelingen manchmal, schlagen manchmal fehl — besonders in elektrisch gestörter Umgebung oder nahe induktiven Lasten.
Causes:
- ❌ Langes Kabel ohne verdrillte Doppelleitung
- ❌ Kabel parallel zur Netzverdrahtung verlegt → Kopplung bei 50 Hz / 100 Hz
- ❌ Verrauschte Masse auf der Master-Seite (z. B. ein separater Regler ohne Stützkondensator)
- ❌ Streukapazität zwischen SDA und GND > 100 pF (z. B. eine Verbindung mit langen Stichleitungen)
Solutions:
- Verwenden Sie verdrillte Doppelader (SDA + GND in einem Paar, SCL + GND im anderen)
- I²C-Leitungen nicht parallel zur Netzverkabelung im selben Kabelkanal führen
- Auf 50 kHz senken / 100 nF zwischen VCC und GND des Moduls nahe am Stecker ergänzen
- Bei langen Leitungen außerhalb eines Gehäuses ESD-Schutz hinzufügen (TVS-Dioden an SDA und SCL)
— dieselbe Aufgabe ohne Registerzugriff:
| Bibliothek | Aufruf | Was es tut |
|---|---|---|
| Arduino | RbAmp::retryExhaustionCount() / RbAmp::sanityRejectCount() |
erschöpfte Bus-Wiederholungen und zurückgewiesene Messwerte |
| ESP-IDF | rbamp_retry_exhaustion_count() / rbamp_sanity_reject_count() |
erschöpfte Bus-Wiederholungen und zurückgewiesene Messwerte |
| Python | dev.sanity_reject_count / Zähler von MachineI2CBackend |
zurückgewiesene Messwerte zählen; Wiederholungszähler am MicroPython-Backend |
| ESPHome | — | keine Diagnosezähler verfügbar |
3. DATA_VALID (0xCE) wird nie 1
Symptom: Der Master liest 0xCE und erhält immer 0x00. Andere Register können ebenfalls auf null bleiben.
Causes:
- ❌ Das Modul hat den Start noch nicht abgeschlossen (normal in den ersten ~250 ms nach dem Einschalten)
- ❌ Initialisierungsfehler der Firmware —
REG_ERROR(0x02) lesen: 0xFB(ERR_FLASH_PARAMS_BAD) — der Flash-Parameterblock ist beschädigt; das Modul läuft mit den Standardwerten. Neu kalibrieren / neu provisionieren.0xFA(ERR_LUT_BAD) — die Werkskalibrierungstabelle ist beschädigt. Nicht fatal — Messungen laufen weiter; die Genauigkeit kann vermindert sein. Lassen Sie den Lieferanten neu kalibrieren.- ❌ Ausfall des MCU-Takts (selten) — Modul stromlos schalten und neu starten
Solutions:
- 300 ms nach dem Einschalten warten, bevor
0xCEabgefragt wird. - Wenn
DATA_VALID = 1nach mehr als 1 s nicht erscheint — Modul stromlos schalten und neu starten. - Besteht das Problem nach einem Netz-Aus/Ein weiter — Versorgung prüfen (Welligkeit, Unterspannung).
— dieselbe Aufgabe ohne Registerzugriff:
| Bibliothek | Aufruf | Was es tut |
|---|---|---|
| Arduino | RbAmp::waitReady(timeout_ms) / RbAmp::readLastError() |
auf das Bereit-Flag warten; den Gerätefehlercode lesen |
| ESP-IDF | rbamp_wait_ready() / rbamp_read_last_error() |
auf das Bereit-Flag warten; den Gerätefehlercode lesen |
| Python | dev.wait_ready(timeout_ms=1000) / dev.read_last_error() |
auf das Bereit-Flag warten (bei Zeitüberschreitung Fehler); den Gerätefehlercode lesen |
| ESPHome | update()-Bereitschaftsprüfung / get_last_error_str() |
Messwerte werden veröffentlicht, sobald das Modul Bereitschaft meldet; der Fehlercode als Text |
Kalibrierung und Genauigkeit
4. I_rms nahe 0, während eine Last läuft
Symptom: Die Lampe leuchtet, der Heizer ist warm, aber I_rms zeigt 0.001 A oder schwankt zwischen 0 und einigen mA.
Ursachen (in absteigender Häufigkeit):
- ❌ CT-Zange nicht um den Leiter — der Leiter führt an der Zange vorbei statt durch sie hindurch.
- ❌ CT-Zange gleichzeitig auf L und N — die Flüsse von Phase und Neutralleiter heben sich auf, der Sensor zeigt nahezu null. Siehe hardware-connection.md → Stromsensor. Die Zange muss auf einem Leiter sitzen (Phase/L).
- ❌ Zange nicht vollständig geschlossen — ein Spalt von mehr als 0.1 mm zwischen den Kernhälften erhöht den magnetischen Widerstand stark, sodass das Sensorsignal deutlich unter den Normalwert sinkt. Lösen Sie die Zange und drücken Sie sie wieder zu, bis sie einrastet. Schmutz oder Oxid im Spalt ist eine häufige Ursache — wischen Sie die Kontaktflächen ab.
- ❌ Lockere 3.5-mm-Buchse — Stecker abziehen und wieder einstecken.
- ❌
REG_CT_MODELnicht gesetzt — das Modul kennt die Empfindlichkeit des Sensors nicht. Siehe initialization.md → Sensorklasse und CT-Modell setzen. Register0x05muss den richtigen Modellcode enthalten. - ❌ Falsches Modellkennzeichen geschrieben — zum Beispiel ein SCT-013-030-Sensor mit dem Code von SCT-013-010 → der angezeigte Strom ist ~3× niedriger als der tatsächliche (und umgekehrt zeigt ein zu großer Code zu hoch an). Prüfen Sie die Gehäusekennzeichnung des Sensors gegen den Modellcode.
- ❌ Strom unter der Rauschgrenze — bei sehr kleinen Lasten (< ~10 mA an einer 30-A-Zange) liegt das Sensorsignal nahe am Rauschpegel. Die Firmware wendet eine Quadratur-Rauschsubtraktion an:
I_corrected = √(I_raw² − NF²). WennI_raw ≤ NF, wird das Ergebnis auf 0 begrenzt. Das ist beabsichtigtes Verhalten.
5. I_rms um einen großen Faktor falsch
Symptom: Die tatsächliche Last beträgt ~10 A (laut Referenzzähler), das Modul zeigt 3 A oder 30 A.
Causes:
- ❌ Falscher CT-Modellcode — der häufigste Fall. Siehe #4.
- ❌ Falsches CT-Modell installiert — jemand hat eine 100-A-Zange eingebaut, wo die Konfiguration eine 30-A-Zange verlangt (oder umgekehrt).
- ❌ Zange nicht vollständig geschlossen (siehe #4) — typischerweise 5–20 % zu niedrig.
- ❌ Vermuteter Drift der Werkskalibrierung — wenn alle oben genannten Ursachen ausgeschlossen sind und die Abweichung bei einer bekannten Referenzlast bestehen bleibt, wenden Sie sich an Ihren Modullieferanten; eine Neukalibrierung ist ein Werksvorgang.
6. Vorzeichen von P_real ist falsch (Verbrauch wird als Einspeisung angezeigt)
Symptom: Die Last nimmt eindeutig Leistung auf (warmer Heizer, leuchtende Lampe), aber P_real < 0.
Ursachen und Abhilfen:
- ❌ L und N an den Spannungsklemmen vertauscht — die häufigste Ursache. Siehe hardware-connection.md → Spannungssensor. Tauschen Sie L und N auf der Platine.
- ❌ CT-Zange falsch herum montiert — der Pfeil auf der Zange muss in Stromrichtung zur Last zeigen (Schaltschrank → Last). Zeigt er in die andere Richtung, lösen Sie die Zange und setzen Sie sie umgekehrt auf.
- ❌ Physische Umkehrung ist nicht praktikabel — bei BASIC setzt der Periodenakkumulator (
PERIOD_AVG_P_W) negative Abtastwerte auf null, sodass bei vertauschter Polung das Energieregister bis zur Korrektur der physischen Polung auf 0 bleibt — das Negieren im Master-Code (p_corrected = -p_raw) korrigiert nur Ihre eigene RT-Integration, nie die Periodendaten auf dem Modul. Korrigieren Sie die Verdrahtung.
7. Gesamtenergie weicht um einige Prozent von einem Referenzzähler ab
Symptom: E_Wh über eine Stunde weicht vom Versorgerzähler um 2–10 % ab.
Wahrscheinliche Ursachen (in absteigender Reihenfolge):
- ❌ Zange nicht vollständig geschlossen (Spalt) — typischerweise −5 bis −20 % zu niedrig. Die häufigste Ursache überhaupt. Lösen Sie die Zange, reinigen Sie die Kontaktflächen und drücken Sie sie wieder zu, bis sie ganz geschlossen ist.
- ❌ CT-Zange an einem „sekundären“ Leiter angebracht — im Sicherungskasten, an einer kurzen Stichleitung hinter einer Sicherung. Streufelder benachbarter Sicherungen führen zu Fehlern. Bringen Sie die Zange auf die Hauptzuleitung oder auf einen isolierten Leiterabschnitt.
- ❌ Nahe starker Blindlasten — nahe Transformatoren, Asynchronmotoren, USV-Anlagen. Magnetfelder von benachbarten Induktivitäten erzeugen ein Störsignal. Halten Sie die Zange ≥ 10 cm von jedem ferromagnetischen Bauteil entfernt.
- ❌ Niedriger PF (≤ 0.5) — große Blindlasten erfordern eine präzise Phasenkompensation. Die Genauigkeit ist für ohmsche Lasten (PF ≈ 1) angegeben; für stark induktive Lasten ist sie nicht spezifiziert. Wenn die Genauigkeit bei einem bestimmten PF-Profil entscheidend ist, wenden Sie sich an Ihren Modullieferanten.
- ❌ Verzerrte Netzspannung (Kurzzeitabsenkungen, Oberschwingungen hoher Ordnung) — Effektiv- und Mittelwertberechnung sind robuster als Spitzenwerterkennung, für stark verzerrte Netzspannung ist die Genauigkeit jedoch nicht spezifiziert; wenden Sie sich an Ihren Lieferanten, wenn dies für Ihre Installation von Bedeutung ist.
- ❌ Beschädigtes CT-Kabel oder lockere Buchse — Unterbrechung oder kalte Lötstelle im Stecker. Prüfen Sie mit einem Multimeter, bei von der Modulbuchse abgezogenem Stecker (die CT-Zange ist ein Abwärtswandler; die Sekundärwicklung sollte je nach Modell 50–200 Ω messen).
8. avg_P_W ist deutlich niedriger als erwartet
Symptom: Eine 1000-W-Heizung ist eingeschaltet, RT P_real ≈ 1000 W, aber PERIOD_AVG_P_W zeigt über eine Minute Periode ~200 W.
Causes:
- ❌ Die Last ist tatsächlich intermittierend (taktender Thermostat, pulsierendes Heizelement) —
avg_P_Wgibt korrekt den zeitlichen Mittelwert an. Gegenprüfung mitPERIOD_MAX_P_W(0xE0), um die Spitze innerhalb eines Messfensters zu sehen. - ❌ Wenn die Last konstant ist und RT
P_real ≈ avg_P_Wnicht zutrifft: - Bei der BASIC-Stufe: Prüfen Sie das RT-Vorzeichen von
P_real. WennPgelegentlich negativ ist (etwa weil ein Solarwechselrichter einspeist), werden negative Samples ausPERIOD_AVG_P_Wausgeschlossen und ziehen den Mittelwert nach unten. Siehe period-metering.md → BASIC-Stufe.
9. PERIOD_VALID = 0 nach einem Snapshot
Symptom: Der Master sendet CMD_LATCH_PERIOD, liest 0x07 und erhält 0. Der Snapshot ist nicht frisch.
Causes:
- ❌ Schnappschüsse zu dicht beieinander — zwischen zwei Schnappschüssen wurde kein RT-Fenster abgeschlossen (~100 ms ab v1.2; zuvor 200 ms). Der Akkumulator ist leer, der Schnappschuss wird verworfen.
- ❌ Wettlauf mit einem RT-Commit — selten: Der Master hat den Befehl genau in dem Moment geschrieben, in dem die Firmware den Live-Akkumulator committete. Bei sehr schnellen Mastern möglich.
Lösung — das Wiederholungsmuster (siehe period-metering.md → Grundzyklus):
if ((rb_read_u8(0x50, 0x07) & 0x01) == 0) {
delay(250); // let at least one RT window complete
rb_write_u8(0x50, 0x01, 0x27);
delay(50);
// retry read of PERIOD_VALID
}
— dieselbe Aufgabe ohne Registerzugriff:
| Bibliothek | Aufruf | Was es tut |
|---|---|---|
| Arduino | RbAmp::isPeriodValid() / RbAmp::readPeriodSnapshot() |
das Bit „Schnappschuss bereit“ prüfen; einen Periodenschnappschuss nehmen und validieren |
| ESP-IDF | rbamp_is_period_valid() / rbamp_read_period_snapshot() |
das Bit „Schnappschuss bereit“ prüfen; einen Periodenschnappschuss nehmen und validieren |
| Python | dev.is_period_valid() / dev.read_period_snapshot() |
das Bit „Schnappschuss bereit“ prüfen; einen Periodenschnappschuss nehmen und validieren |
| ESPHome | Periodenschnappschuss nicht gültig | was die Komponente protokolliert, wenn das Gültigkeitsflag 0 ist; der erste Snapshot nach dem Start wird verworfen |
Probleme bei mehreren Modulen
10. Adresskollision
Symptom: Mehrere Module wurden am Bus angeschlossen — einige „verschwinden“ oder liefern Müll. Dieselbe Adresse antwortet mit unterschiedlichen Werten.
Ursache: Zwei oder mehr Module haben dieselbe Adresse → I²C-Arbitrierung / Kollision. Tritt häufig direkt nach dem Auspacken auf, wenn alle Module auf der Werkseinstellung 0x50 stehen.
Feinere Form: Die Adresse antwortet stabil, die UID, die bei 0x5C gelesen wird (Kap. 11 §4.8), passt aber zu keinem Ihnen bekannten Modul. Zwei Module antworten gleichzeitig — der Bus verknüpft ihre Ausgänge per Wired-AND zu einer stabilen, aber fiktiven UID. Meldet ein Hub eine „unbekannte UID“ unter einer Adresse, die er vergeben hat, vermuten Sie zuerst eine Adresskollision, bevor Sie ein fremdes Modul vermuten.
Solution:
- Trennen Sie jedes Modul.
- Verbinden Sie einzeln — niemals zwei Module im Werkszustand gleichzeitig am Bus neu adressieren; jedes auf eine eindeutige Adresse umstellen.
- Nach dem Umadressieren aller Module diese parallel anschließen und jede Adresse durch Auslesen ihrer UID prüfen.
Siehe initialization.md → Empfohlener Ablauf.
— dieselbe Aufgabe ohne Registerzugriff:
| Bibliothek | Aufruf | Was es tut |
|---|---|---|
| Arduino | RbAmpFleet::checkConflict() / RbAmpFleet::scan() |
eine Adresse auf ein zweites Gerät prüfen; den Bus nach Modulen absuchen |
| ESP-IDF | rbamp_fleet_check_conflict() / rbamp_fleet_scan() |
eine Adresse auf ein zweites Gerät prüfen; den Bus nach Modulen absuchen |
| Python | fleet.check_conflict(addr) / fleet.scan() |
eine Adresse auf ein zweites Gerät prüfen; den Bus nach Modulen absuchen |
| ESPHome | rbamp:-Liste |
ein Block je Modul, jeweils mit eigener id und address |
11. Wired-OR-DRDY löst in rascher Folge mehrmals aus
Symptom: Bei Wired-OR-DRDY löst der EXTI des Masters alle 1–5 ms mehrmals hintereinander aus.
Ursache: Die Module sind nicht exakt synchronisiert — jedes hat seinen eigenen Quarz, und die RT-Fensterperioden weichen leicht ab (99.9 ms gegen 100.1 ms). Über die Länge des Fensters ziehen die Module die Leitung zu leicht unterschiedlichen Zeitpunkten.
Das ist normal. Lösungen:
- „Doppelte“ Auslösungen ignorieren: Nach dem ersten Auslösen alle Module auslesen; weitere Auslösungen innerhalb von ~10 ms unterdrücken.
- Verwenden Sie den Broadcast-Snapshot (siehe period-metering.md → Ansatz 2) für präzise Synchronisation — aber nur für Periodenschnappschüsse, nicht für RT.
- Auf DRDY pro Modul umstellen — jedes Modul an seinem eigenen GPIO.
12. I²C-Bus belegt, wenn DRDY auslöst
Symptom: DRDY löst aus, während der Master bereits eine Transaktion mit einem anderen Modul abwickelt. Der EXTI-Handler wird verzögert.
Das ist normal. Die RT-Register bleiben bis zum nächsten Commit gültig (ein Fenster, ~100 ms, später). Der Master:
- Beendet die laufende Transaktion.
- Bedient den verzögerten EXTI und liest das nächste Modul.
- Latenz: typisch 1–10 ms — nicht kritisch.
13. Taktdrift mehrerer Module bei langen Tests
Symptom: Die kumulierte Energie weicht zwischen Modulen über eine Woche um Bruchteile eines Prozents ab.
Ursache: Jedes rbAmp hat seinen eigenen Quarz mit ±50 ppm Drift (1–5 s pro Tag).
Lösung — in der Architektur verankert: Der Master verwendet seine eigene Uhr, um mit dt zu multiplizieren. Alle Module teilen dieselbe Zeitreferenz, daher weicht die systemweite Wh-Summe nicht ab.
Um die Chipdrift für die Qualitätssicherung zu prüfen, vergleichen Sie PERIOD_LATCH_MS (0xEC) mit dem dt des Masters:
uint32_t chip_dt = rb_read_u32(0x50, 0xEC);
float ratio = (float)chip_dt / (float)master_dt;
printf("Chip drift: %.3f (1.000 = perfect)\n", ratio);
Akzeptanzschwelle für PERIOD_LATCH_MS: bis zu 30 % Unterzählung unter Last ist normal (Verhältnis bis hinab zu ~0.70). Der interne Diagnose-Zeitbezug des Moduls zeigt bei ausgelastetem Modul zu kurz an — das ist so vorgesehen. Der 30-%-Bereich ist eine Eigenschaft des Zeitbezugs des Moduls, kein Fehler. Diese Schwelle gilt einheitlich für alle SKUs und Stufen.
Die alte 3-%-Schwelle aus früherer Dokumentation ist für v1.3 falsch und verwirft gesunde Module in Massen; verwenden Sie sie nicht.
Dieser Drift betrifft nur das Diagnoseregister auf Chipseite; die Energiegenauigkeit bleibt unberührt, da Wh auf Master-Seite als avg_P × master_dt berechnet wird (siehe period-metering.md). Wandert master_dt selbst (der Takt des Master-Mikrocontrollers driftet), wenden Sie die eigene NTP/SNTP-Korrektur des Masters an — PERIOD_LATCH_MS ist dafür nicht die richtige Referenz.
— dieselbe Aufgabe ohne Registerzugriff:
| Bibliothek | Aufruf | Was es tut |
|---|---|---|
| Arduino | RbAmp::readPeriodLatchMs() |
Periodenlänge auf Modulseite lesen (nur Diagnose) |
| ESP-IDF | rbamp_read_period_latch_ms() |
Periodenlänge auf Modulseite lesen (nur Diagnose) |
| Python | dev.read_period_latch_ms() |
Periodenlänge auf Modulseite lesen (nur Diagnose) |
| ESPHome | — | nicht verfügbar |
Leistung und Flash
14. Stromausfall während eines Flash-Schreibbefehls → teilweise geschriebenes Flash
Symptom: Nach einem Stromausfall während eines Schreibvorgangs in den Flash (CMD_SAVE_USER_CONFIG, CMD_COMMIT_ADDR) startet das Modul mit REG_ERROR = 0xFB (ERR_FLASH_PARAMS_BAD) und gesetztem EVENT_FLAGS.bit3.
Was geschah: Die Firmware erkannte einen CRC-Fehler im Benutzerkonfigurationsblock im Flash, lud die Werkseinstellungen und schrieb sie neu.
Solution:
- Die Werkseinstellungen werden wiederhergestellt — das Modul funktioniert, aber seine eigene Adresse bzw. Sensorkonfiguration ist verloren.
- Konfiguration erneut anwenden:
SENSOR_CLASSsetzen +CT_MODELje Kanal zuordnen +CMD_SAVE_USER_CONFIGausführen (und Adressänderung wiederholen, falls nötig). - Um das künftig zu vermeiden: Trennen Sie die Stromversorgung nach einem Flash-Schreibbefehl mindestens 1 Sekunde lang nicht. Das Fenster für Flash-Löschen und -Schreiben beträgt selbst ~700 ms; planen Sie Reserve ein.
15. Modul ist heiß
Symptom: Das Gehäuse fühlt sich deutlich warm an.
Normal: Bei Netzstrom bis zum Nennwert (je nach SKU) ist eine leichte Erwärmung der NS-Seite (LDO-Regler) bis ca. 40 °C zu erwarten.
Nicht normal: heißes Gehäuse (≥ 60 °C), Brandgeruch, Verfärbung des Kunststoffs.
Causes:
- ❌ Überspannung auf der Niederspannungsseite (VCC > 5.5 V) — Versorgung prüfen.
- ❌ Innenschaden auf der Netzseite (Kurzschluss im Teiler oder im CT-Kreis).
- ❌ Externe CT-Zange überlastet (Strom über dem Messbereich des Sensors).
Maßnahme: Sofort die Stromversorgung trennen, das Modul isolieren, den Lieferanten kontaktieren.
Sensorverdrahtung — kritische Fehler
16. Plausibilitätsprüfung — was „richtig verdrahtet“ bedeutet
Führen Sie nach dem Installieren oder Neuinstallieren eines Moduls einen Funktionstest mit einer bekannten rein ohmschen Last durch (Glühlampe, Wasserkocher, Heizelement) — zum Beispiel eine 100-W-Lampe an 230 V.
Expected:
U_rms ≈ 220..240(je nach lokalem Netz)I_rms ≈ 100 W / 230 V ≈ 0.43 AP_real ≈ +100 W(positiv, Verbrauch)PF ≈ 0.998..1.000(ohmsche Last)Q ≈ 0(kein Blindanteil)
Wenn P_real negativ ist: siehe #6 — L/N vertauscht oder CT-Zange verkehrt herum montiert. Wenn |I_rms − erwartet| > 10 %: siehe #5 — falsches CT-Modell oder Zange nicht geschlossen. Wenn |P_real − U × I| > 5 % bei PF = 1: Phasenkompensation könnte abweichen — wenden Sie sich an den Lieferanten.
17. Prüfliste vor der Inbetriebnahme
Bevor Sie ein Modul in einem Produktivsystem einschalten:
- [ ] L am L-Anschluss der Platine angeschlossen (nicht mit N vertauscht)
- [ ] CT-Zange am L-Leiter (nicht am N, nicht an beiden gleichzeitig)
- [ ] Pfeil an der CT-Zange zur Last hin
- [ ] CT-Zange vollständig geschlossen (kein Spalt, kein Spiel — bis zum Einrasten zudrücken)
- [ ] CT-Kabel intakt, Stecker vollständig in der Buchse
- [ ] VCC innerhalb 4.5…5.5 V, saubere Masse
- [ ] I²C-Pull-ups geprüft (siehe hardware-connection.md → I²C-Pull-ups)
- [ ] Bei BASIC-SCT-Modulen:
REG_CT_MODELgeschrieben und gespeichert, passend zum installierten Sensor - [ ] Funktionstest mit ohmscher Last abgeschlossen — alle fünf Werte (U, I, P, PF, Q) liegen im erwarteten Bereich
Ist ein Punkt nicht abgehakt, sind seltsame Messwerte zu erwarten. Die häufigsten Ursachen für Messfehler sind Installationsfehler am Sensor, nicht Fehler der Firmware oder Elektronik.
CT-Serie (werkseitig gepaarte Zangen)
- ❌ Messwerte auf einem Kanal wirken falsch — die Zange sitzt nicht auf ihrem eigenen Kanal oder wurde ersetzt. Schließen Sie die mit dieser Kanalnummer markierte Zange wieder an; eine Zange eines anderen Kanals liefert einen falschen Wert.
- ❌ Ein Schreibvorgang der Sensorklasse oder des Modells liefert
ERR_PARAM(0xFE) — erwartet bei Firmware 1.4.22 und neuer: Ein CT-Modul lehnt diese Schreibvorgänge ab. Schreiben Sie sie nicht (siehe Start ohne Konfiguration). - ❌ Eine CT-Zange oder ein Kanal ist beschädigt — sie sind im Feld nicht austauschbar; wenden Sie sich an den Werkskundendienst.
- ❌ Strom ist negativ / Energie läuft in die falsche Richtung — die Zange ist verkehrt herum: Der Pfeil muss zur Last zeigen.
Fehlercodes (REG_ERROR = 0x02)
| Code | Name | Bedeutung | Aktion |
|---|---|---|---|
0x00 |
ERR_OK |
Normal — letzter Schreibvorgang erfolgreich | — |
0xF9 |
ERR_CLONE |
Reserviert — wird nicht ausgelöst | Falls dies jemals beobachtet wird, wenden Sie sich an den Lieferanten. |
0xFA |
ERR_LUT_BAD |
Die Werkskalibrierungstabelle hat die CRC-Prüfung nicht bestanden; das Modul arbeitet mit einer linearen Näherung | Nicht fatal. Messungen laufen weiter; die Genauigkeit kann reduziert sein. Lassen Sie den Lieferanten neu kalibrieren. |
0xFB |
ERR_FLASH_PARAMS_BAD |
Flash-Parameterblock beschädigt; Standardwerte wiederhergestellt | Adresse / SENSOR_CLASS / CT_MODEL neu konfigurieren und CMD_SAVE_USER_CONFIG (0x32) ausführen. Normal bei einem neuen Modul (siehe Kapitel 11 §6.5) — bei der Erstinstallation nicht wegen 0xFB abbrechen. |
0xFC |
ERR_NOT_READY |
Das erste RT-Fenster ist nach dem Start noch nicht abgeschlossen | Warten Sie 300 ms. |
0xFD |
ERR_SENSOR_OVERFLOW |
Eingangssignal übersteuert (Skalierungsendwert überschritten) | Strom verringern oder eine größere CT-Zange verwenden. |
0xFE |
ERR_PARAM |
Ungültiger Befehlscode oder Wert außerhalb des Bereichs | Befehl und Wertebereich prüfen. |
0xFF |
ERR_UNHANDLED |
HardFault oder nicht behandelte Bedingung | Netz aus- und einschalten. Tritt es erneut auf, wenden Sie sich an den Lieferanten. |
Bedeutung — REG_ERROR ist NICHT klebend (v1.3)
REG_ERROR enthält das Ergebnis der letzten Schreibtransaktion. Jeder weitere Schreibvorgang — erfolgreich oder nicht — überschreibt es. Es ist nicht nötig, REG_ERROR zwischen Versuchen zu löschen; tatsächlich kann ein späteres Lesen als unmittelbar nach dem fehlgeschlagenen Schreibvorgang ein neueres Ergebnis aus einer nachfolgenden Operation zeigen.
Wenn Sie ein dauerhaftes Fehlersignal benötigen, das spätere Schreibvorgänge überdauert, verwenden Sie EVENT_FLAGS.bit3 (ERROR_OCCURRED) — es wird W1C gespeichert und nur gelöscht, wenn der Master eine 1 in dieses Bit schreibt. Das vollständige Fehlermodell finden Sie in Kapitel 11 §5.3.
Explizites Löschen (selten nötig): CMD_CLEAR_ERROR (Opcode 0x31) setzt REG_ERROR auf null.
— dieselbe Aufgabe ohne Registerzugriff:
| Bibliothek | Aufruf | Was es tut |
|---|---|---|
| Arduino | RbAmp::readLastError() / RbAmp::clearError() |
den Fehlercode des letzten Schreibvorgangs lesen; löschen |
| ESP-IDF | rbamp_read_last_error() / rbamp_clear_error() |
den Fehlercode des letzten Schreibvorgangs lesen; löschen |
| Python | dev.read_last_error() / dev.clear_error() |
den Fehlercode des letzten Schreibvorgangs lesen; löschen |
| ESPHome | get_last_error_str() / write_clear_error() |
den Fehlercode als Text lesen; den Fehler löschen |
Wann Sie den Lieferanten kontaktieren
Symptome, die einen Service erfordern:
- Das Modul verlässt
DATA_VALID = 0nach drei Netzzyklen nicht ERR_UNHANDLED(0xFF) tritt wiederholt auf- Vermuteter Kalibrierungsdrift — Abweichung von mehr als 5 % gegenüber einem Referenzzähler an einer bekannten ohmschen Last bleibt bestehen, nachdem die Diagnoseprüfliste in #17 erfüllt ist
- Das Gehäuse ist heiß oder riecht nach verbranntem Material
- Abweichung von mehr als 5 % gegenüber einem Referenzzähler, obwohl die Prüfliste in #17 erfüllt ist
- Ein neues Modul startet beim ersten Einschalten mit
ERR_LUT_BAD(0xFA)
Weiter
- arduino-examples.md — Beispiele mit Fehlerbehandlung
- Für Smart-Home-Integrationen (ESPHome / Home Assistant, Python) siehe die Tabelle der Client-Bibliotheken in der README