After you submit a batch update request, IoT Platform pushes an update notification to your devices based on your settings. You can view the update statuses of your devices and the update package information in the IoT Platform console.

Prerequisites

A batch update request is submitted. For more information, see Initiate a batch update.

Procedure

  1. Log on to the IoT Platform console.
  2. In the left-side navigation pane, choose Maintenance > OTA Update.
    Note To provide better services, IoT Platform improves the OTA update feature and adds statistics on update package versions. When you use the new OTA update feature in the console for the first time, you must associate the uploaded update packages with products. You can associate an update package with only one product. For more information about how to associate update packages with products, see the instructions in the console.
  3. On the Update Packages tab, find the update package that you use for a batch update and click View in the Actions column. Then, you can view the information and perform operations on the following tabs:
    • Batch Management
      • View the type of an update batch, such as Verify Update Package or Batch Update.
      • Find the update batch and click View in the Actions column. On the Batch Details page, you can view devices in different states on the Device List tab.
        State Description
        Pending Confirmation The OTA update task has not been confirmed by using the mobile app.

        If you set APP Confirm Upgrade to Yes when you create an update batch, the update tasks in the batch are in this state.

        To Be Pushed The OTA update notification has not been pushed to the device.

        This state may appear due to the following three causes: 1. The device is offline. 2. The notification is scheduled to be pushed. 3. The pushing rate exceeds the limit. The following states that correspond to these three causes are displayed:

        • To Be Pushed (Device Offline)
        • To Be Pushed (Scheduled:XX XX, XXXX, XX:XX:XX)
        • To Be Pushed
        Pushed The device has received the OTA update notification but has not submitted the update progress.
        In upgrade The device has received the OTA update notification and submitted the update progress.
        Updated The device has submitted a valid version number after the update.
        Note After a device is updated, make sure that the device submits a valid version number at the earliest opportunity. Otherwise, the update may fail due to a timeout issue.
        Updated Failed OTA updates may fail due to the following causes:
        • You initiate a new batch update for a device. However, you do not overwrite the previous update task that is not completed on the device.

          You can use one of the following methods to resolve the issue:

          • After the previous update task is completed, initiate a new update.
          • Before you initiate a new update for a device, overwrite the previous task that is still running on the device.
            Note If the device is in the In upgrade state, an update task that is running on the device cannot be overwritten.
        • The device submits the value of -1, -2, -3, or -4 that indicates a failure when the device uses a specific topic to submit the update progress to IoT Platform. Description of the values:
          • -1: indicates that the update failed.
          • -2: indicates that the download failed.
          • -3: indicates that the verification failed.
          • -4: indicates that the burning failed.
        • During a device update, the update period starts from the first time the device submits the update progress. The device fails to submit the updated version number within the specified timeout period.
        • The device in the In upgrade state submits a version number that is not the source version or destination version.

        If you specify a version number to be updated and specify a retry interval when you initiate a batch update, retries are performed after the update fails. An update may fail due to one of the following causes:

        • The device in the In upgrade state submits a version number that is not the source version or destination version.
        • The device submits one of the following values when the device uses a specific topic to submit the update progress to IoT Platform: -1, -2, -3, and -4.

        During automatic retries, the update status of a device in IoT Platform remains unchanged. For example, if a retry occurs on a device that is in the Pushed state, the device status is still displayed as Pushed in the IoT Platform console. If a retry occurs on a device that is in the In upgrade state, the device status is still displayed as In upgrade in the IoT Platform console.

        Note

        IoT Platform does not perform retries if an update fails due to one of the following causes:

        • The update times out.
        • The update is canceled.
        Canceled The update for the device is canceled.

        You can also click the Batch information tab to view the basic information about the batch. If the update batch is in the In upgrade state, the Edit button is displayed next to Tag Information. You can click Edit to modify or add tags. For more information about tags, see Initiate a batch update.

      • Find the update batch and click Cancel in the Actions column.
        • If you cancel a static update batch, all update tasks of the batch are canceled by default, including the tasks in the Pending Confirmed, To Be Pushed, Pushed, and Updated states.
        • If you cancel a dynamic update batch, only the dynamic update policy is canceled by default. You can cancel all ongoing update tasks based on your business requirements, including the tasks in the To Be Pushed, Pushed, and In upgrade states.

        You can cancel all device update tasks that are in Pending Confirmation, To Be Pushed, or Pushed state.

    • Device List

      View the information about the devices to which the update package is pushed, including the update status of devices, and the statistics on successful updates, failed updates, and canceled updates.

      Find the device and click View in the Actions column. On the Batch Details page, you can cancel the update task of the device.

    • Update Package Information
      • View the basic information about the update package, such as the ID, name, signature, signature algorithm, version number, status, and module of the update package.
      • To obtain the update package, click Download next to Update Package Signature.

What to do next

View statistics on update package versions and success rates: After the OTA update task is completed, you can go to the Data analysis tab to view the distribution of update package versions and the statistics on the success rate of updates.

Related API operation

Operation Description
ListOTAJobByFirmware Queries the update batches of an update package.
ListOTAJobByDevice Queries the update batches of an update package by device.
ListOTATaskByJob Queries the update tasks of a device by update batch.
QueryOTAJob Queries the details of an update task.

For more information about API operations related to the OTA update feature, see OTA updates.