Qué pasa si la actualización de firmware se detiene a medio camino

  • Probado con el firmware v1.1.6
  • Primeros pasos

Redactado para el firmware v1.1.6.. La versión actual es v1.2.1, así que algunos detalles pueden ser distintos.

Una actualización por aire de una caja en su cuadro eléctrico suena como algo que puede salir mal. Así que primero el mecanismo, porque es la respuesta al miedo:

El nuevo firmware se escribe en una partición libre mientras el hub sigue funcionando con el anterior. El cambio ocurre solo cuando el archivo completo ha llegado y ha pasado sus comprobaciones. Si se corta la corriente o se pierde el Wi-Fi a mitad de camino, el firmware en funcionamiento no se toca: el hub vuelve con la versión que ya tenía, y usted vuelve a instalar. En nuestro banco de pruebas, una subida cortada en 377 KB de 1650 KB hizo exactamente eso, y el registro del hub lo dijo con todas las letras: running image intact.

Y si el nuevo firmware se escribe pero no arranca, el hub vuelve solo al anterior. Dos particiones, y una de ellas siempre es la que se sabe que funciona.

Hay un minuto en el proceso en el que una persona puede deshacerlo, y es la única parte de esta página que vale la pena memorizar.

Primero: una copia de restauración nueva

El firmware y sus ajustes son cosas distintas. Una actualización conserva sus ajustes; una copia de restauración es un seguro contra todo lo demás, y se hace con una sola pulsación.

Settings → Restore point → Save restore point. Contiene seis archivos —ajustes, hardware, puntos, tarifas, hora y módulos— tal como están en ese momento. Solo hay una copia de restauración en el hub: un guardado nuevo sustituye al anterior. Restore and restart la recupera, y el hub vuelve en 20–30 segundos.

Dos cosas que no contiene, y ambas importan si cuenta con ella:

  • No su historial. Restaurar escribe solo esos seis archivos de ajustes; los registros de medición y los totales de por vida no se tocan. (Medido: 71 registros horarios byte a byte idénticos antes y después de una restauración.)
  • No sus accesos. El token de API, la red Wi-Fi y su contraseña, la contraseña del punto de acceso, los orígenes de acceso desde el navegador (CORS) y la dirección del broker MQTT quedan fuera de la copia: ni se guardan ni se revierten.

Guárdela justo antes de actualizar, no semanas antes. Restaura el hub tal como estaba cuando se guardó, así que una copia antigua trae de vuelta una disposición antigua: los puntos que ha cambiado desde entonces, la tarifa que ya corrigió.

Una copia de restauración guardada en v1.1.5 se restauró sin problemas en un hub actualizado a v1.1.6 — medido, los seis archivos, sin errores. No hay comprobación de versión; el hub no rechaza una copia más antigua. Otras combinaciones de versiones no se han probado, y esa es la razón real para guardar una nueva en lugar de fiarse de una antigua.

El archivo

De la versión, necesita main_release.bin y nada más. Los otros tres archivos de la versión son para una grabación nueva por USB y no sirven aquí.

La app web no está en ese archivo. Se distribuye como un kit propio, rbgrid-ui_<version>.zip, que se instala después — véase el final de esta página. Dos archivos, dos pasos; mantenerlos separados es la confusión más habitual sobre qué acaba de actualizar.

Lo que verá realmente

Settings → Hub firmware. El panel se abre con lo que tiene ahora:

Now: version 1.1.5 · build Nov 6 2026 16:38:17 · image 3ecbbfde

Elija el archivo, y le dice lo que contiene antes de enviar nada: tamaño, versión, compilación y el framework con el que se compiló. Las comprobaciones también se hacen aquí: se rechaza un archivo que no es una imagen de firmware, uno sin descripción, y también el firmware de otro dispositivo («This is another device's firmware, not the hub's»). Si elige la compilación que ya tiene, responde "This build is already installed. No need to update." — Install sigue disponible, y reinstalar funciona.

Pulse Install y confirme. El diálogo merece una lectura, porque describe toda la secuencia:

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.

