拓扑关系如何管理？

news2024/9/27 21:24:53

在设备对接涂鸦的云端过程中，一部分设备由于自身资源或硬件配置，无法直接连接云端。而是需要通过网关进行中转，由网关代理实现和云端进行数据交互，间接实现设备接入云端。这样的设备也称为子设备。

要想实现网关代理子设备接入云端，子设备和网关需要先建立关联关系，也称为 拓扑关系。

方式对比

建立拓扑关系有三种方式，您可以根据实际情况，选择其中一种，并且注意不要混用。

名称适用场景接口特点
动态发现
  • 无法事先获取子设备信息，无法提前在云端注册子设备和烧录注册信息。
  • 网关能发现子设备，动态向云端注册子设备并建立拓扑。
网关绑定子设备全自动
网关建立拓扑
  • 事先获取子设备信息，并在云端注册子设备。
  • 拿到子设备注册信息后，烧录到子设备或者网关里面。
  • 网关发现子设备，调用云端接口建立拓扑关系。
建立拓扑关系半自动
平台管理
  • 事先获取子设备信息，并在云端注册子设备。
  • 在云端上建立拓扑关系。
建立拓扑关系全手动

本文主要介绍用于网关设备侧管理拓扑关系的协议内容，并详细说明每个协议。

网关绑定子设备（动态发现）

网关动态发现子设备，请求云端注册子设备并建立拓扑关系，云端返回请求结果。这对应方式对比章节的 动态发现 方式。

交互流程

拓扑关系管理

设备发送消息

设备检测到子设备连接，主动向云端发送绑定子设备消息。

topic: tylink/${deviceId}/device/sub/bind

