rbAmp
DE
Shop
Docs
Aktualisiert · Auf GitHub bearbeiten

03 · Auswahl des Stromsensors

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.

Das physische Anschließen des Sensors (Zangenausrichtung, Prüfung der L/N-Polarität) ist in 04_hardware.md beschrieben. Dieses Kapitel behandelt die Wahl des Modells und die API-Aufrufe.

Wie die SCT-013-Zange auf dem Außenleiter montiert wird, mit dem Pfeil zur Last.

Sensorklasse

rbAmp-Module arbeiten mit CT-Zangen der Familie SCT-013. Sie müssen dem Modul die Sensorklasse einmal mitteilen, mit rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013), bevor Sie mit rbamp_set_ct_model() ein bestimmtes CT-Zangenmodell wählen.

Auswahl des SCT-013-Modells

Entscheidungstabelle zur Wahl des SCT-013-Modells anhand des größten erwarteten Stroms plus 30 Prozent Reserve.

Die SCT-013-Familie hat sieben Modelle, die sich im maximalen Strom des Primärkreises unterscheiden. Alle sieben Codes {1, 2, 3, 4, 5, 6, 7} werden unterstützt.

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 Eine einzelne Last mittlerer Leistung — Kühlschrank, Waschmaschine, Klimagerät bis 2 kW
3 SCT-013-030 0…30 A ✅ charakterisiert Hausanschluss eines mittleren Haushalts — bis etwa 7 kW
4 SCT-013-050 0…50 A ✅ charakterisiert Großer Hausanschluss — elektrische Heizung, E-Ladestation, Haus mit Lastspitzen
5 SCT-013-100 0…100 A ✅ charakterisiert Hauptanschluss eines Hauses oder eines kleinen Büros
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}. Ein Code außerhalb dieser Menge (z. B. 0 oder 8), an rbamp_set_ct_model_ch übergeben, liefert ESP_ERR_INVALID_ARG + REG_ERROR = 0xFE (ERR_PARAM). Siehe 09 · API-Referenz, Abschnitt „Error model v1.3“, für Details, wie die Komponente diesen Fehler zurückgibt.

Wie man das richtige Modell auswählt

Die Grundregel:

  1. Den maximalen Strom bestimmen, der im Stromkreis fließen kann (anhand der größten Last + 30 % Reserve).

  2. Wählen Sie die kleinste Nennzange oberhalb dieses Werts.

  3. Nicht um mehr als das 5-Fache überdimensionieren. Eine SCT-013-100-Zange auf einem Stromkreis mit 5 A Maximum funktioniert, liefert aber geringe Auflösung und einen großen Fehler bei typischen Werten.

Reserve

Eine SCT-013-Zange arbeitet innerhalb ihres Nennbereichs ohne Sättigung. Kurze Spitzen (Anlauf eines Kompressors, induktive Last) können den Nennwert um das 5- bis 7-Fache überschreiten — das ist normal, die Zange hält es physikalisch aus, aber die Messung wird oberhalb des Nennwerts nichtlinear.

Hat Ihre Last eine Spitzenstromstärke über der Nennlast der Zange, wählen Sie die nächstgrößere. Beispiel: für eine Waschmaschine mit 12 A Einschaltstrom (bei 2–3 A Dauerbetrieb): 12 A × 1.3 = 15.6 A, also ist die kleinste passende Zange darüber die SCT-013-020 (Code 6) — besser als eine SCT-013-005.

So teilen Sie dem Modul Ihre Wahl mit

Zwei Aufrufe sind zwingend, in der richtigen Reihenfolge — zuerst rbamp_set_sensor_class(), dann rbamp_set_ct_model(). Rufen Sie rbamp_set_ct_model() vor rbamp_set_sensor_class() auf, liefert die Komponente ESP_ERR_INVALID_STATE, und die Voreinstellung wird NICHT geladen.

Hinweis

Ein CT-Modell ist eine funktionale Voreinstellung, kein Etikett. Das Schreiben des CT-Modells wendet sofort den NF-Grundwert, die Verstärkung und den Formfaktor auf die Messpipeline des Moduls an; die Stromwerte ändern sich. Das Ändern von sensor_class setzt das CT-Modell auf den Standard (0) zurück und erfordert erneutes Setzen.

