拓扑关系如何管理?

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

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

方式对比

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

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

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

网关绑定子设备(动态发现)

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

交互流程

拓扑关系管理

设备发送消息

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

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.rhkb.cn/news/137198.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

1.简单工厂模式

UML类图 代码 main.cpp #include <iostream> #include "OperationFactory.h" using namespace std;int main(void) {float num1;float num2;char operate;cin >> num1 >> num2 >> operate;Operation* oper OperationFactory::createOpera…

【LQR】离散代数黎卡提方程的求解,附Matlab/python代码(笔记)

LQR的核心是设计QRN&#xff0c;并求解对应的黎卡提方程 对于连续状态空间方程系统&#xff0c;先求连续LQR后离散 和 先离散后求离散LQR方程 的结果 是不一样的 1.离散代数黎卡提方程 注&#xff1a;LQR算法中含N项 离散系统&#xff1a; 在matlab里有现成的函数dlqr()&…

GLTF编辑器如何快速重置模型原点

1、什么是模型原点&#xff1f; 模型原点是三维建模中的概念&#xff0c;它是指在一个虚拟三维空间中确定的参考点。模型原点通常位于模型的几何中心或基本组件的中心位置。如图所示&#xff1a; 可以看到模型的原点在模型的几何中心 2、模型原点的作用 知道了什么是模型原点&…

本地项目上传至码云gitee

1、springboot-mgx是需要上传的项目 2、码云后台创建一个新的仓库 3、创建完成后&#xff0c;复制下来https链接&#xff0c;后面要用到。 4、进入项目要上传的文件中 5、对git进行初始化&#xff0c;git指令 git init 6、 上传项目至gitee &#xff08;1&#xff09;连接远…

windows系统安装python教程,以及PyCharm安装,新手入门详细

最近需要给新电脑安装python&#xff0c;记录一下安装过程。 到python的官网进行下载&#xff1a;https://www.python.org/ 选择下载的系统&#xff0c;这边是Windows 然后选择最新的Release版本&#xff0c;点进去 然后滑到最下边&#xff0c;选择适合自己系统的&#xff0c;…

ReactNative中升级IOS 17版本Crash解决

ReactNative中升级IOS 17版本Crash解决 ReactNative中升级IOS 17版本Crash解决一、问题描述二、原因分析三、解决方案决策3.1 设置宽高为非零值3.2 使用新的UIGraphicsImageRenderer替换就版本的UIGraphicsBeginImageContext 四、可能使用到该API的三方库4.1 react-native-fast…

【智慧工地源码】智慧工地助力数字建造、智慧建造、安全建造、绿色建造

智慧工地围绕建设过程管理&#xff0c;建设项目与智能生产、科学管理建设项目信息生态系统集成在一起&#xff0c;该数据在虚拟现实环境中&#xff0c;将物联网收集的工程信息用于数据挖掘和分析&#xff0c;提供过程趋势预测和专家计划&#xff0c;实现工程建设的智能化管理&a…

Web前端大作业html+css静态页面--掌****有限公司

文章目录 前言 一、效果图 二、代码展示 1.html 2.css部分 总结 前言 对于大一新生来说&#xff0c;期末考试和专业结课作业可能会带来很大的压力。特别是涉及到网页设计和编写的作业&#xff0c;可能让人感到无从下手。例如&#xff0c;web实训大作业、网页期末作业、web课程与…

uni-app:通过ECharts实现数据可视化-如何引入项目

效果 引入文件位置 代码 <template><view id"myChart"></view> </template> <script> import echarts from /static/js/echarts.js // 引入文件 export default {mounted() {// 初始化EChartsconst myChart echarts.init(document…

一台主机外接两台显示器

一台主机外接两台显示器 写在最前面双屏配置软件双屏跳转 写在最前面 在使用电脑时需要运行多个程序&#xff0c;时不时就要频繁的切换&#xff0c;很麻烦 但就能用双屏显示来解决这个问题&#xff0c;用一台主机控制&#xff0c;同时外接两台显示器并显示不同画面。 参考&a…

