Verifying Firmware


After a new firmware is added, you should select a few devices to verify the OTA process to reduce bricking the devices caused by wrong firmware.

Note

EnOS only provides the message channels for verification. Developers will need to verify whether the firmware can be pushed to the device and whether the upgrading process is finished successfully and the device can function properly.


This section shows how to batch verify device firmware.

Before You Start

  • Ensure that you have completed Uploading Firmware.
  • Ensure that you have the device firmware version and deviceKey information.

Procedure

  1. Select Device Management > OTA Upgrades > OTA Jobs.

  2. Click New Job and select Verification for Type.

  3. Fill in the information for the below.

    • Job Name: Enter a name for the OTA verification job.
    • Product: Select the product for the firmware verifcation from the drop-down.
    • Firmware Name: Select the firmware from the list of names in the drop-down.
    • Current Firmware Version: Select the firmware version for upgrading.
    • Target Device: Select the devices for upgrading. You can select up to a maximum of 5 devices.
    • Upgrade Timeout: Enter a timeout period for the verification job in minutes. If the device(s) selected above for updating does not return the verification result (successful or failed) within this time period, the job will fail. The default period is 120 minutes.
    • Start Upon Creation: If enabled, the job will start immediately when you click Confirm.


    ../../_images/ota_verify_job.png


  4. Click Confirm to finish creating the job. If Start Upon Creation was enabled during creation, the job will start immediately.

Results

  • Once successfully created, the verification job will be listed in the list of jobs in the OTA Jobs tab page. If you toggled Start Upon Creation to on, the verification job will start immediately. Otherwise, you can go to the OTA Jobs tab page to start the job manually.
  • In OTA Jobs, select View Details to enter the job details page where you can view the details of the verification. For more information, see Viewing OTA Job Details.

Note

After the OTA upgrading process is finished, the developer should verify whether the device can function properly.