与OneNET服务器连接初体验

要想与OneNET服务器相连，我们首先要了解一下什么是MQTT。

MQTT简介

MQTT (Message Queuing Telemetry Transport )，是由IBM开发的轻量级消息传输协议，相比其他通讯协议，MQTT更适合物联网场景。

在MQTT中，主要有三个角色：

MQTT传输的消息分为：主题（Topic--区分不同消息）和负载（payload--消息内容）两部分。

MQTT协议采用发布/订阅（Publish/Subscribe）模式，MQTT是应用层的协议，其底层为TCP协议，TCP是传输层协议，云端（服务器端）通过主题（Topic）的方式管理各个物联网设备的订阅，实现将设备与设备之间消息进行转发。

MQTT协议适合场景：

• 客户端数量众多每次消息传输的数据量不大协议占用资源小，能够方便移植到单片机等硬件上提供不同等级的“服务质量--Qos”在低带宽、高延迟、不可靠的网络和资源有限的硬件环境下，进行相对可靠的数据传输支持一对多的消息分发

一般物联网平台都是支持MQTT协议的，比如我们今天要接入的OneNET——中国移动物联网开放平台，也是支持MQTT协议的，具体支持的协议包括以下几种：

我们今天就看看基于MQTT协议，如何能够接入OneNET服务器。

MQTT.fx简介

OneNET平台相当于MQTT中的Broker（服务器），要想实现与OneNET平台连接，我们需要一个客户端，而MQTT.fx是目前最常用的MQTT客户端，我们使用的MQTT.fx的版本为1.7.1。

MQTT.fx软件下载后，默认安装即可，安装完毕的软件界面如下：

创建产品和设备

注册并登录 OneNET 平台的控制台，网址为：

https://open.iot.10086.cn/console/

在后台的 文档中心-->MQTT物联网套件(新版)-->快速入门  版块：

我们找到如下有用信息：

创建产品

参考官网文档：

https://open.iot.10086.cn/doc/mqtt/book/get-start/product&device/createProduct.html

创建设备

参考官方文档：

https://open.iot.10086.cn/doc/mqtt/book/get-start/product&device/createDevice.html

我们按照上面网文教程创建一个产品和一个测试设备：

服务器地址

OneNET物联网平台的地址和端口在下面链接获取：

https://open.iot.10086.cn/doc/iot_platform/book/device-connect&manager/MQTT/mqtt-device-development.html

Broker Address：studio-mqtt.heclouds.com

Broker Port：1883

进入与MQTT服务器连接配置界面之后，将地址和端口填写到下图所示位置：

其他部分配置信息说明：

Profile Name：可以随便命名，我命名为：OneNET

Profile Type：保持默认设置，MQTT Broker

Broker Address：MQTT服务器的地址，studio-mqtt.heclouds.com

Broker Port：服务器端口，1883

Client ID：客户端ID，此处填写 设备名称 ：XiaoHaLED

General 标签下的内容，MQTT Version后面的复选框取消，其他默认即可。

填写用户凭证信息

在 User Credentials 标签页下面，需要我们填写 User Name 和 Password 。

其中，User Name 就是产品管理页面的产品ID ，对应我创建的测试设备就是：hg8zt6E3LP 。

Password 处应该填写鉴权信息，此处即为一个token。

生成token

token的介绍

token算法详解参考下面链接：

https://open.iot.10086.cn/doc/mqtt/book/manual/auth/token.html

token生成工具

OneNET提供了token生成的上位机软件，可以通过下面链接下载并使用：

https://open.iot.10086.cn/doc/mqtt/book/manual/auth/tool.html

其中：res：products/{pid}/devices/{device_name}

上面是 res 的值由产品ID和设备名称组成，通过上面我们知道，我们创建的测试设备的产品ID值为：hg8zt6E3LP ，设备名称 的值为：XiaoHaLED 。

所以，最终res 的值为：products/hg8zt6E3LP/devices/XiaoHaLED

et：expiration time ，表示过期时间，此时间要求大于当前时间，为了避免太快过期，可以适当加大此参数数值，此处为unix时间。

简单来说，unix时间戳就是从1970年1月1日（UTC/GMT的午夜）开始所经过的秒数。

除了使用程序获得当前unix时间以外，还可以使用网上现成的 unix时间戳 << >> 北京时间 转换的在线工具完成，比如下面的网址即可：

https://tool.lu/timestamp/

2021-12-27 16:38:28 <==> et：1640594308

key：这个参数就是 产品key 这个参数，所在位置如下图所示：

其他参数默认即可。

将上面得到的 res 、 et 、 key 代入 token计算工具 软件中，点击 Generate 按钮：

生成的字符串即为 User Credentials 标签页下面， Password 文本框内需要填写的内容，即填写如下内容：

version=2018-10-31&res=products%2Fhg8zt6E3LP%2Fdevices%2FXiaoHaLED&et=1640594308&method=md5&sign=yBG2008b6SMfxiW6q6KmnA%3D%3D

其他参数默认即可，然后点击 OK 退出配置页面。

连接OneNET服务器

下图下拉列表中，选择刚刚创建的Profile Name：OneNET，点击“Connect”按钮，成功连接至OneNET平台服务器，效果如下图所示：

连接之后，我们查看OneNET控制台，在 设备接入与管理-->设备管理 页面，可以看到 XiaoHaLED 设备已经处于在线状态。

好了，我们已经顺利连接上了OneNET服务器，今天的分享就到这里，用这个 MQTT.fx 软件也可以连接其他物联网平台，比如阿里云物联网平台，感兴趣的可以自己试试哈~