rbAmp STD — riferimento tecnico
Riferimento tecnico completo per la linea di moduli rbAmp STD: mappa dei registri, trasporti, comandi, modello di misura ed energia, aggiornamento firmware, diagnostica e integrazione con l'host.
Versione della mappa dei registri 0x36.
Questo riferimento descrive il nucleo firmware condiviso da ogni modulo STD. Membri: STD-UI1 (1 tensione + 1 corrente) e STD-U3I3 (3 tensioni + 3 correnti, trifase). Usano la stessa mappa e differiscono solo per N_VOLTAGE / N_CURRENT e per il codice di variante, quindi tutto qui è scritto in modo generico per numero di canali.
Indice
| # | File | Copre |
|---|---|---|
| 1 | Identità e rilevamento | magic, versioni, capacità, codici di variante, numero di canali, UID, id scheda |
| 2 | Trasporto I²C | puntatore a 16 bit, sequenze di lettura/scrittura, clock stretching, cambio di indirizzo |
| 3 | Trasporto Modbus RTU | framing, profili, spazi di registri, eccezioni, UNLOCK, regole di comportamento |
| 4 | Mappa dei registri | ogni blocco con indirizzo, tipo, unità, scala, accesso |
| 5 | Comandi | registro dei comandi, semantica di occupato/risultato, codici di errore, protezioni |
| 6 | Uscita di dati pronti ed eventi | contratto DRDY, WIN_SEQ, flag di evento, soglie, allarme |
| 7 | Modello di misura ed energia | finestre, unità, contatori di energia, storia, registro eventi, ora |
| 8 | Configurazione, persistenza e taratura | cosa sopravvive a reset/spegnimento, come salvare, taratura visibile all'utente |
| 9 | Aggiornamento firmware | protocollo OTA lato host su I²C e Modbus |
| 10 | Diagnostica | bit di stato, causa del reset, contatori, checklist di salute, LED |
| 11 | Interfaccia hardware | segnali, cablaggio, switch della modalità d'interfaccia, DRDY, reset |
| 12 | Integrazione host | sequenze di registri grezze senza le nostre librerie; puntatori alle librerie |
| 13 | Sequenze | flussi canonici passo-passo: inizializzazione, comandi, configurazione, cambio di indirizzo, energia, storico, OTA, sblocco |
Convenzioni usate in tutto il documento
-
Indirizzi. Gli indirizzi dei registri I²C sono a 16 bit, scritti
0xNNNN. Gli indirizzi dei registri Modbus sono uno spazio separato (vedere Trasporto Modbus); un indirizzo Modbus non coincide mai con "l'indirizzo I²C dello stesso valore" — le tabelle di corrispondenza sono fornite esplicitamente. -
Ordine dei byte. I valori multi-byte su I²C sono little-endian. Su Modbus il profilo nativo usa l'ordine delle parole big-endian ABCD (configurabile); il profilo float32 è sempre ABCD.
-
Unità (interi a scala fissa, mai float, su I²C e sul profilo nativo Modbus):
| Grandezza | Unità | In SI |
|---|---|---|
| Tensione | mV | ÷1000 → V |
| Corrente | µA | ÷1 000 000 → A |
| Potenza attiva | mW (con segno) | ÷1000 → W |
| Potenza reattiva | mvar (con segno) | ÷1000 → var |
| Potenza apparente | mVA | ÷1000 → VA |
| Fattore di potenza | Q10 (con segno) | ÷1024 → PF |
| Frequenza | cHz | ÷100 → Hz |
| Energia cumulativa | Wh / varh (i64, con segno) e mWh (i64); contatori µWh (i64) e µvarh (i64) | — |
| Angolo di fase della tensione | centi-grado (i16, con segno) | ÷100 → ° |
| Energia per finestra | mW·campioni (i64, con segno) | vedere il modello di misura |
| THD | centi-percento | ÷100 → % |
-
Segni. P > 0 = importazione (consumo); l'esportazione è negativa. Q segue IEC 62053-23 (Q > 0 induttivo). PF porta il segno di P. L'energia di importazione ed esportazione è conservata in contatori separati.
-
Sentinelle — per trasporto. Un campo che una certa build non offre legge, sul profilo nativo Modbus, una sentinella:
0x8000(i16),0x80000000(i32),0xFFFF(u16); nel profilo float32 legge 0; su I²C tali campi leggono semplicemente 0, e gli indirizzi I²C non mappati leggono0xFF. -
Regola di protezione. Un master deve regolare l'accesso ai canali tramite
N_VOLTAGE/N_CURRENTe l'accesso alle funzioni tramiteCAPABILITIES— i registri dei canali ≥ N e delle funzioni assenti non sono dati.