设备管理

创建产品

菜单路径

产品与服务→物联网服务→设备管理→产品。

操作步骤

1.登录浪潮云服务控制台

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“产品”,进入产品列表页面。

4.点击"+ 创建产品",完成产品信息填写。 如表1所示。

表1 属性说明

属性 属性说明
所属项目 产品的所属项目。
产品名称 产品的名称。名称只能包含中文、数字、字母和"-"或"_",1-36个字符。
节点类型 支持三种类型:
  • 直连设备:指不能挂载子设备的设备。这种设备可以直接连接物联网平台。
  • 网关:指可以挂载子设备的设备。网关能直接连接物联网平台且具有子设备管理模块,能够代理子设备连接云端。
  • 子设备:本质上也是设备,但子设备不能直接连接物联网平台,只能通过网关连接。
产品模板 预定义好的标准产品模板;若需要完全自定义该产品的功能,选择“自定义品类”。
数据格式 设备上下行的数据格式,可选择透传/自定义。
  • 透传/自定义:如果您希望使用自定义的串口数据格式,可以选择透传/自定义。
描述 产品的描述信息,最多能输入255位字符。

5.点击“确认”按钮,可完成产品的创建并将自动返回产品列表页面。

6.点击“取消”按钮,返回到产品列表页面。列表中的基本操作如表2

表2 基本操作

操作名称 操作 详解
查看 点击“产品ID“ 查看产品,包括:
  • 基本信息
  • 功能定义
  • 消息通信
  • 服务端订阅
编辑 点击”编辑“ 编辑产品信息。
删除 点击”删除“ 删除产品。

1)“基本信息”标签页面中展示了产品基本信息、标签信息、产品秘钥以及动态注册开关,标签信息可编辑,支持添加、修改和删除,产品秘钥可以重置。

2)“功能定义”标签页面中展示了产品功能。产品功能可根据需求添加、修改和删除。

3)“消息通信”标签页面中展示了用于与云端交互的Topic模板,产品下的设备将继承并实现这些Topic。

4)“服务端订阅”标签页面中展示了服务端对设备消息的订阅权限,用户通过订阅消息实时获得设备变化信息,包含证书下载以及订阅(取消订阅)功能。

创建产品标签

产品标签通常描述的是对一个产品下所有设备所具有的共性信息。如产品的制造商、所属单位、外观尺寸、操作系统等。需在创建产品后,再为该产品添加产品标签。

菜单路径

产品与服务→物联网服务→设备管理→产品→产品ID。

操作步骤

1.登录浪潮云服务控制台

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“产品”,进入产品列表页面。

4.点击对应产品ID,进入产品详情页。

5.点击“+ 添加标签”,填写标签信息。 如表3所示。

表3 属性说明

属性 属性说明
标签key 标签key值,只能包含数字、字母和特殊字符中的"_",1-36个字符。
显示名称 标签名称,只能包含中文、数字、字母和特殊字符中的"-"或"_",1-36个字符。
标签value 标签value值,1-36个字符。

6.点击“确认”按钮,可完成产品标签的创建。

创建功能

菜单路径

产品与服务→物联网服务→设备管理→产品→产品ID→功能定义。

操作步骤

1.登录浪潮云服务控制台

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“产品”,进入产品列表页面。

4.点击对应产品ID,进入产品详情页,选择“功能定义”标签页。

5.点击“+ 添加功能”,填写功能信息,如表4所示。

表4 属性说明

属性 属性说明
功能名称 功能的名称,同一产品下功能名称不能重复。1-36个字符,只能包含中文、数字、字母和特殊字符中的"-"或"_"。
标识符 属性唯一标识符,在产品中具有唯一性。1-36个字符,只能包含数字、字母和特殊字符中的"_",并且不能以数字开头。
数据类型
  • int:整型。需定义取值范围、步长和单位符号。
  • float:单精度浮点型。需定义取值范围、步长和单位符号。
  • double:双精度浮点型。需定义取值范围、步长和单位符号。
  • enum:枚举型。定义枚举项的参数值和参数描述,如 1-加热模式、2-制冷模式。
  • bool:布尔型。采用 0 或 1 来定义布尔值,如 0-关、1-开。
  • text:字符串。需定义字符串的数据长度。
  • date:时间戳。格式为 string 类型的 UTC 时间戳,单位:毫秒。
