browse

| Overview

The OTA progress updates is a feature implemented in the 75F system, to improve transparency and progress visualization of Over the Air firmware updates for the hardware devices.

This enhances the message-handling capability between the cloud and CCU, and thus addresses issues like:

  • No way to track OTA updates.
  • No actual status notifications for the users on updates.

The implementation targets the following aspects:

  • Status updates for the OTA initiated from portals in the portal.
  • Progress of the update
  • Notifying the users of the success and failure of the updates

| OTA Status Updates

As part of the above-mentioned aspects, the following capability is added.

Communication status between CCU and cloud 
When an OTA is initiated from the portals to update firmware on the field device. The CCU could provide a status back to the cloud. This status is visualized in the portals, for the end user to act upon. For information on how to initiate an Over the air firmware update for devices, from the portal refer to Remote Tuner Commands for the Hardware
The OTA Statuses implemented are as follows:
Statuses Description
Packet received
  • An indication that the firmware download from CCU to CM is completed. 
Download started.
  • An indication that firmware download from CM to the field device is started. 
Update Completed
  • An indication that the CM successfully updated the field device.
The above table is a broader classification of the statuses implemented, to track an OTA update progress. For a drill down on the actual statuses refer to the sections below.

| OTA Status Update Point

The implementation to achieve the OTA status visibility uses a newly added point  OtaStatus, and its respective Enums to provide information about different stages of the OTA update.

Following are the Enumerations used for the point OtaStatus and their descriptions:

Enumeration  Enumeration Description 
OTA_REQUEST_RECEIVED 
OTA_UPDATE_STARTED 
OTA_REQUEST_IN_PROGRESS 
OTA_FIRMWARE_DOWNLOAD_FAILED 
OTA_CCU_TO_CM_FAILED 
OTA_CCU_TO_CM_UPDATE_STARTED 
OTA_CCU_TO_CM_PERCENT_COMPLETED_10 
OTA_CCU_TO_CM_PERCENT_COMPLETED_50 
OTA_CCU_TO_CM_PERCENT_COMPLETED_100 
OTA_CCU_TO_CM_FIRMWARE_RECEIVED 
10  OTA_CM_TO_DEVICE_PACKET_STARTED 
11  OTA_CM_TO_DEVICE_PERCENT_COMPLETED_10 
12  OTA_CM_TO_DEVICE_PERCENT_COMPLETED_20 
13  OTA_CM_TO_DEVICE_PERCENT_COMPLETED_30 
14  OTA_CM_TO_DEVICE_PERCENT_COMPLETED_40 
15  OTA_CM_TO_DEVICE_PERCENT_COMPLETED_50 
16  OTA_CM_TO_DEVICE_PERCENT_COMPLETED_60 
17  OTA_CM_TO_DEVICE_PERCENT_COMPLETED_70 
18  OTA_CM_TO_DEVICE_PERCENT_COMPLETED_80 
19  OTA_CM_TO_DEVICE_PERCENT_COMPLETED_90 
20  OTA_CM_TO_DEVICE_PERCENT_COMPLETED_100 
21  OTA_SUCCESSED 
22  OTA_TIMEOUT 
23  OTA_CM_TO_DEVICE_FAILED 
24  NODE_STATUS_VALUE_FW_OTA_SUCCESSFUL 
 
| OTA Failure Handling

The OTA updates initiated from the portals could fail for various reasons and at two places in the OTA process steps.

  • While firmware upgrade packets are being received
  • After firmware upgrade packets are received

During these steps of the process, when the CCU application crashes for any reason, the OTA update fails.

During this kind of failure, when the CCU application comes back online, it recognizes an active request for the update is present.

This request for the update can be visualized in the Portal with the failure status message, and the same can be resumed.

| OTA Failure Update

The OtaStatus also provides the status of the failed OTA update.

Following are the Enumerations used for the point OtaStatus and their descriptions on the OTA Update failure statuses.

Enumeration  Enumeration Description 
25  NODE_STATUS_VALUE_FW_OTA_FAIL_REBOOT_INTERRUPTION 
26  NODE_STATUS_VALUE_FW_OTA_FAIL_NOT_FOR_ME_DEV_TYPE 
27  NODE_STATUS_VALUE_FW_OTA_FAIL_NOT_FOR_ME_FW_VERSION 
28  NODE_STATUS_VALUE_FW_OTA_FAIL_IMAGE_SIZE 
29  NODE_STATUS_VALUE_FW_OTA_FAIL_EXT_FLASH_ERROR 
30  NODE_STATUS_VALUE_FW_OTA_FAIL_IMAGE_VERIFICATION 
31  NODE_STATUS_VALUE_FW_OTA_FAIL_INACTIVITY_TIMEOUT 
32  NO INFO 

Based on an enum value visualized for the point OtaStaus the user can conclude on the failure status of an OTA update.

| OTA Status Update Visualizations

The OTA status updates can be visualized in various places like the Summary table. by adding point OTA Status to the summary table using the filter shown below.
 
2.jpg
 
Published Summary table
 
1.jpg
And in the system widget screen, as a custom visualization, as below
 
3.jpg

| Feature Availability Versions

  • The OTA progress tracking feature is available from the CM version 3.31 and above.
  • The OTA progress tracking feature is available from the CCU version 3.31 and above.

 

 
Previous
Next

Comments

0 comments

Please sign in to leave a comment.

Was this article helpful?

0 out of 0 found this helpful
Powered by Zendesk