rbAmp
DE
Shop
Docs
Aktualisiert

Modbus-RTU-Transport

Bei der Modbus-Einstellung des Umschalters für den Schnittstellenmodus ist das Modul ein Modbus-RTU-Slave auf seinen UART-Leitungen (ein externer Transceiver passt sie an RS-485 an). Die Modbus-Schicht ist eine Übersetzung auf dieselbe Registerdatei wie bei I²C: dieselben Größen, dieselben Befehle, eine Befehlswarteschlange; nur das Drahtformat unterscheidet sich.

Seriell

  • Rahmenformat: Standard-RTU [addr][function][data][CRC16], CRC16-Polynom 0xA001 (reflektiert), LSB zuerst. Ein Rahmen mit falscher CRC erhält keine Antwort (Standard-RTU-Verhalten).

  • Unit-ID: 1..247, Standard 1 (CFG_MODBUS_ADDR). 0 = Broadcast (nur freigegebene Schreibvorgänge, siehe unten). IDs 248..255 werden bei der Konfiguration abgelehnt.

  • Baud: Standard 9600. Codes in CFG_MB_BAUD: 0=2400 · 1=4800 · 2=9600 · 3=19200 · 4=38400 · 5=57600 · 6=115200 · 7=230400 · 8=460800 · 9=921600 · 10=1000000. Das Modul akzeptiert die Codes 0–10; die Leitungsgeschwindigkeit über RS-485 wird durch den externen Transceiver festgelegt. Ist der gespeicherte Code einmal ungültig, startet das Modul mit 9600.

  • Rahmenformat: CFG_MB_FRAME 0=8N1 · 1=8E1 · 2=8O1 · 3=8N2.

  • Antwortverzögerung: CFG_TX_DELAY 0..100 ms — für RS-485-Adapter mit automatischer Richtungsumschaltung, die Zeit brauchen, um die Leitung freizugeben.

  • Serielle Einstellungen werden beim Schreiben geprüft (Ausnahme 03). Ein Schreibvorgang legt den Wert nur im RAM ab — damit er wirksam wird: speichern (COMMAND 0x04) und dann neu starten (COMMAND 0x02, nur mit UNLOCK freigegeben); das Modul startet mit den gespeicherten Werten. Schritt für Schritt: Abläufe D4.

  • Antwortlatenz: Der angeforderte Bereich wird atomar aus dem veröffentlichten Abbild kopiert, daher ist auch ein Lesevorgang über 125 Register intern kohärent; das Gerät antwortet in < 20 ms bei jeder Baudrate (geeignet für Wechselrichter-Abfragen mit 3–5 Hz).

  • Antworten auf neustartauslösende Befehle (RESET, Firmware-ACTIVATE, Adressänderung über UID) können abgeschnitten oder ganz ausbleiben — das Gerät kann vor Ende der Antwort neu starten, und eine konfigurierte Sendeverzögerung kann sie vollständig unterdrücken. Nach dem Neustart erneut abfragen und die Bestätigung nicht aus der Antwort ableiten.

Funktionscodes

FC03 Halteregister lesen · FC04 Eingangsregister lesen · FC06 einzelnes Register schreiben · FC16 mehrere Register schreiben. Jeder andere Funktionscode → Ausnahme 01.

Grenzen: FC03/FC04 Menge 1..125, FC16 1..123 — außerhalb → Ausnahme 03. FC16 ist alles oder nichts: der gesamte Rahmen wird zuerst geprüft; ein fehlerhaftes Register → nichts angewendet. COMMAND (Halteregister 0x8113) ist nur schreibbar — Lesen führt zu Ausnahme 02.

Registerbereiche

Modbus-Adressen sind ein eigener Adressraum — unabhängig von I²C-Adressen. Aufbau:

Leerzeichen Bereich Inhalt
Eingang 0x0000–0x03FF Float32-Profil (13 Live-Punkte, unten)
Eingang 0x6000–0x6FFF natives Profil mit Ganzzahlen fester Skalierung (Discovery, Kanäle, Energie, Summen)
Halteregister 0x8000–0x83FF native Konfiguration · Zeit/Befehle · Firmware-Update
Halteregister 0x8400–0x847F Sicherheitsfenster (Gerätezertifikat / Attestierung; Bytestrom)
Halteregister 0xA000–0xAFFF schreibgeschützter Spiegel des nativen Eingangs (= Eingangsadresse + 0x4000) für Master, die nur FC03 beherrschen
— alles Übrige nicht zugeordnet → Ausnahme 02

