设备固件管理接口

查询固件版本信息

  • 接口intent:query.ota.firmware
  • 接口描述:本接口用于查询指定设备模型值的所有固件版本信息。
  • 请求参数
名称 类型 是否必须 描述
model String 设备类型
  • 请求示例
{
    "intent": "query.ota.firmware",
    "data": {
        "model": "lumi.gateway.acn01"
    }
}
  • 返回参数
名称 类型 描述
fileSize Int 固件文件大小,单位字节
firmwareVersion String 固件版本
releaseTime String 发布时间,(时间戳,单位:毫秒)
necessary Int 是否必经,0:否,1:是
updateLog String 固件更新日志
state int 2 - 已上线
  • 返回示例
{
    "code": 0,
    "message": "Success",
    "msgDetails": null,
    "requestId": "5147.139.16228802663580161",
    "result": [
        {
            "releaseTime": "1621848755000",
            "necessary": 1,
            "fileSize": 1253864,
            "updateLog": "修复问题",
            "state": 2,
            "firmwareVersion": "1.5.1_0001"
        }
        {
            "releaseTime": "1621848755000",
            "necessary": 0,
            "fileSize": 1276934,
            "updateLog": "xxxxx",
            "state": 2,
            "firmwareVersion": "3.1.1_0021.0519"
        }
    ]
}

升级固件(一键升级多个固件)

  • 接口intent:write.ota.upgrade
  • 接口描述:本接口用于对设备进行固件升级,支持批量升级。
  • 请求参数
名称 类型 是否必须 描述
dids Array(String) 设备id数组(最大列表100)
  • 请求示例
{
    "intent": "write.ota.upgrade",
    "data": {
        "dids": [
            "virtual2.11774113824794",
            "lumi.158d0001ab4030"
        ]
    }
}
  • 返回参数
名称 类型 描述
did String 无法升级的设备id
code Int 无法升级错误码
message String 升级失败的消息说明
deviceName String 无法升级的设备名称
  • 返回示例
{
    "code": 0,
    "message": "Success",
    "msgDetails": "",
    "requestId": "",
    "result": [
        {
            "code": 602,
            "message": "Device is offline",
            "deviceName": "门窗传感器",
            "did": "lumi.158d0001ab4030"
        }
    ]
}

查询设备升级的状态

  • 接口intent:query.ota.upgrade
  • 接口描述:本接口用于查询设备的升级状态,搭配“write.ota.upgrade”接口使用。
  • 请求参数
名称 类型 是否必须 描述
dids Array(String) 设备id数组
  • 请求示例
{
    "intent": "query.ota.upgrade",
    "data": {
        "dids": [
            "virtual2.11774113824794"
        ]
    }
}
  • 返回参数
名称 类型 描述
did String 升级的设备id
status Int 固件升级状态数字表示。 0:升级成功; 1:升级中;2:升级失败;3:未知;4:等待升级中。跟result字段对应
result String 当前设备的固件升级状态:succ:升级成功;upgrade:升级中,fail:升级失败;unknow:未知; waiting:等待升级中
progress Int 当前升级的进度,取值范围0~100
  • 返回示例
{
    "code": 0,
    "message": "Success",
    "msgDetails": "",
    "requestId": "",
    "result": [
        {
            "result": "unknow",
            "did": "virtual2.11774113824794",
            "status": 3
        }
    ]
}
Copyright © 2023 深圳绿米联创科技有限公司 all right reserved,powered by Gitbook文档修改时间: 2024-09-27 21:51:47

results matching ""

    No results matching ""