C
#include "driver/i2c_master.h"
#include "rbamp.h"

void setup_sensor(rbamp_handle_t dev) {
    /* Step 1: select the sensor family.
     * MANDATORY before rbamp_set_ct_model(). */
    esp_err_t err = rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013);
    if (err != ESP_OK) {
        ESP_LOGE("app", "set_sensor_class: %s", rbamp_err_to_str(err));
        return;
    }

    /* Step 2: select the 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. */
    err = rbamp_set_ct_model(dev, 3);   /* e.g. SCT-013-030 */
    if (err != ESP_OK) {
        /* Possible causes:
         *   ESP_ERR_INVALID_STATE — rbamp_set_sensor_class() was not called
         *                            before rbamp_set_ct_model()
         *   ESP_ERR_INVALID_ARG   — code not in {1,2,3,4,5,6,7}
         *   ESP_FAIL              — communication error (NACK after retry)
         */
        ESP_LOGE("app", "set_ct_model: %s", rbamp_err_to_str(err));
        return;
    }
}
Hinweis

Die Komponente ruft rbamp_set_sensor_class() für Sie bewusst NICHT auf. Wird dieser Schritt übersprungen, liefert rbamp_set_ct_model() ESP_ERR_INVALID_STATE, ohne in den Flash zu schreiben. Das geschieht, um das Verhalten vorhersehbar und explizit zu halten — keine „Magie“ in der öffentlichen API.

Nach diesen beiden Aufrufen:

  • Das Modul speichert beide Werte im Flash — die Einstellung übersteht Reset, Stromausfall und ein erneutes Flashen der Firmware.

  • Die Kalibrierkoeffizienten für diese spezielle Kombination (Sensorklasse + Modell) werden aus der Werks-Voreinstellungstabelle geladen. Sie müssen keine manuellen Kalibrierregister anfassen.

  • Der nächste Aufruf rbamp_read_current(dev, 0, &i) liefert bereits einen Wert in Ampere mit korrekter Skalierung.

Gesamtzeit für beide Aufrufe beträgt etwa 1.4 Sekunden (zwei Flash-Schreibvorgänge × ~700 ms je Vorgang, begrenzt durch die Löschzeit der Flash-Seite). Das geschieht einmal bei der Erstinstallation; die Einstellung wird im Flash gespeichert und nie wiederholt.

Hinweis

Wenn Sie den Sensor bereits beim ersten Start gewählt haben und den ESP32 nur neu starten, müssen Sie rbamp_set_sensor_class() und rbamp_set_ct_model() nicht wiederholen — das Modul merkt sich die frühere Wahl. Schadet aber auch nicht: Ein erneuter Aufruf mit demselben Wert schreibt nur dasselbe Byte erneut.

Überprüfen der Einrichtung

Eine einfache Plausibilitätsprüfung nach rbamp_set_ct_model():

C
#include 
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"

static const char *TAG = "rbamp_check";

void sanity_check(rbamp_handle_t dev) {
    ESP_LOGI(TAG, "Ready. Connect a purely resistive load "
                  "(e.g. an incandescent lamp).");
    ESP_LOGI(TAG, "Expect a stable PF ~= 1.0 and positive P.");

    while (1) {
        float u = NAN, i = NAN, p = NAN, pf = NAN;
        rbamp_read_voltage(dev, 0, &u);
        rbamp_read_current(dev, 0, &i);
        rbamp_read_power(dev, 0, &p);
        rbamp_read_power_factor(dev, 0, &pf);

        ESP_LOGI(TAG, "U=%.1f V  I=%.2f A  P=%.1f W  PF=%.2f",
                 (double)u, (double)i, (double)p, (double)pf);
        vTaskDelay(pdMS_TO_TICKS(2000));
    }
}

Bei einer rein ohmschen Last (Glühlampe, Wasserkocher, Heizelement) erwarten Sie:

  • U ≈ 220–240 V (bei 230-V-Netz)
  • I ≈ entspricht der Lastleistung (P / U)
  • P > 0 und stabil
  • PF ≈ 1.0 (deutlich positiv)