Die Adressen der einzelnen Blöcke (nativ und Holding) sind mit der I²C-Zuordnung in der Registerübersicht aufgeführt.

Natives Profil (Eingang 0x6000+)

Ganzzahlen mit fester Skalierung, gleiche Einheiten wie I²C. Wortreihenfolge ABCD (oberes Wort zuerst) standardmäßig; CFG_WORD_ORDER = 1 tauscht auf niederwertiges Wort zuerst für alle mehrregistrigen Zahlen im nativen Eingangsprofil (i64 = alle vier Wörter umgekehrt), und die Platzhalter für nicht vorhandene Kanäle werden ebenso getauscht. Die Halteregisterfenster (0x81xx/0x83xx) sind immer oberes Wort zuerst, unabhängig von CFG_WORD_ORDER. i32 = 2 Register, i64 = 4 Register. Die Summen P/Q/S werden über Modbus als i64 veröffentlicht (aus den Gerätewerten mit Vorzeichen erweitert).

Float32-Profil (Eingang 0x0000)

Modbus RTU mit einem float32-Registerprofil aus 13 Werten. Die Registeradressen und die ABCD-Wortreihenfolge folgen der öffentlich dokumentierten SDM-Registerübersicht. Wir haben das Modul nicht gegen ein SDM-Gerät, gegen Drittanbieter-Software von SDM, einen Wechselrichter, eine SPS oder ein SCADA-System getestet.

IEEE-754 float32, immer ABCD, physikalische Einheiten (V/A/W/kWh), Export als positiver Betrag. Live-Punkte (13):

Eingangsadr. Punkt
0x0000 / 0x0002 / 0x0004 Spannung L1 / L2 / L3, V
0x0006 / 0x0008 / 0x000A Strom L1 / L2 / L3, A
0x000C / 0x000E / 0x0010 Wirkleistung L1 / L2 / L3, W
0x0034 Gesamt-Wirkleistung, W
0x0046 Frequenz, Hz
0x0048 / 0x004A Import-/Exportenergie, kWh

Jede andere Adresse im Bereich 0x0000–0x03FF liefert 0; ein Wechselrichter oder SCADA, der Register außerhalb der obigen Liste braucht, bekommt sie aus diesem Profil nicht. Nicht vorhandene Phasen des Moduls liefern 0.0 (STD-UI1 veröffentlicht seinen Kanal als L1; seine L1-Adressen enthalten Spannung, Strom, Leistung, Frequenz, Bezug und Einspeiseenergie). Punkte für S, Q, PF und Gesamtenergie liefern 0. Einphasige Mitglieder veröffentlichen ihren Kanal als L1. Dieses Profil hat keine Konfigurationsaliase — die Konfiguration erfolgt über die nativen Halteregister.

Virtuelle Unit-IDs

Mit CFG_VIRTUAL_IDS = 1 (gespeichert + Neustart; wirkt beim Booten) antwortet ein Modul mit mehr als einem Stromkanal auch auf Unit-IDs Basis+1 … Basis+N_CURRENT (begrenzt auf 247): Jede ID ist eine schreibgeschützte Einkanal-float32-Ansicht eines Stromkanals — dessen Spannung, Strom, Leistung, Gesamtleistung = Leistung dieses Kanals, Frequenz; Energiepunkte liefern 0. Jeder Schreibvorgang auf eine virtuelle ID → Ausnahme 02. Wählen Sie die Basis-Unit-ID so, dass die abgeleiteten IDs nicht mit anderen Zählern auf dem Bus kollidieren.

(Die METER_GROUP-Konfigurationstabelle in der Übersicht ist reserviert — die Gruppenzusammensetzung ist nicht konfigurierbar.)

Broadcast (Unit-ID 0)

Auf Broadcast werden nur diese Schreibvorgänge angenommen; alles andere wird stillschweigend abgelehnt (keine Ausnahmeantwort auf Broadcast, gemäß Modbus-Standard):

  • Zeit setzen — zwei Rahmen: FC16 an 0x8100–0x8101 (Epoche, höheres Wort zuerst), danach FC06 COMMAND 0x8113 = 0x0006 — busweite Uhrensynchronisation;

  • LATCH_BANK / PERIOD_ARM 0x8110–11 und COMMAND 0x03 — synchronisierte Momentaufnahme über Module hinweg (Fähigkeitsbit 8);

  • Staging der Adressierung über UID 0x8118–0x811E + COMMAND 0x16 — Inbetriebnahme an einem gemeinsamen Bus.

