Un aggiornamento over the air di un dispositivo nel quadro elettrico può sembrare un'operazione che potrebbe andare male. Quindi prima il meccanismo, perché è la risposta a questo timore:
Il nuovo firmware viene scritto in uno slot di riserva mentre l'hub continua a funzionare su quello attuale. Il passaggio avviene solo dopo che l'intero file è arrivato e ha superato i controlli. Se a metà manca la corrente o cade il Wi-Fi, il firmware in esecuzione non viene toccato: l'hub torna alla versione che aveva già, e Lei installa di nuovo. Sul nostro banco un caricamento interrotto a 377 KB su 1650 KB ha fatto esattamente questo, e il registro dell'hub lo ha detto chiaramente: running image intact.
E se il nuovo firmware viene scritto ma non si avvia, l'hub torna da solo a quello precedente. Due slot, e uno dei due è sempre quello di cui si sa che funziona.
C'è un solo momento del processo in cui una persona può annullare l'operazione, ed è l'unica parte di questa pagina che vale la pena memorizzare.
Prima di tutto: un punto di ripristino recente
Firmware e impostazioni sono cose separate. L'aggiornamento conserva le Sue impostazioni; un punto di ripristino è un'assicurazione contro tutto il resto, e richiede una sola pressione.
Settings → Restore point → Save restore point. Contiene sei file — impostazioni, hardware, punti, tariffe, ora e moduli — così come sono in quel momento. Sull'hub c'è un solo punto di ripristino: un nuovo salvataggio sostituisce il precedente. Restore and restart lo riporta in funzione, e l'hub torna attivo in 20–30 secondi.
Due cose che non contiene, e che contano se ci si affida ad esso:
- Non la cronologia. Il ripristino scrive solo quei sei file di impostazioni; i record di misura e i totali di vita restano invariati. (Misurato: 71 record orari identici byte per byte prima e dopo un ripristino.)
- Non gli accessi. Il token API, la rete Wi-Fi e la sua password, la password del punto di accesso, le origini di accesso dal browser (CORS) e l'indirizzo del broker MQTT restano fuori dal punto di ripristino — non vengono né salvati né riportati indietro.
Lo salvi subito prima di aggiornare, non settimane prima. Il punto riporta l'hub com'era al momento del salvataggio, quindi uno vecchio riporta un assetto vecchio: i punti che nel frattempo ha cambiato, la tariffa che nel frattempo ha corretto.
Un punto di ripristino salvato sulla v1.1.5 è stato ripristinato correttamente su un hub aggiornato alla v1.1.6 — misurato, tutti e sei i file, nessuna segnalazione. Non c'è alcun controllo di versione; l'hub non rifiuta un punto più vecchio. Altre coppie di versioni non sono state testate, ed è il vero motivo per salvarne uno nuovo invece di fidarsi di uno vecchio.
Il file
Dalla release Le serve main_release.bin e nient'altro. Gli altri tre file della release servono per un flash USB da zero e qui non vanno bene.
L'app web non è in quel file. È distribuita come kit separato, rbgrid-ui_<version>.zip, da installare dopo — vedi la fine di questa pagina. Due file, due passaggi, e tenerli distinti è l'errore più comune quando si confonde che cosa si è aggiornato.
Che cosa vedrà
Settings → Hub firmware. Il pannello si apre con ciò che ha adesso:
Now: version 1.1.5 · build Nov 6 2026 16:38:17 · image 3ecbbfde
Scelga il file, e prima che venga inviato qualsiasi dato l'app Le dice che cosa contiene — dimensione, versione, build e il framework con cui è stato compilato. Anche i controlli vengono eseguiti qui: un file che non è un'immagine firmware viene rifiutato, così come uno senza descrizione, e così il firmware destinato a un altro dispositivo ("This is another device's firmware, not the hub's"). Se sceglie la build che è già installata, l'app risponde "This build is already installed. No need to update." — Install resta disponibile, e reinstallare funziona.
Prema Install e confermi. Vale la pena leggere una volta la finestra di conferma, perché descrive l'intera sequenza:
Update the hub firmware? The hub takes the file, restarts (offline for about half a minute) and confirms the new firmware a minute after it starts. Don't power the hub off until it's done.
Poi il pannello racconta ogni passaggio, e nulla avviene in silenzio:
- Sending the file… 6 % … 100 % — circa 30 secondi sul nostro banco via Wi-Fi.
- The hub wrote the firmware and is restarting…
- The hub is back. Waiting for the new firmware to confirm (about a minute)…
- Done: the hub runs the new firmware — version 1.1.6, build Nov 6 2026 21:28:48.
Dall'inizio alla fine, circa 1 minuto e 40 secondi sul banco — ben dentro i tre minuti dopo i quali l'app smette di aspettare. Il Suo tempo dipende dal Wi-Fi; consideri il nostro come una forma, non come una cifra. L'intestazione mostra poi la nuova versione, e l'aggiornamento è concluso.
Il minuto che conta
Tra il passo 3 e il passo 4 il nuovo firmware è installato ma non ancora confermato. Un riavvio in quella finestra — manuale o staccando la corrente — riporta l'hub al firmware che aveva prima. Tutto avrà l'aspetto di un aggiornamento mai avvenuto.
Quindi: non tolga l'alimentazione all'hub e non lo riavvii finché il pannello non dice Done. È l'unica cosa per cui esiste questa pagina.
È improbabile che incontri il rifiuto dell'hub in quella finestra, e vale la pena sapere perché: Done compare solo dopo la conferma, quindi quando il pannello Le offre qualcosa il minuto è già passato. Il rifiuto compare se una seconda scheda del browser, un altro dispositivo o uno script prova a installare mentre la prima sta ancora aspettando:
Failed: The hub is still confirming the firmware installed less than a minute ago. Try again in about a minute.
Non c'è nulla di sbagliato se lo vede. Attenda un minuto e installi di nuovo. (Il messaggio stesso è del firmware v1.1.6 con la sua app corrispondente; sulla v1.1.5 e precedenti la stessa situazione dava un errore generico.)
Quando non va a buon fine
- Il nuovo firmware non si è avviato. L'hub torna da solo a quello precedente e l'app lo segnala: "The new firmware didn't start — the hub went back to the previous one. Details in 'Events → Hub log'." Il registro dell'hub si trova nella scheda Log. → Events
- L'hub non è tornato entro tre minuti. L'app smette di aspettare e lo dice. Verifichi che l'hub sia alimentato e collegato alla rete, poi ricarichi l'app e guardi la versione nell'intestazione del pannello: indicherà quale firmware è in esecuzione.
- Alimentazione o connessione sono caduti durante il caricamento. L'hub resta sul firmware che aveva. Installi di nuovo.
In ogni caso il punto di ripristino è la seconda rete di sicurezza, ed è per le Sue impostazioni — non per il firmware, che ha la sua.
Tornare a una release precedente
Si può. L'hub non lo blocca: installare un main_release.bin più vecchio funziona come per uno più recente, ed è stato misurato il passaggio dalla v1.1.6 alla v1.1.5.
Ciò che si ottiene è il comportamento di quella release, bug compresi — un hub sotto la v1.1.6, per esempio, può cancellare i suoi server NTP quando si salva il fuso orario, cosa che la v1.1.6 ha corretto.
⚠️ E una regola che non è facoltativa: se il Suo ingresso trifase è misurato con un punto per fase, lo riporti a un solo punto prima di installare qualsiasi cosa più vecchia della v1.1.5. Il firmware più vecchio gestisce un solo punto di alimentazione. → L'alimentazione trifase è misurata su una sola fase
Che cosa conserva un aggiornamento
Wi-Fi, impostazioni, punti, tariffa, token, cronologia e l'app web installata vengono tutti conservati. I moduli continuano a contare durante l'operazione — l'aggiornamento riguarda l'hub, non i contatori.
Dopo, installi il file rbgrid-ui_<version>.zip della release corrispondente, così l'app che apre è quella costruita per il firmware che ora gira. Diverse modifiche di una release riguardano l'app più che il firmware, e finché non installa il kit vedrà la vecchia app sul nuovo hub.
Un'ultima cosa, perché è la domanda dietro la domanda: l'hub non scarica il firmware da solo. Non c'è alcun download in background, nessun avviso "aggiornamento disponibile" e nulla che si applica di notte. Si aggiorna solo quando una persona sceglie un file e preme Install, e mai altrimenti.
Avanti
- Settings: Hub firmware · Restore point
- Che cosa ha cambiato l'ultima release: RBgrid v1.1.6
- L'aggiornamento del firmware di un modulo è un'operazione diversa, dalla scheda del modulo stesso: Sensors and modules
- Domande → Supporto