{
    "msgId":"45lkj355123****",
    "time":1626197189600,
    "version":"1.0",
	"data":[
      {
        "productId":"a123b456****",
        "clientId":"123455asdf****"
      },
      {
        "productId":"a123b457****",
        "clientId":"453455asdf****"
      }
    ]
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是发起子设备绑定的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，上报和订阅消息通过该值建立应答关系。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
dataArray子设备参数列表是多个子设备绑定参数，子设备数量不超过 100 个。
data[].productIdString子设备的产品 ID是需要绑定在子设备的产品 ID。
data[].clientIdString设备端唯一 ID是此处主要用于子设备硬件的唯一标识，可以是设备的 MAC、SN 等，至少保证产品下唯一，将显示在 设备管理 > 注册 ID 字段。

设备接收消息

设备订阅接收绑定子设备消息回复。

topic: tylink/${deviceId}/device/sub/bind_response

{
    "msgId":"45lkj3551234****",
    "time":1626197189640,
    "version":"1.0",
    "code":0,
	"data":[
      {
        "productId":"a123b456****",
        "clientId":"123455****",
        "deviceId":"6c828cba434ff40c07****"
      },
      {
        "productId":"a123b457****",
        "clientId":"123456****",
        "deviceId":"6c828cba434ff40c07****"
      }
    ]
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是发起子设备绑定的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，上报和订阅消息通过该值建立应答关系。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
codeNumber响应状态码否
  • 0 代表成功，默认值。
  • 非 0 代表失败。
dataArray子设备绑定结果列表是-
data[].productIdString产品 ID是子设备的产品 ID。
data[].clientIdString子设备硬件的唯一表示 ID是子设备的唯一标识，需保证产品下唯一。
data[].deviceIdString云端分配的唯一设备 ID是同一个 clientId、同一个网关设备 ID，多次绑定只会生成同一个设备 ID，否则会重新生成一个新的设备 ID。

状态码说明

状态码说明
0默认状态，代表成功。
1001服务异常。
1002请求参数校验不合法。
1004设备不存在。
2401产品不存在。
2402网关绑定了多个设备组。
2403拓扑信息存在，子设备信息不存在。
2404授权码数量不足， 获取授权码失败。
2405获取网关设备组异常。
2406子设备重新注册时，必须先解绑。
2410同一个网关绑定子设备的数量，不能超过 2000 个。

网关删除子设备

网关通过动态发现注册的子设备，可支持网关请求云端删除对应的子设备。云端接收到该请求后，会校验并删除该子设备，同时删除网关和子设备的拓扑关系。由于是设备端发起的删除操作，针对已绑定家庭或资产的子设备，支持网关直接删除子设备。

交互流程

拓扑关系管理

设备发送消息

Topic：tylink/${deviceId}/device/sub/delete

消息内容

{
    "msgId":"45lkj355123****",
    "time":1626197189600,
    "version":"1.0",
	"data":[
      "devId123455as****",
      "devId123456ty****"
    ]
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是发起删除子设备的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，上报和订阅消息通过该值建立应答关系。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
dataArray待删除的子设备 ID 列表是子设备 ID 列表，设备数量不超过 10。

设备接收消息

Topic：tylink/${deviceId}/device/sub/delete_response

消息内容

{
    "msgId":"45lkj355123****",
    "time":1626197189640,
    "version":"1.0",
  	"code":0,
	"data":[
      "devId123455as****",
      "devId123456ty****"
    ]
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是发起删除拓扑关系的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，上报和订阅消息通过该值建立应答关系。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
codeNumber响应状态码否0 代表成功，非 0 代表失败，默认 0。
dataArray被删除的子设备 ID 列表。是/

状态码说明

状态码说明
0默认状态，代表成功。
1001服务异常。
1004设备记录不存在。
2407子设备列表为空。
2408子设备数量超限。

建立拓扑关系

对于已经在云端注册的子设备，拿到子设备注册信息后烧录到子设备。网关运行后动态发现子设备，请求云端建立拓扑关系，云端返回请求结果。这对应方式对比章节中的 网关建立拓扑 方式。

交互流程

拓扑关系管理

设备发送消息

topic：tylink/${deviceId}/device/topo/add

{
    "msgId":"45lkj355123****",
    "time":1626197189600,
    "version":"1.0",
	"data":[
      {
        "productId":"a123b456****",
        "deviceId":"123455asdf****",
        "sign":"adstewq35324ds****",
        "signMethod":"HmacSHA256",
        "timestamp":"16067836521"
      },
      {
        "productId":"a123b457****",
        "deviceId":"123456****",
        "sign":"adstewq35324ds****",
        "signMethod":"HmacSHA256",
        "timestamp":"16067836521"
      }
    ]
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是发起建立拓扑关系的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，上报和订阅消息通过该值建立应答关系。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
dataArray子设备参数列表是多个子设备拓扑参数, 子设备数量不能超过 100 个。
data[].productIdString子设备的产品 ID是-
data[].deviceIdString子设备的设备 ID是注册设备时，获取的设备 ID，云端分配的唯一 ID。
data[].signMethodString签名算法是签名算法, 当前仅支持 HmacSHA256。
data[].timestampString时间戳是签名时间戳，10 位秒级或 13 位毫秒级。
data[].signString签名是使用 signMethod 对内容进行签名。例如，HmacSHA256（content, deviceSecret）, content 的内容如：productId= a123b456****|deviceId=123455asdf****|timestamp=${签名时间戳}, deviceSecret 为 涂鸦 IoT 开发平台 设备管理中展示的 DeviceSecret 字段。

设备接收消息

topic：tylink/${deviceId}/device/topo/add_response

{
    "msgId":"45lkj355123****",
    "time":1626197189640,
    "version":"1.0",
  	"code":0,
	"data":[
      {
        "productId":"a123b456****",
        "deviceId":"6c828cba434ff40c07****"
      },
      {
        "productId":"a123b457****",
        "deviceId":"6c828cba434ff40c07****"
      }
    ]
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是发起建立拓扑关系的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，上报和订阅消息通过该值建立应答关系。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
codeNumber响应状态码否
  • 0 代表成功，默认值。
  • 非 0 代表失败。
dataArray建立拓扑关系成功的结果列表。是-
data[].productIdString子设备的产品 ID。是-
data[].deviceIdString子设备的设备 ID。是-

状态码说明

状态码说明
0默认状态，代表成功。
1001服务异常。
1004设备记录不存在。
2407子设备列表为空。
2408子设备数量超限。
2409签名验证失败。
2410同一个网关绑定子设备的数量，不能超过 2000 个。

删除拓扑关系

网关请求云端删除与指定子设备的拓扑关系，云端返回请求结果。该请求不会删除子设备。删除拓扑关系后，子设备还能和该网关或其它网关再次建立拓扑关系。

交互流程

拓扑关系管理

设备发送消息

topic：tylink/${deviceId}/device/topo/delete

{
    "msgId":"45lkj355123****",
    "time":1626197189600,
    "version":"1.0",
	"data":[
      "devId123455as****",
      "devId123456ty****"
    ]
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是发起删除拓扑关系的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，上报和订阅消息通过该值建立应答关系。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
dataArray待删除的子设备 ID 列表是子设备 ID 列表, 设备数量不超过 100 个。

设备接收消息

topic：tylink/${deviceId}/device/topo/delete_response

{
    "msgId":"45lkj355123****",
    "time":1626197189640,
    "version":"1.0",
  	"code":0,
	"data":[
      "devId123455as****",
      "devId123456ty****"
    ]
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是发起删除拓扑关系的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，上报和订阅消息通过该值建立应答关系。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
codeNumber响应状态码否
  • 0 代表成功，默认值。
  • 非 0 代表失败。
dataArray被删除的子设备 ID 列表是-

状态码说明

状态码说明
0默认状态，代表成功。
1001服务异常。
1004设备记录不存在。
2407子设备列表为空。
2408子设备数量超限。

查询拓扑关系

网关请求云端查询拓扑关系，云端返回请求结果。

交互流程

拓扑关系管理

设备发送消息

topic：tylink/${deviceId}/device/topo/get

{
    "msgId":"45lkj355123****",
    "time":1626197189600,
    "version":"1.0",
	"data":{
      "startId": 0,
      "pageSize": 20, 
      "devIds":[
        "devId123455as****",
        "devId123456ty****"
      ]
    }
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是发起查询拓扑关系的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，上报和订阅消息通过该值建立应答关系。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
codeNumber响应状态码否
  • 0 代表成功，默认值。
  • 非 0 代表失败。
data.startIndexIdNumber本次查询子设备列表起始值否默认为 0，从第一条开始查询。如果查询第二页, 则该值为第一页查询结果最后一条记录的索引 ID。第三页及以后，以此类推。
data.pageSizeNumber每次查询的设备数量否默认及最大查询数量均为 100 个。
data.devIdsArray本次查询子设备 ID 列表否子设备 ID 列表，设备数量不超过 100 个。

设备接收消息

topic：tylink/${deviceId}/device/topo/get_response

{
    "msgId":"45lkj355123****",
    "time":1626197189640,
    "version":"1.0",
  	"code":0,
	"data":[
      {
        "productId":"a123b456****",
        "deviceId":"6c828cba434ff40c074***",
        "indexId": 1
      },
      {
        "productId":"a123b457****",
        "deviceId":"6c828cba434ff40c074***",
        "indexId": 2
      }
    ]
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是发起拓扑关系查询的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，上报和订阅消息通过该值建立应答关系。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
codeNumber响应状态码否
  • 0 代表成功，默认值。
  • 非 0 代表失败。
dataArray子设备列表是-
data[].productIdString子设备的产品 ID是-
data[].deviceIdString子设备的设备 ID是-
data[].indexIdNumber索引 ID是每页最后一条记录的索引 ID，作为下一页查询的 startIndexId。

状态码说明

状态码说明
0默认状态，代表成功。
1001服务异常。
1004设备不存在。
2408子设备数量超限。

通知拓扑关系变更

云端变更拓扑关系，如往拓扑关系中新增子设备，或把子设备从拓扑关系中删除，发送消息通知网关。

交互流程

拓扑关系管理

设备接收消息

topic：tylink/${deviceId}/device/topo/change

{
    "msgId":"45lkj355123****",
    "time":1626197189600,
	"data":{
      "addDevIds":[
           "devId123asdf****",
           "devId456tyiy****"
        ],
       "delDevIds":[
           "devId789****",
           "devIdyiy****"
        ]
    }
}

参数说明

参数类型说明必选备注
${deviceId}String设备 ID是拓扑关系发生变更的网关设备 ID。
versionString协议版本否默认 1.0，当前仅支持 1.0。
msgIdString消息 ID是总长度不超过 32 位的字符，消息的唯一 ID。
timeNumber消息时间戳是消息发送时的 Unix 时间戳，10 位秒级或 13 位毫秒级。
dataobject业务数据是-
data.addDevIdsArray新增的子设备 ID 列表否子设备数量不超过 100 个。
data.delDevIdsArray删除的子设备 ID 列表否子设备数量不超过 100 个。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1026271.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

C++跳坑记：位移超出范围的处理

C++跳坑记：位移超出范围的处理

在C编程中，数据类型的选择不仅影响内存占用和性能，还可以对某些操作的结果产生意想不到的影响。今天，我将分享一个关于C在不同变量类型下位移操作结果的发现。 位移操作是C中常见的对整数的高效操作之一。然而，我们可能会忽视一个…
阅读更多...
单播与多播mac地址

单播与多播mac地址

MAC 地址（Media Access Control Address）是一个用于识别网络设备的唯一标识符。每个网络设备都有一个独特的 MAC 地址，用于在局域网中进行通信。 单播MAC地址：单播MAC地址用于单播通信，即一对一的通信模式。当设备发送…
阅读更多...
day4_QT

day4_QT

day4_QT qt绘制钟表 qt绘制钟表 #include "widget.h" #include "ui_widget.h"Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget) {ui->setupUi(this);this->resize(1000,1000);this->setStyleSheet("background-color:…
阅读更多...
Word中对象方法（Methods）的理解及示例（下）

Word中对象方法（Methods）的理解及示例（下）

【分享成果，随喜正能量】当你的见识多了，眼界宽了，格局大了，所有的磨难都将不再是磨难，而是助你成长的阶梯。 。 《VBA之Word应用》（10178982），是我推出第八套教程，教程…
阅读更多...
pnpm入门教程

pnpm入门教程

一、概述 1、更小 使用 npm 时，依赖每次被不同的项目使用，都会重复安装一次。 而在使用 pnpm 时，依赖会被存储在内容可寻址的存储中。 2、更快 依赖解析。 仓库中没有的依赖都被识别并获取到仓库。目录结构计算。 node_modules 目录结构是…
阅读更多...
编程(47)----------Spring AOP

编程(47)----------Spring AOP

AOP是Spring中, 个人认为较为抽象的一个思想. 一般来说, 学习一个新东西, 第一件事是先看看这个知识点的定义是什么. 同时要注意, 同一事物的定义可以有很多, 毕竟定义没有绝对的对与错, 只有准确与否. 而初次接触AOP的定义, 第一感觉可能就是抽象, 或者说看不懂, 这里面也有…
阅读更多...
刷题日记——将x减到0的最小操作数

刷题日记——将x减到0的最小操作数

将x减到0的最小操作数 题目链接：https://leetcode.cn/problems/minimum-operations-to-reduce-x-to-zero/ 题目解读 题目要求移除元素总和等于参数x，这道题给我的第一感觉就是从数组的两边入手，对数据进行加和删除，但是这里有一…
阅读更多...
SVN状态图标不显示

SVN状态图标不显示

问题可能点1：图标覆盖 1、右键找到设置 2、找到图标覆盖 3、重启TortoiseSVN 问题可能点2：注册表图标顺序太靠下，被占用 1、windowsr, 输入regedit进入注册表 2、找到一下目录 计算机\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Cu…
阅读更多...
servlet中doGet方法无法读取body中的数据

servlet中doGet方法无法读取body中的数据

servlet中doGet方法不支持读取body中的数据。
阅读更多...
警惕！多本SCI/SSCI被剔除，9月SCI/SSCI期刊目录已更新~（附下载）

警惕！多本SCI/SSCI被剔除，9月SCI/SSCI期刊目录已更新~（附下载）

【SciencePub学术】 2023年9月20日，科睿唯安更新了Web of Science核心期刊目录。 继上次SCI期刊目录和SSCI期刊目录更新之后，本次9月更新共有9本期刊发生变动： • SCIE：有3本期刊不再被SCIE期刊目录收录(Editorial De-listing/Pr…
阅读更多...
Python 之 shadow 爆破密码脚本编写

Python 之 shadow 爆破密码脚本编写

文章目录 Linux shadow 爆破脚本Linux shadow 爆破初探Linux shadow 爆破进阶 Linux shadow 爆破脚本 Linux shadow 爆破初探 目的是为了明白其shadow爆破原理 # Linux shadow爆破初探 1import crypt#shadow文件中的一条用户数据 shadow_line "ghui:$y$j9T$DQ2d2fD138…
阅读更多...
（JavaEE）（多线程案例）线程池 （简单介绍了工厂模式）（含经典面试题ThreadPoolExector构造方法）

（JavaEE）（多线程案例）线程池 （简单介绍了工厂模式）（含经典面试题ThreadPoolExector构造方法）

线程诞生的意义，是因为进程的创建/销毁，太重了（比较慢），虽然和进程比，线程更快了，但是如果进一步提高线程创建销毁的频率，线程的开销就不能忽视了。 这时候我们就要找一些其他的办法…
阅读更多...
基于微信小程序的个人健康管理系统的设计与实现(源码+lw+部署文档+讲解等)

基于微信小程序的个人健康管理系统的设计与实现(源码+lw+部署文档+讲解等)

前言 💗博主介绍：✌全网粉丝10W,CSDN特邀作者、博客专家、CSDN新星计划导师、全栈领域优质创作者，博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战✌💗 👇🏻…
阅读更多...
ad18学习笔记十二：如何把同属性的元器件全部高亮？

ad18学习笔记十二：如何把同属性的元器件全部高亮？

1、先选择需要修改的器件的其中一个。 2、右键find similar objects，然后在弹出的对话框中，将要修改的属性后的any改为same 3、像这样勾选的话，能把同属性的元器件选中，其他器件颜色不变 注意了，如果这个时候&#xff…
阅读更多...
CSS 布局 (三) 浮动、定位、多列布局

CSS 布局 (三) 浮动、定位、多列布局

6、浮动 最初用于在文本块内浮动图像，float属性成为在网页上创建多列布局最常用的工具之一。随着flexbox和grid的出现，它现在又回到了最初的目的，正如本文所解释的那样。 6.1 浮动的背景 引入float属性是为了允许web开发人员实现包含图像在…
阅读更多...
Qt Charts简介

Qt Charts简介

文章目录 一.图标类型Charts分类1.折线图和样条曲线图2.面积图和散点图3.条形图4.饼图5.误差棒图6.烛台图7.极坐标图 二.坐标轴Axes类型分类三.图例四.图表的互动五.图表样式主题 一.图标类型Charts分类 图表是通过使用系列类的实例并将其添加到QChart或ChartView实例来创建的…
阅读更多...
【Linux】指针常量和常量指针

【Linux】指针常量和常量指针

这个是指针常量，不能修改指向【其实就是引用的原型】：可以理解为const是否限制了星号 这个是常量指针，可以改指向，不能改值：
阅读更多...
[Qt/C/C++]JSON和程序发布

[Qt/C/C++]JSON和程序发布

文章摘于 爱编程的大丙 文章目录 1. JSON1.1 Json数组1.2 Json对象1.3 注意事项 2. Qt中JSON操作2.1 QJsonValue2.2 QJsonObject2.3 QJsonArray2.4 QJsonDocument2.5 举例2.5.1 写文件2.5.2 读文件 3. cjson库的使用3.1 cJSON结构体3.2 cJson API3.2.1 数据的封装3.2.2 Json对…
阅读更多...
搭建自动化 Web 页面性能检测系统 —— 设计篇

搭建自动化 Web 页面性能检测系统 —— 设计篇

页面性能对于用户体验、用户留存有着重要影响，当页面加载时间过长时，往往会伴随着一部分用户的流失，也会带来一些用户差评。性能的优劣往往是同类产品中胜出的影响因素，也是一个网站口碑的重要评判标准。 一、名称解释 前端监控…
阅读更多...
滚雪球学Java(26)：Java进制转换

滚雪球学Java(26)：Java进制转换

🏆本文收录于「滚雪球学Java」专栏，专业攻坚指数级提升，助你一臂之力，带你早日登顶🚀，欢迎大家关注&&收藏！持续更新中，up！up！up！&#xf…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023