Actualizaciones de firmware (OTA)

Hermetry entrega firmware por aire (OTA). Usted sube un paquete, lo asigna, y cada dispositivo lo descarga, lo verifica e instala por sí mismo, informando de su progreso a medida que avanza. Hermetry nunca firma el firmware: la firma se realiza en su pipeline de publicación, y Hermetry solo conserva sus claves públicas.

Abra Firmware en el menú IoT («Suba imágenes de firmware, asígnelas a los dispositivos y siga cada actualización.»).

Permisos

Acción	Rol predeterminado
Ver paquetes, asignaciones y estados de actualización de los dispositivos	Usuario
Subir, retirar, revocar y eliminar paquetes	Administrador
Asignar firmware, cambiar la configuración OTA, reintentar actualizaciones	Administrador
Registrar y revocar claves públicas de firma	Propietario

1. Active las actualizaciones para el perfil

Las actualizaciones están desactivadas en un perfil nuevo. Actívelas cuando sus dispositivos informen del progreso de la actualización. Abra la pestaña Firmware del perfil (Actualizaciones de firmware):

Ajuste	Predeterminado	Rango
Permitir actualizaciones de firmware para este perfil	Desactivado	—
Permitir imágenes sin firmar	Desactivado	«Solo para dispositivos de prueba.»
Permitir actualizaciones por LTE (datos móviles)	Desactivado	Un dispositivo puede tener su propio ajuste.
La descarga puede tardar (minutos)	60	5 a 1.440
La instalación puede tardar (minutos)	20	2 a 240
Intentos por actualización	3	1 a 10

La pestaña también muestra lo que está Asignado a este perfil y un botón Asignar firmware.

2. Registre una clave de firma

1. En Firmware, abra Claves de firma («Las claves públicas con las que se firma su firmware. Las imágenes subidas se comprueban con ellas. Las claves privadas nunca llegan aquí.»).
2. Seleccione Añadir clave, indique un Nombre, elija su Tipo y pegue la Clave pública.

Se admiten dos tipos de firma: un archivo de firma Ed25519 separado (.sig) generado para la imagen, donde pega el archivo de clave pública completo; y una firma dentro de la imagen generada por el esquema de arranque seguro (secure boot) del dispositivo, donde pega el resumen de la clave de 64 caracteres. Solo los propietarios pueden añadir o revocar claves.

3. Suba un paquete

Seleccione Subir firmware y complete:

Campo	Reglas
Tipo	Firmware o Software.
Nombre	Solo letras, dígitos y . _ + -. Debe coincidir con lo que espera el dispositivo (su título de firmware).
Versión	De 1 a 64 letras, dígitos o . _ + ~ -, por ejemplo 24.10.0-r1234. Cada par nombre y versión se usa una sola vez; el formulario muestra la versión más reciente hasta el momento.
Imagen de firmware	El archivo .bin o .img que se instala en el dispositivo.
Firmado con	El tipo de clave, o Sin firmar (solo los perfiles que permiten imágenes sin firmar pueden usarlo).
Archivo de firma (.sig)	Para firmas separadas. En las imágenes de arranque seguro la firma va dentro de la imagen.
Modelos de hardware	Opcional, separados por comas: solo los dispositivos que informen de uno de estos reciben la imagen.
Versión más baja desde la que puede actualizar	Opcional: se excluyen los dispositivos con una versión anterior.
Solo para dispositivos de este perfil	Déjelo en Cualquier perfil cuando la imagen sirva para todos los perfiles.
Notas de la versión	Opcional.

Su navegador calcula el SHA-256 del archivo mientras se sube («Compárelo con el que le dio su compilación.»). El servidor vuelve a comprobar el SHA-256, verifica la firma con sus claves registradas y analiza el archivo en busca de virus. El paquete está En comprobación hasta que el análisis sea limpio, y entonces pasa a Listo; un archivo que falla queda Rechazado y se elimina.

4. Asígnelo

En la página del paquete seleccione Asignar, o use la pestaña Firmware de un perfil o de un dispositivo. En Enviar a elija:

Opción	Abarca
Todos los dispositivos de un perfil	«Los dispositivos añadidos al perfil más adelante también la recibirán.»
Algunos dispositivos	«Una lista fija: los dispositivos añadidos después no están incluidos.»
Un dispositivo	Ese dispositivo.

