创建项目

创建接入项目

1.点击“项目列表”,进入项目列表页面。

2.点击“+ 创建接入项目”,进入创建页面。

3.根据界面提示,填写项目的基本信息。如表 1所示。

表 1 属性说明

属性 属性说明 示例
项目名称 项目的名称。名称只能包含中文、数字、字母和"-",长度不超过 36。 示例项目
描述 项目的描述信息,最多能输入 255 位字符。 这是一个项目样例

4.点击“确定”按钮,即可完成一个项目的创建。

查看项目

1.点击项目,进入项目详情页面。

2.页面显示当前项目的基本信息,包括:当前项目各种设备的数量以及当前项目的连接信息等。

创建产品和设备

创建产品

1.点击“设备管理”>“产品”,进入产品页面。

2.点击“+ 创建产品”,进入创建页面。

3.根据界面提示,填写产品的基本信息。 如表 2所示。

表 2 属性说明

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

4.点击“确认”按钮,即可完成一个产品的创建。

创建设备并下载证书

1.点击“设备管理”>“设备”,进入设备列表页面。

2.选择设备所属项目,这里选择“示例项目”。

3.点击“+添加设备”,填写设备的基本信息。 如表 3所示。

表 3 属性说明

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

4.点击“确认”按钮,即可完成一个设备的创建并将自动返回设备列表页面。

5.点击“device-inst-example”,进入“设备详情”tab 页,点击证书名称后的“下载”按钮完成证书下载。

6.将下载的证书文件解压缩后得到 3 个文件备用。

表 4 证书文件说明

文件 说明
IoTRootCA.crt 根证书
principal-****.crt 客户端证书文件,即设备证书
principal-****.key 客户端密钥文件,即设备密钥

使用 MQTT.fx 接入

本教程使用 MQTT.fx 客户端工具,使用指定格式主题发送消息或订阅消息,验证设备与项目是否正常通讯。 MQTT.fx 是目前主流的 MQTT 桌面客户端,它支持 Windows, Mac, Linux,可以快速验证是否可以与浪潮云 IoT 进行连接并发布或订阅消息,下面将通过图文形式演示 MQTT.fx 如何与平台交互。

消息交互示意

设备主题权限列表

点击“设备管理”>“设备”,进入设备列表页面,进入对应设备详情页,点击“Topic 列表”tab 页查看设备的主题权限

连接 IoT Hub

MQTT.fx 下载页面

1、打开 MQTT.fx 下载页面,找到适合的版本下载并安装 MQTT.fx 客户端,本文以 MQTT.fx 1.7.1 for Windows 版本为例。 2、打开 MQTT.fx 客户端程序,点击设置按钮打开设置页面,并点击" + "按钮,创建一个新的配置文件。

3、填写 Connection Profile 相关信息和 General 信息。注意 Client ID 字段的填写,格式为"{项目编码}@{产品编码}@{设备编码}",例如:iotol9592xu@33cxb5tl@yqqdevice。

参数 说明
Profile Name 配置文件保存为的名称
Broker Address MQTT 服务器连接地址
Broker Port MQTT 服务器连接端口
Client ID MQTT 协议字段,按照约定好的规则填写
Connection Timeou 连接超时时间 秒
Keep Alive Interva 心跳间隔时间 秒
Auto Reconnect 断网自动重连

Broker Address 和 Broker Port 获取:点击“设备管理”>“设备”,进入设备列表页面,进入对应设备详情页,点击“配置信息”tab 页查看

4、选择开启 SSL/TLS,勾选 Self signed Certificates,上传相关内容。

文件 说明
ca.crt 根证书,对应“创建设备并下载证书” 步骤中保存的根证书
Client Certificate File 客户端证书文件,对应“创建设备并下载证书” 步骤中保存的设备证书
Client Key File 客户端密钥文件,即设备密钥,对应“创建设备并下载证书” 步骤中保存的设备秘钥
PEM Formatted 由于根证书、设备证书、设备密钥均由 openssl 生成使用 PEM 格式,而 MQTT.fx 是 Java 客户端,所以不识别 PEM 证书,这里需要勾选由该客户端自动转换为 Java 识别的 JKS 格式

5、完成以上步骤设置后,点击【Apply】和【OK】进行保存,并在配置文件框中选择刚才创建的文件名,点击【Connect】按钮。当右上角圆形图标为绿色时,说明已连接 IoT Hub 成功,可进行发布和订阅操作。

发布消息

选择客户端 Publish Tab,输入主题名称、Qos 等级,点击【Publish】按钮进行发布。发布结果可通过 Log Tab 查询。

以向平台上报设备上线通知为例:

设置发布主题,并发布信息到设备上线主题

{ "version":"1.0.0","iotGatewayCode": "device"}

查看 Log Tab,设备上报上线状态成功

在平台设备列表页查看设备状态,显示设备上线成功

订阅主题

选择客户端 Subscribe Tab,输入主题名称、Qos 等级,点击【Subscribe】按钮进行主题订阅,订阅结果可通过客户端 Log Tab 查询。

客户端订阅设备影子更新响应主题,当客户端发布设备影子更新被平台响应后,可在响应主题接收到订阅信息:

订阅设备影子更新响应主题

客户端发布设备影子更新

{"state":{"reported":{"temperature":"34"}},"clientToken":"12345678","timeStamp":1525309237000}

在客户端 Subscribe Tab 查看订阅消息

在平台设备详情页“设备影子”tab,点击“刷新”按钮,获取最新的设备影子状态数据

更多操作

更多消息交互操作请参考“消息交互示意” 、“设备主题权限列表”章节体验。