Trasporto Modbus RTU
Con l'impostazione Modbus del commutatore della modalità di interfaccia il modulo è uno slave Modbus RTU sulle sue linee UART (un trasmettitore esterno le adatta a RS-485). Il livello Modbus è una traduzione sullo stesso file di registri di I²C: stesse grandezze, stessi comandi, una sola coda di comandi; cambia solo il formato sul filo.
Seriale
-
Framing: RTU standard
[addr][function][data][CRC16], polinomio CRC16 0xA001 (riflesso), LSB per primo. Un frame con CRC errato non riceve nessuna risposta (comportamento RTU standard). -
Id unità: 1..247, predefinito 1 (
CFG_MODBUS_ADDR). 0 = broadcast (solo scritture in whitelist, vedere sotto). Gli id 248..255 sono rifiutati in configurazione. -
Baud: predefinito 9600. Codici in
CFG_MB_BAUD: 0=2400 · 1=4800 · 2=9600 · 3=19200 · 4=38400 · 5=57600 · 6=115200 · 7=230400 · 8=460800 · 9=921600 · 10=1 000 000. Il modulo accetta i codici 0–10; la velocità di linea su RS-485 è impostata dal ricetrasmettitore esterno. Se il codice memorizzato non è valido, il modulo si avvia a 9600. -
Formato del frame:
CFG_MB_FRAME0=8N1 · 1=8E1 · 2=8O1 · 3=8N2. -
Ritardo di risposta:
CFG_TX_DELAY0..100 ms — per gli adattatori RS-485 a direzione automatica che hanno bisogno di tempo per rilasciare la linea. -
Le impostazioni seriali vengono validate in scrittura (eccezione 03). Una scrittura imposta il valore solo in RAM — per renderlo effettivo: salvare (
COMMAND0x04), poi riavviare (COMMAND0x02, subordinato a UNLOCK); il modulo si avvia con i valori salvati. Procedura passo passo: Sequenze D4. -
Latenza di risposta: l'intervallo richiesto viene copiato in modo atomico dall'immagine pubblicata, quindi anche una lettura di 125 registri è internamente coerente; il dispositivo risponde in < 20 ms a qualsiasi baud (adatto all'interrogazione di inverter a 3–5 Hz).
-
Risposte ai comandi che causano un riavvio (RESET, ACTIVATE del firmware, cambio di indirizzo tramite UID) possono essere troncate o assenti — il dispositivo può riavviarsi prima che la risposta sia completa, e un ritardo TX configurato può sopprimerla del tutto. Confermare interrogando di nuovo dopo il riavvio, non tramite la risposta.
Codici funzione
FC03 lettura holding · FC04 lettura input · FC06 scrittura singola · FC16 scrittura multipla. Qualsiasi altro codice funzione → eccezione 01.
Limiti: FC03/FC04 quantità 1..125, FC16 1..123 — fuori → eccezione 03. FC16 è tutto o niente: l'intero frame viene validato prima; un registro errato → nulla applicato. COMMAND (holding 0x8113) è solo scrittura — leggerlo → eccezione 02.
Spazi dei registri
Gli indirizzi Modbus sono uno spazio a sé — indipendenti dagli indirizzi I²C. Struttura:
| Spazio | Intervallo | Contenuto |
|---|---|---|
| Ingresso | 0x0000–0x03FF | Profilo float32 (13 punti live, sotto) |
| Ingresso | 0x6000–0x6FFF | profilo nativo a interi a scala (discovery, canali, energia, totali) |
| Holding | 0x8000–0x83FF | configurazione nativa · tempo/comandi · aggiornamento firmware |
| Holding | 0x8400–0x847F | finestra di sicurezza (certificato del dispositivo / attestazione; flusso di byte) |
| Holding | 0xA000–0xAFFF | specchio di sola lettura dell'input nativo (= indirizzo input + 0x4000) per master solo FC03 |
| — | tutto il resto | non mappato → eccezione 02 |
Gli indirizzi nativi e holding di ciascun blocco sono elencati insieme alla mappa I²C nella mappa dei registri.
Profilo nativo (input 0x6000+)
Interi a scala fissa, stesse unità di I²C. Ordine delle parole ABCD (parola alta per prima) per impostazione predefinita; CFG_WORD_ORDER = 1 scambia in parola bassa per prima per tutti i numeri a più registri nel profilo di input nativo (i64 = tutte e quattro le parole invertite), e i valori sentinella dei canali assenti si scambiano allo stesso modo. Le finestre holding (0x81xx/0x83xx) sono sempre con parola alta per prima, indipendentemente da CFG_WORD_ORDER. i32 = 2 registri, i64 = 4 registri. I totali P/Q/S sono pubblicati come i64 su Modbus (estesi con segno dai valori del dispositivo).
Profilo float32 (input 0x0000)
Modbus RTU con un profilo di registri float32 di 13 valori. Gli indirizzi dei registri e l'ordine delle parole ABCD seguono la mappa dei registri SDM pubblicamente documentata. Non abbiamo testato il modulo con alcun dispositivo SDM, né con software SDM di terze parti, inverter, PLC o sistemi SCADA.
IEEE-754 float32, sempre ABCD, unità fisiche (V/A/W/kWh), esportazione come modulo positivo. Punti in tempo reale (13):
| Indirizzo input | Punto |
|---|---|
| 0x0000 / 0x0002 / 0x0004 | tensione L1 / L2 / L3, V |
| 0x0006 / 0x0008 / 0x000A | corrente L1 / L2 / L3, A |
| 0x000C / 0x000E / 0x0010 | potenza attiva L1 / L2 / L3, W |
| 0x0034 | potenza attiva totale, W |
| 0x0046 | frequenza, Hz |
| 0x0048 / 0x004A | energia importata / esportata, kWh |
Ogni altro indirizzo in 0x0000–0x03FF legge 0; un inverter o un SCADA che ha bisogno di registri fuori dall'elenco sopra non li ottiene da questo profilo. Le fasi che il modulo non ha leggono 0.0 (STD-UI1 pubblica il proprio canale come L1; i suoi indirizzi L1 contengono tensione, corrente, potenza, frequenza, energia di importazione ed esportazione). I punti S, Q, PF ed energia totale leggono 0. I membri monofase pubblicano il proprio canale come L1. Questo profilo non ha alias di configurazione — la configurazione avviene tramite i registri holding nativi.
ID unità virtuali
Con CFG_VIRTUAL_IDS = 1 (salvato + riavvio; ha effetto all'avvio) un modulo con più di un canale di corrente risponde anche agli ID unità base+1 … base+N_CURRENT (limitato a 247): ogni ID è una vista float32 a canale singolo di sola lettura di un canale di corrente — la sua tensione, corrente, potenza, potenza totale = potenza di quel canale, frequenza; i punti energia leggono 0. Qualsiasi scrittura su un ID virtuale → eccezione 02. Scegliere l'ID unità base in modo che gli ID derivati non collidano con altri contatori sul bus.
(La tabella di configurazione METER_GROUP nella mappa è riservata — la composizione dei gruppi non è configurabile.)
Broadcast (id unità 0)
Su broadcast sono accettate solo queste scritture; tutto il resto viene rifiutato in silenzio (nessuna risposta di eccezione in broadcast, secondo lo standard Modbus):
-
impostazione dell'ora — due frame: FC16 a 0x8100–0x8101 (epoch, prima la parola alta), poi FC06
COMMAND0x8113 = 0x0006 — sincronizzazione dell'orologio su tutto il bus; -
LATCH_BANK/PERIOD_ARM0x8110–11 eCOMMAND0x03 — istantanea sincronizzata tra moduli (bit 8 delle capacità); -
staging dell'indirizzo tramite UID 0x8118–0x811E +
COMMAND0x16 — messa in servizio su un bus condiviso.
Un FC16 di broadcast deve restare entro i registri in lista bianca — un frame che tocca altro viene rifiutato per intero.
UNLOCK (comandi protetti)
I comandi che modificano lo stato del dispositivo devono essere preceduti dalla scrittura della chiave di sblocco 0xA5C3 nel holding 0x8112:
- La chiave è valida per 10 s e viene consumata da un solo comando protetto.
- Scrivere un valore errato annulla uno sblocco attivo.
- Un comando protetto senza uno sblocco valido → eccezione 03.
- La lettura di 0x8112 restituisce il flag di sblocco (0/1) com'è stato impostato — da considerare solo informativo.
- Sblocco e comando possono stare in un unico frame FC16 a 0x8112–0x8113 (prima la chiave, poi l'opcode).
Set protetto: 0x01 SAVE_CAL · 0x02 RESET · 0x07 ENERGY_RESET (ove implementato) · 0x10/0x12/0x13/0x14 (aggiornamento firmware) · 0x15 (assistenza). Non protetti: 0x04 SAVE_CONFIG · 0x06 SET_TIME · 0x08–0x0F · 0x11 scrittura pagina · 0x16 indirizzo per UID. Sui moduli che non implementano un opcode il rifiuto è l'eccezione 03, prima ancora che la protezione sia verificata. I comandi di energia di vita usano un meccanismo di chiave diverso, monouso (LT_KEY), non UNLOCK — vedere Comandi.
Regole di comportamento (contratto di famiglia)
-
I valori di
COMMAND,LATCH_BANK,PERIOD_ARMsuperiori a 0xFF → eccezione 03 (nessun troncamento silenzioso del byte basso). -
Una scrittura su
COMMANDmentre un comando è ancora in esecuzione → eccezione 06 (dispositivo occupato). -
Finestre a coppie di byte (sicurezza 0x8400+, payload firmware 0x8380+, record storico 0x8180+): il registro k contiene i byte 2k (alto) e 2k+1 (basso). Scritture che toccano byte di sola lettura → eccezione
-
La finestra di sicurezza è un flusso di byte little-endian — i campi numerici al suo interno si decodificano LE dai byte, non come registri big-endian.
-
Un'unica tabella di valori di configurazione validi serve entrambi i trasporti: un valore non valido su Modbus → eccezione 03; lo stesso valore su I²C viene rifiutato in SAVE_CONFIG con
ERROR0xFD — in entrambi i casi nulla viene reso persistente. -
I campi che la build non offre (canali assenti; grandezze THD e sfasamento con CAPABILITIES bit 2 = 0) restituiscono il valore sentinella nel profilo nativo (
0xFFFF/0x8000…); nel profilo float32 restituiscono 0.
Eccezioni
| Codice | Significato |
|---|---|
| 01 | funzione non valida (qualsiasi cosa tranne FC03/04/06/16) |
| 02 | indirizzo fuori dalla mappa · scrittura su un registro di ingresso, holding in sola lettura o ID unità virtuale · lettura di un registro solo scrittura |
| 03 | valore non valido (id unità / codice baud / valore di configurazione errato · codice operativo non valido · valore COMMAND/LATCH troppo grande · quantità fuori intervallo · comando protetto senza sblocco) |
| 04 | guasto interno del dispositivo |
| 06 | dispositivo occupato (comando o operazione firmware in corso) |
L'ultima eccezione è conservata per la diagnostica in LAST_EXCEPTION (FC<<24 | code<<16 | address), leggibile su entrambi i trasporti: I²C 0x0158, Modbus holding 0x830A–0B.