Ein Broadcast-FC16 muss innerhalb der Whitelist-Register bleiben — ein Rahmen, der etwas anderes berührt, wird insgesamt abgelehnt.

UNLOCK (gesperrte Befehle)

Befehle, die den Gerätezustand ändern, müssen vorher der Entsperrschlüssel 0xA5C3 in das Halteregister 0x8112 geschrieben werden:

  • Der Schlüssel ist 10 s gültig und wird durch einen freigabepflichtigen Befehl verbraucht.
  • Das Schreiben eines falschen Werts löscht eine aktive Freischaltung.
  • Ein geschützter Befehl ohne gültige Entsperrung → Ausnahme 03.
  • Das Lesen von 0x8112 liefert das Freischaltungs-Flag (0/1) wie zuletzt gesetzt — nur informativ behandeln.
  • Freischaltung und Befehl dürfen in einem FC16-Rahmen bei 0x8112–0x8113 stehen (zuerst der Schlüssel, dann der Opcode).

Freigabepflichtige Menge: 0x01 SAVE_CAL · 0x02 RESET · 0x07 ENERGY_RESET (wo implementiert) · 0x10/0x12/0x13/0x14 (Firmware-Update) · 0x15 (Service). Nicht freigabepflichtig: 0x04 SAVE_CONFIG · 0x06 SET_TIME · 0x08–0x0F · 0x11 Seitenschreibvorgang · 0x16 Adresse per UID. Bei Modulen, die einen Opcode nicht implementieren, lautet die Ablehnung Ausnahme 03, noch bevor die Freigabe geprüft wird. Die Lebenszeit-Energiebefehle verwenden einen anderen, einmaligen Schlüsselmechanismus (LT_KEY), nicht UNLOCK — siehe Befehle.

Verhaltensregeln (Vertrag der Familie)

  • Die Werte von COMMAND, LATCH_BANK, PERIOD_ARM > 0xFF ergeben Ausnahme 03 (kein stilles Abschneiden der niederwertigen Byte).

  • Ein Schreibvorgang auf COMMAND, während ein Befehl noch läuft → Ausnahme 06 (Gerät belegt).

  • Byte-Paar-Fenster (Sicherheit 0x8400+, Firmware-Nutzlast 0x8380+, Verlaufsdatensatz 0x8180+): Register k enthält die Bytes 2k (hoch) und 2k+1 (niedrig). Schreibvorgänge, die schreibgeschützte Bytes berühren → Ausnahme

  • Das Sicherheitsfenster ist ein Little-Endian-Bytestrom — numerische Felder darin werden aus den Bytes als LE dekodiert, nicht als Big-Endian-Register.

  • Eine Tabelle gültiger Konfigurationswerte gilt für beide Transporte: ein ungültiger Wert über Modbus → Ausnahme 03; derselbe Wert über I²C wird bei SAVE_CONFIG mit ERROR 0xFD abgelehnt — in beiden Fällen wird nichts dauerhaft gespeichert.

  • Felder, die der Build nicht anbietet (fehlende Kanäle; THD- und Blindgrößen bei CAPABILITIES Bit 2 = 0), liefern in der nativen Profilform den Platzhalter (0xFFFF / 0x8000…); im float32-Profil liefern sie 0.

Ausnahmen

Code Bedeutung
01 unzulässige Funktion (alles außer FC03/04/06/16)
02 Adresse außerhalb der Übersicht · Schreiben auf ein Eingangsregister, ein schreibgeschütztes Holding-Register oder eine virtuelle Unit-ID · Lesen eines nur schreibbaren Registers
03 ungültiger Wert (falsche Unit-ID / Baud-Code / Konfigurationswert · ungültiger Befehls-Opcode · übergroßer COMMAND-/LATCH-Wert · Menge außerhalb des Bereichs · geschützter Befehl ohne Entsperrung)
04 interner Gerätefehler
06 Gerät beschäftigt (Befehl oder Firmware-Vorgang läuft)

Die letzte Ausnahme wird zur Diagnose in LAST_EXCEPTION gespeichert (FC<<24 | code<<16 | address) und ist auf beiden Transporten lesbar: I²C 0x0158, Modbus-Halteregister 0x830A–0B.