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).ERRORliefert 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) →
ERRORlesen. 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.