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

 

MQTT简介

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

 

在MQTT中,主要有三个角色:

 

角色 说明
发布者(Publish) 发送消息的一方,可以为一个应用程序或一台设备
代理(Broker)(服务器) 管理消息队列的一方,位于消息发布者和订阅者之间
订阅者(Subscribe) 订阅主题的一方,主要用于接收消息

 

 

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 软件也可以连接其他物联网平台,比如阿里云物联网平台,感兴趣的可以自己试试哈~