tencent cloud

文档反馈

代理子设备上下线

最后更新时间:2021-09-18 17:01:59

    功能概述

    网关类型的设备,可通过与云端的数据通信,代理其下的子设备进行上线与下线操作。此类功能所用到的 Topic 与网关子设备拓扑管理的 Topic 一致:

    • 数据上行 Topic(用于发布):$gateway/operation/${productid}/${devicename}
    • 数据下行 Topic(用于订阅):$gateway/operation/result/${productid}/${devicename}

    代理子设备上线

    网关类型的设备,可以通过数据上行 Topic 代理子设备上线。请求成功之后,云端通过数据下行 Topic 返回子设备的上线信息。

    网关代理子设备上线请求数据格式:

    {
    "type": "online",
    "payload": {
      "devices": [
        {
          "product_id": "CFCSQ5EAG7",
          "device_name": "onlinedev00"
        }
      ]
    }
    }
    

    代理子设备上线响应数据格式:

    {
    "type": "online",
    "payload": {
      "devices": [
        {
          "product_id": "CFCSQ5EAG7",
          "device_name": "onlinedev00",
    "result":0
        }
      ]
    }
    }
    

    请求参数说明:

    字段 类型 描述
    type String 网关消息类型。代理子设备上线取值为:online
    payload.devices Array 需上线的子设备列表
    product_id String 子设备产品 ID
    device_name String 子设备名称

    响应参数说明:

    字段 类型 描述
    type String 网关消息类型。代理子设备上线取值为:online
    payload.devices Array 需上线的子设备列表
    product_id String 子设备产品 ID
    device_name String 子设备名称
    result Int 子设备上线结果,具体错误码见下表

    代理子设备下线

    网关类型的设备, 可以通过数据上行 Topic 代理子设备下线。请求成功之后,云端通过数据下行 Topic 返回成功子设备的下线信息。

    网关代理子设备下线请求数据格式:

    {
    "type": "offline",
    "payload": {
      "devices": [
        {
          "product_id": "CFCSQ5EAG7",
          "device_name": "offlinedev00"
        }
      ]
    }
    }
    

    代理子设备下线响应数据格式:

    {
    "type": "offline",
    "payload": {
      "devices": [
        {
          "product_id": "CFCSQ5EAG7",
          "device_name": "offlinedev00",
    "result":-1
        }
      ]
    }
    }
    

    请求参数说明:

    字段 类型 描述
    type String 网关消息类型。代理子设备下线取值为:offline
    payload.devices Array 需代理下线的子设备列表
    product_id String 子设备产品 ID
    device_name String 子设备名称

    响应参数说明:

    字段 类型 描述
    type String 网关消息类型。代理子设备下线取值为:offline
    payload.devices Array 需代理下线的子设备列表
    product_id String 子设备产品 ID
    device_name String 子设备名称
    result Int 子设备下线结果,具体错误码见下表

    错误码

    错误码 描述
    0 成功
    -1 网关设备未绑定该子设备
    -2 系统错误,子设备上线或者下线失败
    801 请求参数错误
    802 设备名非法,或者设备不存在
    810 不支持的子设备
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持