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:
ID(0x0000, 2 Byte) muss'S','T'(0x53, 0x54) ergeben — alles andere ist kein STD-Modul.-
VERSION(0x0003) ist die Version des Registerlayouts (aktuell:0x36). Funktionserweiterungen erhöhen sie; ein Master macht Kartenfunktionen davon abhängig. -
CAPABILITIES(0x0004, u16) — Funktionsbitmap, siehe unten. Bit 9 (16-Bit-Adressierung) ist bei STD immer gesetzt. -
N_VOLTAGE(0x0007) /N_CURRENT(0x0008) — wie viele Kanäle belegt sind. Kanalblöcke mit Index ≥ N sind reserviert; ihr Wert ist nicht festgelegt. -
VARIANT(0x0009) — Familienmitglied-Code. -
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. -
FW_VER(0x0114, u32) — die laufende Firmware-Version (für Bestandsführung und Update-Entscheidungen verwenden). Lesen Sie sie alsHauptversion.Nebenversion: das obere Wort und das untere Wort dezimal;0x0001007Ewird 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) |
⚠ 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.