Event

固件升级进度

Topic: thing/product/{gateway_sn}/events

Direction: up

Method: ota_progress

Data:

Column	Name	Type	constraint	Description
result	结果返回码	int	{}
status	任务状态	enum	{"sent":"已下发","in_progress":"执行中","ok":"执行成功","paused":"暂停","rejected":"拒绝","failed":"失败","canceled":"取消或终止","timeout":"超时"}
progress	进度	struct
»percent	进度百分比	int	{"min":"0","max":"100","unit":"%","unitName":"百分比","step":"1"}
»step_key	当前步骤	enum	{"download_firmware":"下载固件","upgrade_firmware":"更新固件"}
»step_result	步骤结果	int	{}	非 0 代表错误

Example:

{
	"method": "ota_progress",
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp:": 1654070968655,
	"data": {
		"result": 0,
		"output": {
			"status": "in_progress",
			"progress": {
				"percent": 10,
				"step_key": "download_firmware"
			}
		}
	}
}

Service

固件升级

Topic: thing/product/{gateway_sn}/services

Direction: down

Method: ota_create

Data:

Column	Name	Type	constraint	Description
devices	固件升级设备集合	array	{}
»[array_item]	Elements in array	struct	{}	{"size": "2"}
»»sn	设备序列号	text	{"length":"10240"}
»»product_version	固件版本号	text	{"length":"10240"}
»»file_url	固件文件下载地址	text	{"length":"10240"}
»»md5	固件文件md5	text	{"length":"10240"}
»»file_size	固件文件大小	int
»»file_name	固件文件名称	text
»»firmware_upgrade_type	固件升级类型	enum	{"2":"一致性升级","3":"普通升级"}	一致性升级：指飞行器某些模块的固件版本与系统匹配版本不一致，需要进行升级。常见的情况例如：飞行器与遥控器已经升级至最新版本，但替换电池时发现电池未升级，此时一致性升级将被提示。普通升级：开发者将飞行器所有模块升级至指定固件版本。

Example:

{
	"method": "ota_create",
	"timestamp:": 1654070968655,
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"data": {
		"devices": [
			{
				"sn": "drone_sn",
				"product_version": "1.00.223",
				"file_url": "https://s3.com/xxx.zip",
				"md5": "abcdefabcdefabcdef",
				"file_size": 653467234,
				"file_name": "wm245_1.00.223.zip",
				"firmware_upgrade_type": 2
			},
			{
				"sn": "dock_sn",
				"product_version": "1.00.223",
				"firmware_upgrade_type": 3
			}
		]
	}
}

Topic: thing/product/{gateway_sn}/services_reply

Direction: up

Method: ota_create

Data:

Column	Name	Type	constraint	Description
status	任务状态	enum	{"sent":"已下发","in_progress":"执行中","ok":"执行成功","paused":"暂停","rejected":"拒绝","failed":"失败","canceled":"取消或终止","timeout":"超时"}

Example:

{
	"method": "ota_create",
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp:": 1654070968655,
	"data": {
		"result": 0,
		"output": {
			"status": "in_progress"
		}
	}
}