rbAmp
DE
Shop
Docs
Aktualisiert

Befehle

Alle Gerätevorgänge laufen über das COMMAND-Register (0x0060, u8) — über Modbus Holding 0x8113 (dort nur schreibbar). Ein Schreibvorgang reiht den Opcode ein; die Ausführung erfolgt in der Hauptschleife des Geräts (Millisekunden für die meisten Befehle; Befehle, die den Flash berühren, brauchen länger).

Abschluss und Ergebnissemantik

  • Busy: CMD_STATE (0x006A) Bit 0 = BUSY, solange ein Befehl läuft. BUSY ist das Abschlusssignal — fragen Sie es ab, bis es 0 ist, bevor Sie das Ergebnis lesen. Ein neuer Befehl, der während BUSY geschrieben wird, wird verworfen (Bit 1 OVERRUN gesetzt; der laufende Befehl wird nicht überschrieben; OVERRUN wird gelöscht, wenn der nächste Befehl angenommen wird). Über Modbus ergibt ein COMMAND-Schreibvorgang während BUSY → Ausnahme 06.

  • Ergebnis: ERROR (0x0002; Modbus-Rücklesen Halteregister 0x8114) enthält das Ergebnis nach Abschluss (0x00 = OK). ERROR liefert während der gesamten Ausführung 0xF0 (Modbus 0xFFFF) und wird zusammen mit dem Abschluss geschrieben; den Abschluss anhand von BUSY beurteilen und das Ergebnis danach aus ERROR lesen.

  • Aktualität: CMD_SEQ (0x0067) zählt einmal je abgeschlossenem Befehl hoch — abfragen, um ein frisches von einem veralteten Ergebnis zu unterscheiden.

  • Muster: BUSY = 0 prüfen → Parameter schreiben, dann COMMAND → BUSY → 0 abfragen (Timeouts: ≥1 s für einfache Befehle und Speicherungen, ≥0.5 s für ein Firmware-Seitenschreiben, ≥3 s für das COMMIT des Updates; bei I²C ≥10 ms Clock-Stretching tolerieren und NACKte Lesevorgänge wiederholen — einen COMMAND-Schreibvorgang nie blind erneut senden) → ERROR lesen. Vollständige Schritt-für-Schritt-Anleitung: Abläufe D2.

  • Befehle, die das Modul neu starten (0x02 RESET, 0x13 ACTIVATE, 0x16 ADDR_BY_UID am passenden Modul): über Modbus kann die Antwort abgeschnitten sein oder fehlen (und eine konfigurierte Sendeverzögerung kann sie unterdrücken); nach dem Neustart das Gerät erneut abfragen, um es zu bestätigen.

Fehlercodes (ERROR 0x0002)

Code Name Bedeutung
0x00 OK angenommen / abgeschlossen
0xF0 PENDING Befehl läuft noch (mit BUSY = 1)
0xF6 NVM_IO ein Speicherschreibvorgang ist fehlgeschlagen (SAVE_CAL / SAVE_CONFIG / Verlaufsimport)
0xF7 NO_KEY Attestierung verweigert — kein bereitgestellter Geräteschlüssel
0xF8 — Vorgang durch Servicerichtlinie abgelehnt
0xF9 NVM_RATE_LIMIT Neuschreiben der Speicherung ratenbegrenzt (mindestens ca. 5 s zwischen Speichervorgängen) — später erneut versuchen
0xFA OP_RETRY Vorgang läuft bereits · im aktuellen Zustand abgelehnt (z. B. Energiespeicher FAULT, negativer Übernahmewert)
0xFB KEY_GATE geschützter Befehl ohne gültigen einmaligen Schlüssel (LT_KEY)
0xFC VALUE_CRC CRC-Abweichung der Update-Seite (Seite erneut senden) · Zeitepoche unter 1600000000 · UID-Abweichung (ADDR_BY_UID) · kein solcher Verlaufseintrag (HIST_READ)
0xFD PARAM ungültiger Parameter / Konfigurationswert — nichts gespeichert
0xFE UNKNOWN_CMD Opcode nicht unterstützt

Befehlssatz

Befehle der Familie