Wenn etwas nicht stimmig ist, 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 einzelne Last mit vollständiger Leistungsberechnung (P, PF, Q, Wh) — der typische Netzzähler
UI2 2 ja Zwei unabhängige Lasten an einer Phase mit Leistung je Kanal (1 U + 2 I)
UI3 3 ja Drei Lasten auf einer Phase mit Leistungsmessung je Kanal (1 U + 3 I)
I1 1 nein Unterzähler ohne Leistungsberechnung (nur Strom) — wenn die Netzmessung von einem separaten UI1 übernommen wird
I2 2 nein Zweikanaliger Strom-Unterzähler — Aufschlüsselung je Stromkreis
I3 3 nein Dreikanaliger Strom-Unterzähler — Aufschlüsselung je Stromkreis / Zwei-CT-Topologie

Was jeder Kanal misst

  • U-Kanal (nur UI): U_rms, U_peak, Frequenz. Ein* pro Modul (an die Eingangsphase gebunden).
  • I-channels:
  • bei UI-Varianten — jeder Kanal liefert I_rms, I_peak, P (Wirkleistung), PF, avg_p über die Periode.
  • auf I-Varianten — nur Strom (I_rms, I_peak). Wirkleistung und PF werden nicht berechnet — sie setzen eine Spannung voraus, die die I-Variante nicht hat. Die Register power[]/power_factor[] auf I-Varianten liefern 0.
  • Mehrphasig vs. Mehrpunkt: Das Modul unterscheidet NICHT, an welche Phase jeder I-Kanal angeschlossen ist. Diese Semantik liegt auf der Master-Seite.

CT-Modell je Kanal — unabhängige kanalweise Kalibrierung

Auf Mehrkanal-Modulen (I2, I3) hat jeder Stromkanal eine unabhängige Wahl des SCT-013-Modells. Sie können zum Beispiel einen SCT-013-005 an Kanal 0 (eine einzelne Steckdose), einen SCT-013-030 an Kanal 1 (die Herdleitung) und einen SCT-013-020 an Kanal 2 (Warmwasserbereiter oder Boiler) anschließen.

Die API für die Auswahl je Kanal lautet rbamp_set_ct_model_ch(dev, channel, code):

C
rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013);   /* once for all */

/* v1.3: channel binding order is arbitrary. */
rbamp_set_ct_model_ch(dev, 0, 1);   /* channel 0: SCT-013-005 */
rbamp_set_ct_model_ch(dev, 1, 3);   /* channel 1: SCT-013-030 */
rbamp_set_ct_model_ch(dev, 2, 6);   /* channel 2: SCT-013-020 */
Hinweis

✅ Die Bindungsreihenfolge ist beliebig (Kanon v1.3). Das Schreiben von REG_CT_MODEL (0x05) stellt den Wert nur bereit, wendet ihn aber nicht automatisch auf einen Kanal an. Angewandt wird er nur über CMD_SET_CT_MODEL_CHn je Kanal, der den aktuell bereitgestellten Wert nimmt und ihn auf seinen eigenen Kanal schreibt. Kanäle lassen sich in beliebiger Reihenfolge konfigurieren (ch0 zuerst, zuletzt, verschachtelt — es macht keinen Unterschied); es kommt zu keinem Überschreiben. Alle Erwähnungen von „ascending / descending / bind ch0 last“ in älteren Dokumenten und Codebasen beziehen sich auf das Verhalten vor v1.3 — sie können entfernt werden.

Jeder Kanal wird in zwei Schritten gebunden: (1) das Modell in REG_CT_MODEL schreiben (Staging), (2) CMD_SET_CT_MODEL_CHn (Bindung). Die Prüfung (Klasse, Modell) übernimmt die Firmware beim Bindungsschritt.

Wenn mehrere Kanäle dasselbe Modell erhalten, können Sie mit demselben Code aufrufen — wiederholte Anwendung ist idempotent:

C
rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013);
rbamp_set_ct_model_ch(dev, 0, 1);
rbamp_set_ct_model_ch(dev, 1, 1);
rbamp_set_ct_model_ch(dev, 2, 1);

Eine Alternative für den typischen Fall I2/I3 ist rbamp_configure_channels(dev, class, models[], n): eine einzige Operation konfiguriert die Klasse + alle Kanäle + speichert alles mit einem abschließenden CMD_SAVE_USER_CONFIG im Flash (flash-schonend — ein Löschzyklus statt N). Siehe Kapitel 09 · API-Referenz, Abschnitt „Multi-channel configuration“.

