Trasporto I²C
Il modulo è uno slave I²C con la mappa completa dei registri. Indirizzo predefinito a 7 bit 0x50 (configurabile, vedere sotto). Velocità di bus consigliata 50 kHz su host ESP32 ed ESP8266 e 100 kHz su altri host (non 400 kHz); lo slave supporta il clock stretching e un master deve tollerarlo (vedere i limiti sotto).
Il trasporto attivo (I²C o Modbus RTU) viene selezionato una volta per avvio dal commutatore della modalità di interfaccia — vedere Interfaccia hardware. Con l'impostazione I²C lo spazio di registri Modbus non viene servito, e viceversa; comandi e dati sono gli stessi su entrambi.
Puntatore di registro
- Puntatore di registro a 16 bit, big-endian sul filo (prima il byte alto), con auto-incremento.
-
Scrittura: il master invia 2 byte di puntatore (alto, basso), poi un flusso di dati; ogni byte di dati finisce al puntatore, che si incrementa dopo.
-
Lettura: il master scrive i 2 byte del puntatore, poi invia un repeated start e legge; i byte fluiscono dal puntatore con autoincremento.
-
I campi multibyte sono little-endian e indirizzati per byte — nessun requisito di allineamento sul bus; un master può leggere ogni campo come N byte little-endian a partire dal proprio indirizzo, in una o più transazioni.
-
Indirizzi non mappati: le letture restituiscono
0xFF, le scritture vengono ignorate. Gli indirizzi dei blocchi canale con indice ≥N_CURRENT/N_VOLTAGEnon sono specificati — condizionare sui conteggi, non interpretarli.
Non esiste una sonda a livello di bus per l'indirizzamento a 8 o 16 bit (un dispositivo a 8 bit leggerebbe il secondo byte del puntatore come dato). Un master conosce la convenzione per linea di prodotto; la firma STD dopo una lettura a 16 bit di 0x0000 è 'S','T' + VERSION ≥ 0x30 + bit 9 di CAPABILITIES.
Tempistica e robustezza
-
Prontezza dopo il reset: l'interfaccia dei registri è operativa entro pochi millisecondi dal reset, prima del percorso di misura — il modulo risponde sul bus anche mentre il percorso del sensore sta ancora avviandosi. Dopo un riavvio per attivazione del firmware attendere ~4 s prima che il dispositivo ricompaia.
-
Clock stretching: di norma trascurabile; durante le operazioni di flash dell'aggiornamento firmware lo slave può trattenere SCL fino a ≈9 ms. Impostare il timeout SCL del master a ≥10 ms, altrimenti i tentativi verranno registrati durante l'OTA (i dati non sono corrotti — la transazione semplicemente attende).
-
Durante le scritture flash attivate dai comandi (salvataggio di configurazione/calibrazione, programmazione di pagine OTA) lo slave può anche non riconoscere brevemente (NACK). Riprovare fino allo scadere del tempo di assestamento del comando anziché interrompere al primo NACK (vedere Comandi per i tempi di assestamento).
-
Coerenza: ogni transazione di lettura è servita da un'istantanea coerente di 128 byte presa quando viene impostato l'indirizzo del registro — i campi letti in una transazione fino a 128 byte provengono da un'unica pubblicazione e non possono spezzarsi (così si leggono i campi energia i64 e interi blocchi). I campi letti in transazioni separate possono provenire da finestre diverse. Per rilevare un riavvio del modulo tra due letture, controllare la monotonia di
FRAME_CNT(0x0020) e diBOOT_COUNT(0x00CE).
Modifica dell'indirizzo I²C
Due percorsi:
Diretto (indirizzo noto):
- Scrivere il nuovo indirizzo a 7 bit (0x08..0x77) in
CFG_I2C_ADDR(0x0073). -
COMMAND= 0x04 (SAVE_CONFIG) — validato; un indirizzo non valido viene rifiutato conERROR0xFD e nulla viene salvato. I salvataggi sono limitati nel tempo: una ripetizione entro ~5 s risponde 0xF9 — riprovare più tardi. Attendere BUSY = 0 eERROR= 0 prima del passo successivo. -
COMMAND= 0x02 (RESET). L'indirizzo si applica al riavvio; il dispositivo si ri-enumera al nuovo indirizzo in ~1 s.
⚠ Dopo il reset ogni master sul bus deve passare al nuovo indirizzo; pianificare questa operazione come intervento di installazione, non come routine.
Per UID (più moduli su un unico indirizzo predefinito): scrivere l'UID a 12 byte del modulo di destinazione in ADDR_UID (0x00E0), il nuovo indirizzo I²C in ADDR_UID_I2C (0x00EC, 0 = mantieni) e/o il nuovo id unità Modbus in ADDR_UID_UNIT (0x00ED, 0 = mantieni), poi COMMAND = 0x16 (ADDR_BY_UID). Solo il modulo il cui UID corrisponde rende persistente la modifica — insieme a eventuali altri valori CFG_ in sospeso, come un SAVE_CONFIG — e si riavvia; tutti gli altri moduli ignorano il comando (ERROR 0xFC lì). Accettato anche su un broadcast Modbus — vedere Trasporto Modbus. Entrambi i campi del nuovo indirizzo a zero → 0xFD; indirizzo non valido → 0xFD; limite di salvataggio → 0xF9. Passo per passo: Sequenze D4.