06 · Energie und Perioden
So erhalten Sie Energie von einem STD-Modul: kumulative Zähler, Stundenverlauf, das Ereignisprotokoll und die acht Snapshot-Bänke. Vollständige Regeln: Mess- & Energiemodell.
Kumulative Zähler
Das Modul führt lebenslange Energiezähler, die einen Stromausfall überdauern: Wirkenergie Import, Export und Saldo in Wh, mWh und µWh; Blindenergie Import und Export in varh und µvarh. Lesen Sie sie in einer Transaktion über 0x0800–0x0843 (und 0x08D0–0x08F7 für den Satz mit feiner Auflösung).
Rules:
-
Energie vom Modul lesen; niemals P·dt auf dem Host integrieren. Das Integral des Moduls ist lückenkompensiert und übersteht Neustarts.
-
Intervallenergie = die Differenz zweier Messwerte an den Intervallgrenzen. Eine verpasste Grenze verbindet zwei Intervalle und verliert nichts.
-
Nach einem Neustart laufen die Zähler ab dem letzten gespeicherten Wert weiter; bis zu etwa der letzten Sekunde Energie kann fehlen. Bilden Sie die Differenz als
max(0, neu − letzter)und verankern Sie neu — verwerfen Sie die Periode nicht. -
LT_GEN(0x0840) springt bei jedem Zählerreset oder jeder Übernahme. Wenn er sich geändert hat, bilden Sie keine Differenz: setzen Sie neu an und prüfen Sie das Ereignisprotokoll. -
Anlaufstrom (
CFG_START_UA, Standard 400 µA): darunter addiert ein Kanal keine Energie zu einem Zähler, was Leerlauf-Kriechen verhindert. Messwerte sind nicht betroffen.
Stundenverlauf
Das Modul behält die letzten 7 stündlichen Datensätze (Energie und eine elektrische Zusammenfassung je Stunde) im nichtflüchtigen Speicher (HIST_CAP, 0x0C08, gibt die Zahl der Datensätze an). Die Datensätze überstehen einen Neustart; ein längeres Archiv führt der Master.
- Datensätze werden nur geschrieben, nachdem der Master die Zeit gesetzt hat, und der Master setzt sie nach jedem Neustart des Moduls erneut: Es gibt keine batteriegepufferte Uhr (siehe Erste Schritte).
- Ein Datensatz schließt, wenn die Uhr des Moduls die Stundengrenze überschreitet. Ein Teilstunden-Datensatz (die Zeit wurde mitten in der Stunde gesetzt oder das Modul ist mitten in der Stunde gestartet) trägt ein Flag.
- Von der 15-Minuten-Periode ist nur die letzte abgeschlossene Zusammenfassung verfügbar (elektrische Werte, keine Energie). Sie wird im RAM gehalten und beim Neustart verworfen.
Abfrageschnittstelle: Registerübersicht.
Ereignisprotokoll
Das Ereignisprotokoll enthält Zählerresets und Übernahmen, Kalibrierspeicherungen, Firmware-Updates und abgelehnte Datensätze, mit Werten vorher/nachher; es sollte regelmäßig geleert werden.
Snapshot-Bänke
Wenn CAPABILITIES Bit 8 = 1 ist, hat das Modul acht unabhängige Snapshot-Bänke: Jeder Master friert die Periode ein, die er braucht, und mehrere Verbraucher stören sich nicht gegenseitig. Verwenden Sie sie, wenn mehrere Module dieselbe Periode im selben Augenblick abschneiden müssen; für ein einzelnes Modul sind die Zählerdifferenzen oben einfacher.
-
Scharfschalten. Schreiben Sie
PERIOD_ARM(0x0063): Bit b = 1 lässt Bank b akkumulieren. Eine neu scharfgeschaltete Bank beginnt leer. -
Snapshot. Schreiben Sie
LATCH_BANK(0x0062) = b, danach den Befehl0x03(LATCH_PERIOD). Der Schnitt wird an der nächsten Fenstergrenze genommen; die Bank beginnt bei null neu. Auf einem Modbus-Bus können dieselben Schreibvorgänge für einen gemeinsamen Schnitt über mehrere Module per Broadcast (Unit 0) gesendet werden. -
Warten. Nach den Schritten von
CMD_SEQwarten, bisWIN_SEQum 2 weitergezählt hat (ca. 200 ms). - Lesen. Die Bank liegt bei
0x2000 + b·0x800(Modbus-Eingang0x7000 + b·0x100): P / Q / S über die Periode gemittelt, vorzeichenbehaftete Energie, Fensteranzahl, Spitzenwerte und Energie je Kanal. Bit b vonPD_VALIDzeigt an, dass die Bank einen Snapshot enthält; es bleibt gesetzt und ist kein Aktualitätskennzeichen.
Bänke liegen im RAM: ein Reset leert sie. Eine Bank, die in den ersten 3 Fenstern nach dem Start einen Snapshot erhält, enthält Nullen mit WIN_CNT = 0. Aufbau und Einheiten: Registerübersicht.
In den Client-Bibliotheken
— dieselbe Aufgabe ohne Registerzugriff:
| Bibliothek | Aufruf | Was es tut |
|---|---|---|
| Arduino | stdArmBanks, stdLatch, stdReadLatch, stdLatchWh |
Bänke scharfschalten, einen Snapshot erstellen, lesen und in Wh umrechnen; verfügbar, wenn das Modul Bänke meldet (Bit 8) |
| ESP-IDF | rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch, rbamp_std_latch_wh |
dasselbe in der ESP-IDF-Komponente; Bank 0 gehört zur Bibliothek, Banken 1 und höher verwenden (Beispiel std_meter) |
| ESPHome | period_banks:, rbamp.latch_bank |
die zu latchenden Bänke in YAML deklarieren, über ein interval: und/oder durch die Aktion (ab v1.9.1) |
| Python | std_arm_banks, std_latch, std_read_latch, std_latch_wh |
dieselben Aufrufe im Python-Client (ab v1.6.1); das gültige Kennzeichen einer Bank bleibt gesetzt; eine Bank mindestens 300 ms nach dem Latchen lesen |
Siehe Beispiele.