Der Einzelparameter-Aufruf rbamp_set_ct_model(dev, code) ist eine Komfortform für Ein-Kanal-Varianten (wirkt auf Kanal 0). Bei Mehrkanal-Modulen entspricht er rbamp_set_ct_model_ch(dev, 0, code).

Erweiterte Einrichtung: zwei Zangen unterschiedlicher Nennwerte an einer Leitung

Hinweis

⚙ Ein zusätzliches Muster, kein Grundmuster. Dieser Abschnitt beschreibt eine optionale Technik zur Verbesserung der Auflösung bei kleinen Strömen. Für die meisten Installationen reicht eine einzelne, auf den Lastbereich dimensionierte Zange. Verwenden Sie Dual-CT nur, wenn Sie eine bestimmte Genauigkeitsanforderung bei Strömen < 1 A haben.

Wann es gilt

  • Mehrkanal-Module I2 / I3 (aktuelle Hardware).
  • 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: der Hausanschluss einer Wohnung, an dem tagsüber 50–100 W Standby anliegen und abends der Einschaltstoß eines Wasserkochers oder Elektroherds mit 3+ kW.

Die Idee

Zwei SCT-013-Zangen mit unterschiedlichen Nennwerten werden am selben Leiter angebracht:

Zwei Zangen unterschiedlicher Nennwerte, am selben Leiter eines Moduls 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 selbst den Kanal anhand des Stromwerts — solange die kleine Zange in ihrem linearen Bereich ist, ist ihr Messwert genauer; bei Überschreitung schaltet er auf die große um.

Konfiguration

Die Sensorklasse einmal, danach die Modelle je Kanal in beliebiger Reihenfolge (v1.3 reines Staging, die Reihenfolge spielt keine Rolle):

C
rbamp_set_sensor_class(dev, RBAMP_SENSOR_SCT013);   /* once */

rbamp_set_ct_model_ch(dev, 0, 1);   /* ch0 = SCT-013-005 (0..5 A)  — small clamp */
rbamp_set_ct_model_ch(dev, 1, 3);   /* ch1 = SCT-013-030 (0..30 A) — large clamp */

Endzustand: ch0 = SCT-013-005, ch1 = SCT-013-030. ✓

Eine Alternative über rbamp_configure_channels() — eine Operation statt zwei:

C
uint8_t models[2] = { 1, 3 };   /* ch0=5A, ch1=30A */
rbamp_configure_channels(dev, RBAMP_SENSOR_SCT013, models, 2);

Aggregationslogik auf der Masterseite

Die einfachste Vorlage schaltet bei einem Schwellenwert:

C
float read_combined_current(rbamp_handle_t dev) {
    float i_low  = NAN;
    float i_high = NAN;
    esp_err_t err_low  = rbamp_read_current(dev, 0, &i_low);   /* small */
    esp_err_t err_high = rbamp_read_current(dev, 1, &i_high);  /* large */

    /* While the small clamp is far from saturation, it gives better
     * accuracy at small currents. Switch to the large one as it
     * approaches the overload point.
     *
     * The 4.5 A threshold for the SCT-013-005 is an example value;
     * figures for low-current dual-CT use are not published. */
    if (err_low == ESP_OK && i_low < 4.5f) {
        return i_low;
    }
    return (err_high == ESP_OK) ? i_high : NAN;
}
Hinweis

Zwei Zangen auf einem Draht sind bei den meisten Haushaltskabeln physisch möglich, benötigen aber etwas Platz im Verteiler.

⚙ Dual-CT-Werte. Werte für die Nutzung von Dual-CT bei kleinen Strömen (Verhalten nahe der Schwelle, Abweichung der beiden Zangen im überlappenden Bereich) werden nicht veröffentlicht. Behandeln Sie Dual-CT als Pilotmuster; für kritische Anwendungen ist eine einzige, auf den oberen Lastbereich dimensionierte Zange vorzuziehen.

Mehrkanal-Module — I2 und I3 (nur Strom)

