rbAmp
DE
Shop
Docs
Aktualisiert · Auf GitHub bearbeiten [Edit on GitHub]

11 · Änderungsprotokoll

Versionsverlauf der externen Komponente rbamp für ESPHome. Diese Seite spiegelt CHANGELOG.md im Repository, das die maßgebliche Quelle ist.

Öffentliche Releases werden mit v1.9.0 fortgesetzt; die unten aufgeführten Zwischenversionen wurden nur intern veröffentlicht.

Contents:


v1.9.1 — 2026-11-01

STD-Snapshot-Bänke im YAML, die Klemmenmodelle 50 A und 100 A sowie eine klare Meldung, wenn ein werkseitig gepaartes Modul einen Konfigurationsschreibvorgang verweigert.

Hinzugefügt

  • Snapshot-Bänke (period_banks:) für Module, die sie anbieten (16-Bit-Linie, Image 0x7E und neuer): Durchschnittsleistung, Energie, Spitzenwerte und Periodenlänge pro Periode auf einer der acht Bänke des Moduls, erfasst über ein interval: und/oder durch die neue Aktion rbamp.latch_bank. Periodenenergiewerte sind pro Periode (state_class: measurement), keine Zähler. Die erste Erfassung nach dem Start oder einem Modul-Neustart startet nur die Periode. Beispiel: example/std_banks.yaml.

  • Host-Tests für die Bank-Logik: tests/host/test_std_bank.cpp (einfaches g++, ohne Framework).

  • Sensormodell-Register: Codes 11 (50 A, 33 Ω) und 13 (100 A, 20 Ω) sind jetzt charakterisiert und werden ohne den Hinweis „reserved“ akzeptiert.

Fest

  • Bei Firmware 1.4.22 und neuer verweigert ein werkseitig gepaartes Modul (Klasse WIRED_CT / BUILTIN_CT) Klassen- und Modellschreibvorgänge im Normalbetrieb, auch mit ct_model_force: true (das Erzwingen funktioniert nur im Werksmodus). Die Komponente meldet nun „factory-paired module: configuration locked“ statt eines allgemeinen Parameterfehlers, und ein abgelehnter einzelner Schreibvorgang ct_model: wird weder gespeichert noch von der Nennwertkorrektur gefolgt.

v1.9.0 — 2026-10-21

Öffentliche Veröffentlichungen werden mit dieser Version wieder aufgenommen; Zwischenversionen wurden nur intern veröffentlicht.

Umschalten des SCT-Nennwerts ohne Verlust der Werksgenauigkeit (8-Bit-Linie), dazu die Schutzmechanismen aus den Releases 1.8.x, die in diese öffentliche Version eingeflossen sind.

Hinzugefügt

  • SCT-013-060 und -100 werden akzeptiert (sie wurden clientseitig als reserviert abgelehnt); die Grenzwerte der Sensormodelle wurden auf gemessene Werte aktualisiert.
  • Korrektur beim SCT-Nennwert-Wechsel (Module mit der Sensorklasse SCT-013, Firmware ≤ 1.4.19). Jedes SCT-Modul ist werkseitig mit dem Sensor -030 kalibriert; die Auswahl eines anderen ct_model: ließ Strom, Leistung und Energie früher auf der -030-Skala. Die Komponente schließt das Schreiben des Modells nun mit dem Modul-Neustart ab, den das Verfahren erfordert (Speichern → Reset → erneute Erkennung mit UID-Prüfung), liest die tatsächlich angewendete Verstärkung des Moduls aus und skaliert Strom, Wirk- und Blindleistung sowie die Energieintegration auf den Nennwert des gewählten Sensors — die werkseitige Einzelabgleichung bleibt erhalten. Spannung und Leistungsfaktor sind nicht betroffen. Ein Neustart des Moduls (eigener oder externer) wird erkannt, und die Korrektur wird automatisch neu berechnet. Liegt die angewendete Verstärkung außerhalb von ±5 % des Kalibrationsmodellwerts, warnt die Komponente und skaliert nicht. Keine YAML-Änderung nötig.

  • Firmware 1.4.20+ führt den Nennwert-Wechsel auf dem Gerät durch und meldet ihn — die Komponente erkennt das und lässt die Messwerte unverändert (reines Modell-Schreiben, kein Neustart).

  • Host-Test für die Logik der Korrekturentscheidung: tests/host/test_sct_rating.cpp (einfaches g++, ohne Framework).