Op Name Wirkung
0x01 SAVE_CAL Kalibrierregister dauerhaft speichern (Service/Werk; über Modbus per UNLOCK freizugeben; ratenbegrenzt → 0xF9)
0x02 RESET Warm-Reset (über Modbus per UNLOCK freizugeben; keine oder abgeschnittene Modbus-Antwort erwarten)
0x03 LATCH_PERIOD an der nächsten Fenstergrenze das durch LATCH_BANK gewählte Snapshot-Bank (0..7; ≥ 8 → 0xFD) erstellen und deren Akkumulation neu starten — Fähigkeitsbit 8; sonst 0xFE
0x04 SAVE_CONFIG Konfiguration dauerhaft speichern (Lesen-Ändern-Schreiben; Kalibrierung unberührt; nicht UNLOCK-freigabepflichtig). Werte gegen die Tabelle zulässiger Werte validiert; unzulässig → 0xFD, nichts gespeichert; ratenbegrenzt → 0xF9; ein unveränderter Speichervorgang ist ein OK-Leerlauf (erzeugt trotzdem CONFIG_CHANGED)
0x06 SET_TIME die in TIME_SET/RTC_EPOCH geschriebene Epoche übernehmen; Epoche < 1600000000 → 0xFC; STATUS Bit 4 wird sofort gesetzt
0x07 ENERGY_RESET Familien-Opcode, UNLOCK-gesperrt. Nicht verwendet (0xFE / Ausnahme 03) — das Zurücksetzen des Zählers erfolgt über das geschützte LT_RESET unten
0x0E IDENTIFY LEDs 10 s lang blinken lassen — das Modul im Schaltschrank finden. Nicht geschützt
0x0F ATTEST die 32-B-Challenge bei 0x0B80 signieren (Registerübersicht); ~55 ms; 0xF7 = kein Schlüssel
0x10 OTA_BEGIN eine Update-Sitzung öffnen (Firmware-Update)
0x11 OTA_BLOCK_WR eine 256-B-Seite programmieren (gedrosselt auf eine Seite / ~250 ms — BUSY bis zu ihrem Platz)
0x12 OTA_COMMIT geprüftes und scharfgeschaltetes Image bereitstellen (kein Reset); BUSY ≥ 3 s abfragen
0x13 OTA_ACTIVATE Reset in das scharfgeschaltete Image (nur wenn OTA_STATUS = 2; ca. 4 s bis es wieder erscheint)
0x14 FW_ABORT Update-Sitzung schließen / ein scharfgeschaltetes Image entschärfen
0x15 — reserviert (Werk/Service)
0x16 ADDR_BY_UID Das Modul, dessen UID mit ADDR_UID übereinstimmt, übernimmt die vorgemerkte(n) Adresse(n), speichert sie zusammen mit allen anderen ausstehenden CFG_-Änderungen und startet neu; andere Module antworten mit 0xFC. Beide neuen Adressfelder null → 0xFD; ungültige Adresse → 0xFD; Speicher-Ratenbegrenzung → 0xF9. Funktioniert über einen Modbus-Broadcast. Nicht freigabepflichtig

Geschützte Befehle (Lebensdauerzähler und Verlauf)

Diese Befehle ändern messrelevante Zustände, daher muss unmittelbar vor dem Befehl der passende Einmal-Schlüssel in LT_KEY (0x0844 / Modbus-Halteregister 0x8142–43, oberes Wort zuerst) geschrieben werden. Der Schlüssel wird vom nächsten Befehl verbraucht; falscher oder fehlender Schlüssel → ERROR 0xFB. Dies ist ein Schutz gegen unbeabsichtigte Aktionen zusätzlich zum Transport (nicht das Modbus-UNLOCK).

Op Name Schlüssel (u32) Wirkung
0x08 HIST_READ — (ohne Schlüssel) den Datensatz laden, der durch HIST_PERIOD/HIST_BACK gewählt ist, in HIST_REC; kein solcher Datensatz → 0xFC
0x09 HIST_FLUSH — (ohne Schlüssel) Energie jetzt schreiben: die Retention-Kopie immer; der NVM-Datensatz nur, wenn seit seinem letzten Schreibvorgang ≥ 10 s vergangen sind (ergibt sich auch bei RESET und Aktivierung des Updates)
0x0A LT_RESET 0x4C545253 "LTRS" Lebensdauer-Energie auf null setzen; Generationszähler ++ (protokolliert). Speicher-FEHLER → 0xFA
0x0B LT_ADOPT 0x4C544150 "LTAP" die gestagten Zählerwerte übernehmen (Platinentausch / Migration); Generation ++ (protokolliert). Reihenfolge des Stagings: Bezug Wh · Einspeisung Wh · Blind-Bezug varh · Blind-Einspeisung varh (4×i64); ein negativer Wert → 0xFA
0x0C HIST_WRITE 0x48494D50 "HIMP" den 80-B-Datensatz aus HIST_REC in den Stundenring übernehmen (HIST_PERIOD muss 1 sein, sonst 0xFC); Zeitstempel nicht neuer → 0xFD; NVM-E/A → 0xF6
0x0D HIST_CLEAR 0x48434C52 "HCLR" schrittweises Löschen des Stundenrings; bei laufendem Vorgang wiederholen → 0xFA (protokolliert)

Zählerresets, Übernahmen und Verlaufsschreibvorgänge im Leben des Zählers werden mit Werten vorher/nachher im Ereignisprotokoll festgehalten — sie können nicht unbemerkt geschehen.

Zusammenfassung der Freigaben

Mechanismus Umfang Wie
Modbus UNLOCK 0x01 · 0x02 · 0x07 · 0x10 · 0x12 · 0x13 · 0x14 · 0x15 Schlüssel 0xA5C3 → Halteregister 0x8112; 10-s-Fenster, ein Befehl; darf mit dem Opcode in einem FC16 zusammen gesendet werden (Modbus)
LT_KEY 0x0A–0x0D, beide Transporte Magic je Befehl, einmalig
Whitelist für Broadcast Modbus-Unit 0 nur Zeit setzen, Snapshot, Adressierung über UID (Modbus)

Auf keinem der Übertragungswege freigabepflichtig: 0x04, 0x06, 0x08, 0x09, 0x0E, 0x0F, 0x11, 0x16. I²C kennt keinen UNLOCK-Schritt: der physische Zugang zum I²C-Bus der Platine ist die Vertrauensgrenze der Installation; die geschützten Befehle sind auf beiden Übertragungswegen trotzdem freigabepflichtig.