rbAmp
DE
Shop
Docs
Aktualisiert

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.

  1. Scharfschalten. Schreiben Sie PERIOD_ARM (0x0063): Bit b = 1 lässt Bank b akkumulieren. Eine neu scharfgeschaltete Bank beginnt leer.

  2. Snapshot. Schreiben Sie LATCH_BANK (0x0062) = b, danach den Befehl 0x03 (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.

  3. Warten. Nach den Schritten von CMD_SEQ warten, bis WIN_SEQ um 2 weitergezählt hat (ca. 200 ms).

  4. Lesen. Die Bank liegt bei 0x2000 + b·0x800 (Modbus-Eingang 0x7000 + b·0x100): P / Q / S über die Periode gemittelt, vorzeichenbehaftete Energie, Fensteranzahl, Spitzenwerte und Energie je Kanal. Bit b von PD_VALID zeigt 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

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.