If you set the Verify Update Package? parameter to Yes when you add an update package, you must verify the update package on tested devices before you perform a batch update. The update package can be pushed to devices for an over-the-air (OTA) update only after tested devices are updated. This article describes how to verify an update package in the IoT Platform console.

Prerequisites

An update package is added. For more information, see Add an update package.

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 want to verify and click Verify in the Actions column. In the Verify Update Package dialog box, set the parameters as required and click OK to verify the update package on one or more devices.
    Parameter Description
    Version number to be upgraded
    • If you perform a full update, this parameter is optional.

      The drop-down list displays the OTA module versions of all devices in the current product, except for the version to be updated to. You can select one or more versions. After you select the required versions, the related devices are added to the Device to be verified list as candidate devices.

      If you do not set this parameter, no limit is set on the OTA module versions of the devices to be verified.

    • If you perform a differential update, the value of this parameter is the version number that you specify when you add the update package.
    Device to be verified Select one or more devices to be verified.
    Whether IoT Platform Actively Pushes Update Task Specify whether to automatically push update tasks from IoT Platform to devices.
    • Yes (default): After an update batch is created, IoT Platform automatically pushes update tasks to the specified online devices.

      In this case, a device can still initiate a request to obtain the information about the OTA update task from IoT Platform.

    • No: A device must initiate a request to obtain the information about the OTA update task from IoT Platform.
    APP Confirm Upgrade Specify whether to control the update by using a mobile app. You must develop the mobile app as needed.
    • Yes: To perform an OTA update on a device, you must confirm the update by using your mobile app. You can call the ConfirmOTATask operation to confirm the update tasks that are pending confirmation. Then, the device can obtain the information about the OTA update task based on the Whether IoT Platform Actively Pushes Update Task parameter.
    • No (default): A device obtains the information about the OTA update task based on the Whether IoT Platform Actively Pushes Update Task parameter.
    Device upgrade time-out (minutes) Specify the timeout period of the update. If a specified device has not been updated within this period, the update times out. Valid values: 1 to 1440. Unit: minutes.

    If you perform an OTA update by using the update package for the first time, we recommend that you set this parameter to its maximum value. This increases the success rate of the update. The console shows a recommended value based on update records.

    Note
    • The update period starts from the first time the specified device submits the update progress.

      During the update, the update package may be repeatedly pushed to the specified device because the device goes online and offline multiple times. However, the start time of the update period does not change.

    • After the device is updated, the device must immediately submit the updated version number. Otherwise, the update may fail due to a timeout error.

    For example, you set the timeout period to 60 minutes and the device first submits the update progress at 10:00. If the device does not submit the updated version number before 11:00, the update fails.

    Batch label Click Add Tag. In the field that appears, specify the Tag Key and Tag Value parameters. After an update batch is created, you cannot modify the tags that are added to the update batch.

    The tags of an update batch are sent to devices when IoT Platform pushes update notifications to these devices.

    You can click the Help icon to view the rules on how to configure tags.

Results

In the Verify Update Package dialog box, click Close.

On the Update Packages tab, find the update package that is in the Verifying state and click View in the Actions column. On the Update Package Information tab, you can view the verification progress.

Verification Progress

What to do next

After tested devices are updated and the status of the update package is displayed as Verified, you can perform a batch update. For more information, see Initiate a batch update.

Related operations

Operation Description
CreateOTAVerifyJob Creates a verification task for an update package.
QueryOTAFirmware Queries the details of an update package.

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