rbAmp
DE
Shop
Docs
Aktualisiert

rbAmp STD — technische Referenz

Vollständige technische Referenz für die rbAmp-STD-Modulreihe: Registerübersicht, Übertragungswege, Befehle, Mess- und Energiemodell, Firmware-Update, Diagnose und Host-Integration.

Hinweis

Version der Registerübersicht 0x36.

Diese Referenz beschreibt den Firmware-Kern, den alle STD-Module teilen. Mitglieder: STD-UI1 (1 Spannungs- + 1 Stromkanal) und STD-U3I3 (3 Spannungs- + 3 Stromkanäle, Drehstrom). Sie verwenden dieselbe Karte und unterscheiden sich nur in N_VOLTAGE / N_CURRENT und im Variantencode, daher ist alles hier allgemein nach Kanalanzahl geschrieben.

Inhalt

# Datei Umfasst
1 Identität & Erkennung Magic, Versionen, Fähigkeiten, Variantencodes, Kanalanzahlen, UID, Platinen-ID
2 I²C-Transport 16-Bit-Zeiger, Lese-/Schreibfolgen, Clock-Stretching, Adressänderung
3 Modbus-RTU-Transport Rahmen, Profile, Registerbereiche, Ausnahmen, UNLOCK, Verhaltensregeln
4 Registerübersicht jeder Block mit Adresse, Typ, Einheiten, Skalierung, Zugriff
5 Befehle Befehlsregister, Semantik von Busy/Ergebnis, Fehlercodes, Freigabe
6 Datenbereit-Ausgang & Ereignisse DRDY-Vertrag, WIN_SEQ, Ereignisflags, Schwellen, Alarm
7 Mess- & Energiemodell Fenster, Einheiten, Energiezähler, Verlauf, Ereignisprotokoll, Zeit
8 Konfiguration, Speicherung & Kalibrierung was Reset/Stromausfall überdauert, wie gespeichert wird, für Anwender sichtbare Kalibrierung
9 Firmware-Update Host-seitiges OTA-Protokoll über I²C und Modbus
10 Diagnose Statusflags, Reset-Ursache, Zähler, Gesundheits-Checkliste, LEDs
11 Hardware-Schnittstelle Signale, Verdrahtung, Schnittstellenmodus-Schalter, DRDY, Reset
12 Host-Integration rohe Registerfolgen ohne unsere Bibliotheken; Verweise auf Bibliotheken
13 Abläufe kanonische Schritt-für-Schritt-Abläufe: Initialisierung, Befehle, Konfiguration, Adressänderung, Energie, Verlauf, OTA, Freischaltung

Durchgehend verwendete Konventionen

  • Adressen. I²C-Registeradressen sind 16 Bit, geschrieben als 0xNNNN. Modbus-Registeradressen sind ein eigener Adressraum (siehe Modbus-Transport); eine Modbus-Adresse entspricht nie „der I²C-Adresse mit demselben Wert“ — Zuordnungstabellen werden explizit angegeben.

  • Byte-Reihenfolge. Mehrbyte-Werte auf I²C sind Little-Endian. Über Modbus ist die Wortreihenfolge des nativen Profils Big-Endian ABCD (konfigurierbar), das float32-Profil ist immer ABCD.

  • Einheiten (Ganzzahlen mit fester Skalierung, nie Gleitkomma, bei I²C und dem nativen Modbus-Profil):

Größe Einheit In SI
Spannung mV ÷1000 → V
Strom µA ÷1 000 000 → A
Wirkleistung mW (vorzeichenbehaftet) ÷1000 → W
Blindleistung mvar (vorzeichenbehaftet) ÷1000 → var
Scheinleistung mVA ÷1000 → VA
Leistungsfaktor Q10 (vorzeichenbehaftet) ÷1024 → PF
Frequenz cHz ÷100 → Hz
Summenenergie Wh / varh (i64, vorzeichenbehaftet) und mWh (i64); µWh (i64) und µvarh (i64) Zähler —
Spannungs-Phasenwinkel Hundertstel Grad (i16, vorzeichenbehaftet) ÷100 → °
Energie je Fenster mW·Abtastwerte (i64, vorzeichenbehaftet) siehe Messmodell
THD Hundertstel Prozent ÷100 → %
  • Vorzeichen. P > 0 = Bezug (Verbrauch); Einspeisung ist negativ. Q folgt IEC 62053-23 (Q > 0 induktiv). PF trägt das Vorzeichen von P. Bezugs- und Einspeiseenergie werden in getrennten Zählern geführt.

  • Sentinel — je Übertragungsweg. Ein Feld, das ein bestimmter Build nicht anbietet, liefert im nativen Modbus-Profil einen Sentinel: 0x8000 (i16), 0x80000000 (i32), 0xFFFF (u16); im float32-Profil liefert es 0; bei I²C liefern solche Felder einfach 0, und nicht abgebildete I²C-Adressen liefern 0xFF.

  • Freigaberegel. Ein Master muss den Kanalzugriff über N_VOLTAGE / N_CURRENT und den Funktionszugriff über CAPABILITIES steuern — Register von Kanälen ≥ N und nicht vorhandener Funktionen sind keine Daten.