遠程升級OTA
產品簡介
產品定價
使用者指南
設備開發
最佳實踐
常見問題
更新日誌
上報升級狀態
請求方式：POSTURL：http://ota.heclouds.com/ota/south/device/download/{token}/progress
http頭部
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| Content-Type | string | 是 | 必須為application/json |
| Authorization | string | 是 | 安全鑒權信息 |
http 請求參數
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| dev_id | long | 是 | 設備Id |
http 請求內容
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| step | int | 是 | 取值為[0，100]，下載進度比 |
返回參數
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| errno | int | 調用錯誤碼，為0表示調用成功 |
| error | string | 錯誤描述，為"succ"表示調用成功 |
說明
1、設備在下載升級包的過程中（分片下載），可以根據需要上報下載進度（設備處於“下載中”，才能上報step=[0，100]）；
2、如果設備上報的下載進度為100（即step:100），那麼平台會將設備的升級狀態從“正在下載”修改為“正在升級”狀態；
3、只有當設備處於“正在下載”狀態時，設備才能夠使用該介面上報下載進度，其他狀態將返回“invalid state”的錯誤；
4、step如果大於100，將作為上報狀態使用（設備處於：待升級、下載中、升級中，這三個狀態時，可以通過上報如下狀態碼完成升級流程。 其他狀態如：已取消，升級失敗、升級成功、暫停時，不能上報如下狀態）：
| 狀態碼 | 說明 |
|---|---|
| 101 | 升級包下載成功（設備狀態變成：升級中）。 |
| 102 | 下載失敗，空間不足（設備狀態變成：升級失敗）。 |
| 103 | 下載失敗，記憶體溢出（設備狀態變成：升級失敗）。 |
| 104 | 下載失敗，下載請求超時（設備狀態變成：升級失敗）。 |
| 105 | 下載失敗，電量不足（設備狀態變成：升級失敗）。 |
| 106 | 下載失敗，信號不良（設備狀態變成：升級失敗）。 |
| 107 | 下載失敗，未知異常（設備狀態變成：升級失敗）。 |
| 201 | 升級成功，此時會把設備的版本號修改為任務的目標版本 （設備狀態變成：升級完成）。 |
| 202 | 升級失敗，電量不足（設備狀態變成：升級失敗）。 |
| 203 | 升級失敗，記憶體溢出（設備狀態變成：升級失敗）。 |
| 204 | 升級失敗，升級包與當前任務目標版本不一致（設備狀態變成：升級失敗）。 |
| 205 | 升級失敗，MD5校驗失敗（設備狀態變成：升級失敗）。 |
| 206 | 升級失敗，未知異常（設備狀態變成：升級失敗）。 |
| 207 | 達到最大重試次數（設備狀態變成：升級失敗）。 |
| 208 | 設備升級過期（設備狀態變成：升級失敗）。 |
特別說明
下載中狀態可以上報下載中的狀態碼或者升級中的狀態碼；升級中狀態只能上報升級中的狀態碼。
請求示例
POST http:///ota/south/device/download/ota_MP9qVOT0AtsHhUSNYMy7/progress?dev_id=32981907
Content-Type:application/json
Host: api.heclouds.com
http請求參數示例
{
"step":50 // [1, 100] 下載進度為50%
}
返回示例
{
"errno": 0,
"error":“succ”
}