Esta página ayuda cuando una actualización de firmware no llega a un dispositivo, no termina o cuando una implantación por oleadas se detiene. Empiece en la página del paquete (Firmware > el paquete): su lista de Devices muestra el State, el Progress, los Tries y el Problem de cada dispositivo. La pestaña Firmware del dispositivo muestra lo que Runs, su Update y su History.
El dispositivo no recibe la imagen
Antes de asignar, seleccione Check: What happens enumera los dispositivos que no aceptarán el paquete, con el motivo.
| Motivo | Solución |
|---|---|
| Las actualizaciones están desactivadas para su perfil | En la pestaña Firmware del perfil active Allow firmware updates for this profile (desactivado en un perfil nuevo) |
| Otro modelo de hardware | El paquete enumera los Hardware models; el dispositivo informa de otro |
| Creado para otro perfil | El paquete está limitado a un perfil (Only for devices of this profile) |
| Sin firmar no permitido | El paquete está Not signed y el perfil no permite Allow unsigned images (use esto solo para dispositivos de prueba) |
| Versión actual demasiado antigua | El dispositivo es anterior a Lowest version it can update from |
| Versión actual aún desconocida | El dispositivo no ha informado de current_fw_version. Debe enviarlo tras cada conexión. |
| Gana la asignación más específica | Una asignación de dispositivo prevalece sobre una lista de dispositivos, y una lista sobre un perfil |
| Espera a su oleada | En una implantación, un dispositivo de una oleada posterior no recibe nada hasta que empiece su oleada: Waits for wave n |
El paquete no está listo
| Estado | Significado |
|---|---|
| Being checked | El archivo se analiza en busca de virus; pasa a Ready cuando el análisis es limpio |
| Rejected | Fallaron la suma de comprobación, la firma o el análisis; el archivo se eliminó. Vuelva a subirlo. |
| Tras Retire | Ya no se ofrece para nuevas asignaciones; las actualizaciones en curso continúan |
| Tras Revoke | No debe instalarse: se detuvieron las actualizaciones que no han empezado a instalarse |
La firma se comprueba con sus Signing keys registradas. Revocar una clave revoca todos los paquetes firmados con ella.
Lea el estado de la actualización
| Estado | Significado | Qué hacer |
|---|---|---|
| Queued | Asignada; se envía cuando el dispositivo esté en línea | Ponga el dispositivo en línea |
| Sent to the device | Notificado; debe empezar a descargar | Si se mantiene, el dispositivo no gestiona los atributos compartidos fw_* en v1/attributes/set |
| Downloading, Downloaded, Checked, Installing | Progreso que informa el dispositivo | Espera |
| Waiting | 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. Vea más abajo. |
| Failed | El dispositivo informó de FAILED con un código fw_error | Lea el Problem; Try again tras corregir la causa |
| No answer in time | El dispositivo dejó de informar dentro de Download may take (minutes) (60 por defecto) o Installing may take (minutes) (20 por defecto) | Compruebe el enlace y el dispositivo; aumente los tiempos en el perfil para enlaces lentos o imágenes grandes |
| Volvió a la versión anterior | La nueva versión no arrancó correctamente y el dispositivo volvió a la anterior | Pruebe la imagen en un dispositivo al que pueda acceder; revise los registros de arranque |
| No es para este dispositivo | El paquete no le corresponde | Vea la primera tabla |
| Cancelled | Detenida antes de instalarse |
Tries per update (3 por defecto, de 1 a 10 en la pestaña Firmware del perfil) define cuántos intentos tiene cada actualización. Para los dispositivos fallidos, caducados o que volvieron atrás, la página del paquete ofrece Try again.
Espera en un enlace medido
Un dispositivo con enlace móvil (LTE) informa de fw_wait: metered y espera, porque Allow updates over LTE (mobile data) está desactivado por defecto. Para permitir que se actualice:
- active la opción en el perfil, o
- establezca Updates over LTE en Allowed for this device en la pestaña Firmware del dispositivo.
fw_wait: quota_exhausted significa que el dispositivo agotó su cuota de datos móviles; approval significa que alguien debe aprobar en el dispositivo. Los dispositivos en espera no cuentan como fallos al cerrarse una oleada.
Problemas de descarga e instalación
| Síntoma | Causa |
|---|---|
| La descarga falla tras 15 minutos | fw_url es válida durante 15 minutos. El dispositivo debe volver a pedir fw_url y reanudar con una petición HTTP Range. |
| La suma de comprobación coincide pero el dispositivo rechaza la imagen | La firma no se verifica. El dispositivo hace bien en rechazarla: vuelva a firmar la imagen con una clave registrada. |
| El dispositivo informa de Updated pero el estado no cambia | UPDATED sin el nuevo current_fw_version no se acepta por sí solo. Informe de la versión en ejecución tras el reinicio. |
| El firmware nunca se ofrece | El firmware nunca se ofrece por MQTT sin cifrar: el dispositivo debe usar TLS |
Vea Firmware updates (OTA) para lo que recibe y comunica el dispositivo.
Una implantación se pausó sola
Una implantación por oleadas se pausa sola cuando una oleada:
| Motivo mostrado | Significado | Qué hacer |
|---|---|---|
| demasiados dispositivos fallaron | Más fallos que el At most failed (%) de la oleada | Revise el Problem de los dispositivos fallidos, corrija la causa y luego Resume o Abort |
| se actualizaron muy pocos dispositivos | La oleada se cerró con menos dispositivos actualizados de los requeridos | A menudo son dispositivos sin conexión. Compruébelos y luego reanude. |
| ningún dispositivo terminó a tiempo | La oleada se cerró sin que ningún dispositivo terminara | Es posible que los dispositivos estén sin conexión o no puedan descargar |
«Los dispositivos que ya empezaron terminan su actualización; ningún otro dispositivo la recibe hasta que alguien reanude la implantación.» Los administradores reciben un aviso en la aplicación. Resume acepta lo ocurrido hasta ahora: solo los nuevos fallos cuentan contra el control. Abort elimina la asignación y no se puede deshacer.
El plan habitual: un canario del 1 % (de 1 a 10 dispositivos), luego el 10 %, el 50 % y el resto; cada oleada necesita que el 90 % de sus dispositivos terminados estén actualizados, se pausa si los fallidos superan el 5 % y se cierra como máximo a los 240 minutos. Vea Rolling out firmware in waves.
Quién puede hacer qué
| Acción | Rol por defecto |
|---|---|
| Ver paquetes y estados de actualización | Usuario |
| Subir, retirar, revocar, eliminar paquetes; asignar; cambiar ajustes OTA; reintentar | Administrador |
| Registrar y revocar claves de firma | Propietario |