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-AufrufestdArmBanks()/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+) liefertRB_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 (Image0x0001007Boder 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 KlasseWiredCT/BuiltinCTwird 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_CHANNELSnie überschreiten (darüberliegende Kanäle liefernRB_ERR_PARAM); Host-Unit-Tests (extras/host_tests) führen die echten Quellen gegen einen Mock-Bus aus. -
RbAmpStdEnergyhat 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 neuereadReactivePower()/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-InstanzRB_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 alsRB_ERR_PARAMgemeldet (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).RbAmpCTModelist 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_CHANNELSvon 3 auf 7 erhöht. Bestehende Sketches, dieRbAmpSnapshot-Arrays verwenden, werden größer — Neukompilierung erforderlich (keine Quelländerungen nötig, sofern Sie keine Array-Größen fest einprogrammiert haben). -
03_MultiModuleBroadcastfü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ündeltespollAll(), flottenweitetotalPower()/totalEnergyWh()/pollErrors(), General-Call-Synchronisierung (enableGcAll()/gcLatch()/checkSync()),assignAddress(),checkConflict()undprovision(), 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) undreadCTModelCh()(Rücklesen des übernommenen Modells). -
Geräteseitige Flotten-Primitive:
enableGc(),setGroupId(),readGroupId(),readGcTick(),readFleetConfig(),readLabel(),writeLabel(),saveUserConfig(), statischbroadcastLatchGroup(). -
Beispiel
08_FleetSync(Scan → GC-Synchronisierung → Aggregation). - Maske
RbAmpSnapshot.implausibleje Feld: Ein Feld, das den physikalischen Plausibilitätsfilter nicht besteht, wird aufNaNgesetzt 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_msdes 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 —
Sct013akzeptiert{005, 010, 030, 050, 100, 020, 060}.REG_CT_MODEList 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 istSingle(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:
doubleist 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-
Wireumhü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)