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

11 · Änderungsprotokoll

Die vollständige, ausführliche Historie steht in CHANGELOG.md im Stammverzeichnis des Repositorys; dieses Kapitel enthält die Kurzfassung.

1.6.2 — STD-Energie bleibt bei den Zählern, Zeilen der Modellregistry, Fehler bei gesperrtem Modul

  • STD, Images mit Zählern und Latch-Bänken: Ein solches Modul behält readPeriodSnapshot() / energy() nun auf seinen gespeicherten Zählern (früher wechselte es stillschweigend zur auf dem Host aus Bank 0 integrierten Energie). Die Bank-Aufrufe stdArmBanks() / stdLatch() / stdReadLatch() bleiben verfügbar und werden allein durch die Bank-Fähigkeit freigegeben. Bibliothek 1.6.2 ist das Minimum für ein solches Image; siehe Energiequelle und minimale Bibliotheksversion.

  • Neues Beispiel 12_StdBanks: zwei vom Master getaktete Perioden auf ihren eigenen Snapshot-Bänken.

  • Sensormodell-Register: die 2000:1-Zeilen für 50 A (Code 11) und 100 A (Code 13) werden akzeptiert.

  • setCTModelChForce() auf einem werkseitig gepaarten BASIC-Modul außerhalb des Werkmodus (Firmware 1.4.22+) liefert RB_ERR_MODE ("Konfiguration gesperrt") und speichert nichts; ein erzwungenes Schreiben funktioniert nur im Werkmodus.

1.6.1 — STD-Energie mit Mikroauflösung, Nennwertkorrektur SCT-013, Schutz der Sensorkonfiguration

Zusammen mit 1.6.0 (der STD-Linie) als erste öffentliche Version der Bibliothek mit zwei Linien veröffentlicht.

  • STD-Linie: Energiezähler mit Mikroauflösung (µWh / µvarh), der Anlaufstrom für Energie (stdSetEnergyStartCurrent() / stdReadEnergyStartCurrent()), Spannungsphasenwinkel (RbAmpStdVoltage::angle_deg) und Phasenfolge (stdReadPhaseSequence()) — für Module, deren Image sie veröffentlicht (Image 0x0001007B oder neuer); ältere Module verhalten sich genau wie bisher. stdEnergyDelta() deckt die neuen Felder ab.

  • BASIC-Linie — SCT-013-Nennkorrektur: auf Firmware bis 1.4.19 wird ein Kanal, der auf ein anderes SCT-013-Modell umgestellt wurde, relativ zur Verstärkung gelesen, die das Modul anwendet. begin() liest jeden Kanal und skaliert Strom / Leistung / Periodenleistung (und die daraus abgeleitete Energie); Leistungsfaktor und Spannung bleiben unverändert. Neu: sctRatingRefresh(), sctRating(), sctRatingScale(), sctPresetGain(). Firmware 1.4.20 und neuer korrigiert sich selbst. Die Modell-Setter starten das Modul nach dem Speichern auf Firmware neu, die das benötigt (ca. 0.5 s zusätzlich je Aufruf).

  • Setter für Sensorklasse / CT-Modell lesen vor dem Schreiben (setSensorClass(), setCTModel(), configureChannels()): Eine gespeicherte Konfiguration kann bei jedem Start erneut angewendet werden, ohne die Kalibrierung des Moduls anzutasten. Ein Modul der Klasse WiredCT / BuiltinCT wird nicht neu konfiguriert (RB_ERR_MODE); setCTModelChForce() ist der Serviceweg. Neu: readSensorClass(), RbAmp::sensorModel() / RbAmp::sensorModelRatedA() (Registry-Abfragen mit den aktuellen Grenzwerten des Modells).

  • SCT-013-060 und -100 werden akzeptiert (sie wurden clientseitig als reserviert abgelehnt); die Grenzwerte der Sensormodelle wurden auf gemessene Werte aktualisiert.

  • Beide Linien: Messfenster und Veröffentlichungstakt sind mit 100 ms dokumentiert (200 ms nur als Hinweis für ältere Images beibehalten); die Kanalanzahl kann RBAMP_MAX_CHANNELS nie überschreiten (darüberliegende Kanäle liefern RB_ERR_PARAM); Host-Unit-Tests (extras/host_tests) führen die echten Quellen gegen einen Mock-Bus aus.

  • RbAmpStdEnergy hat in dieser Version neue Felder erhalten: Speichern Sie bei einer Ablage als binärer Rohblock nur die Felder, die Sie in Ihrem eigenen festen Format benötigen.

1.6.0 — STD-Linie (16-Bit-Registermodell)