Die reinen Strommodule für die Mehrkanal-Topologie sind I2 (zwei Stromkanäle) und I3 (drei Stromkanäle). Beide Module haben keinen U-Kanal, daher ist eine P- / PF- / Q-Berechnung auf Modulseite unmöglich — sie liefern Strom je Kanal (I_rms, I_peak je Kanal) und nichts weiter.

UI2 und UI3 fügen den U-Kanal hinzu (1 U + 2 I / 1 U + 3 I), sodass die Leistung je Kanal auf dem Modul berechnet wird. Wo nur eine Stromaufschlüsselung nötig ist, verwenden Sie I2/I3 als Stromteilzähler zusammen mit einer separaten UI1 am Hausanschluss, die die Netzenergie + Spannung liefert.

Lesen der Kanäle (I2 / I3)

C
float i0, i1, i2;
rbamp_read_current(dev, 0, &i0);   /* ch0 */
rbamp_read_current(dev, 1, &i1);   /* ch1 */
rbamp_read_current(dev, 2, &i2);   /* ch2 — I3 only */

/* On an I variant rbamp_read_power(...) returns 0 — this is by design. */
float p_dummy; rbamp_read_power(dev, 0, &p_dummy); /* = 0.0f */

Wenn Sie Wirkleistung auf jeder Teilleitung brauchen, setzen Sie ein UI1 an den Hausanschluss und teilen dessen Gesamtleistung proportional zum Strom je Kanal I[k] aus den I2/I3 auf. Das ist die typische Installation im Haushalt:

C
/* Pseudo-pattern: UI1 on mains, I3 on 3 sub-lines */
float p_mains_total, i0, i1, i2;
rbamp_read_power(mains_ui1, 0, &p_mains_total);
rbamp_read_current(loads_i3, 0, &i0);
rbamp_read_current(loads_i3, 1, &i1);
rbamp_read_current(loads_i3, 2, &i2);
float i_sum = i0 + i1 + i2;
if (i_sum > 0.01f) {
    float p0 = p_mains_total * i0 / i_sum;   /* approximation */
    /* ... */
}
Hinweis

Das ist eine Näherung: Die Aufteilung nach Strom funktioniert, wenn der Leistungsfaktor über alle Lasten ungefähr gleich ist. Für eine genaue Leistungsabrechnung je Last verwenden Sie an jeder Leitung eine UI-Variante (UI1 / UI2 / UI3 / UI5 / UI7).

Anwendungen von I2 / I3

  • Unterzählung des Stroms: Aufschlüsselung des Stroms je Stromkreis, ein Messpunkt am Verteiler statt eines eigenen Moduls je Leitung.

  • Aufteilung zusammen mit einer UI1: Die UI1 liefert Netzenergie / -leistung, und die I2/I3 schlüsseln den Verbrauch nach Stromkreis auf (siehe Kapitel 06, Szenario 1).

  • Stromüberwachung ohne Leistungsabrechnung: Überlastkontrolle, Erkennung von Ein-/Ausschalten einer Last, das I(t)-Profil.

  • Zwei CTs + ein dritter Kanal (I3): eine große Zange auf Kanal 0 für einen weiten Bereich, eine kleine auf Kanal 1 für Genauigkeit bei kleinen Strömen, der dritte Kanal für eine separate Hilfsleitung. Siehe den Abschnitt „Advanced setup: two clamps of different ratings“ (Erweiterte Einrichtung: zwei Zangen unterschiedlicher Nennwerte) oben.

Leistungsberechnung auf der Masterseite:

C
float i;
rbamp_read_current(dev, ch, &i);

/* If the voltage is known (from a UI module upstream or fixed) */
const float U_nominal = 230.0f;
float p_estimated = U_nominal * i;   /* without PF — guaranteed overestimate */

Für eine genaue Leistungsbuchung verwenden Sie ein UI-Modul (mit U-Kanal).

Ansätze zur Verbesserung der Empfindlichkeit bei kleinen Strömen

Hat Ihre Last einen großen Dynamikbereich (z. B. 1 W Standby eines Routers gegenüber einem 2000-W-Warmwasserboiler an derselben Steckdose), verliert eine einzelne, auf die Obergrenze ausgelegte Zange die kleinen Ströme im Rauschen.

