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
-
Selezionare. Leggere
FW_ACTIVE_BANK→ scegliere il file di rilascio per l'altro banco. VerificareBOARD_IDrispetto al file; facoltativamente verificareOTA_KEYID. -
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. -
BLOCK_WR (0x11) per pagina, in ordine crescente. Per ogni pagina da 256 B non vuota k del file:
OTA_IDX= k → 256 B inOTA_PAYLOAD→ (facoltativo)OTA_PCRC_EXP= CRC-32 della pagina → comando 0x11 → interrogare BUSY fino a 0 (attendere fino a ~0.5 s). -
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. -
Dopo ogni verifica di pagina
OTA_STATUSè ancora 1.ERROR0xFC = il payload è arrivato corrotto → riscrivere il payload e ripetere la pagina (un reinvio identico di una pagina già scritta è accettato).OTA_STATUS3 = la sessione è fallita (leggereOTA_DIAG; dati diversi per una pagina già scritta sono una causa) — le scritture successive vengono ignorate; ricominciare da BEGIN. -
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.
-
Su I²C attendersi clock stretching fino a ~9 ms e tollerare NACK durante la finestra di scrittura (trasporto I²C). Modbus non è interessato.
-
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:
-
OTA_STATUS2 — 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). -
3 — rifiutato;
OTA_DIAGindica il motivo (sotto). - 4 — versione più vecchia di quella in esecuzione; nulla è cambiato.
- ACTIVATE (0x13) quando l'installazione è pronta per un riavvio — verificare prima
OTA_STATUS= 2 (non armato → il comando non fa nulla,ERRORresta 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_BANKcambiato,FW_VER= nuova versione,SWAP_PENDINGda 2 a 0; se è in esecuzione ancora il vecchioFW_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.