Después, el panel narra el proceso, y nada ocurre en silencio:

  1. Sending the file… 6 % … 100 % — unos 30 segundos en nuestro banco de pruebas, por Wi-Fi.
  2. The hub wrote the firmware and is restarting…
  3. The hub is back. Waiting for the new firmware to confirm (about a minute)…
  4. Done: the hub runs the new firmware — version 1.1.6, build Nov 6 2026 21:28:48.

De principio a fin, unos 1 minuto 40 segundos en el banco de pruebas, muy por debajo de los tres minutos que la app espera antes de rendirse. Su propio tiempo depende de su Wi-Fi; tome el nuestro como forma, no como cifra. La cabecera muestra entonces la nueva versión, y la actualización está hecha.

El minuto que importa

Entre el paso 3 y el 4 el nuevo firmware está instalado pero todavía no confirmado. Un reinicio en esa ventana —a mano o por un corte de corriente— devuelve el hub al firmware que tenía antes. Todo parecerá como si la actualización simplemente no hubiera ocurrido.

Así que: no apague el hub ni lo reinicie hasta que el panel diga Done. Es lo único que esta página existe para decirle.

Casi no verá la negativa del propio hub en esa ventana, y conviene saber por qué: Done aparece solo después de la confirmación, así que, cuando el panel le ofrece algo, el minuto ya ha pasado. Aparece si una segunda pestaña del navegador, otro dispositivo o un script intenta instalar mientras la primera sigue esperando:

Failed: The hub is still confirming the firmware installed less than a minute ago. Try again in about a minute.

No pasa nada si ve eso. Espere un minuto e instale de nuevo. (El mensaje en sí corresponde al firmware v1.1.6 con su app correspondiente; en v1.1.5 y anteriores, la misma situación fallaba con un error genérico.)

Cuando no prospera

  • El nuevo firmware no arrancó. El hub vuelve al anterior por su cuenta y la app se lo indica: "The new firmware didn't start — the hub went back to the previous one. Details in 'Events → Hub log'." El registro del hub está en la pestaña Log. → Events
  • El hub no volvió en tres minutos. La app deja de esperar y lo dice. Compruebe que el hub tiene corriente y está en su red; después recargue la app y mire la versión en la cabecera del panel: le indicará qué firmware tiene.
  • Se cortó la corriente o la conexión durante la subida. El hub se queda con el firmware que tenía. Vuelva a instalar.

En cada caso, la copia de restauración es la segunda red de seguridad, y es para sus ajustes, no para el firmware, que tiene la suya propia.

Volver a una versión anterior

Puede hacerlo. El hub no lo bloquea: instalar un main_release.bin más antiguo funciona igual que uno más nuevo, y se midió al pasar de v1.1.6 a v1.1.5.

Lo que obtiene es el comportamiento de esa versión, con sus fallos incluidos. Un hub anterior a v1.1.6, por ejemplo, puede borrar sus servidores NTP al guardar la zona horaria, algo que v1.1.6 corrigió.

⚠️ Y una regla que no es opcional: si su entrada trifásica se mide con un punto por fase, vuelva a un solo punto antes de instalar nada anterior a v1.1.5. El firmware antiguo solo maneja un punto de suministro. → Su suministro trifásico se mide en una sola fase

Lo que conserva una actualización

Wi-Fi, ajustes, puntos, tarifa, tokens, historial y la app web instalada se conservan todos. Los módulos siguen contando mientras ocurre: la actualización es asunto del hub, no de los medidores.

Después, instale el rbgrid-ui_<version>.zip que corresponde a la versión, para que la app que abre sea la compilada para el firmware que ahora tiene. Varios de los cambios de una versión están en la app y no en el firmware, y hasta que instale el kit verá la app antigua sobre el hub nuevo.

Y una última cosa, porque es la pregunta detrás de la pregunta: el hub no descarga firmware por sí mismo. No hay descarga en segundo plano, ni aviso de «actualización disponible», ni nada que se aplique durante la noche. Se actualiza solo cuando una persona elige un archivo y pulsa Install, y en ningún otro caso.

Siguientes pasos