11 · Änderungsprotokoll
Dieses Kapitel spiegelt CHANGELOG.md im Repository-Stamm. Öffentliche Veröffentlichungen beginnen wieder mit Version 1.7.2; Zwischenversionen wurden nur intern veröffentlicht.
1.7.3 — STD-Energie bleibt auf den Zählern, Zangenmodelle 100 A und 50 A, Meldung zum gesperrten Modul (2026-11-01)
Fest
- STD-Module, die beide Snapshot-Bänke (Fähigkeitsbit 8) und geräteinterne Energiezähler (Bit 13) melden, etwa Modul-Image 0x0001007E: Energie- und Periodenaufrufe nutzen nun die persistenten Zähler. Zuvor wurde ein solches Modul ohne jeden Hinweis auf die vom Host integrierte Bank 0 umgeschaltet. Die Snapshot-Bank-Aufrufe (
rbamp_std_arm_banks,rbamp_std_latch,rbamp_std_read_latch) sind ein eigenes Werkzeug, das nur von Bit 8 abhängt, und funktionieren auf diesen Modulen wie bisher.rbamp_std_info_t.period_sourcemeldet die tatsächlich verwendete Quelle.
Hinzugefügt
-
README: Abschnitt „STD-Linie“ mit der minimalen Komponentenversion für das Modul-Image 0x0001007E und den Snapshot-Bank-Aufrufen.
-
Das Beispiel
std_meterscharf stellt seine eigene Bank 1 auf jedem Modul, das Latch-Bänke meldet, auch wenn die Energie aus den Zählern stammt. -
Firmware-Name für BASIC-
REG_VERSION0x0E:rbamp_basic_fw_name()liefert "1.4.22" (alle BASIC-Varianten). -
Sensormodell-Register: Klemmen 2000:1 mit den Codes 11 (50 A) und 13 (100 A) sind jetzt charakterisierte Modelle (Nennwert 50.0 A / 100.0 A, Vollausschlag 62.5 A / 116.5 A, Spitze 88.4 A / 164.7 A). Code 12 (80 A) bleibt für Module, die bereits daran gebunden sind.
Geändert
rbamp_set_ct_model_ch_force()auf einem BASIC-Modul der Klasse 2 oder 3 liefertESP_ERR_INVALID_STATEmit einer Logzeile, die die gesperrte Konfiguration nennt, wenn das Modul den Schreibvorgang ablehnt (Firmware 1.4.22 und neuer lehnt Klassen- und Modellschreibvorgänge auf einem werkseitig gepaarten Modul außerhalb des Wartungsmodus ab). Früher erschien die Ablehnung als allgemeiner Parameterfehler. Der Force-Pfad funktioniert auf einem solchen Modul nur im Wartungsmodus.
1.7.2 — SCT-013-Nennwertkorrektur, Wiederaufnahme nach Ausfall des Masters, Fensterlesen in einer Transaktion (2026-10-21)
Erste öffentliche Veröffentlichung seit 1.5.0. Sie enthält 1.6.0 – 1.7.2 gemeinsam: die Modulreihe STD hinter demselben Handle, die Datenbereit-Leitung, Ereignisse, µWh-Energie und Phasengrößen, eine Kanalanzahl, die dem Modul folgt (1, 2, 3, 5 oder 7), die Sensormodell-Registry mit Clip-Grenzen, Fensterlesezugriffe in einer Transaktion, Wiederaufnahme nach einem Ausfall des Masters und die SCT-013-Nennwertkorrektur für Strommodule, deren Firmware die 30-A-Kalibrierung beibehält (Firmware, die die Fähigkeit zur Selbstkorrektur meldet, korrigiert sich selbst). Die Hardwarevalidierung dieser Linie erfolgte auf einem Host mit ESP-IDF 5.4.1.
Hinzugefügt
- SCT-013-060 und -100 werden akzeptiert (sie wurden clientseitig als reserviert abgelehnt); die Grenzwerte der Sensormodelle wurden auf gemessene Werte aktualisiert.
-
SCT-013-Nennwertschaltung: Ein Strommodul der Klasse 1 wird mit dem 30-A-Sensor kalibriert, und Firmware bis 1.4.19 behält diese Kalibrierung bei, nachdem der Anwender ein anderes Modell zugewiesen hat. Die Bibliothek liest jetzt die Verstärkung, die das Modul bei
rbamp_begin(), nach einem Modellschreiben und nach jedem erkannten Neustart des Moduls anwendet, und skaliert Strom, Spitzenstrom, Wirkleistung, periodengemittelte Leistung, die integrierte Energie, den Digest und die Ereignisschwellen auf das gewählte Modell. Spannung und Leistungsfaktor werden nicht skaliert.rbamp_sct_correction()meldet das Ergebnis je Kanal (rbamp_sct_correction_t: Status, Modell, Skalierung, angewandte Verstärkung), undrbamp_sct_refresh()bewertet auf Abruf neu. Eine Verstärkung, die noch dem rohen Voreinstellungswert entspricht (Modell in diesem Start gewechselt, ohne Neustart), löst einen CMD_RESET aus; eine unerwartete angewandte Verstärkung, ein unbekanntes Modell oder eine rohe Voreinstellung, die den Reset überlebt, lassen die Messwerte unskaliert mit einer Warnung. Ein Modul, das die Fähigkeit zur Selbstkorrektur meldet (Firmware 1.4.20 und neuer), korrigiert sich selbst und erhält Skalierung 1 — erkannt über die Fähigkeit, nie über VERSION.CONFIG_RBAMP_SCT_RATING_CORRECTION(Standard: an) schaltet den Mechanismus ab. -
rbamp_begin_resume()—rbamp_begin()ohne den Primer-Latch. Ein BASIC-Modul mittelt weiter bis zum nächsten Latch; nach einem Neustart oder Ausfall des Masters integriert der erste verbrauchte Snapshot über das eigene Fenster des Moduls und holt die Energie der Ausfallzeit nach. Spätere Snapshots nutzen wie bisher die Uhr des Masters. STD-Module verhalten sich genau wie beirbamp_begin(). -
rbamp_period_snapshot_t:module_window_ms(die eigene Länge des gelatchten Fensters des Moduls, 0 auf STD; das Modul zählt Commits zu 100 ms bei aktueller Firmware und zu 200 ms bei Firmware vor v1.2 — die Bibliothek erkennt dies am Snapshot selbst und meldet es inmodule_commit_ms),module_uptime_s,window_from_boot(das Fenster begann beim Booten des Moduls: ein Neustart oder der erste Latch seit dem Booten) undwindow_long(über 6 h, wo der Mittelwert des Moduls an Genauigkeit verliert). Beim ersten Snapshot nachrbamp_begin_resume()giltmodule_restarted=window_from_boot. -
rbamp_read_uptime_s()— Sekunden seit dem Booten des Moduls (BASIC und STD). Liefert 0 auf BASIC-Firmware, die sie nicht veröffentlicht; dann bleibtwindow_from_bootauf false. -
rbamp_read_digest()— ein Fenster eines BASIC-Moduls in einer einzigen Transaktion: Status, Fenstersequenz und die gewählten Felder (Strom, Spannung, Wirkleistung mit Vorzeichen in ganzen Watt, Leistungsfaktor) für die Kanäle 0–2. Gedacht zum Lesen jedes veröffentlichten Fensters auf der Data-Ready-Leitung.rbamp_set_digest_fields()wählt die Felder; die Bibliothek schreibt die Wahl auf das Modul und schreibt sie nach einem erkannten Neustart des Moduls erneut. Benötigt BASIC-Firmware mit der Digest-Fähigkeit; nicht auf STD verfügbar. -
rbamp_basic_fw_name()— der Firmware-Releasename für ein BASIC-Versionsbyte ("1.4.19" für 0x0B usw.). -
rbamp_read_sensor_class()— die aktuelle Sensorklasse des Moduls. -
rbamp_sensor_model_limits()— der Nennstrom-Effektivwert eines Sensormodells, der Effektivstrom, bei dem eine Sinuswelle zu übersteuern beginnt, und die momentane Übersteuerungsgrenze, in A, aus der generierten Modellregistrierung (0, wenn unbekannt).rbamp_sensor_model_rated_a()ist die Kurzform für den Nennstrom; beachten Sie, dass der Nennwert von den Ampere im Modellnamen abweichen kann. -
Generierte Registry der Sensormodelle mit diesen Grenzwerten aktualisiert.
rbamp_set_ct_model_ch_force()— Servicepfad, der das Modell eines Kanals unabhängig von der Klasse und dem aktuellen Modell des Moduls setzt. Er ersetzt die Kalibrierung, die das Gerät für diesen Kanal trägt, durch die generische Voreinstellung des Modells; danach ist eine Kalibrierung fällig.
Geändert
-
rbamp_set_ct_model(),rbamp_set_ct_model_ch()undrbamp_configure_channels()auf einem Klasse-1-Modul ohne die Selbstkorrektur-Fähigkeit (Firmware bis 1.4.19) enden mit einem Neustart des Moduls (CMD_RESET, dieselbe UID verifiziert, etwa eine Sekunde): der einzige Weg, auf dem das Modul nach einem Modellschreibvorgang zu seiner kalibrierten Verstärkung zurückkehrt. Die Bibliothek wendet an, was ihr gehört (Primer-Latch, Digest-Maske bei nächster Verwendung); die Periodenakkumulatoren starten neu, wie nach jedem Modul-Reset. -
Der Transport ruft nicht mehr selbst
i2c_master_bus_reset()vor dem letzten Versuch einer fehlgeschlagenen Transaktion auf. Der Treiber setzt nach jeder fehlgeschlagenen Transaktion ohnehin zurück, und der explizite Reset nimmt keine Bussperre: Hat eine andere Task eine Transaktion in Arbeit, erzeugt er ein STOP auf den Live-Pins, das der Interrupt-Handler des Treibers für das Ende eines Lesevorgangs halten und im ISR abstürzen kann (gesehen auf einem Host mit einem im laufenden Betrieb eingesteckten Modul).CONFIG_RBAMP_BUS_RESET_ON_RETRY_EXHAUSTIONstellt das alte Verhalten für einen Single-Task-Master wieder her. -
rbamp_set_sensor_class(),rbamp_set_ct_model(),rbamp_set_ct_model_ch()undrbamp_configure_channels()lesen, bevor sie schreiben. Eine Klasse oder ein Modell, das das Modul bereits hält, wird nicht erneut geschrieben (kein Buszugriff): Auf dem Modul löscht ein Klassenschreibvorgang die CT-Modelle selbst dann, wenn der Wert unverändert ist, und ein Modellschreibvorgang überschreibt die eigene Kalibrierung des Geräts mit dem generischen Preset selbst dann, wenn das Modell unverändert ist. Daher verschlechterte das erneute Anwenden einer gespeicherten Konfiguration bei jedem Wiederverbinden früher die Messwerte. Ein Modul der Klasse 2 oder 3 (zusammen mit seinem Sensor ausgeliefert und kalibriert) wird nicht neu konfiguriert:ESP_ERR_INVALID_STATE.rbamp_configure_channels()entscheidet den gesamten Auftrag vor dem ersten Schreibvorgang, sodass bei einem solchen Modul nichts halb angewendet wird. -
Dokumentation zu
latch_ms: nur Diagnose, kann unter Last zu kurz anzeigen; das Energie-Integrationsfenster istmaster_dt_msodermodule_window_ms. -
Die Dokumentation und die Kconfig-Hilfe nennen das Veröffentlichungsfenster des Moduls jetzt einheitlich mit 100 ms für die gesamte Familie (ältere Images: 200 ms). Die 300-ms-Abklingzeit, die die Bibliothek nach einem STD-Latch anwendet, ist als sichere obere Grenze beschrieben. Am Zeitverhalten hat sich nichts geändert.
Fest
rbamp_read_all()/rbamp_read_all_ready()auf einem Modul mit mehr als drei Kanälen (UI5/UI7, BASIC oder STD) schrieb Kanäle 3+ über die dreielementigen Arrays vonrbamp_snapshot_thinaus:frequency,topologyundchannelswurden überschrieben (der Host sah dannchannels= 0), und der letzte Kanal landete vier Bytes hinter der Struktur auf dem Stack des Aufrufers. Der Aufruf füllt jetzt nur ch0-2 (RBAMP_SNAPSHOT_CHANNELS), genau wie der Periodensnapshot; ch3+ bleiben beirbamp_read_channel()/rbamp_read_all_channels(). Gefunden auf einem Host mit einem 7-Kanal-Modul. Eine Host-Simulation der gesamten Komponente gegen ein gefälschtes Registerabbild läuft jetztread_allfür 1/3/5/7 Kanäle mit Wächterwörtern hinter der Struktur.
1.7.1 — Kanalanzahl folgt dem Modul (2026-10-18)
Fest
-
rbamp_new()erzeugte ein Handle, dessen Kanalzahl auf drei festgelegt war, sodass ein Ein-Kanal-Modul (UI1, I1) nachrbamp_begin()weiterhin drei Kanäle meldete. Der Standardkonstruktor übernimmt jetzt die Kanalzahl und das Vorhandensein der Spannung aus dem Varianten-Register des Moduls; drei Kanäle bleiben nur als Rückfall für Firmware, die keine Variante veröffentlicht.rbamp_new_with_topology()legt die Zahl wie bisher fest (es wird eine Warnung protokolliert, wenn das Modul widerspricht). Gemeldet von einem Host mit einer UI1; dort validiert: Ein UI1-Modul meldet nachrbamp_begin()einen Kanal und die UI1-Variante. -
rbamp_read_variant()auf der Linie BASIC lieferte für die Codes UI5 / UI7 UNKNOWN; jetzt wird jeder bekannte Code abgebildet.
Hinzugefügt
-
rbamp_variant_t rbamp_variant(rbamp_handle_t dev)— die vonrbamp_begin()zwischengespeicherte Variante, ohne Busverkehr.RBAMP_VARIANT_UNKNOWNvorrbamp_begin()oder wenn das Modul seine Variante nicht veröffentlicht. -
Host-Unit-Tests für die Varianten-Policy beider Konstruktoren (
test/host/test_std_decode.c).
1.7.0 — µWh-Energie, Anlaufstrom, Phasenwinkel und Reihenfolge (2026-10-17)
Unterstützung für Modul-Image-Version 0x0001007A / 0x0001007B. Jede Ergänzung ist davon abhängig, was das Modul meldet; ältere Module verhalten sich genau wie zuvor.
Validiert auf STD-Modulen mit Modul-Image-Version 0x0001007B auf einer Host-Anwendung: Anlaufstrom lesen/setzen und zurücklesen, Phasenwinkel und Phasenfolge auf einem Dreiphasenmodul, Flags für feine Energie, Energie-Differenz über Modul-Neustarts hinweg.
Hinzugefügt
-
Energie mit µWh- / µvarh-Auflösung in
rbamp_std_energy_t:act_import_uwh,act_export_uwh,act_net_uwh,rea_import_uvarh,rea_export_uvarh,ch_import_uwh[],ch_export_uwh[], zuzüglichfine/fine_reactive. Die Felder werden auf jedem Modul gefüllt: aus den eigenen µ-Zählern des Moduls, wenn es sie veröffentlicht (Modul-Image-Version 0x0001007A; Blindenergie ab 0x0001007B), andernfalls aus den groben Zählern skaliert mitfine= false — Aufrufer können die µ-Felder bedenkenlos verwenden. Gelesen als kohärente Snapshots (eine Transaktion pro Block).rbamp_std_energy_deltawendet dieselben Regeln darauf an (Generationswechsel → kein Delta, Abfall der Laufzeit = Neustart, ein Zähler unter dem vorherigen Wert → 0, netto = Bezug − Einspeisung).rbamp_read_period_snapshotnutzt auf dem Zählerpfad die µWh-Differenz, sofern verfügbar. -
Anlaufstrom für die Energie:
rbamp_std_get_start_current/rbamp_std_set_start_current(µA; 0 = aus; ein Wert außerhalb des Satzes, den das Modul akzeptiert →ESP_ERR_INVALID_ARGohne Busschreibvorgang; zurückgelesen und bestätigt;rbamp_save_user_configspeichert ihn dauerhaft). Unterhalb dieses Kanalstroms zählt das Modul keine Energie; die Messwerte bleiben unberührt. Auch inrbamp_std_config_t(start_ua,start_ua_supported).ESP_ERR_NOT_SUPPORTEDohne Busverkehr vor der Modul-Image-Version 0x0001007B. -
Spannungs-Phasenwinkel:
rbamp_std_voltage_t.angle_deg/angle_valid(Grad gegenüber Spannungseingang 0; Modul-Image-Version 0x0001007A+, Dreiphasenmodule; sonst istangle_validfalse). Dasselbe Einzel-Burst-Lesen wie zuvor. -
Phasenfolge:
rbamp_std_read_phase_seq→rbamp_std_phase_seq_t(RBAMP_STD_PHASE_SEQ_NA/FORWARD/REVERSE/ABNORMAL);ESP_ERR_NOT_SUPPORTEDohne Bus-Verkehr vor Modul-Image-Version 0x0001007A. -
Host-Unittest der reinen Dekodierhilfen:
test/host/run.sh(gcc, ohne ESP-IDF). Die Regeln für Energie-Deltas liegen jetzt insrc/rbamp_std_decode.c.
Geändert
rbamp_is_provisioned(STD-Linie) dokumentiert die Kalibriermarke der Modul-Image-Version 0x0001007A: Ein unter älterer Firmware kalibriertes Gerät liefert nach dem Update false, bis einmalrbamp_save_gainsausgeführt wurde.
Hinweis zum Upgrade
- Die Struktur des Energie-Snapshots (
rbamp_std_energy_t) hat in dieser Version Felder erhalten. Wenn Ihre Anwendung sie als rohen Binär-Blob speichert (NVS, Datei), legen Sie nur die benötigten Felder in Ihrem eigenen festen Format ab; ein von einer älteren Version gespeicherter Blob passt nicht zur neuen Größe.
1.6.1 — Befehlsabschluss, kohärente Lesevorgänge, OTA-Sitzungsprüfungen (2026-10-11)
Bibliotheksseitige Korrekturen aus dem Firmware-/Bibliotheks-Audit vom 2026-10-11. Keine neue API; das Verhalten bestehender Aufrufe auf der STD-Linie wurde verschärft.
Geändert
-
Abschluss eines Befehls ist das Befehlsstatusregister des Moduls (Busy-Flag gelöscht und der Zähler abgeschlossener Befehle erhöht), nie das Fehlerregister allein; das Ergebnis wird erst nach Abschluss gelesen. Speichervorgänge (
rbamp_save_gains,rbamp_save_user_config),rbamp_std_cal_thd_floor,rbamp_reset, Adressänderung und jeder OTA-Befehl nutzen dies — keine festen Abklingpausen auf Modulen, die das Register veröffentlichen; Timeouts von mindestens 1 s (3 s für OTA-Commit). Ein Befehl, der geschrieben wird, während das Modul beschäftigt ist, wird zuerst abgewartet; ein Befehl, den das Modul verworfen hat (Überlauf), schlägt mitESP_ERR_INVALID_STATEfehl, statt das Ergebnis des vorherigen Befehls zurückzugeben. -
Ein Befehlsschreibvorgang wird bei einem Transportfehler nie wiederholt (ein Retry könnte den Opcode zweimal zustellen). Lese- und Schreibvorgänge der Datenregister behalten den Retry.
-
Blocklesevorgänge sind eine einzige Transaktion — das Modul bedient jeden Lesevorgang aus einem kohärenten Snapshot, daher reißen Energiezähler, Kanalblöcke und Summen nicht mehr über Bursts hinweg auseinander.
rbamp_read_allliest auf einem STD-Modul den Spannungsblock und jeden Kanalblock als Ganzes, statt Feld für Feld. -
OTA: Nach jeder Seite muss die Sitzung noch offen sein (Status 1); andernfalls
ESP_ERR_INVALID_STATEmit dem vom Modul protokollierten Grund — neu ab begin starten. Abfragen während eines Flash-Stillstands setzen den Bus nicht mehr zurück.rbamp_std_ota_activatehält durch das Testfenster des Moduls von etwa 10 s und bestätigt, dass das laufende Image die bereitgestellte Version ist und der Wechsel nicht mehr aussteht.rbamp_std_ota_write_image(vom Host gebautes, unsigniertes Image) liefertESP_ERR_NOT_SUPPORTED, bevor es das Modul berührt — die Modul-Firmware akzeptiert nur herstellerseitig vorbereitete Images. -
Adressänderung (
rbamp_commit_address_change, STD): Das Speichern der Konfiguration ist synchron (Ratenbegrenzung →ESP_ERR_NOT_FINISHED, Wiederholung nach etwa 5 s); das Handle wechselt erst auf die neue Adresse, wenn dort ein Modul antwortet, andernfallsESP_ERR_NOT_FOUND, und das Handle behält die alte Adresse. -
rbamp_std_read_totals: Die Energiefelder der Summenblöcke liefern 0 (vom Modul nicht gefüllt — verwenden Sierbamp_std_read_energy). -
rbamp_read_frequency(STD): 0 vom Modul bedeutet kein Netz →ESP_ERR_INVALID_RESPONSE/ NaN (rbamp_read_allmarkiert ihn als unplausibel). -
rbamp_is_provisioned(STD): dokumentiert als verlässlich ab Modul-Image-Version 0x00010079 (ältere Images melden die Kalibrierung auch bei Standardverstärkungen als gültig).
1.6.0 — Modulreihe STD, Datenbereit-Leitung, Ereignisse (2026-10-11)
Hinzugefügt
-
STD-Modullinie (16-Bit-Registerkarte) hinter demselben Handle und derselben API wie die ursprüngliche Linie:
rbamp_std_probe/rbamp_std_identify/rbamp_std_info, Echtzeitwerte je Kanal inklusive Blind- und Scheinleistung (rbamp_read_reactive_power,rbamp_read_apparent_power,rbamp_std_read_channel,rbamp_std_read_voltage), Summen je Phase und Gesamtsummen (rbamp_std_read_totals), Konfiguration und Oberschwingungen (rbamp_std_read_config,rbamp_std_set_harmonics,rbamp_std_cal_thd_floor). -
Energie auf Modulen ohne Latch-Bänke: Die Periodenquelle wird über die Fähigkeiten des Moduls bei
rbamp_begingewählt (rbamp_std_info_t.period_source); die Periodenenergie ist die Differenz zweier Messwerte der persistenten Zähler, mit Regeln für Neustart und Zählerrücksetzung.rbamp_std_read_energy(Wh / varh, plus mWh je Kanal und je Gruppe auf Map 0x36+),rbamp_std_energy_delta,rbamp_energy_add_wh,RBAMP_ENERGY_CH_TOTAL.rbamp_period_snapshot_terhieltavg_p_total,wh_netundmodule_restarted. -
Latch-Bänke auf Modulen, die sie besitzen:
rbamp_std_arm_banks,rbamp_std_latch,rbamp_std_read_latch,rbamp_std_latch_wh. -
Modul-Uhr, Verlauf und Ereignisprotokoll:
rbamp_std_set_time,rbamp_std_read_time,rbamp_std_read_image_version,rbamp_std_hist_info,rbamp_std_hist_read,rbamp_std_hist_read_raw,rbamp_std_event_read,rbamp_std_hist_flush(der stündliche Ringpuffer ist dauerhaft; der 15-Minuten-Datensatz ist nur der letzte). -
Zustand:
rbamp_std_read_healthwurde um Statusbits, Lebensdauer und Kalibrierquellen, Frame-Zähler, Laufzeit sowie Reset-Ursache und Bootzähler erweitert (Modul-Image-Version 0x00010076 und neuer,RBAMP_STD_RST_*). -
Befehle und Service:
rbamp_std_command,rbamp_std_wait_idle,rbamp_std_locate,rbamp_std_read_board_id,rbamp_std_ota_board_ok(Board-Prüfung vor einem OTA-Stream),rbamp_std_set_address_by_uid. -
OTA: Dual-Bank-Image-Update einschließlich vorbereiteter signierter Images (
rbamp_std_ota_begin…rbamp_std_ota_activate,rbamp_std_ota_write_prepared,rbamp_std_ota_write_prepared_pair,rbamp_std_ota_diag,rbamp_std_ota_staged_version,rbamp_std_ota_abort). -
Zertifikat und Attestierung:
rbamp_std_read_certificate,rbamp_std_attest(die Signaturprüfung erfolgt durch die Anwendung). -
Data-Ready-Leitung (DRDY), beide Modulstufen:
rbamp_set_drdy_gpio,rbamp_wait_data_ready,rbamp_read_all_ready,rbamp_read_data_seq. Eine Open-Drain-Leitung darf mehrere Module teilen; die Bibliothek prüft die Veröffentlichungssequenz, zählt verpasste Fenster, meldet die Latenz und erkennt eine dauerhaft auf LOW gehaltene Alarmleitung. Abfrage-Fallback überCONFIG_RBAMP_DRDY_POLL_MS. STD-Module benötigen Modul-Image-Version 0x00010075 oder neuer. -
Ereignisse auf beiden Linien:
rbamp_read_event_mask,rbamp_set_event_mask,rbamp_set_event_thresholds,rbamp_begin_event_flags,RBAMP_EVENT_NVM_FAULT;rbamp_read_event_flags/rbamp_clear_event_flags/rbamp_has_error/rbamp_clear_errordecken jetzt auch die STD-Linie ab. -
Kconfig:
RBAMP_I2C_SCL_WAIT_US(Budget für Clock-Stretching, Standard 10 ms) undRBAMP_DRDY_POLL_MS. -
Beispiel
std_meter.
Geändert
-
Periodenaufrufe auf Modulen ohne Latch-Bänke liefern
ESP_ERR_NOT_SUPPORTED, statt stillschweigend eine ungültige Periode zu melden. -
rbamp_set_ct_model_chliefertESP_ERR_NOT_SUPPORTEDauf STD-Modulen, deren Kanalkarte nicht beschreibbar ist. -
rbamp_err_to_strdecktESP_ERR_NOT_FOUND,ESP_ERR_NOT_FINISHEDundESP_ERR_INVALID_CRCab. -
rbamp_period_snapshot_tundrbamp_std_health_thaben Felder erhalten (quellkompatibel; abhängige Projekte neu bauen). -
Die Komponente benötigt jetzt
esp_driver_gpio(integrierte IDF-Komponente).
1.5.0 — Kanalspezifisches CT-Modell auf jedem Kanal (2026-09-04)
Hinzugefügt
-
rbamp_set_ct_model_ch/rbamp_read_ct_model_ch/rbamp_configure_channelsakzeptieren jeden Kanal bis zur erkannten Kanalanzahl (Kanäle 3 und höher über das Kanalfenster). -
Modellcodes und Beschreibungen stammen aus der generierten
rbamp_sensor_models.h(rbamp_sensor_model_lookup); unbekannte Codes werden vom Modul abgelehnt und an den Aufrufer weitergegeben.
Fest
- Sensorklasse und CT-Modell bleiben jetzt auf Produktionsmodulen erhalten: Der bisherige Speicherbefehl hat auf der Produktionsfirmware nicht in den Flash geschrieben, sodass die Bindung nur im RAM wirkte und beim nächsten Neustart verloren ging. Keine API-Änderung, gleiche ~700 ms Einschwingzeit.
1.4.0 — Fünf- und Siebenkanal-Module
Hinzugefügt
- Topologie
FIVE_CH/SEVEN_CH, VariantenUI5/UI7,RBAMP_MAX_CHANNELS= 7;rbamp_read_channel,rbamp_read_all_channels,rbamp_read_commit_seq. Der Periodensnapshot integriert alle Kanäle.
1.3.0 (2026-06-16) — Öffentliche Veröffentlichung
Erste öffentliche Veröffentlichung der Komponente rbamp für ESP-IDF v5.x.
Hauptmerkmale
-
Fleet-Manager: verwaltet eine Gruppe von Modulen an einem einzigen I²C-Bus über ein einziges
rbamp_fleet_t-Handle. Erkennung mit Konfliktprüfung und Tier-2-Wedge-Canary, MISS-resilientes_poll_all, Aggregation von Gesamtleistung / Gesamtenergie / Fehlern, Broadcast-Latch für enge Synchronität. Siehe Kapitel 09 · API-Referenz, Abschnitt „Fleet manager“. -
Provisionierung:
rbamp_provision— ein Ein-Aufruf-Ablauf, um ein jungfräuliches Modul seiner Arbeitsadresse zuzuweisen, optional mit Speicherung der Konfiguration im Flash. Disziplin: ein jungfräuliches Modul gleichzeitig am Bus (eine normative MUSS-Regel). -
Mehrkanal-Konfiguration:
rbamp_configure_channels— atomare Einrichtung der CT-Modelle pro Kanal in einer einzigen Operation mit einem einzigen abschließenden Flash-Zyklus (flash-schonend). -
Fehlermodell v1.3: trennt das Ergebnis des letzten Schreibvorgangs (
REG_ERROR (0x02)— synchroner Kanal, durch die Setter geprüft) vom dauerhaften asynchronen Signal (EVENT_FLAGS.bit3— klebrig, für Laufzeitereignisse). Die zugehörigen Funktionen sindrbamp_read_last_error,rbamp_has_error,rbamp_clear_error,rbamp_read_event_flags. -
Identität / Funktionserkennung:
rbamp_read_variant,rbamp_read_capability(Fähigkeitskarte),rbamp_has_voltage,rbamp_read_product_id,rbamp_read_uid,rbamp_is_provisioned.
Kanon, wie er in der Dokumentation erscheint
-
Die Mehrmodul-Topologie ist der primäre Betriebsmodus der Bibliothek. Das Szenario „ein Modul am Bus“ ist der Minimalfall, nicht der Kanon. Die kanonische Bereitstellung ist ein Netzmodul am Hauptanschluss plus N Module an einzelnen Lasten, alle an einem einzigen I²C-Bus unter einem einzigen Fleet-Handle.
-
Unterstützte SKUs bei aktueller Hardware:
UI1(Netzzähler: Spannung + Strom + Leistung + PF + Energie),I1/I2/I3(Unterzähler: nur Strom, je Kanal).UI2/UI3folgen mit späterer Firmware. -
Energie und Leistung werden nur auf UI-Varianten berechnet (die ein Spannungsfrontend haben). Auf I-Varianten liefern
rbamp_read_power/_power_factor0.0f; die Fleet-Aggregation von Gesamtleistung / Energie summiert korrekt und ignoriert die Nullbeiträge. -
CT-Bindung ist reines Staging (v1.3-Kanon): Das Schreiben von
REG_CT_MODELwendet den Wert NICHT automatisch an; die Bindung erfolgt über das kanalweiseCMD_SET_CT_MODEL_CHn. Die Bindungsreihenfolge ist beliebig (die „aufsteigende/absteigende Reihenfolge“-Eigenheiten aus den Vor-v1.3-Versionen wurden entfernt). -
Adressänderung ist im Produktionsbetrieb zulässig: zweiphasiger Commit + Magic + Reset funktioniert in der Produktion (kein Werksmodus nötig).
-
Uhr des Masters = kanonische Zeitbasis für Wh: Der Chip-Softwaretimer
PERIOD_LATCH_MS (0xEC)dient nur der Diagnose; nicht für die Energie verwenden. Der Master verwendet seinen eigenenesp_timer_get_time()bzw. seine Wanduhr.
Dokumentation — neue / überarbeitete Kapitel
-
01_overview— Einleitung umgearbeitet, sodass sie zuerst auf mehrere Module ausgerichtet ist; ein ASCII-Diagramm des 80-%-Szenarios ergänzt. -
03_sensor_selection— Durchlauf zur CT-Reihenfolge; neuer Abschnitt „Mehrkanal-Module — I2 und I3 (nur Strom)“ mit einem Muster zur UI1+I3-Disaggregation. -
04_hardware— der Abschnitt „Multi-module bus — primary topology“ wurde zum Hauptbetriebsmodus erhoben; ausdrückliche Anforderung externer ~4.7-kΩ-Pull-ups am Fleet-Bus; Bereitstellungsablauf überrbamp_provision. -
09_api_reference— Abschnitte ergänzt: „Identity and provisioning“ (Identität und Bereitstellung), „Fehlermodell v1.3“, „Multi-channel configuration“ (Mehrkanal-Konfiguration), „Fleet manager — managing multiple modules“ (Fleet-Manager), „Per-device fleet config“ (Fleet-Konfiguration pro Gerät). -
10_troubleshooting— Abschnitte ergänzt: „IDF i2c_master hangs on a marginal bus — three-layer mitigation“ (Hänger des IDF-i2c_master an einem grenzwertigen Bus — dreistufige Abhilfe, mit einer hardwarevalidierten Tabelle der Hängerate), „Fleet: a module ended up excluded“, „Fleet: rbamp_fleet_scan returned INVALID_STATE“, „Fleet: rbamp_provision returned an error“. -
11_changelog— diese Datei.
Quelle & Issues: rb-amp/rbamp-esp-idf · diese Seite im Repo: docs/11_changelog.md (v1.7.3)