Updated on 2022-02-24 GMT+08:00

Software Upgrade

Overview

The IoT platform provides firmware upgrade function using LWM2M for NB-IoT modules. However, most NB-IoT modules do not provide the upgrade interface for the MCU. The MCU can be upgraded only based on the application layer. The MCU upgrade is called software upgrade.

Prerequisites

Before upgrading the software, ensure that the device supports the software upgrade.

  1. Choose Product > Product Development. Click a product name to enter the product space.

  2. In Define Profile section to view OM Maintenance details, and ensure that Software Upgrade function is enabled.

Uploading Software Packages

  1. Choose Product > Upgrade Debugging > Upgrade Package Management > Software, and click Upload Unsigned Software Package.

  2. On the Software Package Upload tab page, select the unsigned software package to be uploaded and click Submit.

    Before uploading the software package, ensure that the corresponding product model exists in the Developer Center.
    NOTE:

    Developer Center can obtain the product model information from the JSON file in the software package. Therefore, you do not need to select a product and associate it with the software package.

Creating a Software Upgrade Task

  1. Choose Product > Upgrade Debugging > Software Upgrade, and click Create Upgrade Task.

    NOTE:

    If no upgrade task is available, click Create Task to create a software upgrade task.

  2. Create the upgrade task according to the wizard.

    1. Enter basic information and click Next.

      If you need to configure the parameters Execution Type and Retry Parameter, set the parameter Advance to True.

      • Execution Type indicates the time when the Developer Center delivers an upgrade task to the device. The value options include Now, Custom, and Device Online.
      • Retry Parameter indicates whether to execute failed task again.

    2. Select the software package to be upgraded and click Next.

      If no required software package exists in the Historical Software Package list, click Unsigned Software Package to upload an unsigned software package. Ensure that the software package to be uploaded can be used for software upgrade. Before uploading the software package, ensure that the corresponding product model exists in the Developer Center.

    3. In the Device Select tab page, you can select one or multiple devices for upgrade and click Submit.

  3. After a software upgrade task is created, you can manage it on the Software Upgrade tab page. Click a task to view the Basic Information and Upgrade Detail.

  4. After the task is complete, click Export to export the task details file.