Remote Upgrade OTA Product Introduction

Product Introduction Product Advantages Terms Explanation

Product Charge User guideline

Product and Device Upgrade Operation Process

Device development

Upgrade Task Push API authentication API List 1- Report Version 2- Detect Device Upgrade Task 3- Detect if token is valid 4- Download Resources 5- Report upgrade status Other API

6- Get device token 7- Query device version number 8- report status 9- Query device ID

Instructions for use of OTA - SDK

Best practice

API debugging- Postman API debugging - network debugging assistant

Common problems

Questions Related to Functions SDK-Related Questions Other Questions

Get token for the device under upgrading (upgrading/downloading)

Request format:GET

URL: http//ota.heclouds.com/ota/south/tasking

At present, “detect device upgrade task” can be used instead.

I only want to see examples！！！

http header

Name	Format	Required or not	Description
Content-Type	string	Yes	Must be application/json.
Authorization	string	Yes	Security authentication information

http request parameter

Name	Format	Required or not	Description
dev_id	long	Yes	Device id
type	int	Yes	1:fota task, 2:sota task
cdn	boolean	No	true\|false, whether to return pull upgrade package ip

Return Parameters

Name	Format	Description
errno	int	Call error code, where 0 means success.
error	string	Error description, where “succ” means success.
data	json	Device-related information returned after interface is successfully called. See the Data Description Table.

Data Description Table

Name	Format	Description
target	string	Target version of upgrade task
token	string	File address: ip:port/ota/download/{token}
size	int	File size
signal	int	The task is performed under the signal greater than this.
power	int	The task is performed with the power larger than the value.
retry	int	Times of retry
interval	int	Retry interval
md5	string	Md5 code of upgrade file
ipPort	string	Ip address pulling the upgrade package
type	int	1: complete package; 2: differential package

Error Code Description

Error Codes	Description
0	Valid
2	Type parameter error.
4	Valid token not found, may be since there is no upgrade task, or the token of the upgrade task is expired.
7	OneNET internal error.
12	Token is expired and device upgrade process flow is ended.

Request Parameter Example

{
    "dev_id":6523,  //device id
    "type":1,       //1:fota task, 2:sota task
    "cdn": true     //whether to return pull upgrade package ip, optional
}

Return Example

{
    "errno": 0,
    "error":"succ",
    "data":
    {
        "target":"1.2", // target version of upgrade task.
        "token":"ota_5hc95SFeo5xJEnaNrste",//file address ip: ip:port/ota/download/{token}
           "size":123,//file size
           "signal":12,//the task is performed under the signal larger than this one 
           "power":90,//the task is performed with the power larger than the value 
           "retry":10,//number of times of retry
           "interval":90,//retry interval 
           "md5":"dfkdajkfd",//md5 of upgrade file.
           "ipPort":"172.19.3.3:8002", //ip of pull upgrade package
           "type":1 // 1: complete package, 2: differential package.
    }
}

« Previous: 5- Report upgrade status

» Next: 7- Query device version number

个搜索结果，搜索内容 “”

0 个搜索结果，搜索内容 “”