文档首页/ 设备接入 IoTDA/ API参考/ 设备侧MQTT/MQTTS接口参考/ 软固件升级/ 平台下发获取版本信息通知
更新时间：2024-09-24 GMT+08:00
查看PDF
分享

平台下发获取版本信息通知

功能介绍

平台下发获取版本信息通知。

Topic

下行: $oc/devices/{device_id}/sys/events/down

参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

参数解释：

  • 平台下发时，若为网关子设备，该参数为Topic中设备的子设备Id。
  • 平台下发时，若为直连设备，该参数会与Topic中的device_id一致。

services

可选

List<ServiceEvent>

参数解释：

事件服务列表。

ServiceEvent定义表

字段名

必选/可选

类型

参数描述

service_id

必选

String

参数解释：

系统字段。

取值范围：

固定为："$ota"。

event_type

必选

String

参数解释：

系统字段。

取值范围：

固定为："version_query"。

event_time

可选

String

参数解释：

事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。

paras

可选

Object

参数解释：

事件参数JSON对象，下发获取版本信息时无具体字段下发。

paras参数列表

字段名

必选/可选

类型

参数描述

task_id

可选

String

参数解释：

网关模式下，创建软固件升级批量任务的任务ID。

sub_device_count

可选

Integer

参数解释：

网关模式下，同一个软固件升级批量任务中网关设备包含的升级子设备数量。

task_ext_info

可选

Object

参数解释：

创建软固件升级任务中添加的额外扩展信息。

示例

Topic: $oc/devices/{device_id}/sys/events/down  
数据格式： 
{
    "object_device_id": "{object_device_id}",
    "services": [
        {
            "service_id": "$ota",
            "event_type": "version_query",
            "event_time": "20151212T121212Z",
            "paras": {
                "task_id": "65d31bf2581ed33a42a58d76",
                "sub_device_count": 2,
                "task_ext_info": {
                    "device_type": "DDC"
                }
            }
        }
    ]
}
父主题： 软固件升级