rbAmp
DE
Shop
Docs
Aktualisiert

Identität und Discovery

Wie ein Host ein STD-Modul erkennt, was es ist und was es kann. Alle Register in diesem Kapitel sind nur lesbar, sofern nicht anders angegeben. I²C-Adressen; Modbus-Discovery-Spiegel sind am Ende aufgeführt.

Erkennungsablauf

Beim ersten Kontakt liest ein Master den Identitätsblock bei 0x0000 und macht alles Weitere davon abhängig:

  1. ID (0x0000, 2 Byte) muss 'S','T' (0x53, 0x54) ergeben — alles andere ist kein STD-Modul.
  2. VERSION (0x0003) ist die Version des Registerlayouts (aktuell: 0x36). Funktionserweiterungen erhöhen sie; ein Master macht Kartenfunktionen davon abhängig.

  3. CAPABILITIES (0x0004, u16) — Funktionsbitmap, siehe unten. Bit 9 (16-Bit-Adressierung) ist bei STD immer gesetzt.

  4. N_VOLTAGE (0x0007) / N_CURRENT (0x0008) — wie viele Kanäle belegt sind. Kanalblöcke mit Index ≥ N sind reserviert; ihr Wert ist nicht festgelegt.

  5. VARIANT (0x0009) — Familienmitglied-Code.

  6. UID (0x00F4, 12 Byte) — die eindeutige Chip-ID. Adressen lassen sich ändern, die UID nicht: verwenden Sie sie als Geräteidentität in jeder Datenbank.

  7. FW_VER (0x0114, u32) — die laufende Firmware-Version (für Bestandsführung und Update-Entscheidungen verwenden). Lesen Sie sie als Hauptversion.Nebenversion: das obere Wort und das untere Wort dezimal; 0x0001007E wird als STD-Firmware 1.126 angezeigt. Die Version der Registerübersicht (VERSION, 0x0003) ist davon getrennt.

Identitätsregister

Adr Name Typ Bedeutung
0x0000 ID 2×u8 'S','T'
0x0002 ERROR u8 Ergebnis des letzten Befehls (siehe Befehle)
0x0003 VERSION u8 Version der Registerübersicht (0x36)
0x0004 CAPABILITIES u16 Funktionsbitmap
0x0006 STATUS u8 Live-Statusbits (siehe Diagnose)
0x0007 N_VOLTAGE u8 Spannungskanäle, 0..8
0x0008 N_CURRENT u8 Stromkanäle, 1..64
0x0009 VARIANT u8 Mitgliedscode der Familie
0x000A HW_REV u8 Hardware-Revision
0x000B FW_VERSION u16 Firmware-Linienkennung — nicht die Image-Version
0x00F4 UID 12×u8 eindeutige Chip-ID
0x0114 FW_VER u32 laufende Firmware-Version: oberes Wort . unteres Wort, dezimal (0x0001007E = 1.126)
0x017C BOARD_ID u32 Board-ID des laufenden Images (siehe unten)
Sicherheit

⚠ Aus historischen Gründen gibt es zwei Register für die „Firmware-Version“. FW_VERSION (0x000B, u16) kennzeichnet nur die Firmware-Linie. Die tatsächliche, monoton steigende Firmware-Version ist FW_VER (0x0114, u32), dargestellt als major.minor — verwenden Sie sie für Inventur und Update-Entscheidungen.

BOARD_ID (0x017C)

BOARD_ID kennzeichnet die Platine, für die das laufende Image gebaut wurde: ("BD" << 16) | Kanalanzahl << 8 | VARIANT = 0x4244nnvv — z. B. 0x42440211 für STD-UI1. Jedes Release-Image trägt dasselbe Wort, abgedeckt durch die Integritäts- und Signaturprüfungen des Images; ein Firmware-Update mit einer anderen Board-ID wird abgelehnt (siehe Firmware-Update). Vergleichen Sie BOARD_ID mit der Release-Datei, bevor Sie ein Update senden.

CAPABILITIES-Bitmap (0x0004)

Bit Name Bedeutung
0 SIGNED vorzeichenbehaftete Leistung/Energie (Import/Export)
1 REACTIVE Q und S veröffentlicht
2 THD THD-/Verschiebungs-PF-Felder live (0 → diese Felder liefern bei I²C 0, bei nativem Modbus den Sentinel)
3 HARMONICS Spektren je Oberschwingung (Industrie-Stufe)
4 INDUSTRIAL Build der Industrie-Stufe
5 HUB_IFACE hostseitige Schnittstelle
6 OTA Firmware-Update über den Bus
7 ENERGY Energieakkumulatoren je Fenster
8 MULTI_LATCH acht Snapshot-Bänke vorhanden — siehe Snapshot-Bänke
9 ADDR16 16-Bit-Registeradressierung (bei STD immer 1)
10 MULTI_CHANNEL mehr als ein Stromkanal
11 MODBUS_IFACE Modbus-RTU-Transport vorhanden
12 RTC batteriegepufferte Geräteuhr (0 — die Zeit kommt vom Master)
13 ONDEVICE_ENERGY auf dem Gerät gespeicherte kumulative Energiezähler
14 CHMAP_PERSIST CT-Modell je Kanal bleibt erhalten (reserviert; 0 bis zur Umsetzung)
15 ENERGY_UWH veröffentlichte Energiezähler mit µWh-Auflösung (Wirk-µWh und Blind-µvarh) — siehe Messung & Energie

Ein Master behandelt unbekannte Bits als „Funktion nicht vorhanden“ und verlässt sich nie auf reservierte Felder.

Regel der ehrlichen Fähigkeiten: Ein Modul meldet nur, was der laufende Build tatsächlich bietet. Zum Beispiel meldet die Drehstrom-Firmware THD = 0 und RTC = 0 (der Master liefert die Uhr); Module ohne Snapshot-Bänke melden MULTI_LATCH = 0 (Energie wird aus kumulativen Zählern gelesen).

VARIANT-Codes (0x0009)

Code Mitglied Kanäle
0x11 STD-UI1 1 V + 1 I
0x63 STD-U3I3 3 V + 3 I (Drehstrom)

Andere Codes im Aufzählungsraum sind reserviert und dürfen nicht als dauerhaft fehlend angenommen werden; ein Master entscheidet anhand von N_VOLTAGE / N_CURRENT + CAPABILITIES, nicht durch fest codierte Variantencodes.

Modbus-Discovery-Spiegel

Derselbe Identitätssatz ist über Modbus als Eingangsregister bei 0x6000 lesbar: MAGIC 0x6000 · MAP_VERSION 0x6001 · FW_VERSION 0x6002 · HW_REV 0x6003 · CAPABILITIES 0x6004 · N_VOLTAGE 0x6005 · N_CURRENT 0x6006 · VARIANT 0x6007 · TIER 0x6008 · STATUS 0x6009 · ERROR 0x600A · UID 0x600B–0x6010 (12 Byte, big-endian je Register) · FRAME_CNT 0x6011–12 · FREQ 0x6013 · WINDOW_MS 0x6014 · CMD_SEQ 0x6015 · RING_DROP 0x6016 · WIN_NSAMP 0x6017 · WIN_PERIOD 0x6018 · CPU-Diagnose 0x6019–0x601C · LOST_FRAMES 0x601D–1E · WIN_SEQ 0x601F. BOARD_ID steht auf dem Halteregister 0x831B–1C; FW_VER auf dem Halteregister 0x8315–16.