Eine Bibliothek für beide Produktlinien: begin() erkennt, ob das Modul das BASIC-Registermodell (8 Bit) oder das STD-Registermodell (16 Bit, Festkomma) spricht, und leitet jeden Aufruf intern weiter — die Methodenoberfläche ist auf beiden Linien dieselbe.

  • line() (RbAmpLine::Basic / RbAmpLine::Std); einheitliche Leser auf STD (readVoltage(phase), readCurrent(), readPower() …) plus neue readReactivePower() / readApparentPower() (nur STD).

  • Die Block-API des STD: stdInfo(), stdReadChannel(), stdReadTotals(), stdReadVoltage(), stdReadHealth(), stdReadConfig(), stdSetHarmonics(), stdCalThdFloor(); Latch-Bänke (stdArmBanks(), stdLatch(), stdReadLatch(), stdLatchWh()); Lebensdauerzähler (stdReadEnergy(), stdEnergyDelta()).

  • Die Periodenquelle wird anhand der Fähigkeiten des Moduls gewählt (Latch-Bänke oder gespeicherte Zähler); die Latch-Energie übersteht einen Modul-Reset; die Periodenmomentaufnahme erhielt avg_p_total, wh_net, module_restarted.

  • Identität, Uhr, Verlauf: stdIdentify(), RbAmp::stdProbe(), stdReadImageVersion(), stdReadBoardId(), stdSetTime() / stdReadTime(), stdHistInfo() / stdHistRead() / stdHistReadRaw() / stdEventRead() / stdHistFlush(), stdCommand() / stdWaitIdle() / stdLocate(), RbAmp::stdSetAddressByUid().

  • Konfiguration und Befehle funktionieren auf STD (setSensorClass(), setCTModel(), configureChannels(), saveUserConfig(), saveGains(), Adressänderung); jeder Befehl wartet, bis das Modul den Abschluss meldet, und prüft sein Urteil. Auf STD ist das CT-Modell nur eine Referenzbezeichnung.

  • Firmware-Update über I²C: stdOtaBegin() → stdOtaWritePage() → stdOtaCommit() → stdOtaActivate(), stdOtaWritePreparedImage() (vom Hersteller vorbereitete Images), stdOtaDiag(), stdOtaAbort(), stdOtaBoardOk().

  • Data-Ready-Leitung und Ereignisse auf beiden Leitungen: setDrdyPin(), waitDataReady(), readAllReady(), readDataSeq(), beginEventFlags(), setEventMask() / readEventMask(), setEventThresholds(); readEventFlags() / clearEventFlags() / hasError() funktionieren bei STD-Modulen, die den Ereignisblock bereitstellen.

  • Nur-BASIC-Aufrufe (factoryReset(), General-Call- und Label-Helfer, readCapability(), readCommitSeq(), readPeriodLatchMs()) liefern auf einer STD-Instanz RB_ERR_NOT_IMPLEMENTED. Keine Änderung der BASIC-API.

  • Beispiel 11_StdLine.

1.5.0 — CT-Modelle je Kanal + Registry der Sensormodelle

  • setCTModel(channel, code) / configureChannels() binden jeden Kanal, einschließlich der Kanäle 3+ der Top-SKU (über das Kanalfenster); jeder Schreibzugriff wird durch einen Rücklesezugriff bestätigt, und ein Modell, das das Modul nicht akzeptiert, wird als RB_ERR_PARAM gemeldet (der Kanal behält sein bisheriges Modell).

  • readCTModelCh() deckt alle Kanäle ab.

  • Generiertes Sensormodell-Register RbAmpSensorModels.h (RBAMP_CT_*-Defines, Beschreibungen, rbamp_sensor_model_lookup()); die CT-Modell-Validierung ist registergesteuert (der Client weist nur Codes zurück, die nicht im Register stehen — die Annahme entscheidet das Modul). RbAmpCTModel ist ein eingefrorenes Alias für die sieben SCT-013-Codes.

  • CT-Modell / Sensorklasse werden nun auf Produktionsmodulen gespeichert (CMD_SAVE_USER_CONFIG).

  • Beispiel 10_PerChannelModels.

1.4.0 — Unterstützung der Senior-SKUs (UI5/UI7)

Ergänzt die Unterstützung der 7-Kanal-Module der Senior-SKU (UI5, UI7) und aktualisiert das GC-Broadcast-Beispiel. Auf Silizium an einer heterogenen Flotte (UI1/UI2/UI3/UI5/UI7) verifiziert, Firmware-Vertrag bd2ad8e.

Hinzugefügt

  • Beispiel 09_SeniorSku — Abfrage von 7 Kanälen + Energieintegration für die Module UI5/UI7.

  • readCommitSeq() — Rücklesen der Commit-Sequenz der Firmware.

Geändert

  • RBAMP_MAX_CHANNELS von 3 auf 7 erhöht. Bestehende Sketches, die RbAmpSnapshot-Arrays verwenden, werden größer — Neukompilierung erforderlich (keine Quelländerungen nötig, sofern Sie keine Array-Größen fest einprogrammiert haben).

  • 03_MultiModuleBroadcast für den General-Call-Broadcast-Latch der v1.3 neu geschrieben (kohärente Synchronisierung in einem Rahmen ersetzt das alte sequenzielle Latch je Gerät).

  • Neu erzeugte Registerheader (v1.4.0-Vertrag).

  • Energie/Snapshot: Wachstum der Arrays der Senior-SKU + Dispatch nach Kanalanzahl.

