Identità e discovery
Come un host riconosce un modulo STD, cos'è e cosa sa fare. Tutti i registri di questo capitolo sono di sola lettura salvo diversa indicazione. Indirizzi I²C; le copie di rilevamento Modbus sono elencate alla fine.
Sequenza di rilevamento
Al primo contatto un master legge il blocco di identità a 0x0000 e subordina a esso tutto il resto:
ID(0x0000, 2 byte) deve leggere'S','T'(0x53, 0x54) — qualsiasi altro valore indica che non è un modulo STD.-
VERSION(0x0003) è la versione del layout della mappa dei registri (attuale:0x36). Le aggiunte di funzioni la incrementano; un master subordina le funzioni della mappa a essa. -
CAPABILITIES(0x0004, u16) — mappa di bit delle funzioni, vedere sotto. Il bit 9 (indirizzamento a 16 bit) è sempre impostato su STD. -
N_VOLTAGE(0x0007) /N_CURRENT(0x0008) — quanti canali sono presenti. I blocchi dei canali con indice ≥ N sono riservati; il loro valore non è specificato. -
VARIANT(0x0009) — codice del membro della famiglia. -
UID(0x00F4, 12 byte) — l'id univoco del chip. Gli indirizzi possono cambiare; l'UID no: usarlo come identità del dispositivo in qualsiasi database. -
FW_VER(0x0114, u32) — la versione del firmware in esecuzione (da usare per inventario e decisioni di aggiornamento). Si legge comemajor.minor: parola alta e parola bassa in decimale:0x0001007Eviene mostrato come firmware STD 1.126. La versione della mappa dei registri (VERSION, 0x0003) è un'altra cosa.
Registri di identità
| Ind. | Nome | Tipo | Significato |
|---|---|---|---|
| 0x0000 | ID | 2×u8 | 'S','T' |
| 0x0002 | ERROR | u8 | risultato dell'ultimo comando (vedere Comandi) |
| 0x0003 | VERSION | u8 | versione della mappa dei registri (0x36) |
| 0x0004 | CAPABILITIES | u16 | mappa di bit delle funzioni |
| 0x0006 | STATUS | u8 | bit di stato attivi (vedere Diagnostica) |
| 0x0007 | N_VOLTAGE | u8 | canali di tensione, 0..8 |
| 0x0008 | N_CURRENT | u8 | canali di corrente, 1..64 |
| 0x0009 | VARIANT | u8 | codice membro della famiglia |
| 0x000A | HW_REV | u8 | revisione hardware |
| 0x000B | FW_VERSION | u16 | marcatore di linea del firmware — non la versione dell'immagine |
| 0x00F4 | UID | 12×u8 | id chip univoco |
| 0x0114 | FW_VER | u32 | versione del firmware in esecuzione: parola alta . parola bassa, decimale (0x0001007E = 1.126) |
| 0x017C | BOARD_ID | u32 | id scheda dell'immagine in esecuzione (vedere sotto) |
⚠ Esistono due registri di "versione firmware" per ragioni storiche. FW_VERSION (0x000B, u16) indica solo la linea firmware. La versione firmware effettiva, crescente in modo monotono, è FW_VER (0x0114, u32), mostrata come major.minor — usarla per l'inventario e le decisioni di aggiornamento.
BOARD_ID (0x017C)
BOARD_ID identifica la scheda per cui è stata compilata l'immagine in esecuzione: ("BD" << 16) | channel-count << 8 | VARIANT = 0x4244nnvv — ad es. 0x42440211 per STD-UI1. Ogni immagine di rilascio porta la stessa parola, coperta dai controlli di integrità e firma dell'immagine; un aggiornamento firmware con un id scheda diverso viene rifiutato (vedere Aggiornamento firmware). Confrontare BOARD_ID con il file di rilascio prima di inviare un aggiornamento.
Mappa di bit CAPABILITIES (0x0004)
| Bit | Nome | Significato |
|---|---|---|
| 0 | SIGNED | potenza/energia con segno (importazione/esportazione) |
| 1 | REACTIVE | Q e S pubblicate |
| 2 | THD | campi THD / PF di spostamento attivi (0 → quei campi leggono 0 su I²C, la sentinella su Modbus nativo) |
| 3 | HARMONICS | spettri per armonica (linea industriale) |
| 4 | INDUSTRIAL | build della linea industriale |
| 5 | HUB_IFACE | interfaccia lato hub |
| 6 | OTA | aggiornamento firmware sul bus |
| 7 | ENERGY | accumulatori di energia per finestra |
| 8 | MULTI_LATCH | otto banchi di snapshot presenti — vedere Banchi di snapshot |
| 9 | ADDR16 | indirizzamento dei registri a 16 bit (sempre 1 su STD) |
| 10 | MULTI_CHANNEL | più di un canale di corrente |
| 11 | MODBUS_IFACE | Trasporto Modbus RTU presente |
| 12 | RTC | orologio su dispositivo con batteria (0 — l'ora viene dal master) |
| 13 | ONDEVICE_ENERGY | contatori cumulativi di energia persistiti sul dispositivo |
| 14 | CHMAP_PERSIST | la mappa del modello TA per canale resta persistente (riservato; 0 finché non implementato) |
| 15 | ENERGY_UWH | contatori di energia a risoluzione µWh pubblicati (µWh attivi e µvarh reattivi) — vedere Misura ed energia |
Un master tratta i bit sconosciuti come "funzione assente" e non si affida mai ai campi riservati.
Regola delle capacità dichiarate in modo onesto: un modulo riporta solo ciò che la build in esecuzione fornisce effettivamente. Ad esempio, il firmware trifase riporta THD = 0 e RTC = 0 (il master fornisce l'orologio); i moduli senza banchi di snapshot riportano MULTI_LATCH = 0 (l'energia si legge dai contatori cumulativi).
Codici VARIANT (0x0009)
| Codice | Membro | Canali |
|---|---|---|
| 0x11 | STD-UI1 | 1 V + 1 I |
| 0x63 | STD-U3I3 | 3 V + 3 I (trifase) |
Gli altri codici nello spazio enumerativo sono riservati e non vanno considerati assenti per sempre; un master decide in base a N_VOLTAGE / N_CURRENT + CAPABILITIES, non codificando i codici di variante.
Copia di rilevamento Modbus
La stessa serie di identità è leggibile su Modbus come registri di input a 0x6000: 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 per registro) · FRAME_CNT 0x6011–12 · FREQ 0x6013 · WINDOW_MS 0x6014 · CMD_SEQ 0x6015 · RING_DROP 0x6016 · WIN_NSAMP 0x6017 · WIN_PERIOD 0x6018 · diagnostica CPU 0x6019–0x601C · LOST_FRAMES 0x601D–1E · WIN_SEQ 0x601F. BOARD_ID è holding 0x831B–1C; FW_VER è holding 0x8315–16.