物联网通信 拓扑关系管理

一、功能概述

·数据上行 Topic（用于发布）：$gateway/operation/${productid}/${devicename}

·数据下行 Topic（用于订阅）：$gateway/operation/result/${productid}/${devicename}

二、绑定设备

网关类型的设备，可以通过数据上行 Topic 请求添加它和子设备之间的拓扑关系，实现绑定子设备。请求成功之后，云端通过数据下行 Topic 返回子设备的绑定信息。

网关绑定子设备请求数据格式：

{ "type": "bind", "payload": { "devices": [ { "product_id": "CFCS****G7", "device_name": "****ev", "signature": "signature", "random": 121213, "timestamp": 1589786839, "signmethod": "hmacsha256", "authtype": "psk" } ] }}

请求参数说明：

网关绑定子设备响应数据格式：

{ "type": "bind", "payload": { "devices": [ { "product_id": "CFCS****G7", "device_name": "****ev", "result": -1 } ] }}

响应参数说明：

三、解绑设备

网关类型的设备， 可以通过数据上行 Topic 请求解绑它和子设备之间的拓扑关系。请求成功之后，云端通过数据下行 Topic 返回子设备的解绑信息。

网关解绑子设备请求数据格式：

{ "type": "unbind", "payload": { "devices": [ { "product_id": "CFCS****G7", "device_name": "****ev" } ] }}

请求参数说明：

网关解绑子设备响应数据格式：

{ "type": "unbind", "payload": { "devices": [ { "product_id": "CFCS****G7", "device_name": "****ev", "result": -1 } ] }}

响应参数说明：

四、查询拓扑关系

网关类型的设备， 可以通过该Topic上行请求查询子设备的拓扑关系。
数据上行Topic：$gateway/operation/${productid}/${devicename}
数据下行Topic：$gateway/operation/result/${productid}/${devicename}

网关查询子设备拓扑关系请求数据格式：

{ "type": "describe_sub_devices"}

请求参数说明：

网关查询子设备拓扑关系响应数据格式：

{ "type": "describe_sub_devices", "payload": { "devices": [ { "product_id": "XKFA****LX", "device_name": "2OGDy7Ws8mG****YUe" }, { "product_id": "XKFA****LX", "device_name": "5gcEHg3Yuvm****2p8" }, { "product_id": "XKFA****LX", "device_name": "hmIjq0gEFcf****F5X" }, { "product_id": "XKFA****LX", "device_name": "x9pVpmdRmET****mkM" }, { "product_id": "XKFA****LX", "device_name": "zmHv6o6n4G3****Bgh" } ] }}

响应参数说明：

五、拓扑关系变化

网关类型的设备， 可以通过该 Topic 订阅平台对子设备的拓扑关系变化。
数据下行 Topic：$gateway/operation/result/${productid}/${devicename}

子设备被绑定或解绑，网关将收到子设备拓扑关系变化，数据格式如下：

{ "type": "change", "payload": { "status": 0, //0-解绑 1-绑定 "devices": [ { "product_id": "CFCS****G7", "device_name": "****ev", } ] }}

请求参数说明：

网关响应，数据格式如下：

{ "type": "change", "result": 0}

响应参数说明：

六、错误码