步长 属性值输入输出参数值变化的最小粒度。数据类型为int、float、double时,需要设置步长。
单位 单位可选择为无或根据实际情况选择。
读写类型
  • 读写:请求读写的方法支持 GET(获取)和 SET(设置)。
  • 只读:请求只读的方法仅支持 GET(获取)。
描述 功能的描述信息,最多能输入255位字符。

6.点击“确认”按钮,可完成功能的添加。

导入物模型

菜单路径

产品与服务→物联网服务→设备管理→产品→产品ID→功能定义。

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“产品”,进入产品列表页面。

4.点击对应产品ID,进入产品详情页,选择“功能定义”标签页。

5.点击“导入物模型”,物模型支持两种导入方式,如物模型导入方式所示。

物模型导入方式 属性说明

方式 方式说明
拷贝产品 选择已有产品,单击确定,即可将已有产品的物模型导入到此产品中。如果需要修改某些功能,单击功能对应的编辑按钮,即可修改该功能。
导入物模型 将自定义的物模型脚本粘贴进编辑框中,然后单击确定

6.点击“确认”按钮,可完成功能的添加。

注意:导入物模型后,会覆盖该产品原有的功能定义。请谨慎使用。

添加topic类

菜单路径

产品与服务→物联网服务→设备管理→产品→产品ID→消息通信。

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“产品”,进入产品列表页面。

4.点击对应产品ID,进入产品详情页,选择“消息通信”标签页。

5.点击“+ 添加Topic类”,填写Topic类信息,如Topic类表所示。

Topic类表 属性说明

属性 属性说明
设备操作权限 设备对该Topic的操作权限,可设置为发布、订阅、发布和订阅。
Topic类 Topic类的自定义类目名称。1-64个字符,只能包含字母、数字和特殊字符中的"- _ /"、+和#(仅权限是订阅时支持)。
描述 Topic类的描述信息,最多能输入255位字符,可以为空。

6.点击“确认”按钮,可完成Topic类的添加。

服务端订阅

菜单路径

产品与服务→物联网服务→设备管理→产品→产品ID→产品详情→服务端订阅

操作步骤

1.登录浪潮云服务控制台

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“产品”,进入设备产品页面。

4.点击对应产品ID,选择“服务端订阅”标签页,页面信息如表5所示。

表5 服务端订阅页面说明

字段名称 说明
连接地址 服务端连接MQTT的地址
端口号 连接MQTT的端口号
下载证书 证书名称以及下载服务端连接证书
订阅消息类型 系统支持的服务端订阅的类型
主题 该产品的服务端订阅支持的主题
状态 服务端订阅该消息类型的状态
操作 订阅、取消订阅相应的消息

5.选择相应的订阅消息类型,订阅主题

6.下载证书,使用MQTT客户端连接

注意事项

1.用户服务端通过服务端client证书连接EMQ,接收订阅的消息

2.同一产品最多允许用户服务器同时建立5个MQTT客户端与平台建立MQTT连接

3.clientId规则:以证书名称(-替换为@)开始,例:svrsub@iotol9592xu@wr2p76c4

重置产品秘钥

菜单路径

产品与服务→物联网服务→设备管理→产品→产品ID→产品详情。

操作步骤

1.登录浪潮云服务控制台

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“产品”,进入设备产品页面。

4.点击对应产品ID,选择“基本信息”标签页。

5.点击“显示”,再点击“重置”。注意:只有节点类型为网关和直连设备的产品才具有产品秘钥。

动态注册

菜单路径

产品与服务→物联网服务→设备管理→产品→产品ID→产品详情。

操作步骤