Gana la asignación más específica: una asignación a dispositivo prevalece sobre una lista de dispositivos, y una lista sobre un perfil. Seleccione Comprobar para ver Qué ocurre: cuántos dispositivos abarca, cuántos ya ejecutan esta versión, cuántos están sin conexión (se actualizan al conectarse) y cuáles no la recibirán, con el motivo (otro modelo de hardware, actualizaciones desactivadas para su perfil, destinado a otro perfil, sin firmar no permitido, versión actual demasiado antigua o aún no conocida). Después seleccione Asignar y confirme.

Para un perfil o una lista de dispositivos puede activar Enviar por oleadas. Consulte Despliegue de firmware por oleadas.

Lo que recibe el dispositivo

Hermetry escribe estos atributos compartidos en un solo mensaje:

Clave	Ejemplo
fw_title	boiler-fw
fw_version	26.11.0
fw_size	14680064
fw_checksum	hexadecimal en minúsculas
fw_checksum_algorithm	SHA256
fw_url	una dirección HTTPS de descarga de corta duración
fw_sig	la firma separada, cuando la hay
fw_allow_metered	si el dispositivo puede descargar a través de un enlace medido

• fw_url es válida durante 15 minutos y se genera de nuevo en cada envío y en cada solicitud de atributos. Si ha caducado, el dispositivo vuelve a pedir fw_url y reanuda con una solicitud HTTP Range.
• El firmware nunca se ofrece por MQTT sin cifrar.
• Eliminar una asignación borra las claves.

Lo que informa el dispositivo

Atributo de cliente	Valores
fw_state	DOWNLOADING, DOWNLOADED, VERIFIED, UPDATING, UPDATED, FAILED
fw_error	un código de error, solo con FAILED
fw_progress	0 a 100, durante DOWNLOADING
fw_wait	metered, quota_exhausted o approval mientras el dispositivo retiene la actualización
current_fw_title, current_fw_version	lo que se ejecuta ahora; enviar tras cada conexión

El dispositivo debe rechazar una imagen cuya firma no se verifique, aunque la suma de comprobación coincida. Tras el reinicio informa de current_fw_version; UPDATED sin la nueva versión en ejecución no se acepta por sí solo. Si vuelve la versión antigua, Hermetry marca la actualización como revertida.

Estados de la actualización

Estado	Significado
En cola	Asignada; se envía cuando el dispositivo está en línea.
Enviada al dispositivo	Se le indicó al dispositivo y debe empezar a descargar.
Descargando, Descargada, Comprobada, Instalando	Progreso que informa el dispositivo.
Actualizado	El dispositivo ejecuta la nueva versión.
En espera	El dispositivo retiene la actualización: en un enlace medido, sin datos móviles, o esperando aprobación en el propio dispositivo. No es un error.
Fallida	El dispositivo no pudo terminar.
Sin respuesta a tiempo	El dispositivo dejó de responder durante el tiempo de descarga o de instalación.
Revertida a la versión anterior	La nueva versión no arrancó correctamente.
No apta para este dispositivo	El paquete no le corresponde.
Cancelada	Detenida antes de instalarse.

Siga las actualizaciones

• La página del paquete muestra Dónde está asignado, sus Dispositivos con Estado, Progreso, Intentos y Problema, y Reintentar para los dispositivos fallidos, sin respuesta a tiempo o revertidos.
• La pestaña Firmware del dispositivo muestra lo que Ejecuta, su Actualización, su Historial, y Actualizaciones por LTE para este dispositivo (Igual que su perfil, Permitida para este dispositivo, No permitida para este dispositivo).
• Eventos de webhook: ota.update.initiated, ota.update.succeeded, ota.update.failed y, para despliegues, ota.rollout.*.

Retirar, revocar, eliminar

Acción	Efecto
Retirar	«Permanece en el registro y las actualizaciones actuales continúan, pero ya no se ofrece para nuevas asignaciones.»
Revocar	«Úselo cuando la imagen no deba instalarse. Las actualizaciones que aún no han empezado a instalarse se detienen. Los dispositivos que ya la instalaron la conservan.»
Eliminar	Elimina el archivo y sus detalles. Se rechaza mientras esté asignado o tenga historial de actualizaciones: retírelo en su lugar.

Relacionado

• Despliegue de firmware por oleadas
• API de firmware y de ajustes de dispositivo
• Las actualizaciones de firmware no terminan