rbAmp
IT
Negozio
Docs
Aggiornato il

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_VOLTAGE non 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 di BOOT_COUNT (0x00CE).

Modifica dell'indirizzo I²C

Due percorsi:

Diretto (indirizzo noto):

  1. Scrivere il nuovo indirizzo a 7 bit (0x08..0x77) in CFG_I2C_ADDR (0x0073).
  2. COMMAND = 0x04 (SAVE_CONFIG) — validato; un indirizzo non valido viene rifiutato con ERROR 0xFD e nulla viene salvato. I salvataggi sono limitati nel tempo: una ripetizione entro ~5 s risponde 0xF9 — riprovare più tardi. Attendere BUSY = 0 e ERROR = 0 prima del passo successivo.

  3. COMMAND = 0x02 (RESET). L'indirizzo si applica al riavvio; il dispositivo si ri-enumera al nuovo indirizzo in ~1 s.

Sicurezza

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