1.登录浪潮云服务控制台

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“产品”,进入设备产品页面。

4.点击对应产品ID,选择“基本信息”标签页。

5.点击“开”。注意:只有节点类型为网关和直连设备的产品才具有“开/关”按钮。

创建设备

菜单路径

产品与服务→物联网服务→设备管理→设备。

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“设备”,进入设备列表页面。

4.选择设备所属项目,点击“+ 添加设备”,填写设备信息。 如表6所示。

表6 属性说明

属性 属性说明
所属产品 设备的模板,新创建的设备将继承该产品定义好的功能、标签和特性。
设备编码 设备的编码,自动生成。编码只能包含数字、字母和"_",1-36个字符,并且不能以数字开头。
备注名称 备注名称只能包含中文、大小写字母、数字和特殊字符中的"-"或"_",0-36个字符
描述 设备的描述信息,最多能输入255位字符。

5.点击“提交”按钮,完成创建项目下的一个设备。

6.点击“返回”按钮,返回到设备列表页面。列表中的基本操作如表7

表7 基本操作

操作名称 操作 详解
查看 点击“设备编码” 查看设备,包括:
  • 设备详情
  • 运行状态
  • Topic列表
  • 设备影子
  • 配置信息:直连设备和网关才具有配置信息
  • 子设备:网关才具有子设备
编辑 点击“编辑” 编辑设备信息。
删除 点击“删除” 删除设备。
禁用/启用 点击“禁用/启用” 点击禁用后,设备将不能连接到平台;点击启用后,设备才可以连接到平台。

7.点击对应的设备编码,进入设备详情,单击证书名称后的下载,可下载设备的证书。

设备tab表 设备tab描述

列表项 描述
设备详情 “设备详情”标签页中展示设备的基本信息和标签信息,标签信息分为自定义的标签信息和继承自产品的标签信息。自定义的标签信息支持添加、修改和删除;继承自产品的标签信息只支持编辑,编辑该标签信息不会影响产品的标签信息。
运行状态 “运行状态”标签页中展示设备的实时运行状态,可手动点击“刷新”,或打开“实时刷新”按钮,每5秒刷新一次。
Topic列表 “Topic列表”标签页中展示设备与云端交互的Topic列表。
设备影子 “设备影子”标签页面中展示影子状态和元数据,支持刷新和清空影子操作。
  • 影子状态显示的是该设备最近上报上来的最新实时数据。
  • 元数据展示的是设备最近上报上来的最新实时数据的时间戳。
配置信息 “配置信息”标签页中展示用于二次开发的配置文件信息。
子设备 ”子设备“标签页中展示网关关联的子设备,支持建立关联和解除关联。

批量创建设备

菜单路径

产品与服务→物联网服务→设备管理→设备。

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“设备”,进入设备列表页面。

4.选择设备所属项目,点击“批量添加”。

5.选择一个已创建的产品。选择后,新创建的设备将继承该产品的功能和特性。

6.选择设备名称的添加方式。添加方式如表8

表8 方式说明

方式 方式说明
自动生成 您无需为要创建的设备指定编码,您只需填写设备数量,系统将为每个设备自动生成设备编码。
批量上传 您需为每个要创建的设备指定名称。选择为批量上传后,您可以单击页面上蓝色字体的下载模板下载模板。在模板表格中输入设备编码、备注名称、设备描述并保存,然后单击选择,将已填好设备名称的表格上传至控制台。

7.点击“确认”按钮,完成批量创建设备。

8.点击对应的设备编码,进入设备详情,单击证书名称后的下载,可下载设备的证书。

批量删除设备

菜单路径

产品与服务→物联网服务→设备管理→设备。

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“设备”,进入设备列表页面。

4.选择需要批量删除的设备,点击“批量删除”。

5.弹出批量删除确认框,点击“确认”。

自定义设备标签

根据设备的特性为设备添加特有的标签,方便对设备进行管理。

菜单路径

产品与服务→物联网服务→设备管理→设备→设备编码。

