rbAmp
IT
Negozio
Docs
Aggiornato il

Aggiornamento firmware (protocollo lato host)

Gli aggiornamenti firmware passano sul bus di lavoro — I²C o Modbus RTU — senza programmatore e senza rimozione (OTA). La versione firmware è mostrata come major.minor di FW_VER (0x0114), ad esempio firmware STD 1.126. Il dispositivo mantiene due banchi firmware; l'host scrive la nuova immagine nel banco inattivo, il dispositivo la verifica e la arma, e un'attivazione separata riavvia in essa. Un'immagine nuova difettosa o che si blocca torna automaticamente alla precedente funzionante.

La misura continua durante l'aggiornamento. L'aggiornamento cede il passo alla misura (al massimo una scrittura di pagina ogni ~250 ms); i pochi frame di misura persi a ogni scrittura flash sono compensati nei contatori di energia.

File di rilascio

Un rilascio fornisce immagini di banco preparate — firmate e cifrate sulla macchina di build. L'host di trasporto invia il file così com'è; non costruisce, non modifica né reincapsula mai un'immagine:

  • Due file per rilascio, uno per banco (A / B). Leggere FW_ACTIVE_BANK (0x0156): 0 = A in esecuzione → inviare il file B, e viceversa.

  • Confrontare prima l'id scheda del rilascio con BOARD_ID (0x017C) — un'immagine costruita per un'altra scheda viene respinta in verifica (motivo 15).

  • Una versione strettamente inferiore a quella in esecuzione viene rifiutata (anti-downgrade, stato 4); la stessa versione viene accettata. Tornare a una versione più vecchia è possibile solo tramite il percorso di rollback del dispositivo, non inviando un'immagine vecchia.

Registri

I²C (holding Modbus tra parentesi; u32 = 2 registri, parola alta per prima):

Reg Ind. Significato
OTA_STATUS 0x0140 (0x8300) 0 inattivo · 1 pronto / sessione aperta · 2 armato · 3 errore · 4 downgrade rifiutato
OTA_IDX 0x0144 (0x8302–03, rw) indice di pagina da 256 B per la scrittura della pagina successiva
OTA_ACTIVE 0x0148 (0x8306–07) base del banco in esecuzione (opaca)
OTA_BANK_SIZE 0x014C (0x8304–05) dimensione del banco — riportata dal dispositivo; indice della pagina di intestazione = dimensione/256 − 1
FW_STAGED_VERSION 0x0150 (0x8308–09) versione dell'immagine armata (0 = nessuna)
FW_ACTIVE_BANK 0x0156 (0x8301) 0 = A · 1 = B
OTA_PCRC_EXP 0x0170 (0x8310–11, w) CRC-32 atteso facoltativo della pagina successiva
OTA_PCRC_RX 0x0174 (0x8312–13) CRC-32 della pagina come ricevuta
OTA_KEYID 0x0178 (0x8319–1A) id chiave dell'immagine accettata da questo firmware
OTA_DIAG 0x0180 (0x8314: motivo | stato<<8) diagnostica dei guasti
OTA_PAYLOAD 0x0500, 256 B (0x8380–0x83FF coppie di byte) buffer di pagina
FW_VER / SWAP_PENDING 0x0114 / 0x011C (0x8315–16 / 0x8317–18) versione in esecuzione / stato di scambio 0 confermato · 1 armato · 2 di prova

Comandi (COMMAND 0x0060 / holding 0x8113): 0x10 BEGIN · 0x11 BLOCK_WR · 0x12 COMMIT · 0x13 ACTIVATE · 0x14 FW_ABORT. Su Modbus BEGIN/COMMIT/ACTIVATE/FW_ABORT sono subordinati a UNLOCK; BLOCK_WR no. Dopo ogni comando interrogare CMD_STATE (0x006A / 0x8116) fino a BUSY = 0, poi leggere OTA_STATUS / ERROR.

