rbAmp
DE
Shop
Docs
Aktualisiert

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

  1. 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.

  2. UID 0x00F4 (12 B) lesen — die Geräteidentität für Ihre Datenbank; FW_VER 0x0114 (u32 Image-Version); BOARD_ID 0x017C.

  3. Auf Live-Daten warten: WIN_SEQ (0x0016) ≠ 0 und weiterlaufend, STATUS Bit 1 (sensor_ok) = 1 — nach dem Booten ca. 1 s abwarten (Boot-Bereitschaft).

  4. Wenn STATUS Bit 4 (time_valid) = 0 → Uhr stellen (D2, SET_TIME).

  5. Gesundheitsfreigabe: cal_ok oder CAL_SRC (0x0872) ∈ {1, 2}; LTA_STATUS (0x0870) ≤ 1.
  6. RAM-Zustand neu scharfstellen: EVENT_MASK (0x00C1), THRESH_I/P (0x00C4/0x00C8); den Start bestätigen, indem RESET_OCCURRED gelöscht wird — 0x20 in EVENT_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

  1. Leerlaufprüfung: CMD_STATE (0x006A; Halteregister 0x8116) Bit 0 = 0.
  2. 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).

  3. CMD_STATE Bit 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).

  4. ERROR (0x0002; Holding 0x8114) auslesen nachdem BUSY = 0: 0x00 = OK, Codes siehe Befehle. Optional prüfen, ob CMD_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

  1. Die gewünschten CFG_*-Register schreiben (0x0070–0x0085; Halteregister 0x8000–0x800C).
  2. COMMAND 0x04 SAVE_CONFIG (nicht UNLOCK-gesperrt) → D2. ERROR 0xFD = ungültiger Wert, nichts gespeichert · 0xF9 = Ratenbegrenzung, nach ca. 5 s wiederholen · 0xF6 = Speicher-E/A-Fehler.

  3. Wenn die Änderung einen Neustart erfordert (I²C-Adresse, Modbus-Unit/Baud/Rahmen/TX-Verzögerung, CFG_VIRTUAL_IDS): COMMAND 0x02 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):

  1. 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.

  2. COMMAND 0x16 (FC06 0x8113 = 0x0016; Broadcast erlaubt).

  3. Das passende Modul speichert (zusammen mit allen vorgemerkten CFG_-Werten) und startet neu; jedes andere Modul antwortet ERROR 0xFC. Beide neuen Adressfelder 0 oder eine ungültige Adresse → 0xFD; Ratenbegrenzung beim Speichern → 0xF9.

  4. 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):

  1. Eine I²C-Transaktion ≤ 128 B über 0x0800–0x0843: Wh-Zähler, mWh-Zähler, LT_GEN (kohärenter Snapshot). Dazu UPTIME 0x08A0. 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).

  2. Intervallenergie = Differenz der mWh-Zähler (µWh-Zähler, wo feinere Auflösung gewünscht ist).

  3. LT_GEN hat sich geändert → Differenz nicht übernehmen; neu verankern (jemand hat zurückgesetzt bzw. übernommen — siehe Ereignisprotokoll).
  4. UPTIME gesunken → 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

  1. HIST_PERIOD 0x0C00 (Halteregister 0x8160): 0 = letzte 15 Min. (dann muss HIST_BACK 0 sein) · 1 = stündlicher Ring · 2 = Ereignisprotokoll.

  2. HIST_BACK 0x0C04 (Halteregister 0x8163) = n, 0 = neuester.

  3. COMMAND 0x08 HIST_READ → D2. ERROR 0xFC = kein solcher Datensatz.
  4. Bei Erfolg: HIST_FLAGS 0x0C02 Bit 0 = 1; HIST_COUNT / HIST_RECSZ (80 Verlauf / 32 Ereignis) / HIST_OLDEST / HIST_NEWEST lesen, um Zeitstempel auf Indizes abzubilden.

  5. Den Datensatz bei 0x0C20 lesen (HIST_RECSZ Bytes, in einer Transaktion; Modbus-Halteregister 0x8180+ Bytepaare). Aufbau: Mess- & Energiemodell.

  6. HIST_BACK = 0 … COUNT−1 durchlaufen, um die Datensätze zu lesen; Differenzregeln gemäß FLAGS des Datensatzes.

D7 — Firmware-Update

  1. FW_ACTIVE_BANK 0x0156 (Holding 0x8301) → wählen Sie die Release-Datei für die andere Bank.
  2. Freigabe: BOARD_ID 0x017C == das Board-Wort der Datei; Dateiversion ≥ FW_VER 0x0114; OTA_BANK_SIZE 0x014C auslesen (nie fest codieren).

  3. (Modbus: UNLOCK) COMMAND 0x10 BEGIN → D2 → OTA_STATUS 0x0140 (Halteregister 0x8300) = 1.

  4. Je nicht leerer 256-B-Seite, aufsteigend, Seite 0 zuerst: OTA_IDX 0x0144 = k · Nutzlast → 0x0500 (Modbus: zwei FC16 zu je 64 Registern bei 0x8380/0x83C0) · optional OTA_PCRC_EXP 0x0170 = Seiten-CRC-32 · COMMAND 0x11 (nicht gesperrt) · BUSY abfragen (≤ ~0.5 s) · ERROR 0xFC → Nutzlast neu schreiben, Seite wiederholen · prüfen, ob OTA_STATUS noch 1 ist (3 → OTA_DIAG 0x0180 lesen, neu ab BEGIN beginnen).

  5. (UNLOCK) COMMAND 0x12 COMMIT → BUSY ≥ 3 s abfragen → OTA_STATUS: 2 = scharfgeschaltet (FW_STAGED_VERSION 0x0150 = neue Version) · 3 = abgelehnt (Gründe 7–15 in OTA_DIAG) · 4 = niedrigere Version.

  6. Nur bei Status = 2: (UNLOCK) COMMAND 0x13 ACTIVATE — keine oder abgeschnittene Modbus-Antwort; das Modul ist nach ca. 4 s wieder da. Oder (UNLOCK) COMMAND 0x14 FW_ABORT, um das scharfgeschaltete Image zu verwerfen.

  7. Das Modul etwa 10 s lang nicht zurücksetzen (Testlauf + Selbstbestätigung), danach prüfen: FW_ACTIVE_BANK hat gewechselt · FW_VER = neue Version · SWAP_PENDING 0x011C = 0. Steht FW_VER wieder auf der alten Version, wurde zurückgerollt — OTA_DIAG lesen.

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.