3 Star 6 Fork 2

ThingsKit / ThingsKit物联网平台文档

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
device.md 14.36 KB
一键复制 编辑 原始数据 按行查看 历史
cxylln 提交于 2023-06-19 14:31 . docs:文档优化内容
lang title description
zh-CN
设备管理
ThingsKit物联网平台,设备管理使用教程。

设备可以收集和传输实时数据,进行平台与设备通信,实现智能化、远程化和自动化控制。

产品

用于用户设定产品类型,定义物模型,自定义传输协议与设备关联,实现设备相关功能。

新增

  • 点击「设备管理」->「产品」->「新增产品」。

    image-20230510101247198

  • 输入产品详细信息,点击下一步,可自行配置设备传输方式(TCP协议传输可以新增转换函数脚本),设备类型为三种,在创建设备时,选择的产品是什么类型,设备选择该产品就是什么类型。

    image-20230506160601487

    image-20230506160633548

    注意:新增TCP类型产品时,可以进行脚本测试,重新新增脚本。

    image-20230506160650563

  • 点击确定新增产品完成。

说明:规则链和处理队列非必选,会自动默认。
接入协议如果不选会默认MQTT协议。

编辑

  • 点击「设备管理」->「产品」->「编辑」。

    image-20230510101336722

  • 修改产品详细信息,设备类型不可修改。

    image-20230510101358661

  • 点击确定编辑成功。

  • 如果此时产品为TCP接入协议,则可以查看测试和新增转换脚本。

image-20230510101851576

  • 输入16进制参数,点击测试,输出参数显示物模型数据。

image-20230510102406125

删除

  • 点击「设备管理」->「产品」->「删除」。

  • 选择所选产品。

  • 点击删除,如果有关联的设备则不可删除。

image-20230510102643355

默认

  • 点击「设备管理」->「产品」->「默认」。

  • 选择默认的产品。

  • 点击默认,界面显示设置成功。

image-20230510102619789

详情

  • 点击产品界面详情。

image-20230510102605444

  • 传输配置,Topic主题,物模型管理功能。

image-20230510103206034

  • 可以操作接入协议和转换脚本(只有TCP才可以)。

注意:只有产品是TCP协议才会使用转换脚本。

image-20230510102725050

  • 查看订阅和发布主题。

image-20230506161819078

  • 物模型:产品详情里面配置了物模型属性后,并且发布上线,设备创建选择该产品时,才会有相同的物模型属性,监测设备实时数据。

image-20230510102747497

  • 新增物模型:手动新增属性,服务和事件物模型或者导入物模型进行新增。

image-20230228095301649

注意:导入物模型时,需要json格式的文件。

image-20230607145327832

  • 导入物模型成功,红色方框内,点击发布上线即可正常使用。

image-20230607145730426

  • 物模型发布成功。

注意:物模型每次编辑后,需要点击发布上线才能重新生效。

image-20230607150638554

  • 设备物模型遥测数据在平台显示,可点击历史数据进行查看。

image-20230530140906725

  • 如果物模型读写类型为读写的话,设备中物模型便可以进行属性下发,否则就不可以属性下发。

image-20230607151245676

image-20230530141043753

  • 下发内容在设备详情命令记录里面查看。

image-20230530141151003

  • 物模型服务功能:新增了服务物模型功能后,在场景联动中,选择该产品的设备,配置执行动作为服务(输入内容为租户自定义)。

image-20230508174347620

  • 场景联动触发器和执行动作服务设备相对应。

image-20230509092521091

image-20230509092550752

  • 在MQTT连接上触发器配置的设备后,推送触发器属性,然后订阅消息,执行动作中的服务就产生消息与之对应。

image-20230509093035418

  • 此时,设备里命令下发记录出现服务记录,但是只是设备下发,并未回应设备,响应没成功,显示为已过期。

image-20230510103027302

  • 接下来模拟服务物模型双向响应成功。

image-20230509093530699

image-20230509094414446

  • 这时继续重新推送数据,订阅后再publish响应,此时双向响应成功,服务命令下发成功。

image-20230510103043897

  • 物模型事件功能:新增事件后,进行设备连接,再推送设备物模型数据生成事件管理。

image-20230509094545236

  • 事件物模型编辑。

image-20230509094610481

  • 当产品物模型为事件时,复制Topic中事件上报的发布主题到MQTT工具。

image-20230228104016462

  • 并把设备Id和标识符复制进来进行替换,标识符必须与物模型所配置的标识符一致,才能产生事件。

image-20230509094648765

image-20230304150516157

image-20230228104611782

  • 设备事件管理里面进行查看记录。