1.3.0 — Flotte + Protokoll v1.3

Die Arduino-Bibliothek wurde an den rbAmp-v1.3-Drahtprotokollvertrag und das plattformübergreifende Referenzmodell (STM32 HAL / ESP-IDF / Python) angepasst. Hardwareseitig validiert an einer heterogenen Flotte (UI1 + I2 + I3) über die öffentliche API mit Rohregister-Referenzwerten (Suite mit vollständiger Abdeckung 38/38 + erweiterter App-WDT-Dauertest).

Hinzugefügt

  • RbAmpFleet — Verwaltung mehrerer Module: Bus-scan() (mit Kollisionserkennung), gebündeltes pollAll(), flottenweite totalPower() / totalEnergyWh() / pollErrors(), General-Call-Synchronisierung (enableGcAll() / gcLatch() / checkSync()), assignAddress(), checkConflict() und provision(), um ein werksneues Modul in den Bus einzubinden.

  • Identität / Fähigkeit: readVariant(), readCapability(), readProductId(), readUid().

  • Ereigniskanal: readEventFlags(), clearEventFlags(), hasError(), clearError(), readLastError().

  • Kanalweise CT-Konfiguration: configureChannels() (gebündelt, ein Flash-Speichervorgang) und readCTModelCh() (Rücklesen des übernommenen Modells).

  • Geräteseitige Flotten-Primitive: enableGc(), setGroupId(), readGroupId(), readGcTick(), readFleetConfig(), readLabel(), writeLabel(), saveUserConfig(), statisch broadcastLatchGroup().

  • Beispiel 08_FleetSync (Scan → GC-Synchronisierung → Aggregation).

  • Maske RbAmpSnapshot.implausible je Feld: Ein Feld, das den physikalischen Plausibilitätsfilter nicht besteht, wird auf NaN gesetzt und markiert, während der Rest der Momentaufnahme nutzbar bleibt (die vollständige Lesung scheitert nur bei einem Übertragungsfehler).

Geändert

  • Energie wird gegen die Wanduhr des Masters integriert, niemals gegen den diagnostischen latch_ms des Chips (ein Diagnosetimer des Moduls, nicht für Energie). Bei einem veralteten Periodenanker wird die Integration angehalten — das nächste gültige Fenster wird nicht zu niedrig gezählt.

  • Die CT-Modell-Codes folgen dem akzeptierten Satz je Klasse aus v1.3 — Sct013 akzeptiert {005, 010, 030, 050, 100, 020, 060}. REG_CT_MODEL ist reine Vorbereitung: Binden erfolgt über den kanalweisen Befehl; Mehrkanal-Bindungen sind reihenfolgeunabhängig und überschreiben nie Kanal 0.

  • Adressänderung ist ein zweiphasiger Magic-Commit, der für die Produktion zulässig ist; der Werkmodus ist nicht erforderlich.

  • Erkennung der Variante liest REG_HW_VARIANT; der Topologie-Hinweis im Konstruktor ist nun ein Rückfall für Firmware vor v1.3. Der Standardhinweis ist Single (sicher — keine falschen Messwerte nicht vorhandener Kanäle).

  • I²C-Schreibvorgänge nutzen jetzt dieselbe NACK-Wiederholungsdisziplin wie Lesevorgänge (ein Konfigurationsschreiben, das auf einem umkämpften Bus still verloren geht, wäre sonst unsichtbar).

  • setSensorClass() weist Klassen außerhalb der Aufzählung clientseitig ab (die Firmware akzeptiert eine ungültige Klasse stillschweigend, daher ist die clientseitige Prüfung die einzige Absicherung).

Hinweise

  • AVR: double ist auf der klassischen AVR-Toolchain 32-Bit (== float), daher verliert der Wh-Akkumulator bei langen Dauertests an Genauigkeit — setzen Sie ihn regelmäßig zurück oder verwenden Sie einen Kern mit 32/64-Bit-double (ESP32, SAMD, STM32, RP2040).

  • Grenzwertiger Bus / ESP32: Das Arduino-ESP32-Wire umhüllt einen Treiber, der unterhalb der Bibliotheksebene bei einem gehaltenen Bus hängen bleiben kann. Verwenden Sie geeignete externe ~4.7-kΩ-Pull-ups, vermeiden Sie den Debugger / NRST im Produktivbetrieb und richten Sie einen Watchdog auf Anwendungsebene für den Abfrage-Task als Wiederherstellungspfad ein.

1.0.0 — Erstveröffentlichung

Einzelgeräte-Echtzeitmessung (RMS U / I / P / PF / Frequenz), Integration der Periodenenergie (Wh), Konfiguration von CT-Modell + Sensorklasse und Änderung der I²C-Adresse.


Quelle und Probleme: rb-amp/rbamp-arduino · diese Seite im Repository: docs/11_changelog.md (v1.6.2)