onenet云平台是什么（onenet设备云）

OneNET Studio云平台是中移推出的新版本平台，与旧平台数据不能互通。所以在登陆云平台控制台的时候，选择接入平台的时候，要注意选择的是哪个版本的平台。因为平台所使用到的服务器域名或者IP端口是不一样的。本文将介绍4G 模块ML302的DTU版本连接登陆OneNET Studio 云平台。本次实验使用到的开发板是小蓝鲸物联科技的4G通信板ML302-MD-DTU。新用户需要自行注册平台账号，此处不作介绍。

OneNET Studio 云平台

OneNET Studio 控制台界面概览

4G通信板ML302MD-DTU

硬件接线方式：VIN GND接5V~12V电源 ,KEY引脚接GND。TD0和RD0是数据通信串口引脚UART。通信板上模组内部的PWK引脚已经默认接GND，实现上电自动开机。模块具有自适应波特率功能。本次调试采用115200波特率。

ML302通过MQTT协议连接OneNET Studio云平台操作流程

第一步：在OneNET Studio云平台上创建产品和设备。

点击进入“控制台”界面，左侧栏目找到“设备接入与管理”并点击，选择“产品管理”，然后在右上方找到“添加产品”并点击。

产品管理界面

添加产品

产品类别选择

产品添加成功

以上就是产品的创建，本次实验模拟温度采集设备上传云平台。产品类别，这里选择智能仪表。产品采用直连方式登陆，连接协议选择MQTT，数据通信协议为OneJason, 联网方式为蜂窝网络（即4G 网络），下面介绍设备添加。

在左侧找到“设备管理”并点击，然后在右上角找到“添加设备”并点击。

设备管理

添加设备

添加设备要选择对应的所属产品，设备位置信息可以自己定义选择。设备添加成功，设备初始状态为“未激活” ，只要设备首次登陆成功平台，即可激活设备，状态会立即更新在线状态。当设备断开连接，平台则显示已经离线。

设备添加成功

创建完产品和设备后，我们需要记录好需要的产品ID和设备ID及设备秘钥。点击设备右侧的详情，可以查看详细设备的信息。产品ID号为jvyXzK7zgo，设备ID号为LBWIOT001，设备秘钥：aRISN0bEku6KScvcHhYHhZPfhlxP6efGJ778yl6eOkU= 这是MQTT协议连接云平台需要用到的客户端ID、用户名、密码登陆的三个参数。

查看设备详情

根据OneNET Studio云平台登陆规则，要求设备访问登陆要进行安全认证。产品、设备创建时，平台为每类产品、每个设备均分配了唯一的 key，设备登录时需要使用通过key计算出的访问token 来进行访问安全认证。有专门提供了一个token工具。 OneNET Studio云平台的MQTT服务器域名studio-mqtt.heclouds.com，端口号为1883 （非加密端口接入）

服务器IP和端口号

token 工具

在OneNET Studio 文档中心 目录–“接入安全认证” 文档介绍中可下载token工具。

token工具

第二步：设备鉴权参数按照token算法进行加密计算得出token 值

token 算法规则

这里面有一个要求，需要用到时间戳（访问过期时间expirationTime）单位为秒。请自行百度查找该工具。过期时间要比现在时间要后，不能是过去时间。比如今天是5月16日，那么访问过期时间是5月16日之后。经转换得到 et=1653020058 秒。

时间戳在线转换工具

依据res格式：products/{产品id}/devices/{设备名字} 描述，得到res=products/jvyXzK7zgo/devices/LBWIOT001 ,version 版本默认为2018-10-31 。综合所述，得到如下值：

version = 2018-10-31

et=1653020058

res=products/jvyXzK7zgo/devices/LBWIOT001

method=md5

key=aRISN0bEku6KScvcHhYHhZPfhlxP6efGJ778yl6eOkU=

利用token工具所得token值为version=2018-10-31&res=products%2FjvyXzK7zgo%2Fdevices%2FLBWIOT001&et=1653020058&method=md5&sign=V20E9N2ysfCacK3%2FSeuOYg%3D%3D ，该值是MQTT秘钥参数输入值，MQTT DTU指令会用到。

token工具加密计算

第三步：配置MQTT指令参数，连接OneNET Studio云平台。

设置模块进入MQTT工作模式，发设置指令@set@net@1###，然后再发保存指令@config@para@save### 等待模块自动重启，收到“@rightcode@network ready###” 即可开始发送配置指令。

①服务器配置：@set@server@studio-mqtt.heclouds.com,1883,LBWIOT001,60###

配置服务器IP和端口

②配置用户名和密码：@set@user@jvyXzK7zgo,version=2018-10-31&res=products%2FjvyXzK7zgo%2Fdevices%2FLBWIOT001&et=1653020058&method=md5&sign=V20E9N2ysfCacK3%2FSeuOYg%3D%3D,0### 此处的密码就是输入token值。

用户名密码设置

③设置会话模式：@set@remain@1,2018-10-31###

设置会话模式

④设置非遗嘱工作模式：@set@will@0,0,0,0,0###

设置非遗嘱模式

⑤发送保存指令：@config@para@save###

保存参数并自动重启

以上完成了MQTT参数配置，保存后，模块自动重启，会自动登陆云平台。平台显示设备登陆成功。

mqtt平台登陆成功

第四步：向云平台上传温度数据。

首先要设置温度设备在平台上的数据功能点。注意温度精确值为0.1℃

设置物模型

删除原有的物模型数据功能点

添加自定义数据功能点

保存自定义数据功能点

根据OneNET Studio云平台通信主题Topic使用说明如下：

通信主题Topic列表

温度采集仪表主动上报温度数据，属于设备属性上报。发布主题和订阅主题格式分别如下：

发布主题：$sys/{pid}/{device-name}/thing/property/post

订阅主题：$sys/{pid}/{device-name}/thing/property/post/reply

综上所述可知，订阅主题为$sys/jvyXzK7zgo/LBWIOT001/thing/property/post/reply

发布主题为$sys/jvyXzK7zgo/LBWIOT001/thing/property/post

{pid}是指产品ID号，{device-name}是指设备ID。注意不能填写错误。

OneJSON协议是针对物联网开发领域设计的一种数据交换规范，数据格式是JSON，用于设备端和物联网平台的双向通信，更便捷地实现和规范了设备端和物联网平台之间的业务数据交互。OneNET Studio云平台OneJSON数据格式示例如下截图：

OneJSON数据格式

由于我们的温度采集仪表是只有一个数据功能点temp，假如设备采集到的温度是26.9℃，所以发送数据内容为：{"id": "01","params": {"temp": { "value": 26.9}}} ，为了让模块也能收到服务器下发来的消息，则要订阅该主题$sys/jvyXzK7zgo/LBWIOT001/thing/property/post/reply

①订阅主题:@set@sub@$sys/jvyXzK7zgo/LBWIOT001/thing/property/post/reply,0###

订阅主题

②发布消息: @set@pub@$sys/jvyXzK7zgo/LBWIOT001/thing/property/post,0,0,0,{"id": "01","params": {"temp": { "value": 26.9}}}###

发布消息

平台接收到了温度数据

MQTT连接平台，调试期间，请做好记录，方便查看调试，截图如下：

文档记录

4G DTU模块ML302-DTU

以上就是4G 模块登陆OneNET Studio云平台操作教程，仅供参考学习。云平台有很多功能，这里不做过多介绍，详细了解请登陆OneNET官网查阅。欢迎大家评论区交流，如有遇到疑问，可以关注私信本人，一对一的提供技术支持。商务合作，请私信。