3. 下载包

功能描述:

​ 下载压缩包。

参数描述(JSON格式):

一级参数二级参数类型默认值选择说明举例

method

string

必选

download_package

“download_package”

messageId

string

可选

MQ消息的唯一标识ID

“004a5b58-32e8-487e-a90a-2ce443877e7e”

download_package_info

dict

必选

{}

package_name

string

必选

下载包名称。1、如果有其他需要执行得操作,在压缩包里可以放入执行脚本run.sh, 该脚本为启动脚本,且名称必须为run.sh。2、脚本中执行成功最后必须echo "excute success", 告知成功,否则视为失败。 3、如果有重启得操作,请用echo "need reboot"告知重启, 不能直接"reboot"重启。

package_download_link

string

必选

下载地址,下载包为tar.gz包格式。

package_size

float

必选

下载包得大小, 单位为M,当该值为0时,不进行下载操作

0.34

package_md5

string

必选

下载包的md5值

package_message

string

可选

下载包的一些描述

extend _params

dict

必选

扩展字段,可以为空

notify _path

string

可选

管理平台URL(相对地址),用于通过http方式回传命令执行结果。相对地址的组合请参见 URL组合章节。 注意: 如果登陆时管理平台下发 uploadQueue 字段,则会通过MQ上传通道返回结果。 如果没有 uploadQueue 字段,并且 notify_path 为非空,则会向 notify_path 返回结果 如果两个字段都没有,则不会返回结果(即单向通信)。

MQ命令示例:

{
    "method": "download_package", // 此关键字和内容不能变
    "download_package_info":{  // 下载包对应信息
         "package_name":"ota.tar",
         "package_download_link":"http://xxxxx/xxx",
         "package_size":0.34,          //单位为M
         "package_md5":"8b1085bed498b82ef1485ef19074c281",
         "package_message":"更新了部分在线升级功能",
 },
  
    "extend_params":   // 扩展字段,当前为空。用于将来的接口升级。扩展字段的内容以字典的形式填充,但扩展字段本身为必选。
   { 
   }  
}

返回结果示例:

{
    "success":true,
    "code":0,
    "message":"下载成功",
    "dev_sno":"sda23erasd" ,//设备唯一标识key
    "messageKey":"download_package", //每一类消息格式的key
    "result":{
         "download_package_info":{  
                "package_name":"ota.tar",
                "package_download_link":"http://xxxxx/xxx",
                "package_size":0.34,
                "package_md5":"8b1085bed498b82ef1485ef19074c281",
                "package_message":"更新了部分在线升级功能",
			    "package_download_path":"/data/download/ota.tar"    //下载包下载路径
               }
	}
}

Last updated