使用移讯通YeeCOM DTU设备接入中移Onenet云平台说明(基于MQTT...

yeecom123

YeeCOM DTU使用MQTT协议连[size=18.6667px]中移[size=18.6667px]OneNet云平台说明

YeeCOM DTU支持了MQTT 协议3.1.4和3.1.1版本，可以方便、快捷、稳定的连接支持MQTT协议的云平台。

我司现在支持了连接百度云、阿里云、OneNet云等基于MQTT协议的物联网云平台，也可以基于开源的MQTT Server自己搭建的私有云（推荐），原理都大同小异，下面以我司DTU连接OneNet平台MQTT协议做连接测试说明。

(请使用我司全功能协议产品，将DTU工作模式配置到11-MQTT中移OneNet）

友情提醒1：数据收发，DTU会自动转换为MQTT协议数据进行收发，对于DTU使用者来说都是透明传输，无需关心具体的MQTT协议转换过程，大大简化了使用者的工作量，以达到快速联网目的。

友情提醒2：该文档主要介绍基于我司DTU怎么配置参数可以快速的连接云平台和实现数据收发；

友情提醒3：由于云平台众多，我司无法一一对平台接口做很详细透彻的研究，具体云平台相关接口调用和应用开发，不属于我司传输设备技术支持范围，请联系平台方技术支持，感谢理解和支持。

一、OneNet云平台说明：

OneNet云平台注册，

登录https://open.iot.10086.cn/并注册账户和配置相关产品设备；选择MQTT协议

当前只支持Onenet标准MQTT协议，请选择如下选项。暂时不支持MQTTS非标协议

file:///C:/Users/ADMINI~1/AppData/Local/Temp/msohtmlclip1/01/clip_image002.jpg

DTU连接平台服务器地址 183.230.40.39，TCP 端口 6002

在产品详情找到产品ID和Master-APIKey如下参数：

file:///C:/Users/ADMINI~1/AppData/Local/Temp/msohtmlclip1/01/clip_image004.jpg

设备管理里面找到设备ID：

file:///C:/Users/ADMINI~1/AppData/Local/Temp/msohtmlclip1/01/clip_image006.jpg

其他产品配置，请参考云平台厂家提供的相关资料说明。

3. DTU的参数配置

只需要简单配置几个参数，即可通过MQTT协议连接对应云平台

通过配置工具配置DTU(具体参数参考2里面的图片说明),如下图（其他参数采用默认值即可）：

file:///C:/Users/ADMINI~1/AppData/Local/Temp/msohtmlclip1/01/clip_image008.jpg

查询GPRS状态，返回+GSTATE:1说明DTU已经连接到服务器平台，可以在串口输入框里面模拟发送一段数据；

4.正常连接上云平台后，通过测试，可以看到DTU串口和平台都可以正常接收和发送数据。

正常在线后，设备管理里面设备对应的图标会变绿。

例如：要发送给平台数据流ID为012_1（平台里面配置）数据值为2.3

则其Json的数据格式为{"012_1":2.3}，转换为对应的平台能识别的16进制数据为：

03 00 0d 7b 22 30 31 32 5f31 22 3a 32 2e 33 7d

第1位03：表示数据点类型指示：type=3    // JSON格式2字符串；

第2,3位00 0d：表示后面的数据长度为0x0d

后面的7b 22 30 31 32 5f 31 223a 32 2e 33 7d为{"012_1":2.3}对应16进制数据；

（其他更详细具体数据格式说明请参考OneNet相关文档）

file:///C:/Users/ADMINI~1/AppData/Local/Temp/msohtmlclip1/01/clip_image010.jpg

file:///C:/Users/ADMINI~1/AppData/Local/Temp/msohtmlclip1/01/clip_image012.jpg

可以看到数据ID为012_1收到的数据的曲线图，说明数据可以正常发送；

file:///C:/Users/ADMINI~1/AppData/Local/Temp/msohtmlclip1/01/clip_image014.jpg

三、DTU配置指令及参数说明

也可以通过指令配置相关参数，主要配置如下指令，其他参数使用默认值即可

1.DTU工作模式

DTU工作模式必须配置为11-MQTT中移OneNet，指令格式请参考《DTU配置指令手册》。

指令格式： AT*WKMODE=11#

2.DTUID

配置为OneNet对应设备ID，指令格式请参考《DTU配置指令手册》

指令格式：AT*DTUID=<对应设备ID>#

2.DTU中心地址

使用TCP方式，中心地址和端口参考平台对应的地址和端口，

指令格式请参考《DTU配置指令手册》。

指令格式： AT*SERVER1=<connect type>,<ip addr>,<port>#

3.配置产品ID和APIKey

命令描述：

用来配置对应产品ID和Master-APIKey，参考云平台生成的参数；

命令格式：

命令	返回
AT*MQUSR=<产品ID>,<Master-APIKey>#	OK    ERROR
AT*MQUSR?	+MQUSR: <产品ID>,<Master-APIKey>    OK

参数说明:

<产品ID>:参考云平台生成的参数

<Master-APIKey>：参考云平台生成的参数；

3.配置主题

参考MQTT配置资料手册；

四、OneNet还支持其他协议，原理一样，请具体参考平台配置说明。

1.TCP透传模式

只需要将DTU工作模式，配置为透明传输模式，

IP地址和端口为平台对应地址端口；

DTU注册包配置，格式如下：*$PID#$AUTH_INFO#$PARSER_NAME*

参数解释如下：

PID：产品ID，创建产品时OneNET生成的产品唯一性数字标识

AUTH_INFO：设备鉴权信息，在设备注册时，用户创建设备时指定的唯一字符串标识

PARSER_NAME：用户自定义解析脚本的名称，用户上传脚本时指定的唯一字符串标识 若建立连接成功，可以看到设备在线标记

示例： *221094#devicekey#testlua*

配置如下图：

file:///C:/Users/ADMINI~1/AppData/Local/Temp/msohtmlclip1/01/clip_image016.gif

2.其他协议，参考平台配置说明

五、若使用其他平台，原理一样，请具体参考平台配置说明。

友情特别说明：

我司主要为客户提供基于主流协议的传输通道终端产品，让客户能简单、快速、稳定、可靠的联网，各种服务端基本开发流程请自行参考平台官方网站，我司不提供服务端技术开发支持服务，请理解。

我司可以提供平台软件定制开发。