中国移动物联网开放平台OneNET学习笔记（2）——设备接入测试（MQTT协议）OneNET Studio篇

一、创建产品与设备

1.1 创建产品

进入Studio平台后，展开菜单栏中的「设备接入与管理」，点击「设备管理」，进入设备列表页面。
点击「添加设备」，选中单个设备（默认方式）输入设备详情，点击「确定」创建设备。

按照提示填写产品的基本信息，进行产品创建；请按照提示尽可能完整、全面地填写相应内容，这样更方便您后期对产品进行管理，接入协议选择 MQTT 协议。

1.2 创建设备

进入Studio平台后，展开菜单栏中的「设备接入与管理」，点击「设备管理」，进入设备列表页面。
点击「添加设备」，选中单个设备（默认方式）输入设备详情，点击「确定」创建设备。

编辑「设备名称」与 「设备描述」，点击「确定」，完成添加设备。

二、配置MQTT客户端

MQTT X 是一款开源 5.0 桌面测试客户端，它支持在 macOS，Linux，Windows 操作系统上运行。

MQTT X 支持创建多个同时在线的 MQTT 客户端，方便用户快速测试 MQTT/TCP、MQTT/TLS 、MQTT/WebSocket 的连接/发布/订阅功能及其他 MQTT 协议特性。

• 下载MQTT X

EMQ官网下载：https://www.emqx.com/zh/try?product=MQTTX

• 打开MQTT X客户端，进入客户端配置页面

• Client ID： 填写设备名称
  
• 服务器地址： 填写 studio-mqtt.heclouds.com
  
• 用户名： 填写产品ID
  
• 密码： 填写token ，算法参见接入安全认证

Token由多个参数构成，如下表：

平台提供Token生成工具（点击下载）

• MQTT版本：必须为 3.1.1

三、设备连接

点击连接，此时，设备在页面处于在线状态。

四、属性上报

4.1 订阅属性上报结果通知topic

为了确保设备上传消息确实被平台所接受处理，设备可以订阅系统 topic 获取属性上报结果消息，属性上报回复topic为：$sys/{pid}/{device-name}/thing/property/post/reply

4.2 发布属性上报topic

属性上报的topic为：$sys/{pid}/{device-name}/thing/property/post
上报数据成功后，订阅的属性上报会返回success

OneJSON请求数据格式：

{
    "id": "123",
    "version": "1.0",
    "params": {
        "CurrentVoltage": {
            "value": 5.0,
            "time": 1660720877111
        },
        "CurrentTemperature": {
            "value": 23.6,
            "time": 1660720877111
        }   
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

请求参数说明：

我们进入产品管理-详情页面，选择两个属性的标识符，如当前电压 CurrentVoltage 和当前温度 CurrentTemperature。



页面设备管理-设备详情，查看设备上报的属性数据。

五、属性下发

5.1 订阅设备属性设置topic

设备侧需要收到平台下发的数据，需要订阅：$sys/{pid}/{device-name}/thing/property/set


在页面运维监控-设备调试中-下行数据调试，可进行设置设备属性。

5.2 发布设备属性设置结果通知topic

topic: $sys/{pid}/{device-name}/thing/property/set_reply

{
    "id": "2",
    "code":200,
    "msg":"success"
}
1
2
3
4
5

其中id为下行数据的id，需要匹配，code为200代表成功，msg可以自定义。

六、事件上报

6.1 订阅事件上报结果通知topic

为了确保事件上传消息确实被平台所接受处理，设备可以订阅系统 topic 获取事件上报结果消息，属性上报回复topic为：$sys/{pid}/{device-name}/thing/event/post/reply。
上报数据成功后，订阅的事件上报会返回success。

6.2 发布事件上报topic

上报事件topic为：$sys/{pid}/{device-name}/thing/event/post

OneJSON请求数据格式：

{
	"id": "123",
	"version": "1.0",
	"params": {
		"HumAlarm": {
			"value": {
				"Type": 1
			},
			"time": 1660720877111
		}
		
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13

请求参数说明：

我们进入产品管理-详情页面，选择一个事件的标识符，如湿度报警 HumAlarm。



页面设备管理-设备详情，查看设备上报的事件数据。

七、获取设备期望值

7.1 订阅获取设备期望值结果通知topic

设备侧需要收到平台下发的期望值，需要订阅：$sys/{pid}/{device-name}/thing/property/desired/get/reply

7.2 发布设备获取期望值topic

获取设备期望值的topic为：$sys/{pid}/{device-name}/thing/property/desired/get

OneJSON数据格式：

{
    "id" : "123",
    "version":"1.0",
    "params" : [
        "MaxTempSet"
    ]
}
1
2
3
4
5
6
7

请求参数说明：

页面设置期望值：

---

• 由 Leung 写于 2022 年 8 月 19 日