v1.8.1 — 2026-10-18

Fest

  • Schutz der Werkskalibrierung für sensor_class: / ct_model: (8-Bit-Linie). Die Firmware löscht die Kanalmodelle und Linearitätskurven bei jedem Schreiben der Sensorklasse (auch bei unverändertem Wert) und wendet die generische Voreinstellung bei jedem Schreiben des CT-Modells erneut an — die Komponente schreibt nun nie einen Wert, den das Gerät bereits hat, und lehnt Klassen-/Modelländerungen aus dem YAML bei einem Modul ab, das zusammen mit seinem eingebauten Sensor kalibriert wurde (Klassen WIRED_CT / BUILTIN_CT), mit einer ausdrücklichen Protokollzeile. Die neue Dienstoption ct_model_force: true wendet die Voreinstellung bewusst erneut an; das Schema weist sie ohne Modellschlüssel ab, damit sie nicht scharf im YAML liegen kann.

  • Lesen außerhalb der Grenzen bei Modulen mit 5/7 Kanälen (UI5/UI7): Die Schleife zur Wiederherstellung beim Start indizierte die Exportfelder mit 3 Slots bis Kanal 6 und konnte einen Müllwert in den benachbarten Sensor veröffentlichen. Behoben durch dasselbe Kanaltor, das alle anderen Exportstellen bereits hatten; die Feldgrößen sind nun durch Assertions zur Kompilierzeit festgelegt.

  • Dokumentation/Kommentare sind auf das Familien-Messfenster von 100 ms abgestimmt (Firmware v1.2+; 200 ms nur bei älteren Images).

v1.8.0 — 2026-10-17

On-Device-Gesamtenergie für die 16-Bit-Linie.

Hinzugefügt

  • Energie aus den Zählern am Gerät (Module mit 16-Bit-Map, die diese in der Fähigkeiten-Bitmap ankündigen): Die Komponente integriert Wh nicht mehr selbst, sondern akkumuliert die eigenen Zähler des Moduls — Summen überleben Neustarts sowohl des ESP32 als auch des Moduls, ohne Integrationsdrift. Mikroauflösung (µWh/µvarh) bei Firmware, die sie liefert, sonst automatischer Rückfall auf die grobe Auflösung. Jeder Snapshot wird in einer einzigen zusammenhängenden I²C-Transaktion gelesen, und die veröffentlichten Summen bleiben über Neustarts des Moduls und Zählerresets hinweg monoton.

  • Neue Gesamtsummen-Sensoren: energy_total, energy_exported_total, energy_net (Bezug − Export, kann sinken), reactive_energy, reactive_energy_exported.

  • Konfigurationsschlüssel start_current_ua: (0 = aus, 10..2540 in Schritten von 10 µA): Unterhalb dieses Stroms zählt ein Kanal keine Energie — bei Nulllast ist die gemessene Leistung Rauschen beider Vorzeichen, das sonst in Import- und Exportzähler schleichen würde. Die Messwerte bleiben unberührt. Schema-geprüft; auf dem Gerät mit verifiziertem Speichern persistiert.

  • Drehstromflächen: voltage_angle_b / voltage_angle_c (Grad, bezogen auf Phase A) und phase_sequence (1 vorwärts · 2 rückwärts · 3 abnormal), veröffentlicht bei Firmware, die sie liefert; sonst „unbekannt“.

  • Lambda-Zugriffsfunktionen: get_std_image_version(), get_phase_sequence_str(), read_start_current_ua().

v1.7.0 — 2026-09-30

Unterstützung der neuen Modulreihe mit 16-Bit-Registerkarte, automatisch auf demselben YAML erkannt.

