设备固件管理接口

查询固件版本信息

• 接口intent：query.ota.firmware
• 接口描述：本接口用于查询指定设备模型值的所有固件版本信息。
• 请求参数

• 请求示例

{
    "intent": "query.ota.firmware",
    "data": {
        "model": "lumi.gateway.acn01"
    }
}

• 返回参数

• 返回示例

{
    "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
• 接口描述：本接口用于对设备进行固件升级，支持批量升级。
• 请求参数

• 请求示例

{
    "intent": "write.ota.upgrade",
    "data": {
        "dids": [
            "virtual2.11774113824794",
            "lumi.158d0001ab4030"
        ]
    }
}

• 返回参数

• 返回示例

{
    "code": 0,
    "message": "Success",
    "msgDetails": "",
    "requestId": "",
    "result": [
        {
            "code": 602,
            "message": "Device is offline",
            "deviceName": "门窗传感器",
            "did": "lumi.158d0001ab4030"
        }
    ]
}

查询设备升级的状态

• 接口intent：query.ota.upgrade
• 接口描述：本接口用于查询设备的升级状态，搭配“write.ota.upgrade”接口使用。
• 请求参数

• 请求示例

{
    "intent": "query.ota.upgrade",
    "data": {
        "dids": [
            "virtual2.11774113824794"
        ]
    }
}

• 返回参数

• 返回示例

{
    "code": 0,
    "message": "Success",
    "msgDetails": "",
    "requestId": "",
    "result": [
        {
            "result": "unknow",
            "did": "virtual2.11774113824794",
            "status": 3
        }
    ]
}