online-update-check 接口
在线检测是否有新版本的固件。
进行检测时,必须满足以下条件:
- 未进行固件升级
通过 get-status 接口可以获取到以下信息:
"cur-status": 65552 // 设备运行状态掩码
cur-status
和 设备状态掩码 进行与运算,可以得到以下状态表:
状态 | 条件 |
---|---|
未进行固件升级 | cur-status & statusUpgrade != statusUpgrade |
请求方式
GET http://ip/usapi?method=online-update-check
参数 | 说明 |
---|---|
method | 方法名称:online-update-check |
返回数据
{
"result": 0
}
属性 | 说明 |
---|---|
result | 返回状态,0:操作成功,返回其它值请参考 API 状态码 |
检测过程状态
通过 get-status 接口可以获取到 check-upgrade 和 upgrade 信息,如下:
"check-upgrade": {
"result": 0,
"client-id": ""
},
"upgrade": {
"ver": "1.2.123",
"date": "2012-1-1 00:00:00",
"size-byte": 12004784,
"info": [
{
"version": "1.2.123",
"changelog": "## Develop version 1.2. ## Develop version2."
}
]
}
属性 | 说明 |
---|---|
result | 操作状态。 27:初始状态 2:检测中状态 0:操作成功 返回其它值请参考 API 状态码 |
ver | 新固件版本号 |
date | 新固件发布时间 |
size-byte | 新固件文件大小(B) |
info | 更新日志 |
client-id | 保留属性 |
检测操作失败后,需要调用 clear-check-update 接口将检测状态重置为初始状态(27)。