Hinzugefügt

  • Unterstützung für zwei Linien: Eine Identitätsprüfung beim Start erkennt Module mit 16-Bit-Map und schaltet das Transportprotokoll um (Zeiger in Big-Endian, Burst-Lesen mit Auto-Inkrementierung). Kanalanzahl, Variante und Fähigkeiten kommen aus dem Erkennungsblock des Geräts — topology: und YAML-Slot-Zählungen sind für die Größe der Entitätsmenge nicht mehr nötig. 8-Bit-Module verhalten sich genau wie zuvor.

  • Echtzeit-Sensoren auf der 16-Bit-Linie werden aus den Festkomma-Registern des Geräts veröffentlicht; die Energie nutzt die atomaren Latch-Snapshots des Geräts mit Integration auf dem Master-Takt und dieselbe NVS-Persistenz.

  • Konfigurationsschlüssel (sensor_class:, ct_model:, new_address:) funktionieren auf der 16-Bit-Linie über ihren gestuften Konfigurationsblock mit synchron geprüftem Speichern. Kanalweise ct_models: auf dieser Linie setzen voraus, dass das Gerät persistente Maps je Kanal ankündigt (Fähigkeitsbit); die Komponente verweigert laut, statt den Schreibvorgang stillschweigend zu verlieren.

  • Automatische Wiederherstellung nach einem Modul-Neustart während des Betriebs: Die Komponente erkennt den abgebrochenen Akkumulator-Arm, scharft neu und lädt vor, überspringt ein Fenster, statt die Energieakkumulation stillschweigend zu beenden.

  • NVS-Leerung beim sauberen Herunterfahren (Neustart/OTA verliert nicht mehr bis zu einem Speicherintervall an Energie).

v1.6.0 — 2026-09-04

Kanalweise ct_models: für alle Kanäle (0..15), Sensormodell-Register und Persistenz-Fix. Firmware: v1.4.18+ erforderlich für Kanäle 3+ bei Senior-Varianten.

v1.5.0 — 2026-08 (nur intern)

Hinzugefügt

  • UI5/UI7-Unterstützung für die Senior-SKUs: Kanäle 3–6 über das Kanalzugriffsfenster (Echtzeitmesswerte und Periodenenergie je Kanal), NVS-Energieslots auf 7 Kanäle erweitert.

Hinzugefügt

  • Kanalweise CT-Modelle auf allen Kanälen. ct_models: im YAML akzeptiert jetzt bis zu 16 Einträge. Die Erkennung der Modulvariante bestimmt, wie viele angewendet werden; zusätzliche Einträge erzeugen eine Warnung, keinen Fehler.

  • Sensormodell-Register — die Modellliste kommt aus einem einzigen Register. Die beiden fest codierten Listen (CT_MODELS-Dict + CT_MODEL_ALLOWED_PER_CLASS) werden durch eine einzige Registersuche ersetzt. Ein neues CT-Modell hinzuzufügen ist jetzt eine Registerbearbeitung — kein Bibliotheks-Release nötig.

Fest

  • v1.6.0 ergänzt SAVE nach dem Anwendungszyklus. Frühere Versionen nutzten für CT-Modell und Sensorklasse einen werksgesteuerten Speicherpfad — bei einem Produktionsmodul wirkte die Bindung im RAM, ging aber beim Neustart verloren. v1.6.0 speichert über CMD_SAVE_USER_CONFIG (nicht gesteuert). Anwender früherer Versionen haben in der Produktion die CT-Modell-Bindung bei jedem Neustart stillschweigend verloren — vor der Auslieferung von Geräten aktualisieren.

v1.4.0

Erkennung der Senior-SKU (Varianten mit 5/7 Kanälen), Kanalzugriffsfenster für Echtzeitwerte und der optionale Schlüssel latch_interval:, der den Latch-/Energietakt vom Lesetakt (update_interval:) entkoppelt. Energie bleibt monoton und genau: Die Integration nutzt die tatsächliche Wanduhrzeit zwischen den Latch-Ereignissen.

