本文通过使用模拟器来模拟设备,快速完成设备接入的流程,以方便用户快速熟悉平台各个功能的大致使用。
【注意】
此处只是简单使用了各个模块的部分基础功能,更多更详细的功能介绍可以参看文档后面的章节。

前提条件

  • 完成平台用户注册
  • 平台审核通过并分配账号

    MQTT设备接入快速体验

    第一步 创建产品

    image.png
    登录平台,进入”产品中心”-“产品开发”,点击左上角”创建产品”按钮。

    节点类型

    | 参数 | 值 | | —- | —- | | 节点类型 | 设备 | | 是否接入网关 | 否 |

联网与数据

参数
联网方式 Wi-Fi
交互协议 MQTT
数据格式 MLink
功能参数校验模式 严格模式

如表格所示填写相关信息,配置相关详情可参考创建产品。点击右边”创建”按钮完成创建。
此时回到”产品开发”可以看到刚刚创建的产品卡片。如图所示。
image.png
点击产品卡片,进入产品概览。点击”功能定义”,对产品功能进行定义。
image.png
image.png
点击”自定义参数”-“创建参数”,如上图编写参数。
image.png
再点击”分组”-“创建分组”,分别创建上报命令分组和下发命令分组。
上报命令分组:
image.png
下发命令分组:
image.png

第二步 创建设备

image.png
完成产品创建后,进入”产品中心”-“设备管理”,点击左上角”新增”按钮。
image.png
如图所示填写设备信息。其中”所属产品为第一步中创建的产品”。 “设备ID”则需要为唯一标识。
点击”确定”按钮完成设备创建。

第三步 获取连接信息

完成设备创建后,回到”产品中心”-“产品开发”中,点击第一步创建的产品卡片。进入产品概览,可以获取相应的连接信息。
image.png
其中主要使用到的参数是”设备接入信息”。 此例中用到的是MQTT接入方式:iot.gkiiot.com:1883
进入”设备管理”,选择创建的设备,点击”查看”。
image.png
即可查看设备详细信息。
image.png
如图所示可以得到设备的设备ID、设备所属产品pk以及devSecret。
点击”Topic列表”可以获得MQTT连接需要用到的Topic。 image.png
通过获取到的数据进行处理得到连接参数。处理方式参考MQTT协议接入。
此例中连接数据为:

参数名 参数值
服务器IP iot.gkiiot.com
服务器端口 1883
客户端ID dev:7C523bG2F4Fb6B5b:dev001

第四步 获取模拟器

image.png
MQTTBox是一款快速创建mqtt客户端的工具软件,请使用者自行到网络下载正版软件 。
此处使用的是MQTTBox模拟设备接入,也可以使用其他第三方模拟器MQTT.fx来进行模拟连接。若使用MQTT.fx,则可以参考使用MQTT.fx接入进行模拟。
【注意】:
MQTTBox的基本操作请提前熟悉。

第五步 设备模拟连接

按照第三步中获取的连接信息填写到MQTTBox中模拟设备连接。
image.png
此例中创建的产品不需要设备登录验证,所以不需要写Username和Password。
image.png
如图所示设备连接成功。
平台上,进入设备管理,查看创建的设备详情,点击”在线调试”。如图可以看到设备连接成功,右边消息跟踪获得了设备连接的数据。
image.png

第六步 云端命令下发

为接收到平台下发的命令,必须先在模拟器订阅下发命令的Topic,此例的Topic在第三步中获取到。
image.png
如图将Topic输入后点击”订阅”。
image.png
如上图订阅成功。
回到平台-“在线调试”
image.png
【1】:选择“下发”。
【2】:点击”设置湿度”中的湿度值文本框,如图写入30。(具体功能由创建产品时定义)
【3】:点击”立即发送”按钮发送命令。
【4】:平台显示下发日志。
此时在MQTTBox模拟器也可以顺利收到平台下发的命令。
image.png
如图所示:”humidity”为创建产品时创建的参数,数值为30。

第七步 设备数据上报

使用MQTTBox,对平台进行数据上报。在”发布(publish)”,填入第三步获取用以发布的Topic,以MLink格式写完数据后,点击”发布(Publish)”。
image.png
回到平台-“运行状态”可以看到平台收到了来自设备上报的数据。
image.png