OTA服務升級任務推送使用指導

1 應用場景

使用OTA增值服務時，如果在OneNET平台將設備添加到指定升級包中（即給設備新增升級任務），需要使用者的終端設備主動到OneNET平台檢查是否存在升級任務。這種情況下，使用者的設備就需要開啟一個定時任務，週期性到OneNET平台檢查是否存在升級任務，這種工作模式對電能消耗敏感的設備極其不利。

2 使用流程

OneNET平台提供了OTA升級任務的推送功能，當用戶在OneNET平台為終端設備新建升級任務後，將所涉及到的設備資訊推送給使用者側的應用平台，由用戶的應用平台下發命令給對應設備，再由設備到OneNET平台檢查升級任務進行OTA升級。使用OneNET升級任務推送功能後，設備就不需要週期性到OneNET平台檢查升級任務，節約能耗。

具體流程圖如下所示。

升級任務推送使用流程

第一步：完成用戶側應用平台部署

使用者側應用服務用於接收OneNET OTA推送過來的任務資訊和校驗資訊。OneNET平台提供了簡單的DEMO。

若跳轉失敗，請使用位址 https://github.com/cm-heclouds/ota-receive

第二步：在OneNET OTA官網配置推送url和token

token用於校驗。校驗過程包括：使用者在提交配置時，平台會將token+uid取md5值通過HTTP GET請求發送到使用者配置的url，如果返回PASSED則配置成功，如果返回FAILED則配置失敗。

第三步：在OneNET OTA控制台開啟推送功能，並關聯升級包

配置推送URL和token後，將需要推送的升級包關聯到該URL中，用戶可以選擇推送或者不推送升級資訊（通過開啟和取消關聯等操作）。

第四步：添加設備到對應升級包時

如果用戶開啟推送功能並關聯了該升級包，則OneNET-OTA會將升級的設備資訊通過HTTP POST方法推送給使用者配置的url中。

3 服務校驗介面

HTTP方法: GET

URL: http:///ota/receive

HTTP參數: signature=dfadfdafda

成功返回: PASSED | FAILED

說明: signature是使用者在OneNET-OTA配置的token+uid的md5值。

4 接收任務資訊介面

HTTP方法: POST

URL: http:///ota/receive

HTTP請求內容:

    {
    "info":{
        "uid":1,
        "date":1573611869000
    },
    "signature":"3783bdc4ccdf08f1189d21871edd9df5",
    "msg":{
        "dids":[123,345],
        "startTime":1573611869000,
        "version":"11"
    }
}

« 上一篇：升級操作流程

» 下一篇：API鑒權