Drei Strategien in aufsteigender Komplexität:

  1. Dimensionieren Sie die Zange auf das Maximum, nicht „mit Reserve“. Der häufigste Fehler ist, eine SCT-013-100 (100 A) an eine Haushaltssteckdose mit typischem Verbrauch von 0.5–10 A zu hängen. Das Signal liegt im unteren Bereich von 1–10 % des Sensorbereichs — dort wird das Rauschen mit dem Signal vergleichbar. Für das Haushaltsszenario (16-A-Steckdose) ist der SCT-013-030 optimal; zum Anschluss eines einzelnen Geräts (≤ 5 A) der SCT-013-005.

  2. Zwei-CT-Topologie (erfordert eine I2/I3-Variante — zwei Stromkanäle an einem Modul): eine kleine Zange für den unteren Bereich und eine große für den oberen, wobei der Master anhand eines Schwellwerts umschaltet. Siehe den Abschnitt „Zwei-CT-Topologie“ oben — das Muster ist ein Pilotprojekt; Messwerte für den Einsatz von Zwei-CT bei kleinen Strömen werden nicht veröffentlicht.

  3. Grundrauschen (werksseitig): Die Kalibrierung des Moduls berücksichtigt es bereits. Auf der Anwenderseite ist nichts weiter zu tun als setSensorClass() + setCTModel(). Konkrete Genauigkeitswerte 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. Der aktuelle Modus wird aus dem entsprechenden Modul-Statusregister gelesen.

Befehl (Opcode) Produktion Speichert dauerhaft
CMD_SAVE_USER_CONFIG (0x32) ✅ OK ct_model / sensor_class / fleet_config / group_id / label
CMD_COMMIT_ADDR (0x30, magisch scharf geschaltet) ✅ OK I²C-Adresse (siehe 04 · Verdrahtung — Änderung der Adresse)
CMD_RESET (0x01) ✅ OK — (Software-Reset)
CMD_LATCH_PERIOD (0x27) ✅ OK — (Periodensnapshot)
CMD_CLEAR_ERROR ✅ OK —
CMD_SAVE_GAINS ❌ GESPERRT im Produktivbetrieb (liefert ERR_PARAM) Verstärkungen / NF / Phase (Werkskalibrierung)
CMD_FACTORY_RESET ❌ GESPERRT in der Produktion —

Im Produktionsmodus werden Schreibvorgänge der Werkskalibrierung (CMD_SAVE_GAINS, CMD_FACTORY_RESET) von der Firmware abgelehnt — das schützt vor dem versehentlichen Löschen der Werkskoeffizienten. Den Werkmodus einzuschalten ist eine Aufgabe des Herstellers; Endanwender brauchen ihn nicht.

Rücklesen ≠ Persistenz

Die Produktionssperre akzeptiert einen Schreibvorgang in den RAM (ein nachfolgendes Lesen liefert den geschriebenen Wert), aber das Speichern im Flash kann abgelehnt werden. Nach einem Neustart kehrt der Wert zum Zustand vor dem Schreiben zurück. Der einzig gültige Weg, die Persistenz zu bestätigen, ist ein Neustart des Moduls über CMD_RESET und erneutes Lesen:

C
rbamp_set_ct_model(dev, code);
rbamp_reset(dev);                       // CMD_RESET 0x01, works in production
vTaskDelay(pdMS_TO_TICKS(400));         // boot complete
uint8_t check; rbamp_read_ct_model(dev, 0, ✓);
assert(check == code);                  // ONLY now is persistence confirmed

Querverweis: 09 · API-Referenz — Details zu einzelnen Opcodes; 10 · Diagnose — was zu tun ist, wenn die Persistenz nicht bestätigt wird.

Was als Nächstes kommt

  • 04 · Verdrahtung — physisches Anschließen der Zange, Pfeilrichtung, L/N-Polarität

  • 05 · Schnellstart — das vollständige erste Lichtprojekt

  • 06 · Beispiele — funktionierende Szenarien für verschiedene Lasten

  • 10 · Diagnose — was zu tun ist, wenn die Messwerte merkwürdig sind (negativer PF, instabiles I usw.)


Quelle & Issues: rb-amp/rbamp-esp-idf · diese Seite im Repo: docs/03_sensor_selection.md (v1.7.3)