• 文档
• 节点
• IoT Hub
• Report OTA

Report OTA

Report OTA 节点报告 OTA 信息，例如设备固件版本、OTA 进度等。有关 EnOS 中的固件升级 OTA 的更多信息，参见 固件无线（OTA）升级。

节点类型

IoT Hub。

输入和输出能力

该节点具有多个入口点和 1 个出口点。输入和输出格式均为 JSON。

输入必须遵循 EnOS OTA 的更新格式，如以下示例所示。

{
    "assetId":"assetId",
    "params": {
        "version":"2.1"
    }
}

params 内可能包含的参数包括以下所列内容。

• verison：设备上报的固件版本号。
• progress：设备 OTA 进度，与 OTA 的步骤相对应。有关更多信息，参见 开发设备端 OTA 能力。正值可以表明OTA的进展，而负值则表明失败。
• desc：其他描述性信息，如失败原因。

注解

以下两种情况会报告错误。

• 未填写 assetId。
• 当 version 和 progress 同时存在。任何时候都只能使用一个。

节点属性

名称

该节点的名称。

描述

该节点的描述。

使用限制

• 需要遵循 EnOS OTA 协议的更新格式。

示例

输入示例

{
  "assetId": "BzWDwkn1",
  "params": {
    "progress": "66"
  }
}

输出示例

输出与输入相同。

相关节点

• OTA