Sequenza

  1. Selezionare. Leggere FW_ACTIVE_BANK → scegliere il file di rilascio per l'altro banco. Verificare BOARD_ID rispetto al file; facoltativamente verificare OTA_KEYID.

  2. BEGIN (0x10). Apre la sessione; OTA_STATUS = 1 immediatamente. Non si cancella nulla in anticipo — i settori flash vengono cancellati quando arriva la loro prima pagina, quindi bus e misura continuano a funzionare. Un BEGIN mentre un'immagine è armata la disarma prima.

  3. BLOCK_WR (0x11) per pagina, in ordine crescente. Per ogni pagina da 256 B non vuota k del file: OTA_IDX = k → 256 B in OTA_PAYLOAD → (facoltativo) OTA_PCRC_EXP = CRC-32 della pagina → comando 0x11 → interrogare BUSY fino a 0 (attendere fino a ~0.5 s).

  4. Inviare le pagine in ordine crescente; la pagina 0 deve essere la prima della sessione (altrimenti COMMIT rifiuta con motivo 13); saltare le pagine composte interamente da 0xFF. La pagina di intestazione (OTA_BANK_SIZE/256 − 1) non deve essere l'ultima — l'ordine crescente la invia naturalmente per ultima.

  5. Dopo ogni verifica di pagina OTA_STATUS è ancora 1. ERROR 0xFC = il payload è arrivato corrotto → riscrivere il payload e ripetere la pagina (un reinvio identico di una pagina già scritta è accettato). OTA_STATUS 3 = la sessione è fallita (leggere OTA_DIAG; dati diversi per una pagina già scritta sono una causa) — le scritture successive vengono ignorate; ricominciare da BEGIN.

  6. Limitazione: il dispositivo programma al massimo una pagina ogni ~250 ms (il comando resta semplicemente BUSY fino al suo turno) — la misura ha la precedenza. Un'immagine completa richiede ~1–3 minuti.

  7. Su I²C attendersi clock stretching fino a ~9 ms e tollerare NACK durante la finestra di scrittura (trasporto I²C). Modbus non è interessato.

  8. COMMIT (0x12). Interrogare BUSY con un timeout di ≥ 3 s: il dispositivo cancella i settori non toccati da alcuna pagina, poi verifica l'immagine — integrità, autenticità, versione, id scheda. Risultato:

  9. OTA_STATUS 2 — verificato e armato; FW_STAGED_VERSION = nuova versione. Il modulo esegue ancora l'immagine precedente. Una caduta di alimentazione dopo COMMIT avvia l'immagine armata (sicuro: è quella prevista).

  10. 3 — rifiutato; OTA_DIAG indica il motivo (sotto).

  11. 4 — versione più vecchia di quella in esecuzione; nulla è cambiato.
  12. ACTIVATE (0x13) quando l'installazione è pronta per un riavvio — verificare prima OTA_STATUS = 2 (non armato → il comando non fa nulla, ERROR resta 0). L'energia viene scaricata, il modulo si reimposta e ricompare in ~4 s (su Modbus la risposta ad ACTIVATE può mancare o essere troncata). La nuova immagine parte in prova sotto un watchdog hardware e si conferma da sola dopo ~8 s di misura sana. Qualsiasi reset prima della conferma torna indietro — non resettare il modulo per ~10 s dopo l'attivazione. Verificare dopo: FW_ACTIVE_BANK cambiato, FW_VER = nuova versione, SWAP_PENDING da 2 a 0; se è in esecuzione ancora il vecchio FW_VER, è tornato indietro. FW_ABORT (0x14) invece di ACTIVATE scarta l'immagine armata e chiude la sessione.

Diagnostica dei guasti (OTA_DIAG 0x0180)

Byte 0 = motivo · byte 1 = stato interno · poi offset, pagina/lunghezza e valori di controllo.

Motivo Significato Motivo Significato
1 indice di pagina fuori intervallo 9 verifica di integrità dell'immagine non riuscita
2/3 cancellazione non riuscita / verifica della cancellazione non riuscita 10 autenticazione non riuscita
4 dati diversi per una pagina già scritta (sessione fallita — ripartire da BEGIN) 11 downgrade di versione
5/6 programmazione non riuscita / verifica non riuscita 12 errore del record di scambio
7 intestazione immagine non valida 13 immagine non sigillata / incompleta (per esempio la pagina 0 o la pagina di intestazione non sono arrivate)
8 la pagina di intestazione non è mai arrivata 14 firma non valida
15 immagine costruita per un'altra scheda (valore di controllo = parola di scheda dell'immagine)

Tutti gli errori di autenticazione risultano come OTA_STATUS 3 con il motivo qui indicato: non esistono altri valori di stato da gestire. Su Modbus vengono riflessi solo il motivo e lo stato interno (holding 0x8314); i dettagli di offset/pagina/controllo di OTA_DIAG sono leggibili su I²C.

Proprietà di sicurezza (su cui l'host può contare)

  • In due fasi: COMMIT non riavvia mai; il momento del riavvio spetta all'host (finestra di manutenzione).
  • Una perdita di alimentazione in qualsiasi momento è sicura: prima di COMMIT gira l'immagine vecchia; dopo COMMIT l'immagine armata è quella voluta; una prova fallita torna indietro.

  • Taratura, configurazione, contatori di energia, storia, registro eventi e identità del dispositivo sono conservati al di fuori dei banchi firmware — un aggiornamento non li tocca mai.

  • Un commit del firmware viene registrato nel registro eventi con la transizione di versione.