Abläufe — schrittweise Steuerflüsse
Verbindliche Abläufe auf Host-Seite. Jeder Schritt nennt das Register (I²C-Adresse; Modbus in Klammern) und was zu prüfen ist. Die überall hier geltenden Regeln zur Befehlsabfrage sind einmal in D2 festgelegt.
D1 — Einschalten / Erkennung
-
12 Byte bei 0x0000 in einer Transaktion lesen:
ID= 'S','T' ·VERSION≥ 0x36 ·CAPABILITIES(Bit 9 erwartet gesetzt; THD Bit 2 = 0, Snapshot-Bank Bit 8 = 1, wenn Bänke vorhanden sind, Energie im Gerät Bit 13 = 1) ·STATUS·N_VOLTAGE/N_CURRENT·VARIANT(UI1 0x11 = 1/1, 0x63 = 3/3) ·HW_REV/FW_VERSION. -
UID0x00F4 (12 B) lesen — die Geräteidentität für Ihre Datenbank;FW_VER0x0114 (u32 Image-Version);BOARD_ID0x017C. -
Auf Live-Daten warten:
WIN_SEQ(0x0016) ≠ 0 und weiterlaufend,STATUSBit 1 (sensor_ok) = 1 — nach dem Booten ca. 1 s abwarten (Boot-Bereitschaft). -
Wenn
STATUSBit 4 (time_valid) = 0 → Uhr stellen (D2, SET_TIME). - Gesundheitsfreigabe: cal_ok oder
CAL_SRC(0x0872) ∈ {1, 2};LTA_STATUS(0x0870) ≤ 1. - RAM-Zustand neu scharfstellen:
EVENT_MASK(0x00C1),THRESH_I/P(0x00C4/0x00C8); den Start bestätigen, indem RESET_OCCURRED gelöscht wird — 0x20 inEVENT_FLAGS(0x00C0) schreiben.
Modbus: derselbe Identitätssatz liegt in den Eingangsregistern 0x6000–0x601F (Spiegel); FW_VER Halteregister 0x8315–16, BOARD_ID Halteregister 0x831B–1C.
D2 — Befehl ausführen
- Leerlaufprüfung:
CMD_STATE(0x006A; Halteregister 0x8116) Bit 0 = 0. -
Die Parameterregister des Befehls schreiben, dann den Opcode in
COMMAND(0x0060; Halteregister 0x8113 — bei einem Modbus-geschützten Opcode einen FC16{0x8112 = 0xA5C3, 0x8113 = Opcode}senden; Ausnahme 06 = beschäftigt, Ausnahme 03 = unbekannter Opcode oder fehlende Entsperrung). -
CMD_STATEBit 0 abfragen → 0. Zeitüberschreitungen: ≥ 1 s für einfache Befehle und Speichervorgänge · ≥ 0.5 s Schreiben einer Update-Seite · ≥ 3 s Update-COMMIT. Bei I²C ≥ 10 ms Clock-Stretching tolerieren; NACKte Lesevorgänge wiederholen; einen COMMAND-Schreibvorgang niemals blind erneut senden (ein Duplikat würde als OVERRUN verworfen, Sie verlieren aber den Überblick, welcher Schreibvorgang gewirkt hat). -
ERROR(0x0002; Holding 0x8114) auslesen nachdem BUSY = 0: 0x00 = OK, Codes siehe Befehle. Optional prüfen, obCMD_SEQ(0x0067) um 1 weitergezählt hat und OVERRUN (Bit 1) = 0 ist.
Zeit setzen (der häufigste Befehl): Epoche u32 LE in TIME_SET 0x08C0 schreiben (Modbus FC16 0x8100 = höheres Wort, 0x8101 = niedriges Wort — bei Broadcast ist dies ein eigener Rahmen, der Befehl folgt als zweiter Rahmen) → COMMAND 0x06 → abfragen → ERROR 0xFC = Epoche unter 1600000000. STATUS Bit 4 wird sofort gesetzt.
D3 — Konfiguration
- Die gewünschten
CFG_*-Register schreiben (0x0070–0x0085; Halteregister 0x8000–0x800C). -
COMMAND0x04 SAVE_CONFIG (nicht UNLOCK-gesperrt) → D2.ERROR0xFD = ungültiger Wert, nichts gespeichert · 0xF9 = Ratenbegrenzung, nach ca. 5 s wiederholen · 0xF6 = Speicher-E/A-Fehler. -
Wenn die Änderung einen Neustart erfordert (I²C-Adresse, Modbus-Unit/Baud/Rahmen/TX-Verzögerung,
CFG_VIRTUAL_IDS):COMMAND0x02 RESET (über Modbus per UNLOCK freizugeben; keine oder abgeschnittene Modbus-Antwort erwarten) und das Gerät nach ca. 1 s erneut abfragen.
CFG_LED / CFG_WORD_ORDER wirken beim Schreiben, werden aber beim Booten zurückgesetzt, sofern sie nicht gespeichert wurden. CFG_CLASS, CFG_CT_MODEL, CFG_TZ_OFFSET_MIN, CFG_TIME_AUTH, CFG_ENERGY_PERSIST_S sind gespeicherte Metadaten.
D4 — Adress-/Seriellwechsel
I²C-Adresse (bekanntes Gerät): CFG_I2C_ADDR 0x0073 = 0x08..0x77 → SAVE_CONFIG → BUSY 0 und ERROR 0 → RESET → ~1 s warten → ID = 'S','T' an der neuen Adresse abfragen.
Modbus-Seriell: Halteregister 0x8000 Unit (1–247) / 0x8001 Baud (0–10) / 0x8002 Rahmen / 0x8003 Sendeverzögerung (beim Schreiben geprüft — Ausnahme 03) → FC06 0x8113 = 0x0004 → 0x8114 = 0 abfragen → FC16 {0x8112 = 0xA5C3, 0x8113 = 0x0002} (Antwort kann verloren gehen) → mit den neuen Einstellungen neu verbinden.
Über UID (mehrere Module auf einer Adresse, beide Transporte):
-
I²C: ein Schreibvorgang auf 0x00E0: UID (12 B) + neue I²C-Adresse (0x00EC, oder 0) + neue Modbus-Unit (0x00ED, oder 0). Modbus: FC16 0x8118–0x811E (UID-Bytepaare + 0x811E = Adresse<<8 | Unit) — Broadcast erlaubt.
-
COMMAND0x16 (FC06 0x8113 = 0x0016; Broadcast erlaubt). -
Das passende Modul speichert (zusammen mit allen vorgemerkten CFG_-Werten) und startet neu; jedes andere Modul antwortet
ERROR0xFC. Beide neuen Adressfelder 0 oder eine ungültige Adresse → 0xFD; Ratenbegrenzung beim Speichern → 0xF9. -
Das Modul unter der neuen Adresse/Unit prüfen; über UID identifizieren.
D5 — Energie: lesen, zurücksetzen, übernehmen
Lesen (an jeder Intervallgrenze, nach Ihrer Uhr):
-
Eine I²C-Transaktion ≤ 128 B über 0x0800–0x0843: Wh-Zähler, mWh-Zähler,
LT_GEN(kohärenter Snapshot). DazuUPTIME0x08A0. Modbus: Eingang 0x6B00/0x6B14 + Halteregister 0x8140. Fähigkeitsbit 15: dieselben Zähler mit µWh-Auflösung — Summe bei 0x08D0 (3×i64; Modbus-Eingang 0x6BB0), je Kanal bei 0x0C80 + g·0x10 (Modbus 0x6BC0 + g·8) — derselbe Snapshot wie die mWh-Felder (Bezug/Einspeisung mWh = floor(µWh/1000); netto = Bezug − Einspeisung in derselben Einheit), dieselben Regeln für Differenzen/Generation/Neustart. Das Modul veröffentlicht außerdem die Summen-Blindenergie in µvarh bei 0x08E8/0x08F0 (Modbus 0x6BAC/0x6BBC, nicht zusammenhängend): der kohärente Lesevorgang mit feiner Auflösung ist eine Transaktion über 0x08D0–0x08F7 (40 B). -
Intervallenergie = Differenz der mWh-Zähler (µWh-Zähler, wo feinere Auflösung gewünscht ist).
LT_GENhat sich geändert → Differenz nicht übernehmen; neu verankern (jemand hat zurückgesetzt bzw. übernommen — siehe Ereignisprotokoll).UPTIMEgesunken → Modul neu gestartet: Differenz =max(0, Δ)(bis etwa die letzte Sekunde Energie kann fehlen), Zeit erneut einspeisen (D2).
Reset (bewusst, protokolliert): LT_KEY 0x0844 = 0x4C545253 ("LTRS"; Modbus FC16 0x8142–43, höheres Wort zuerst) → sofort COMMAND 0x0A (jeder Befehl verbraucht den Schlüssel) → D2. ERROR 0xFB = Schlüssel falsch/fehlt · 0xFA = Speicher FAULT. Kein Modbus-UNLOCK nötig — der Schlüssel ist die Sperre. (Der Familien-Opcode 0x07 ENERGY_RESET wird nicht verwendet: 0xFE / Ausnahme 03.)
Übernahme (Board-Tausch / Migration): 4×i64 in LT_ADOPT 0x0848 (Modbus 0x8144–0x8153) stufen, in der Reihenfolge Import Wh · Export Wh · Blindimport varh · Blindexport varh → LT_KEY = 0x4C544150 ("LTAP") → COMMAND 0x0B. Negativer Wert → 0xFA. Sowohl Reset als auch Übernahme erhöhen LT_GEN und landen mit Werten vorher/nachher im Ereignisprotokoll.
D6 — Verlauf und Ereignisprotokoll
-
HIST_PERIOD0x0C00 (Halteregister 0x8160): 0 = letzte 15 Min. (dann mussHIST_BACK0 sein) · 1 = stündlicher Ring · 2 = Ereignisprotokoll. -
HIST_BACK0x0C04 (Halteregister 0x8163) = n, 0 = neuester. COMMAND0x08 HIST_READ → D2.ERROR0xFC = kein solcher Datensatz.-
Bei Erfolg:
HIST_FLAGS0x0C02 Bit 0 = 1;HIST_COUNT/HIST_RECSZ(80 Verlauf / 32 Ereignis) /HIST_OLDEST/HIST_NEWESTlesen, um Zeitstempel auf Indizes abzubilden. -
Den Datensatz bei 0x0C20 lesen (
HIST_RECSZBytes, in einer Transaktion; Modbus-Halteregister 0x8180+ Bytepaare). Aufbau: Mess- & Energiemodell. -
HIST_BACK= 0 … COUNT−1 durchlaufen, um die Datensätze zu lesen; Differenzregeln gemäß FLAGS des Datensatzes.
D7 — Firmware-Update
FW_ACTIVE_BANK0x0156 (Holding 0x8301) → wählen Sie die Release-Datei für die andere Bank.-
Freigabe:
BOARD_ID0x017C == das Board-Wort der Datei; Dateiversion ≥FW_VER0x0114;OTA_BANK_SIZE0x014C auslesen (nie fest codieren). -
(Modbus: UNLOCK)
COMMAND0x10 BEGIN → D2 →OTA_STATUS0x0140 (Halteregister 0x8300) = 1. -
Je nicht leerer 256-B-Seite, aufsteigend, Seite 0 zuerst:
OTA_IDX0x0144 = k · Nutzlast → 0x0500 (Modbus: zwei FC16 zu je 64 Registern bei 0x8380/0x83C0) · optionalOTA_PCRC_EXP0x0170 = Seiten-CRC-32 ·COMMAND0x11 (nicht gesperrt) · BUSY abfragen (≤ ~0.5 s) ·ERROR0xFC → Nutzlast neu schreiben, Seite wiederholen · prüfen, obOTA_STATUSnoch 1 ist (3 →OTA_DIAG0x0180 lesen, neu ab BEGIN beginnen). -
(UNLOCK)
COMMAND0x12 COMMIT → BUSY ≥ 3 s abfragen →OTA_STATUS: 2 = scharfgeschaltet (FW_STAGED_VERSION0x0150 = neue Version) · 3 = abgelehnt (Gründe 7–15 inOTA_DIAG) · 4 = niedrigere Version. -
Nur bei Status = 2: (UNLOCK)
COMMAND0x13 ACTIVATE — keine oder abgeschnittene Modbus-Antwort; das Modul ist nach ca. 4 s wieder da. Oder (UNLOCK)COMMAND0x14 FW_ABORT, um das scharfgeschaltete Image zu verwerfen. -
Das Modul etwa 10 s lang nicht zurücksetzen (Testlauf + Selbstbestätigung), danach prüfen:
FW_ACTIVE_BANKhat gewechselt ·FW_VER= neue Version ·SWAP_PENDING0x011C = 0. StehtFW_VERwieder auf der alten Version, wurde zurückgerollt —OTA_DIAGlesen.
D8 — Modbus-Freischaltung (UNLOCK)
FC06 Holding 0x8112 = 0xA5C3 → gültig 10 s, verbraucht durch einen freigabepflichtigen Befehl; ein falscher Wert löscht eine aktive Freischaltung; fehlend/abgelaufen → Ausnahme 03 beim freigabepflichtigen Befehl. Schlüssel und Opcode können in einem FC16 bei 0x8112–0x8113 stehen.
Freigabepflichtig: 0x01 · 0x02 · 0x07 · 0x10 · 0x12 · 0x13 · 0x14 · 0x15. Nicht freigabepflichtig: 0x04 · 0x06 · 0x08–0x0F · 0x11 · 0x16.