Todos los productos
Search
Centro de documentos

IoT Platform:Preguntas frecuentes sobre errores relacionados con actualizaciones OTA

Última actualización: Sep 04, 2026

Conozca por qué fallan las actualizaciones inalámbricas (OTA) y cómo resolver cada error.

Se agota el tiempo de espera de una actualización de dispositivo

Problema

En la consola de IoT Platform, elija Maintenance > OTA Update para ir a la página de OTA Update. Al iniciar una actualización por lotes en esta página, configure el parámetro Device upgrade time-out (minutes). El temporizador se activa cuando el dispositivo envía el progreso de la actualización por primera vez. Si el dispositivo no se actualiza dentro del periodo de tiempo de espera especificado en el parámetro Device upgrade time-out (minutes), IoT Platform determina que la actualización presentó errores.

Causa

  • La red del dispositivo es inestable, por lo que la descarga del paquete de actualización OTA tarda más que el periodo de tiempo de espera especificado.

  • El dispositivo no logra descargar el paquete de actualización OTA o la actualización falla en el primer intento. El dispositivo se reinicia, recibe la tarea de actualización de IoT Platform, descarga el paquete y vuelve a actualizar. La duración total de este proceso supera el periodo de tiempo de espera especificado.

Solución

Establezca Device upgrade time-out (minutes) en un valor mayor a 60 o deje el parámetro vacío.

Nota

Solo puede modificar Device upgrade time-out (minutes) para tareas de actualización dinámica. Puede modificar este parámetro varias veces. Cada modificación se aplica únicamente a los dispositivos agregados después del cambio.

Un dispositivo envía un número de versión de firmware no válido

Problema

En la consola de IoT Platform, elija Maintenance > OTA Update para ir a la página de OTA Update. Al iniciar una actualización por lotes en esta página, configure el parámetro Version number to be upgraded. Después de que un dispositivo descarga un paquete de actualización, inicia la actualización y envía el progreso, el dispositivo se desconecta. Posteriormente, el dispositivo se conecta y envía un número de versión de firmware que no corresponde ni a la versión de origen ni a la versión de destino. En este caso, IoT Platform determina que la actualización presentó errores.

Causa

Durante una actualización OTA, se ejecuta simultáneamente una actualización de firmware local. Una vez completada la actualización local, el dispositivo reporta una versión de firmware que no coincide con la versión de origen ni con la versión de destino de la tarea de actualización por lotes.

Solución

Antes de actualizar el firmware local de un dispositivo, desconéctelo de IoT Platform. Una vez completada la actualización local, el dispositivo podrá conectarse y reportar el número de versión de firmware más reciente. El dispositivo debe reportar el número de versión dentro de los 2 segundos posteriores a su conexión.

En la consola de IoT Platform, elija Maintenance > OTA Update para ir a la página de OTA Update. Al iniciar una actualización por lotes en esta página, configure el parámetro Max. Retry Times. Por ejemplo, establézcalo en 5. Cuando un dispositivo reporta un número de versión de firmware no válido, IoT Platform reintenta la actualización hasta alcanzar el número de veces especificado en Max. Retry Times. Esto mejora la tasa de éxito de las actualizaciones OTA.

Un dispositivo envía un valor de error

Problema

Durante una actualización, un dispositivo envía uno de los siguientes valores de error mediante el tema específico de progreso de actualización: -1 (Update Failed), -2 (Download Failed), -3 (Verification Failed) y -4 (Burn Failed). En consecuencia, IoT Platform determina que la actualización presentó errores.

Causa

Pueden ocurrir diversos errores durante una actualización OTA. Cuando sucede un error, el dispositivo reporta uno de los valores de error junto con una descripción personalizada para facilitar la solución de problemas.

Las descripciones de los valores de error están predefinidas por IoT Platform, pero usted puede modificarlas. Asimismo, el dispositivo puede reportar una descripción personalizada según el error específico.

Solución

En la consola de IoT Platform, elija Maintenance > OTA Update para ir a la página de OTA Update. Al iniciar una actualización por lotes en esta página, configure el parámetro Max. Retry Times. Por ejemplo, establézcalo en 5.

Después de que un dispositivo reporta un valor de error, IoT Platform reintenta la actualización hasta alcanzar el número de veces especificado en Max. Retry Times. Esto mejora la tasa de éxito de las actualizaciones OTA.

Un dispositivo tiene varias tareas de actualización simultáneas

Problema

Un dispositivo solo puede tener una tarea de actualización en curso. Si inicia otra tarea de actualización para el mismo dispositivo, se produce un conflicto e IoT Platform marca la nueva tarea como con errores.

Causa

Al iniciar otra tarea de actualización para un dispositivo que ya tiene una tarea en curso, estableció Override Previous Device Update Tasks en No.

Solución

  • En la consola de IoT Platform, elija Maintenance > OTA Update para ir a la página de OTA Update. Al iniciar una actualización por lotes, establezca Override Previous Device Update Tasks en Yes.

  • En la página Batch Details de la consola de IoT Platform, cancele las tareas que se encuentran en los estados To Be Pushed, Pushed e In upgrade. A continuación, inicie una nueva tarea de actualización en el dispositivo.

Importante

Puede cancelar tareas de actualización en estado In upgrade, pero no puede sobrescribirlas.