10 · Fehlersuche
Ein symptomorientierter Debugging-Leitfaden für die Komponente rbamp in ESPHome. Jeder Eintrag folgt demselben Muster: was Sie im Log sehen, was es bedeutet, wie Sie es diagnostizieren und eine konkrete Abhilfe.
Contents:
- I²C / Hardware
- Datenqualität
- Energie und Persistenz
- Home-Assistant-Integration
- Build und Toolchain
- Identität / Fähigkeit / Fehler (v1.3)
1. I2C / Hardware
Probe failed at 0x50 — keine Antwort
Was Sie im Log sehen:
[E][rbamp:xxx]: Probe failed at 0x50 — no response. Check wiring/address.
[E][component:xxx]: Component rbamp was marked as failed.
Die Komponente ruft dann mark_failed() auf und stoppt weitere update()-Aufrufe. Alle gebundenen Sensoren bleiben in Home Assistant auf „Unbekannt“.
Was es bedeutet:
Der ESP32 hat die Adressphase an 0x50 (oder eine andere Adresse aus address:) gesendet und kein ACK erhalten. Das Modul fehlt, ist nicht bestromt oder liegt auf einer anderen Adresse.
So diagnostizieren Sie:
-
Prüfen Sie, dass
scan: trueim YAML-Blocki2c:gesetzt ist. Starten Sie den ESP32 neu und achten Sie auf:Text[I][i2c.arduino:069]: Found i2c device at address 0x50Hat der Scan das Gerät gefunden, ist der Schlüssel
address:in Ihrem Blockrbamp:falsch — korrigieren Sie ihn. -
Messen Sie die Versorgung am VCC-Pin des Moduls mit einem Multimeter: Sie muss 4.5..5.5 V betragen (5 V nominal, siehe 04_hardware.md). Null oder unter 4.5 V heißt, die Versorgung fehlt oder ist grenzwertig.
-
Prüfen Sie die Durchgängigkeit von SDA und SCL vom GPIO des ESP32 bis zum Modulstecker. Ein fehlender oder vertauschter Draht ist die häufigste Ursache bei frischen Aufbauten.
-
Prüfen Sie die Pull-up-Widerstände an SDA und SCL (4.7 kΩ gegen 3.3 V). Ohne Pull-ups liegt der Bus auf Low, und jede Adressphase sieht wie ein NACK aus.
-
Wenn Sie kürzlich eine Adressänderung durchgeführt haben (der Schlüssel
new_address:), könnte das Modul nun unter der neuen Adresse sein. Fügen Siescan: truehinzu, finden Sie das Gerät, passen Sieaddress:entsprechend an und entfernen Sienew_address:.
Abhilfe: Verdrahtung / Stromversorgung korrigieren und address: aktualisieren, wenn das Modul verschoben wurde. Antwortet das Modul nach einer Adressänderung nicht, siehe unten „Adresse geändert, Modul antwortet aber nicht“.
RT-Block nicht bereit — Veröffentlichung übersprungen
Was Sie sehen:
[D][rbamp:xxx]: RT block not ready (STATUS=0x00) — skipping live publish
Was es bedeutet: Das Statusregister meldete, dass das Modul nicht bereit ist. Das geschieht, wenn das Modul seinen ersten Block der Momentanwerte nach dem Start noch nicht übernommen hat, mitten in einem Flash-Schreibvorgang steckt oder einen Soft-Reset durchläuft.
So diagnostizieren Sie:
-
Erscheint der Eintrag einmal beim Start (in den ersten 30 s nach dem Einschalten) und verschwindet dann, ist das normal. Das Modul braucht einen Commit-Zyklus (~100 ms), um das READY-Bit nach dem Einschalten zu setzen. Der Startsnapshot in
setup()erzeugt ebenfalls einen übersprungenen Zyklus. -
Strömt die Meldung nach dem Aufwärmen ununterbrochen, ist das Modul vielleicht festgefahren. Prüfen Sie auf wiederholte Einträge
ct_model:/ct_models:(zum Beispiel ein Schlüssel, der im YAML stehen geblieben ist und bei jedem Start geschrieben wird und so ein dauerhaftes Flash-Schreibfenster erzeugt). -
Erscheint die Meldung gelegentlich (etwa einmal alle paar Zyklen), ist das normale Schwankung durch NACKs. Die Wiederholungsschleife fängt die meisten Störungen ab; manchmal schlägt das Lesen des Status dennoch fehl, was diesen DEBUG-Eintrag auslöst.
Fix:
- Aufwärm-Überspringen beim Start ist erwartet; warten Sie zwei vollständige
update_interval-Zyklen. - Ist
ct_model:/ct_models:im YAML gesetzt, lassen Sie es stehen: Bei jedem Start ist das wiederholte Schreiben idempotent (das Modul schreibt nicht, wenn der Wert bereits im Flash steht). Wenn Sie die Aufwärmpausen stören, entfernen Sie den Schlüssel nach einem erfolgreichen ersten Lauf durch Auskommentieren. - Bleibt das Modul 60 s oder länger nicht bereit, schalten Sie das Modul (nicht den ESP32) aus und wieder ein, für einen sauberen Kaltstart.
„rbamp took a long time for an operation (XXX ms)“
Was Sie sehen:
[W][component:522]: rbamp took a long time for an operation (406 ms), max is 30 ms
Was es bedeutet: Diese Warnung erscheint, wenn das update() einer Komponente das Standard-Budget von 30 ms des kooperativen Schedulers von ESPHome überschreitet. Für die Komponente rbamp ist dies erwartbar und unschädlich.
Bei Firmware v1.3 wird die READ-Auto-Inkrementierung für den Block der Momentanwerte unterstützt (der zusammenhängende Bereich mit U / I / P / PF / Q für alle deklarierten Kanäle). Die Komponente gibt für diesen Block einen einzigen Burst-Lesezugriff aus — eine Adressphase, gefolgt von ca. 36 Datenbytes — das kostet ca. 8–10 ms Leitungszeit bei 50 kHz. WRITE-Auto-Inkrementierung wird nicht unterstützt, daher gehen einzelne Schreibvorgänge (CT-Modell-Staging, Sensorklasse, Adress-Commit) weiterhin Byte für Byte. Schlägt der Burst-Lesezugriff fehl (NACK mittendrin, Fähigkeitsbit bei Alt-Firmware nicht gesetzt), fällt die Komponente auf registerweise Lesungen zurück (4 Transaktionen pro Float, bis zu 36 Transaktionen ≈ 90 ms bei 50 kHz). Mit dem Wiederholungs-Tripel pro Byte (bis zu 3 × 5 ms Lücke bei einem NACK-lastigen Zyklus) liegt der ungünstigste Rückfallpfad normalerweise bei 300–450 ms — das erzeugt diese Warnung, wenn sie erscheint.
Das Einschwingen nach dem Snapshot (set_timeout("rbamp_period", 50, ...)) ist nicht blockierend — update() gibt die Steuerung an den Scheduler ab, während die 50 ms verstreichen. Die Warnung spiegelt die Wanduhrzeit des gesamten blockierenden Lesens der Momentanwerte wider, nicht eine Aushungerung durch WLAN oder API.
Keine Aktion des Anwenders nötig. Die Warnung ist kosmetisch; HA-Sensoren aktualisieren sich korrekt. Bei gesunden v1.3-Modulen bleibt der Burst-Lesepfad normalerweise unter 30 ms, und die Warnung erscheint gar nicht.
Wenn die Warnung bei jedem Zyklus erscheint: Der Bus erzwingt den Rückfall auf Einzelregisterlesungen (Legacy-Firmware ohne READ-Burst-Fähigkeit oder grenzwertige Pull-ups, die mitten im Burst NACKs erzeugen). Prüfen Sie die Firmware-Version (Firmware version: 0x04 im Startlog = v1.3) und die Pull-up-Topologie (ein einzelnes 4.7-kΩ-Paar an sauberen 3.3 V).
Periodensnapshot konnte nicht gelesen werden
Was Sie sehen:
[W][rbamp:xxx]: Failed to read PERIOD_AVG_P[0]
[W][rbamp:xxx]: Failed to read PERIOD_AVG_P[1]
Was es bedeutet: Nach dem Snapshot-Befehl und der 50-ms-Wartezeit konnte die Komponente das Periodenmittel der Leistung für Kanal N nach drei Versuchen nicht lesen. Der Energieakkumulator für diesen Kanal wird in diesem Zyklus nicht aktualisiert.
Die häufigsten Ursachen:
- Schreibpause des Flash. Das Modul schreibt ein CT-Modell (ausgelöst durch
ct_model:oderct_models:beim Start) oder speichert eine neue Adresse. Das Fenster beträgt ca. 700 ms; fällt das 50-ms-Settle des Snapshots hinein, läuft das Lesen in ein Timeout. - Verpasster Snapshot bei starker Abfrage. Bei starker, direkt aufeinanderfolgender I²C-Abfrage kann die Modulseite einen Snapshot verpassen. Der Snapshot bleibt leer, aber das Gültigkeitsflag ist 0 — die Komponente überspringt die Integration mit der Meldung „Period snapshot not yet valid; keeping previous integration window“. Die Warnung erscheint nur, wenn das Gültigkeitsflag gesetzt ist, das Register aber trotzdem nicht gelesen werden konnte.
- Erschöpfung durch vorübergehende NACKs. Alle drei Wiederholungen schlugen bei mindestens einem der vier Bytes des Floats fehl. Selten bei 50 kHz (< 1 % der Zyklen), häufiger bei 100 kHz.
Was mit der Energie geschieht: Bei einer Warnung wird last_latch_ms_ nicht aktualisiert. Beim nächsten erfolgreichen Zyklus umfasst dt_ms sowohl das verpasste als auch das neue Fenster — die Energie wird nachgeholt, vorausgesetzt die Last ist über das Intervall ungefähr stabil. Das ist eine akzeptable kleine Ungenauigkeit.
Fix:
- Entfernen Sie die Schlüssel zur Adressänderung (
new_address:) aus dem YAML nach dem ersten erfolgreichen Start. - Tritt die Warnung öfter als einmal pro Stunde auf, prüfen Sie die Bustaktung (
50kHzwird empfohlen) und die Pull-up-Widerstände (4.7 kΩ). - Wenn die Warnung bei jedem Zyklus erscheint, prüfen Sie auf einen Konflikt mit einem anderen Gerät am Bus.
Adresse geändert, aber Modul antwortet nicht
Was Sie sehen:
[E][rbamp:xxx]: Address change applied but slave not responding at 0x51 —
check wiring and try power-cycling the rbAmp.
[E][component:xxx]: Component rbamp was marked as failed.
Was es bedeutet: Der Ablauf der Adressänderung hat alle Schritte durchlaufen (neue Adresse schreiben, im Flash speichern, Soft-Reset, interne I²C-Adresse der Komponente umstellen), aber das Modul antwortete bei der ersten Prüfung nicht unter der neuen Adresse.
Mögliche Ursachen:
- Die Adresse wurde geschrieben und gespeichert, aber das Modul ist in einen fehlerhaften Zustand gegangen (Beschädigung der Flash-Parameter, ein Spannungseinbruch während des 700-ms-Schreibfensters).
- Bei Alt-Firmware (v1.0-v1.2): Das Modul war zum Zeitpunkt des Versuchs nicht im Werks-Provisionierungsmodus. Bei Firmware v1.3+ trifft diese Ursache nicht zu (der Zwei-Phasen-Commit ist produktionstauglich). Schlug schon das Lesen des Modus-Status fehl (NACK), schreibt die Komponente spekulativ mit einer Warnung im Protokoll.
- Ein Verdrahtungsproblem, das schon vor der Adressänderung bestand (die Probe auf die alte Adresse gelang nur zufällig bei einem der drei Versuche).
Wiederherstellungsverfahren:
- Das Modul liegt auf einer unbekannten Adresse. Verwenden Sie ein Test-YAML mit
i2c: scan: trueund einen Power-Cycle — finden Sie heraus, auf welcher Adresse das Modul antwortet. - Wird das Modul unter der neuen Adresse gefunden (z. B. 0x51), setzen Sie im YAML
address: 0x51, entfernennew_address:und flashen neu. Der nächste Start läuft sauber. - Antwortet das Modul auf keiner Adresse, hat der Flash-Schreibvorgang die Parameter eventuell beschädigt. Die Wiederherstellung erfordert einen physischen Eingriff: Konsultieren Sie die Modul-Dokumentation oder Ihren Lieferanten.
Hintergrund: Der Ablauf der Adressänderung in Firmware v1.3 ist ein zweiphasiger Commit — der Master schreibt die neue Adresse in ein Staging-Register und sendet dann CMD_COMMIT_ADDR, um sie dauerhaft zu machen. Das 700-ms-Schreibfenster ist das Löschen und Programmieren der Benutzerkonfigurationsseite im Flash. Siehe 09 · API-Referenz.
i2c_master hängt — Bootschleife des ESP32 oder RT-Block wird nie veröffentlicht
Was Sie sehen:
[I][i2c.idf:xxx]: Performing I2C bus reset...
[E][i2c.idf:xxx]: i2c_master_send_buf failed: ESP_ERR_TIMEOUT
[E][rbamp:xxx]: Probe failed at 0x50 — no response. Check wiring/address.
[E][component:xxx]: Component rbamp was marked as failed.
Im schlimmsten Fall löst ein Timeout des Task-Watchdogs nach mehreren Minuten Dauerbetrieb einen Neustart des ESP32 aus (unter Last, nicht bei der Inbetriebnahme). Es kann so aussehen, als habe das Modul eine Stunde gearbeitet und sei dann stehen geblieben.
Was es bedeutet: Der Treiber i2c_master von ESP-IDF v5 hat eine bekannte Schwachstelle: Auf einem grenzwertigen Bus (langsame Anstiegszeit, schwacher Pull-up, EMV-Störimpuls) dreht die interne Funktion i2c_ll_is_bus_busy endlos und wartet auf eine STOP-Bedingung, die nie kommt. In ESPHome 2025.x kann dieses Drehen das Budget des App-WDT aufzehren und einen Neustart auslösen. Dies ist ein kanonisches ESP-IDF-Problem, nicht spezifisch für rbAmp.
Dreischichtige Abschwächung (in der Komponente standardmäßig aktiv, dazu Hardware-Empfehlungen):
-
Software: die eingebaute NACK-Disziplin — 50 kHz standardmäßig + 3× Wiederholung je Byte mit 5 ms Pause + der IP-009-Plausibilitätsfilter
std::isfinite(). Bereits seit v0.2+ in der Komponente. Die Härtung des Stop-Handlers ist in Firmware v1.1/v1.3 enthalten, aber 50 kHz wird auf ESP-IDF-Mastern weiterhin empfohlen, weil die Wechselwirkung der Treiber-Timings bestehen bleibt. -
Hardware: ein externer 4.7-kΩ-Pull-up an SDA + SCL (ein einzelnes externes Pull-up-Paar, mit durchtrennten Brücken im Modul — siehe §Mehrmodul-Bus). Die internen Pull-ups des ESP32 (~50 kΩ) sind schwach — auf einem langen Bus oder bei einer knappen Versorgung reichen sie nicht. 4.7-kΩ-Pull-ups gegen saubere 3.3 V sind für einen Produktionsbetrieb zwingend.
-
Hardware: den Debugger / den OTA-Reset nicht dauerhaft aktiv halten während I²C-Transaktionen. Ein während einer Transaktion gesetzter RESET hängt den Bus (der Slave treibt weiter SDA), und genau das löst das endlose Drehen von „bus-busy“ aus.
Häufigkeit des Hängenbleibens im 24-Stunden-Dauertest:
| Schicht | Hänger-Rate | Hinweis |
|---|---|---|
| Nur Software (kein externer Pull-up) | ca. 1× pro 10 Minuten | der Bridge-WDT löst aus und erholt sich per Reset, aber Wh verliert ein Fenster |
| Software + externer 4.7-kΩ-Pull-up | ca. 1× pro 24 Stunden | EMV-Störimpuls-Randfall; automatische Wiederherstellung |
| Software + externer Pull-up + sauberer Reset | 0 hängt bei einem 24-Stunden-Dauertest | Produktionsziel |
Schweregrad = Messzeit (Dauertest über die volle Laufzeit), nicht Inbetriebnahme. Bei der Inbetriebnahme fängt die NACK-Disziplin über das Wiederholungstrio mehr als 99 % ab — echtes Hängenbleiben beginnt erst nach Stunden sauberen Dauerbetriebs. Die vollständige Referenz der Disziplin finden Sie in 09 · API-Referenz.
: Als letzte Möglichkeit wdt: (ESPHome-Kern) mit erhöhtem app_wdt_timeout_seconds: konfigurieren (Standard 5 s; 10–15 s setzen). Das verschafft der Komponente Zeit zur Wiederherstellung ohne Neustart.
2. Datenqualität
Spannung springt hin und her — 228 V / 502 V / 1.96 V gemischt
Was Sie sehen:
[D][sensor:xxx]: 'Mains Voltage': Sending state 502.730 V
[D][sensor:xxx]: 'Mains Voltage': Sending state 1.964 V
[D][sensor:xxx]: 'Mains Voltage': Sending state 228.365 V
[D][sensor:xxx]: 'Mains Voltage': Sending state 502.730 V
In Home Assistant ist der Spannungsverlauf eine Sägezahnkurve zwischen ~228 V, ~2 V und ~503 V. Der Strom kann gleichzeitig 0 A oder −2 A anzeigen.
Was es bedeutet: „Geisterwerte“ treten aus einem Pufferleck im Treiber i2c_master von ESP-IDF unter NACK-Bedingungen bei 100 kHz auf. Dies sollte durch die Standardkonfiguration der aktuellen Komponentenversion beseitigt sein. Tritt das Symptom auf:
- Der Block
i2c:hatfrequency: 100kHz— ändern Sie ihn auf50kHz. - Die Komponentenversion ist älter als 2026-05-24 — aktualisieren Sie sie.
Fix:
i2c:
sda: GPIO21
scl: GPIO22
frequency: 50kHz # required for reliable operation
scan: true
Zum Mechanismus der NACK-Disziplin (50 kHz Standard + Wiederholung pro Byte + Plausibilitätsfilter für NaN/Inf) siehe 09 · API-Referenz.
Kompatibilität mit framework: type: — das Geister-Problem bei NACK tritt nur beim ESP-IDF-Treiber i2c_master auf. Bei framework: type: arduino (der Standard) wird der Arduino-Framework-Stack Wire verwendet, der sich bei NACK anders verhält und dieses Symptom nicht erzeugt. Das bedeutet:
- Hat das YAML
esp32: framework: type: arduino, könnten Sie theoretischfrequency: 100kHzohne sichtbare Geisterspitzen beibehalten; die Wiederholungsschleife pro Byte der Komponente läuft aber weiterhin auf Wire, und die periodischen NACKs bei 100 kHz bleiben bestehen — nur ohne die störenden Geister. Für stabile HA-Diagramme empfehlen wir unabhängig vom Framework 50 kHz. - Hat das YAML
esp32: framework: type: esp-idf, istfrequency: 50kHzzwingend. Dies ist die Konfiguration, in der der Geister-Effekt des Treibersi2c_masteram deutlichsten auftritt.
Die Komponente selbst wählt das Framework nicht — sie läuft auf beiden. Das ist allein eine Entscheidung in Ihrem YAML.
Der Strom beträgt unter Last dauerhaft 0 A
Was Sie sehen:
[D][sensor:xxx]: 'Mains Current': Sending state 0.000 A
Die Leistung ist 0 W, die Energie wächst nicht, aber die Spannung wird korrekt gelesen (z. B. 228 V).
Was es bedeutet: eine von zwei typischen Ursachen:
Ursache 1 — ct_model: ist nicht gesetzt oder passt nicht zur physischen Klemme. Ab Firmware v1.2 verwendet das Modul die Werkskoeffizienten für das im YAML gewählte Modell. Ist ct_model: nicht gesetzt oder steht auf z. B. SCT_013_050, obwohl eine echte SCT-013-005 verbaut ist, ist der Messbereich so viel breiter als das physische Signal, dass das Modul es nicht auflösen kann und null meldet.
Ursache 2 — die Klemme ist am Leiter falsch eingebaut (siehe Polarität in 03_sensor_selection.md und Umklammern nur eines Leiters).
So diagnostizieren Sie:
- Vergewissern Sie sich, dass die Zange physisch an einem stromführenden Leiter sitzt und der Leiter tatsächlich Strom führt (Zangenmessgerät als Referenz, falls vorhanden).
- Öffnen Sie das YAML und prüfen Sie, dass
ct_model:(bzw.ct_models:bei UI3) zum physischen Klemmenmodell passt. - Ist
ct_model:auf Firmware v1.2+ gesetzt,sensor_class:aber weggelassen oder auf einen anderen Wert alsSCT_013gesetzt, verweigert das Modul das Schreiben des Modells. Das Startlog zeigt eine Warnung, die auf die fehlende Voraussetzung verweist.
Fix:
rbamp:
id: meter1
sensor_class: SCT_013 # default; required on v1.2+ before ct_model
ct_model: SCT_013_005 # match the physical clamp
Nach dem Start schreibt das Modul das Modell einmal in den Flash (~700 ms) und lädt die Werkskoeffizienten. Die nächste Veröffentlichung der Momentanwerte liefert bereits den korrekten Strom.
Messgenauigkeit bei kleinen Strömen an UI2 / UI3 — das Dual-CT-Muster. Wenn Sie zugleich hohe Auflösung bei kleinen Lasten (Beleuchtung, Standby) und einen weiten Bereich für Spitzen (Wasserkocher, Waschmaschine) wünschen, nutzen Sie zwei Stromkanäle auf derselben Phase gleichzeitig mit verschiedenen Zangen:
rbamp:
id: home_meter
sensor_class: SCT_013
ct_models: [SCT_013_005, SCT_013_030, SCT_013_050]
# CH0 — SCT-013-005 for resolving idle loads (~5..50 W)
# CH1 — SCT-013-030 for the main household load (~50..7000 W)
# CH2 — SCT-013-050 for the peak (EV-charging headroom up to 11.5 kW)
# For peaks above 50 A use SCT_013_060 (60 A) or SCT_013_100 (100 A) on that channel
Alle drei Zangen umschließen denselben gleichen L-Leiter. SCT-013-005 bietet ~10× bessere Auflösung bei kleinen Strömen als SCT-013-030, sättigt aber bei ~5 A. SCT-013-030 deckt den „mittleren“ Bereich des Nutzbaren ab; SCT-013-050 erfasst Spitzen bis ~11.5 kW ohne Sättigung. Auf der HA-Seite wählt ein Template-Sensor die „aktive“ Messung per Schwellwert:
Home-Assistant-YAML (nicht ESPHome) — gehört in Ihre Home-Assistant-Konfiguration, nicht in das YAML des Knotens.
# configuration.yaml — select the active channel by range
template:
- sensor:
- name: "Mains Current (active)"
unit_of_measurement: "A"
device_class: current
state_class: measurement
state: >
{% set i0 = states('sensor.rbamp_ch0_current') | float(0) %}
{% set i1 = states('sensor.rbamp_ch1_current') | float(0) %}
{% set i2 = states('sensor.rbamp_ch2_current') | float(0) %}
{% if i2 > 25 %}{{ i2 }}
{% elif i1 > 4 %}{{ i1 }}
{% else %}{{ i0 }}
{% endif %}
Dies deckt den Bereich vom kleinsten bis zum größten Nennstrom der drei Zangen ab (5 A … 50 A). Abwägung: Drei CT-Zangen an einem Leiter sind physisch sperrig, und jede belegt einen Modulkanal (bei UI3 ist das das ganze Modul). Für die meisten Installationen deckt eine einzige Zange mit einem auf die Last abgestimmten Nennwert 99 % der Szenarien ab — das Dual-/Triple-CT-Muster ist nur nötig, wenn ein breiter Dynamikbereich verlangt wird.
Periodensnapshot ungültig — Energie wächst nicht
Kalibrierung und Genauigkeit (Fehlerbehebung) · 7.5 Erhalt der Periode bei fehlgeschlagenem Snapshot (API-Referenz)
Was Sie sehen:
[D][rbamp:xxx]: Period snapshot not yet valid; keeping previous integration window
Der energy-Sensor in Home Assistant [Home Assistant] zeigt einen konstanten Wert (oder bleibt nach dem Start bei 0 Wh), obwohl die Leistung korrekt gelesen wird.
Was es bedeutet: Das Gültigkeitsflag des Periodensnapshots war 0, als die Komponente es 50 ms nach dem Snapshot-Befehl prüfte. Das Modul hat noch keinen gültigen Periodensnapshot übernommen.
Normale Ursachen:
- Erster Snapshot nach dem Start. Der Start-Snapshot in
setup()verwirft sein Ergebnis immer — der Modul-Akkumulator wird beim ersten Snapshot-Befehl zurückgesetzt. Der zweite Snapshot (eineupdate_intervalnach dem Start) ist der erste, der integriert. Die Energie beginnt sich nach dem ersten vollständigenupdate_intervalab Start zu akkumulieren. - Kaltstart des Moduls. Das Modul benötigt mindestens einen Commit-Zyklus von ca. 100 ms, bevor Daten im Periodenakkumulator vorliegen. Liegt der erste Snapshot früher, ist das Gültigkeits-Flag 0.
- Verpasster Snapshot bei hoher Last. Bei starker I²C-Last kann die Modulseite einen Snapshot verpassen. Der Snapshot bleibt leer; der nächste Snapshot sollte gelingen.
Erscheint der Eintrag bei jedem update()-Zyklus endlos (nicht nur in den ersten beiden), kann das Modul in einem Zustand sein, in dem der Periodenakkumulator nie übernommen wird. Ein Stromzyklus des Moduls löscht diesen Zustand.
3. Energie und Persistenz
Energiezähler nach einem Neustart auf 0 zurückgesetzt
Die Energie stammt aus den eigenen Zählern des Moduls und wird zusätzlich im Flash des ESP32 (NVS) gespeichert, sodass ein Neustart des ESP32 oder des Moduls sie nicht zurücksetzt und die Summen nicht zurückspringen. Startet ein Sensor eines STANDARD-Moduls weiterhin bei 0, liegt die Ursache in einem NVS-Verlust (Flash-Löschung, geänderte Partitionstabelle) und gleichzeitig einem Zählerreset im Modul. Die Gesamtsummen-Sensoren (energy_total, energy_exported_total, energy_net, reactive_energy*) nutzen einen eigenen NVS-Slot, getrennt von den Slots energy je Kanal, sodass ein Upgrade der Komponente die Werte je Kanal nicht löscht.
Was Sie im Energie-Dashboard von HA sehen: ein scharfer Abfall auf 0 Wh, danach normale Akkumulation ab 0. Der alte Wh-Verlauf bleibt in den Langzeitstatistiken von HA erhalten, aber der „aktuelle Zählerstand“ wirkt zurückgesetzt.
Was es bedeutet: Beim Wiederherstellen aus NVS wurden keine Daten gefunden oder ungültige Daten geladen. Mögliche Ursachen:
- Erhöhung der NVS-Layoutversion. Der NVS-Schlüssel wird aus der Komponenten-ID abgeleitet, XOR-verknüpft mit einer Layoutversions-Konstante. Hat sich das Strukturlayout geändert (bei einem Komponenten-Upgrade), ändert sich der NVS-Slot-Schlüssel, und die alten Daten werden nicht mehr gefunden. Die Wiederherstellung startet stillschweigend bei 0.
- NVS-Fragmentierung oder -Beschädigung. Die NVS-Partition des ESP32 nutzt Flash-Wear-Leveling. Bei sehr alten Installationen oder nach vielen Flash-Vorgängen kann Fragmentierung ein Speichern scheitern lassen. Das Protokoll zeigt:
[W][rbamp:xxx]: Failed to save Wh totals to NVS — will retry next cycle. - Änderung des Partitionslayouts. Das Flashen einer neuen
partitions.csv, die Größe oder Position der Partitionnvsändert, macht alle gespeicherten Werte ungültig. - Erster Start nach einem Werksreset oder vollständigem Flash-Löschen. Erwartet: Das NVS ist leer, der Akkumulator beginnt bei 0.
So diagnostizieren Sie:
Suchen Sie im Startprotokoll nach:
[C][rbamp:xxx]: No saved energy state — starting from 0 Wh
Falls vorhanden, hat die Wiederherstellung nichts gefunden. Außerdem:
[C][rbamp:xxx]: Restored Wh from NVS: total[0.310, 0.000, 0.000] export[...]
Ist der wiederhergestellte Wert spürbar niedriger als erwartet, wurde möglicherweise das letzte NVS-Speichern vor 5 Minuten übersprungen (ungünstigster Verlust: ≈ 5 Wh bei durchschnittlich 60 W).
Fix:
- Bei einem Komponenten-Upgrade, das das NVS-Layout ändert, werden alte Summen nicht automatisch wiederhergestellt. Die Langzeitstatistik von HA behält den Verlauf, auch wenn der „aktuelle Messwert“ auf null fällt.
- Um Wh durch ein erzwungenes Löschen des NVS hindurch zu erhalten, lesen Sie die aktuellen Sensorwerte in den HA-Entwicklerwerkzeugen vor dem Löschen und notieren Sie sie. Es gibt keinen Weg, der Komponente einen Startwert einzuspeisen.
Energie in HA stimmt nicht mit einem Referenzzähler überein
Was Sie sehen: Der Sensor energy in HA zeigt merklich weniger (z. B. 10–20 %) als ein Referenz-Smart-Meter oder der Versorgungszähler im selben Zeitraum.
Was es bedeutet: Bei BASIC-Modulen integriert die Komponente die Periodenmittel-Leistung über die ESP32-seitige Zeit zwischen den Snapshot-Befehlen. Bei STANDARD-Modulen akkumuliert sie die eigenen Energiezähler des Moduls.
Wenn die Energie zu niedrig ist, prüfen Sie folgende Punkte:
- Lastcharakter. Der Periodenmittelwert der Leistung ist tatsächlich über eine abgeschlossene Periode gemittelte Leistung, kein Momentanwert. Eine gepulste Last (Motor, Kompressor) mit kurzer Einschaltdauer innerhalb der 60-Sekunden-Periode liegt im Mittel unter ihrer Spitzenleistung.
- Platzierung der Zange und Bürdenkalibrierung. Passt das werkseitige CT-Modell (
ct_model:) nicht zur Realität, sind die Koeffizientenbereiche verschoben. Prüfen Sie, dassct_model:im YAML zur physischen Zange am Leiter passt. - BASIC-Firmware-Stufe. Bei der BASIC-SKU werden die Einzelfenster-Leistungsproben vor der Integration auf 0 begrenzt. Hat die Last einen generatorischen Anteil (z. B. ein Pumpenmotor mit Gegen-EMK), zählt BASIC zu wenig.
4. Home-Assistant-Integration
HA zeigt für alle rbamp-Sensoren „Nicht verfügbar“
Was Sie in HA sehen: Alle Entitäten sensor.rbamp_* zeigen „Nicht verfügbar“.
Ursachen und Abhilfen:
- ESP32 offline. Führen Sie
esphome logs --deviceaus — gelingt keine Verbindung, ist der ESP32 offline. Prüfen Sie die WLAN-Zugangsdaten und den Fallback-AP, falls einer konfiguriert ist. -
API-Verbindung verloren. Die native ESPHome-API (Port 6053) kann durch eine Firewall blockiert sein. Prüfen Sie, ob der ESP32 über die IP erreichbar ist:
ShellpingAntwortet ping, zeigt HA aber weiterhin „nicht verfügbar“, müssen Sie die ESPHome-Integration in HA entfernen und erneut hinzufügen (Einstellungen → Integrationen → ESPHome → Löschen, dann erneut erkennen).
-
API-Verschlüsselungsschlüssel stimmt nicht überein. Ist
api: encryption: key:im YAML konfiguriert, muss die HA-Integration denselben Schlüssel kennen. Eine Abweichung lässt HA das Gerät als offline behandeln. Entfernen und fügen Sie die Integration nach der Aktualisierung des Schlüssels erneut hinzu. - mDNS funktioniert in Ihrer Netzwerktopologie nicht. Liegt der ESP32 in einem anderen VLAN als HA, kann Multicast-mDNS die Grenze möglicherweise nicht überqueren. Fügen Sie das Gerät in der ESPHome-Integration manuell per IP hinzu.
OTA-Flashen schlägt fehl
Was Sie sehen:
ERROR Error resolving IP address: ...
# or
ERROR Upload Failed
Häufige Ursachen:
- Die IP-Adresse hat sich geändert. Der ESP32 hat einen neuen DHCP-Lease erhalten. Prüfen Sie die DHCP-Tabelle des Routers, finden Sie das Gerät über die MAC-Adresse und vergeben Sie eine statische IP oder verwenden Sie den YAML-Schlüssel
wifi: use_address:. -
Der ESP32 ist im abgesicherten Modus. Nach drei fehlgeschlagenen Starts in Folge wechselt ESPHome in den abgesicherten Modus (keine benutzerdefinierten Komponenten, nur WLAN + OTA). OTA funktioniert im abgesicherten Modus, aber das Gerät läuft mit abgespeckter Firmware. Die Markierung in
esphome logs:Text[I][safe_mode:xxx]: Entering safe modeErzwingen Sie einen sauberen Start: BOOT-Taste beim Einschalten gedrückt halten oder
safe_mode: num_attempts: 10hinzufügen, um die Schwelle zu erhöhen. -
Port 3232 (OTA) ist blockiert. Das OTA-Protokoll nutzt TCP 3232. Prüfen Sie, dass keine Firewall-Regel ihn zwischen dem Rechner mit
esphome run(oder dem HA-Host) und der IP des ESP32 blockiert. - Eine große Firmware nach dem Hinzufügen von rbamp. Das erste OTA nach dem Hinzufügen einer externen Komponente kann die OTA-Partitionsgröße des Standard-Layouts des ESP32 mit 4 MB überschreiten. Prüfen Sie die Ausgabe von
esphome compileauf Warnungen zur Binärgröße und wechseln Sie bei Bedarf auf ein Layout mit größerer OTA-Partition.
OTA direkt nach new_address:-Provisionierung lädt nicht
Symptom: Nach einem erfolgreichen ersten Start mit dem Schlüssel new_address: (das Protokoll zeigt Address change SUCCESS, new address 0x51) schlägt das nächste OTA mit einem Kompilierfehler oder einer Laufzeitwarnung address 0x50 NACK fehl.
Was passiert ist: Das Modul liegt nun auf der neuen Adresse (0x51), das YAML zeigt aber noch auf die alte (address: 0x50). Beim nächsten update() versucht die Komponente 0x50, erhält keine Antwort und protokolliert ständig NACKs. Das OTA selbst schlägt hier nicht wirklich fehl — es ist nur ein Begleitsymptom: Sie sehen eine Flut von rbamp-Fehlern in esphome logs und folgern, das Gerät sei defekt.
Wiederherstellung in 3 Schritten:
-
Bearbeiten Sie das YAML:
YAMLrbamp: id: meter1 address: 0x51 # new address — set instead of 0x50 # new_address: 0x51 # ← REMOVE this line. Do not comment it out, # delete it entirely, otherwise the component # tries to provision again and logs a warning update_interval: 60s ct_model: SCT_013_030 -
Führen Sie
esphome run(über die CLI) oder Compile + Upload (über das HA-Add-on) aus. Der Knoten empfängt das neue Binary per WLAN-OTA. -
Öffnen Sie
esphome logsund prüfen Sie, ob die Startmeldungdump_configdie richtige Adresse zeigt undupdate()ohne NACKs läuft.
Regel — new_address: ist eine einmalige Provisionierung. Sobald das Modul an die neue Adresse gewechselt und im Flash gespeichert ist, muss der Schlüssel aus dem YAML entfernt werden. Andernfalls versucht die Komponente bei jedem Start erneut zu provisionieren (ab v1.2 ignoriert das Modul den wiederholten Schreibvorgang, aber die Warnung bleibt im Protokoll und verstopft die HA-notify-Benachrichtigungen).
Wenn das Modul nach der Änderung auf keiner Adresse antwortet, siehe „Adresse geändert, aber Modul antwortet nicht“ oben.
5. Build und Toolchain
Kompilierfehler: 'esphome/core/component.h' nicht gefunden
Was Sie in VS Code / clangd sehen: rote Wellenlinien überall in rbamp.h und rbamp.cpp. Popup:
'esphome/core/component.h' file not found
Was es bedeutet: clangd (die C++-IntelliSense in VS Code) hat keinen Zugriff auf die Include-Pfade von ESPHome + PlatformIO. Das Build-System löst sie bei esphome compile korrekt auf; clangd nicht.
Das ist kein Build-Fehler. Wenn esphome compile example/ui1.yaml ohne Fehler durchläuft, ist der Code korrekt.
Wenn Sie die roten Wellenlinien entfernen wollen: Legen Sie im Komponentenverzeichnis eine Datei .clangd an, die auf die erzeugten Include-Pfade aus der ESPHome-Build-Ausgabe (.esphome/build/) verweist. Das ist rein kosmetisch und optional.
PlatformIO stürzt mit 0xC0000001D ab (EXCEPTION_ILLEGAL_INSTRUCTION)
Was Sie sehen:
Error: Failed to install Python dependencies (exit code: 3221225501)
(0xC0000001D = 3221225501 dezimal)
Was es bedeutet: PlatformIO 6.1.19+ verwendet die Rust-Binary uv, um Python-Abhängigkeiten in seine interne penv zu installieren. Auf einigen aktuellen Intel-Laptop-CPUs stürzt uv mit EXCEPTION_ILLEGAL_INSTRUCTION ab, wegen einer Befehlssatz-Inkompatibilität. Betroffen ist der Schritt penv_setup.py install bei einer frischen PlatformIO-Installation.
Workaround (alle Abhängigkeiten vorab per pip installieren und uv umgehen):
# Step 1: install the ESP32 platform's Python dependencies directly
& "$env:USERPROFILE\.platformio\penv\Scripts\python.exe" -m pip install `
"littlefs-python>=0.16.0" "fatfs-ng>=0.1.14" "pyyaml>=6.0.2" `
"rich-click>=1.8.6" "zopfli>=0.2.2" "intelhex>=2.3.0" "rich>=14.0.0" `
"cryptography>=45.0.3" "certifi>=2025.8.3" "ecdsa>=0.19.1" `
"bitstring>=4.3.1" "reedsolo>=1.5.3,<1.8" "esp-idf-size>=2.0.0" `
"esp-coredump>=1.14.0" "pyelftools>=0.32"
# Step 2: bootstrap the nested ESP-IDF venv (see the next entry)
& "$env:USERPROFILE\.platformio\penv\.espidf-5.5.4\Scripts\python.exe" `
-m ensurepip --default-pip
& "$env:USERPROFILE\.platformio\penv\.espidf-5.5.4\Scripts\python.exe" `
-m pip install -r `
"$env:USERPROFILE\.platformio\packages\framework-espidf\tools\requirements\requirements.core.txt"
Sind diese Pakete installiert, liefert get_packages_to_install() in penv_setup.py eine leere Liste, und das pip-Install über uv wird nicht mehr aufgerufen. Nachfolgende esphome compile-Läufe funktionieren normal.
Der Workaround muss nach einer frischen PlatformIO-Installation oder nach dem Leeren des Caches ~/.platformio erneut angewendet werden.
ESP-IDF-venv: kein Modul idf_component_manager
Was Sie sehen:
ModuleNotFoundError: No module named 'idf_component_manager'
Er erscheint beim ersten esphome compile auf einem Rechner, auf dem PlatformIO das ESP-IDF-Framework heruntergeladen, aber nicht den vollständigen Bootstrap seiner Anforderungen ausgeführt hat.
Was es bedeutet: Das PlatformIO-ESP-IDF-Framework wurde in die verschachtelte venv ~/.platformio/penv/.espidf-5.5.4/ installiert (die Versionsnummer kann abweichen). Diese venv braucht requirements.core.txt aus dem Framework-Paket. Ist der uv-Workaround oben angewendet, bootstrapped Schritt 2 pip in die venv und installiert die Anforderungen.
Wenn der Fehler nach Anwenden des uv-Workarounds auftritt, aber Schritt 2 übersprungen wurde:
# Find the IDF venv (the version number may differ):
ls "$env:USERPROFILE\.platformio\penv\" | Where-Object { $_.Name -like ".espidf-*" }
# Bootstrap pip into the IDF venv:
& "$env:USERPROFILE\.platformio\penv\.espidf-5.5.4\Scripts\python.exe" `
-m ensurepip --default-pip
# Install the IDF core requirements:
& "$env:USERPROFILE\.platformio\penv\.espidf-5.5.4\Scripts\python.exe" `
-m pip install -r `
"$env:USERPROFILE\.platformio\packages\framework-espidf\tools\requirements\requirements.core.txt"
Ersetzen Sie 5.5.4 durch Ihre IDF-Versionsnummer (prüfen Sie ~/.platformio/penv/).
esphome compile schlägt fehl: get_object_id_hash nicht gefunden
Was Sie sehen:
error: 'class esphome::rbamp::RbAmpComponent' has no member named 'get_object_id_hash'
Was es bedeutet: Eine alte Version von rbamp.cpp rief this->get_object_id_hash() auf, um den NVS-Slot zu bestimmen. Diese Methode wurde in ESPHome 2025.x aus PollingComponent entfernt.
Abhilfe: Aktualisieren Sie die Komponente auf die aktuelle Version. Moderner Code verwendet eine Hash-Erzeugung, die mit ESPHome 2025.x und neuer kompatibel ist.
ESPHome zu alt — set_i2c_address nicht gefunden
Was Sie sehen:
error: 'class esphome::i2c::I2CDevice' has no member named 'set_i2c_address'
Was es bedeutet: Der Ablauf new_address: ruft i2c::I2CDevice::set_i2c_address() auf, was einem älteren ESPHome fehlt.
Abhilfe: auf ESPHome 2025.3.0 oder neuer aktualisieren. Das HA-ESPHome-Add-on folgt dem aktuellen Release automatisch — der empfohlene Installationsweg.
# If using a local Python venv:
pip install --upgrade esphome
6. Identität / Fähigkeit / Fehler (v1.3)
Dieser Abschnitt erklärt, was die einzelnen Werte der Identitäts-Entitäten (ein Template-text_sensor über lambda:), die Fähigkeits-Bitmap und die in v1.3 hinzugekommenen REG_ERROR-Codes bedeuten.
Identitätsabfragen liefern „UNK“ / „UNREADABLE“
Was Sie sehen (Template-text_sensor):
text_sensor:
- platform: template
name: "Meter variant"
lambda: 'return id(my_meter).get_variant_str();' # → "UNK" in HA
[D][rbamp:xxx]: get_variant_str(): REG_HW_VARIANT read failed (NACK) — returning UNK
Was es bedeutet:
-
"UNK"— die Komponente konnteREG_HW_VARIANT(0x55) nach allen Wiederholungen nicht lesen. Ursachen: Das Modul läuft auf Legacy-Firmware (v1.0–v1.1, vor der Varianten-Erkennung), oder ein grenzwertiger I²C-Bus mit erschöpften NACK-Wiederholungen bei genau diesem Register. -
"UNREADABLE"— die Lesung lieferte einen Wert außerhalb von0x55..0x5A, außerhalb des Bereichs gültiger Variantencodes. Das deutet auf beschädigte Firmware oder eine Kollision im Rohregister hin (zum Beispiel einen veralteten Puffer).
Fix:
-
Liegt die Firmware unter v1.2, ist die Varianten-Erkennung nicht verfügbar. Der
text_sensorveröffentlicht trotzdem; verwenden Sie einen YAML-seitigen Hinweis übertopology:oder initialisieren Sie über ein HA-Template neu. -
Ist die Firmware v1.3+ und der Bus grenzwertig, siehe i2c_master hängt.
CAPABILITY-Bitmap = 0x0000
Was Sie sehen:
text_sensor:
- platform: template
name: "Meter capability"
lambda: 'return id(my_meter).get_capability_hex();' # → "0x0000"
Was es bedeutet: Das Fähigkeitsregister existiert auf dieser Firmware nicht — es liefert 0 (das übliche Verhalten „Register nicht implementiert“ bei der rbAmp-Firmware). Dies betrifft Legacy-Firmware v1.0–v1.2.
Verhalten der Komponente: Alle fähigkeitsgesteuerten Funktionen (Fleet-GC, zweiphasiger Adress-Commit, save_user_config, clear_error) fallen automatisch auf den Legacy-Pfad zurück:
fleet_gc_enable: true→ Warnung + Überspringen (nicht von der Firmware angekündigt)new_address:→ einphasiger Rückfall, erfordert den Werks-Provisionierungsmodusclear_error()→ Rückfall auf den Vendor-Opcode (nach bestem Bemühen)
Keine Regression: Bestehende v0.4.0-Installationen funktionieren ohne Änderungen am YAML oder am Verhalten weiter. Das ist Kanon C5 — die fähigkeitsgesteuerte Logik bricht nie die Legacy-Funktion.
last_error_str() zeigt "ERR_PARAM" nach einer Änderung von ct_model: oder sensor_class:
Was Sie sehen:
[W][rbamp:xxx]: REG_ERROR after CT_MODEL write: 0xFE (DEV_ERR_PARAM)
get_last_error_str() → "ERR_PARAM".
Was es bedeutet: Die Firmware hat den geschriebenen Wert abgelehnt. Die häufigsten Auslöser:
-
Ein Code außerhalb der zulässigen Menge — für
SCT_013sind die zulässigen Codes{1, 2, 3, 4, 5, 6, 7}. -
CT-Modell nicht im klassenspezifischen Erlaubnissatz — zum Beispiel
WIRED_CT_1mitsensor_class: SCT_013. Siehe 03_sensor_selection.md Tabelle je Klasse. -
Code 0 (UNSET) — ein Versuch, das CT-Modell über 0 zu löschen. Nicht unterstützt; verwenden Sie
dev.factoryReset()für einen vollständigen Reset.
Wiederherstellung: Rufen Sie id(my_meter).write_clear_error(); über einen YAML-Dienst oder über lambda: in on_boot: auf, um REG_ERROR + EVENT_FLAGS bit3 zu löschen. Danach können Sie mit einem korrekten Wert erneut versuchen.
api:
services:
- service: my_meter_clear_error
then:
- lambda: 'id(my_meter).write_clear_error();'
Die Änderung von ct_model: / sensor_class: wird abgewiesen (Protokollzeile, kein Schreiben)
Was Sie sehen:
[W][rbamp:xxx]: ct_model refused: module is calibrated with its fitted sensor (class N) — ...
[W][rbamp:xxx]: sensor_class refused: module is calibrated with its fitted sensor (class N); ...
Was es bedeutet: Das Modul wurde als Paar mit seinem eigenen eingebauten Sensor kalibriert (WIRED_CT / BUILTIN_CT). Ein generischer Klassen- oder Modellwert würde diese individuelle Kalibrierung ersetzen, daher verweigert die Komponente das Schreiben. Das ist der Schreibschutz, kein Fehler. Ein gleicher Wert wird ebenfalls nie geschrieben (dafür wird auf Warnstufe nichts protokolliert).
Abhilfe: Entfernen Sie sensor_class: / ct_model: / ct_models: für ein solches Modul aus dem YAML. Nur wenn Sie bewusst die generische Voreinstellung möchten, setzen Sie ct_model_force: true zusammen mit dem Modell, flashen einmal und entfernen danach beide Zeilen (das Schema weist ct_model_force: ohne Modellschlüssel ab).
ct_models: wird von diesem Gerät nicht unterstützt (STANDARD-Modul)
Was Sie sehen:
[W][rbamp:xxx]: ct_models: (per-channel) not supported by this device — it does not advertise persistent per-channel model storage ... Use the global `ct_model:` key. (Keys ignored.)
Was es bedeutet: Das Modul kann kanalweise Modelle über einen Stromausfall hinweg nicht speichern; ein Schreibversuch würde sie stillschweigend zurücksetzen. Die Komponente verweigert deshalb den Vorgang, statt den Wert zu verlieren.
Abhilfe: Verwenden Sie für alle Kanäle den einzelnen Schlüssel ct_model:.
Änderung von ct_model: startet das Modul einmal neu
Bei SCT-Modulen mit Firmware bis 1.4.19 schließt ein Wechsel auf einen anderen Nennwert mit einem Neustart des Moduls ab (speichern, zurücksetzen, neu erkennen). Das Protokoll zeigt den Neustart und danach, dass Strom/Leistung/Energie auf den neuen Nennwert skaliert sind; Sensoren können währenddessen einen update()-Zyklus überspringen. Das gehört zum normalen Ablauf. Firmware 1.4.20 und neuer führt den Wechsel im Modul aus, ohne Neustart. Meldet das Protokoll, dass die angewendete Verstärkung außerhalb des erwarteten Bereichs liegt, skaliert die Komponente nicht; prüfen Sie, ob ct_model: zur physisch eingebauten Klemme passt.
Gesamtsummen-/Winkelsensoren veröffentlichen nie
Was Sie sehen (Startlog):
[W][rbamp:xxx]: energy_total/energy_net/reactive_energy sensors need on-device energy counters, which this device does not advertise — they will never publish. Per-channel `energy:` keys still work ...
[W][rbamp:xxx]: voltage_angle_*/phase_sequence sensors need a newer device firmware — they will never publish on this device
Was es bedeutet: Das angeschlossene Modul (oder seine Firmware) liefert diese Werte nicht. Die Schlüssel validieren, aber es wird nichts veröffentlicht.
Abhilfe: Verwenden Sie die Sensoren energy: je Kanal oder aktualisieren Sie die Modul-Firmware.
start_current_ua: ignoriert
[W][rbamp:xxx]: start_current_ua: not supported by this device firmware — key ignored — das Modul zählt Energie bei jedem Strom. Der Schlüssel wirkt nur bei STANDARD-Modulen mit Energiezählern im Gerät. Andere Werte als 0 oder 10..2540 in Schritten von 10 werden bei esphome config abgewiesen.
update_interval abgewiesen
update_interval unter 1s wird vom Schema bei esphome config abgelehnt. latch_interval darf nicht kürzer sein als update_interval.
EVENT_FLAGS Bit3 (ERR_LATCH) — Verhalten beim erneuten Setzen
Was Sie sehen: Nach clear_error() ist Bit3 in EVENT_FLAGS wenige hundert Millisekunden später erneut gesetzt (hartnäckiges Wiedersetzen).
Was es bedeutet: Der dauerhafte Fehlerkanal der Firmware setzt Bit3 nach einem Löschen erneut, wenn die ursprüngliche Fehlerbedingung nicht behoben ist. Das ist so gewollt — der Master kann das erste Löschen verpassen und darf nicht dauerhaft annehmen, der Fehler sei weg, solange der Parameter noch falsch ist.
Abhilfe: Die vollständige Wiederherstellung erfordert zwei Schritte:
- Ursache beheben (falschen CT-Modellcode ersetzen, das YAML korrigieren).
write_clear_error()— dieser Aufruf löschtREG_ERRORundEVENT_FLAGSbit3 in einem Schritt.
Wenn bit3 immer wieder einrastet, ist der Parameter weiterhin falsch; lesen Sie get_last_error_str() erneut, um genau herauszufinden, was die Firmware ablehnt.
Quelle und Probleme: rb-amp/rbamp-esphome · diese Seite im Repository: docs/10_troubleshooting.md (v1.9.1)