v1.3.0

Erste öffentliche Veröffentlichung. Multikanal- und Multimodul-Flotte mit Synchronisation der Latch-Snapshots per General-Call (fleet_gc_enable: + group_id:), zweiphasiger Adress-Commit (produktionstauglich, ohne Werks-Provisioning-Modus), Lesen-Vergleichen-Schreiben-Rückschreiben beim Start, fähigkeitsgesteuerte Funktionserkennung, Identitätsschnittstelle für Lambdas (get_variant_str(), get_uid_hex(), ...), NVS-Energiepersistenz.


Richtlinie zur Veraltung

Was die Komponente nicht ohne Vorwarnung brechen wird und was sie darf:

Oberfläche Stabilität Was wir zusagen
YAML-Schlüssel des Blocks rbamp: Stabil Entfernen oder Umbenennen ist nur bei einer Hauptversionserhöhung möglich. Vor dem Entfernen erscheint eine Veraltungswarnung im Log. broadcast_latch: und topology: bleiben aus Gründen der Abwärtskompatibilität im Schema.
YAML-Schlüssel von sensor.platform: rbamp (Slots) Stabil Gleiche Regeln. Die Namen voltage/current/power/energy/frequency/power_factor sind als Vertrag mit dem HA-Energie-Dashboard festgelegt.
Die Menge der HA-Entitäten und ihre device_class / state_class Stabil Wir ändern das nicht ohne Ankündigung; es wirkt sich auf entity_id in HA aus.
Über Lambda zugängliche Methoden RbAmpComponent::* Instabil Diese können sich in Nebenversionen ändern. Wenn Sie Lambda-Aktionen gegen sie schreiben, fixieren Sie die Komponentenversion (ref: in external_components:).
Aufbau des NVS-Formats Versioniert Änderungen gehen mit einer Erhöhung der Layoutversion einher — alte Daten werden verworfen, nie falsch gelesen.
Namen und Verhalten des Blocks i2c: Extern Das ist ESPHome-Kern, nicht unser Code — folgen Sie der vorgelagerten Richtlinie.

Upgrade-Anleitung

Auf v1.9.0 (von jeder früheren Version)

  1. Setzen Sie ref: v1.9.0 in external_components:.
  2. Keine YAML-Änderung nötig. Dasselbe YAML funktioniert für beide Modulreihen; die Komponente erkennt das angeschlossene Modul beim Start. topology: ist nicht nötig.
  3. Wenn Sie auf einem STANDARD-Modul (STD) Energiesummen über alle Kanäle wünschen, ergänzen Sie energy_total / energy_exported_total / energy_net (siehe 09 §2.3).
  4. Wenn Ihr YAML sensor_class: oder ct_model: bei einem Modul setzt, das zusammen mit seinem angepassten Sensor kalibriert geliefert wurde, lehnt die Komponente die Änderung nun ab und protokolliert sie. Entfernen Sie diese Schlüssel bei solchen Modulen.
  5. Haben Sie den SCT-Nennwert über ct_model: gewechselt, bleiben die Messwerte nun genau; ein Neustart des Moduls während des Wechsels ist bei Firmware bis 1.4.19 normal.
  6. ct_model_force: true ist nur eine Dienstoption; das Schema lehnt sie ohne ct_model: / ct_models: ab.
  7. Die Energiewerte pro Kanal im NVS bleiben beim Upgrade erhalten; die neuen Gesamtsummen-Sensoren beginnen beim ersten Start bei 0 und akkumulieren dann (ihr NVS-Slot ist separat).

Ab v1.3 / v1.4

  1. Aktualisieren Sie ref:.
  2. SCT_013_100 (Code 5) und SCT_013_060 (Code 7) werden akzeptiert.
  3. Optional können Sie fleet_gc_enable: / group_id: für synchronisierte Snapshots in einer Installation mit mehreren Modulen ergänzen (BASIC-Module).

Quelle & Probleme: rb-amp/rbamp-esphome · diese Seite im Repo: docs/11_changelog.md (v1.9.1)