rbAmp
IT
Negozio
Docs
Aggiornato il

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:

  1. ID (0x0000, 2 byte) deve leggere 'S','T' (0x53, 0x54) — qualsiasi altro valore indica che non è un modulo STD.
  2. 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.

  3. CAPABILITIES (0x0004, u16) — mappa di bit delle funzioni, vedere sotto. Il bit 9 (indirizzamento a 16 bit) è sempre impostato su STD.

  4. N_VOLTAGE (0x0007) / N_CURRENT (0x0008) — quanti canali sono presenti. I blocchi dei canali con indice ≥ N sono riservati; il loro valore non è specificato.

  5. VARIANT (0x0009) — codice del membro della famiglia.

  6. UID (0x00F4, 12 byte) — l'id univoco del chip. Gli indirizzi possono cambiare; l'UID no: usarlo come identità del dispositivo in qualsiasi database.

  7. FW_VER (0x0114, u32) — la versione del firmware in esecuzione (da usare per inventario e decisioni di aggiornamento). Si legge come major.minor: parola alta e parola bassa in decimale: 0x0001007E viene 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)
Sicurezza

⚠ 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.