Linux CentOS7 history命令

linux查看历史命令可以使用history命令&#xff0c;该命令可以列出所有已键入的命令。 这个命令的作用可以让用户或其他有权限人员&#xff0c;进行审计&#xff0c;查看已录入的命令。 用户所键入的命令作为应保存的信息将记录在文件中&#xff0c;这个文件就是家目录中的一…

Linux备份策略:保证数据安全

&#x1f337;&#x1f341; 博主猫头虎&#xff08;&#x1f405;&#x1f43e;&#xff09;带您 Go to New World✨&#x1f341; &#x1f984; 博客首页——&#x1f405;&#x1f43e;猫头虎的博客&#x1f390; &#x1f433; 《面试题大全专栏》 &#x1f995; 文章图文…

攻防世界-WEB-fileinclude

访问url&#xff0c;可以看到一些提示&#xff0c;绝对路径/var/www/html/index.php&#xff0c;也提示了flag在flag.php中。 快捷键Ctrlu,查看网页源代码 思路&#xff1a; 源代码中看到 include($lan.".php"); &#xff0c;可知此处存在文件包含。$lan的值是从co…

Linux 系统移植(一)-- 系统组成

参考资料&#xff1a; linux系统移植篇&#xff08;一&#xff09;—— linux系统组成【野火Linux移植篇】1-uboot初识与编译/烧录步骤 文章目录 一、linux系统组成二、Uboot三、Linux内核四、设备树 本篇为Linux系统移植系列的第一篇文章&#xff0c;介绍了一个完整可运行的L…

饥饿游戏搜索算法(HGS)(含java实现代码)

Hunger games search: Visions, conception, implementation, deep analysis, perspectives, and towards performance shifts 期刊:Expert Systems With Applications SCI1区 主体框架 public HGS(){initialize();calculateFitness();sortTheFitness();calculateHungry();for…

硬核评测 | 百分点科技NLP、知识图谱产品获“可信AI”多项最高级

权威评测&#xff1a; 百分点科技“文本分析系统”以多项满分评分的优异表现&#xff0c;通过中国信通院“可信AI”功能模块最高级&#xff08;增强型&#xff09;评测&#xff1b;“数据科学基础平台-知识图谱构建系统”通过数据处理、知识构建、管理维护最高级&#xff08;4…

基于Uniapp+SpringBoot+Vue的电影交流平台小程序设计与实现(源码+lw+部署文档+讲解等)

前言 &#x1f497;博主介绍&#xff1a;✌全网粉丝10W,CSDN特邀作者、博客专家、CSDN新星计划导师、全栈领域优质创作者&#xff0c;博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战✌&#x1f497; &#x1f447;&#x1f3fb;…

【SpringCloud微服务全家桶学习笔记-服务注册zookeeper/consul】

SpringCloud微服务全家桶学习笔记 Eureka服务注册 gitee码云仓库 9.其他服务注册框架 &#xff08;1&#xff09;zookeeper安装与使用 zookeeper需安装在虚拟机上&#xff0c;建议使用CentOS&#xff0c;安装地址如下&#xff1a; zookeeper镜像源 选择第一个进入后下载ta…

新手怎样快速上手接口测试?掌握这几个知识点直接起飞!

接口测试是测试系统组件间接口的一种方式&#xff0c;接口测试主要用于检测外部系统与系统之间以及内部各个子系统之间的交互点。测试的重点是检查数据的增删改查操作&#xff0c;以及系统之间的逻辑关系等。 接口的几种类型 接口的类型包括&#xff1a;post &#xff0c;get&…

UWB定位模块

UWB定位模组是华星智控自研的小尺寸高集成度模组&#xff0c;模组长宽厚为30.1513.955.62毫米&#xff0c;天线采用IPEX接口分体式设计&#xff0c;方便集成于您的产品中&#xff0c;产品采用本安设计&#xff0c;可以用于煤矿等井下场景&#xff0c;通信距离>100米&#xf…