操作步骤

1.登录浪潮云服务控制台

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“设备”,进入设备列表页面。

4.点击对应设备编码,进入设备详情页。

5.点击“+ 添加标签”,填写标签信息。 如表9所示。

表9 属性说明

属性 属性说明
标签key 标签key值,只能包含数字、字母和特殊字符中的"_",1-36个字符。
标签name 标签名称,只能包含中文、数字、字母和特殊字符中的"-"或"_",1-36个字符。
标签value 标签value值,1-36个字符。

6.点击“确认”按钮,可完成设备自定义标签的创建。

子设备

菜单路径

产品与服务→物联网服务→设备管理→设备→设备编码→子设备。

操作步骤

1.登录浪潮云服务控制台

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“设备”,进入设备列表页面。

4.点击对应设备编码,选择"子设备"标签页。注意:只有节点类型为网关的设备才具有“子设备”标签页。

5.点击”+添加子设备”,勾选需要添加的子设备,将会得到分页展示列表,包括全部子设备(除绑定自身的子设备)、全部未绑定的子设备、全部已绑定的子设备(除绑定自身的子设备),通过勾选需要添加的子设备可以绑定未绑定的子设备或绑定到其他网关的子设备,如果绑定其他网关的子设备,该子设备将与原设备解绑。详见创建设备

注意:网关绑定或者解绑子设备,相应的网关需要重新连接EMQ服务器,子设备主题权限才会生效,否则可能引起无法发布/订阅子设备权限等问题

重置证书

菜单路径

产品与服务→物联网服务→设备管理→设备→设备编码→设备详情。

操作步骤

1.登录浪潮云服务控制台

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“设备”,进入设备列表页面。

4.点击对应设备编码,选择"设备详情"标签页。

5.点击“重置证书”。注意:只有节点类型为网关和直连设备的设备才具有“重置证书”按钮。

创建分组

菜单路径

产品与服务→物联网服务→设备管理→分组。

操作步骤

1.登录浪潮云服务控制台。

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“分组”,进入分组列表页面。

4.点击“+ 创建分组”,填写分组信息。 如表10所示。

表10 属性说明

属性 属性说明
父分组 选择所属上级分组,最顶级为根分组
分组名称 名称只能包含中文、大小写字母、数字和特殊字符中的"-"或"_",0-36个字符
描述 设备的描述信息,最多能输入255位字符。

5.点击“确定”按钮,完成创建。

6.点击“返回”按钮,返回到分组列表页面。列表中的基本操作如表11

表11 基本操作

操作名称 操作 详解
查看 点击“编码” 查看分组,包括:
  • 分组详情
  • 设备列表
  • 子分组列表
编辑 点击“编辑” 编辑分组信息。
删除 点击“删除” 删除分组。

7.点击对应的分组编码,进入分组详情,单击分组层级后面的分组名称,可跳转至对应分组详情

设备tab表 设备tab描述

列表项 描述
分组详情 “分组详情”标签页中展示分组的基本信息。
设备列表 “设备列表”标签页中展示该分组下的所有设备,支持建立关联和解除关联。。
子分组列表 “子分组列表”标签页中展示该分组下直属的子分组。支持创建新分组与查看分组详情。

分组下设备列表

菜单路径

产品与服务→物联网服务→设备管理→分组→分组编码→设备列表。

操作步骤

1.登录浪潮云服务控制台

2.点击“产品与服务”选择“物联网服务”>“设备管理”,进入设备管理操作界面。

3.点击菜单项“分组”,进入分组列表页面。

4.点击对应分组编码,选择"设备列表"标签页。

5.点击”+添加设备到分组”,将会得到分页展示列表,包括全部设备(除绑定自身的设备),通过勾选需要添加的设备可以绑定未绑定的设备或绑定到其他分组的设备,每个设备最多添加至10个分组内,每个分组内最多10000个。

6.勾选要从分组中删除的设备,然后点击从分组中删除,即可从分组中批量删除设备。