image-20230509095141887

设备列表

用户设备中包含物模型实时数据监测,命令下发和记录,告警数据处理,以及事件管理等功能。

新增

  • 点击「设备管理」->「设备列表」->「新增设备」。

image-20230510093834314

  • 填写设备相关信息,新增设备时,需在此之前先配置好产品,或使用租户默认创建的产品(三条)来达到数据传输和交互功能,用户选择和输入该设备详细信息,设备类型会根据产品类型变化,点击下一步确认并添加设备成功。

image-20230506162205235

编辑

  • 点击「设备管理」->「设备列表」->「编辑」。

    image-20230510093937156

  • 编辑设备详细信息,可以设置别名。

    image-20230510094305283

  • 点击确认编辑完成。

image-20230510094326561

分配客户

  • 点击「设备管理」->「设备列表」->「分配客户」或者「批量分配」。

  • 分配客户时,会通过设备所属组织来决定可分配的客户(也就是在此用户下创建的账号,并且账号组织与设备所属组织同级及以下,在分配客户时通过组织来选择该组织下的用户),点击分配,客户登录账号就可以查看设备详情。

  • 分配成功。

image-20230510094434043

image-20230510094505440

  • 批量分配时,如果设备存在的不属于同组织下,则会提示信息。

image-20230510094628334

设备公开

  • 设备公开后,设备的数据可以被其他人访问,例如:看板管理,如果设备未被公开,分享的看板管理则无法显示数据。

image-20230510094654199

image-20230510094707370

删除

  • 点击所选删除设备,单个删除或者批量删除。

注意:如果删除的设备存在于某个场景联动中,或者分配到某个用户,则先需要取消绑定关系才能进行删除。

image-20230510094734122

设备导入

  • 点击「设备管理」->「设备列表」->「导入」。

image-20230510095308378

  • 选择组织,设备类型和产品。

image-20230510095549947

注意:网关子设备的话,需要选择网关设备。

image-20230510095610778

  • 上传设备CSV文件。

注意:CSV文件在第一步模板下载后进行修改,编辑,第二步上传。

image-20230510095720070

  • 文件格式如下。

image-20230308142301795

image-20230510095805837

  • data1和data2(可以自行修改)中的值为设备可选择的类型值(data1选择列类型为访问令牌,则访问令牌的值为CSV文件里的admin和admin1,分别属于device11和debice22)。

image-20230510095847584

  • 服务器属性:几乎所有平台实体都支持这种类型的属性:设备、资产、客户、租户、用户等等。服务器端属性是您可以通过管理UI或REST API配置的属性。设备固件无法访问服务器端属性。
  • 共享属性:这种类型的属性仅对设备可用。它类似于服务器端属性,但有一个重要的区别。设备固件/应用程序可以请求共享属性的值或订阅属性的更新。通过MQTT或其他双向通信协议通信的设备可以订阅属性更新并实时接收通知。通过HTTP或其他请求-响应通信协议进行通信的设备可以定期请求共享属性的值。

image-20230308142558665

  • 点击下一步。

image-20230313165314973

  • 导入设备成功,回界面看是否设备新增成功。

image-20230510095935549

image-20230510100014003

  • 点击详情,查看设备访问令牌(管理设备凭证),此时访问令牌的值为data中的admin值。

image-20230510100427982

  • 如果说导入时选择红框内MQTT三项中的任何一个,与新增设备时的协议相互对应,data1和data2列下的值为选择列类型的值。

image-20230313165350942

image-20230313165507268

  • 导入设备后,data1为admin1,data2为password1。

image-20230327144812520

  • 为X.509时,data1为RSA公钥。

image-20230310104842478

image-20230310160555312

image-20230310104933303

  • 也可以添加新的列名称和列类型来进行导入,导入界面就新增了可以多选需要的功能。

image-20230310114346689

image-20230510100621951

地理位置

  • 点击「设备管理」->「地理位置」。

  • 用户可以通过设备组织,产品和设备名称,设备所属状态,设备告警状态来进行查询并显示在下拉框。

image-20230510100930790

  • 直接点击下拉框里面的设备。

image-20230510101024465

  • 点击设备信息,会显示设备详细信息,物模型(也就是数据,产品里面发布上线的属性)和告警(网关设备为图二)。

image-20230510101040278

image-20230510101116724

  • 点击历史数据,显示为设备物模型数据,可进行筛选。

image-20221208160901788

1
https://gitee.com/thingskit/thingskit-docs.git
git@gitee.com:thingskit/thingskit-docs.git
thingskit
thingskit-docs
ThingsKit物联网平台文档
master

搜索帮助