OneNet软件包用户手册指南（上）

OneNET 软件包介绍

OneNET 平台是中国移动基于物联网产业打造的生态平台，具有高并发可用、多协议接入、丰富 API 支持、数据安全存储、快速应用孵化等特点，同时，OneNET 平台还提供全方位支撑，加速用户产品的开发速度。

OneNET平台是一个基于物联网产业特点打造的生态环境，可以适配各种网络环境和协议类型，现在支持的协议有LWM2M（NB-IOT）、EDP、MQTT、HTTP、MODBUS、JT\T808、TCP透传、RGMP等。用户可以根据不同的应用场景选择不同的接入协议。

该组件包是 RT-Thread 系统针对 OneNET 平台连接的适配，通过这个组件包可以让设备在 RT-Thread 上非常方便的连接 OneNet 平台，完成数据的发送、接收、设备的注册和控制等功能。

文件目录结构

OneNET 软件包功能特点

RT-Thread OneNET 软件包功能特点如下：

断线重连

RT-Thread OneNET 软件包实现了断线重连机制，在断网或网络不稳定导致连接断开时，会维护登陆状态，重新连接，并自动登陆 OneNET 平台。提高连接的可靠性，增加了软件包的易用性。

自动注册

RT-Thread OneNET 软件包实现了设备自动注册功能。不需要在 web 页面上手动的一个一个创建设备，输入设备名字和鉴权信息。当开启设备注册功能后，设备第一次登陆 OneNET 平台时，会自动调用注册函数向 OneNET 平台注册设备，并将返回的设备信息保存下来，用于下次登陆。

自定义响应函数

RT-Thread OneNET 软件包提供了一个命令响应回调函数，当 OneNET 平台下发命令后，RT-Thread 会自动调用命令响应回调函数，用户处理完命令后，返回要发送的响应内容，RT-Thread 会自动将响应发回 OneNET 平台。

自定义 topic 和回调函数

RT-Thread OneNET 软件包除了可以响应 OneNET 官方 topic 下发的命令外，还可以订阅用户自定义的 topic，并为每个 topic 单独设置一个命令处理回调函数。方便用户开发自定义功能。

上传二进制数据

RT-Thread OneNET 软件包除了上传数字和字符串外，还支持二进制文件上传。当启用了 RT-Thread 的文件系统后，可以直接将文件系统内的文件以二进制的方式上传至云端。

OneNET 工作原理

OneNET 软件包数据的上传和命令的接收是基于 MQTT 实现的，OneNET 的初始化其实就是 MQTT 客户端的初始化，初始化完成后，MQTT 客户端会自动连接 OneNET 平台。数据的上传其实就是往特定的 topic 发布消息。当服务器有命令或者响应需要下发时，会将消息推送给设备。

获取数据流、数据点，发布命令则是基于 HTTP Client 实现的，通过 POST 或 GET 将相应的请求发送给 OneNET 平台，OneNET 将对应的数据返回，这样，我们就能在网页上或者手机 APP 上看到设备上传的数据了。

下图是应用显示设备上传数据的流程图

下图是应用下发命令给设备的流程图

OneNET 示例应用程序

准备工作

在 OneNET 云上注册账号

设备接入 OneNET 云之前，需要在平台注册用户账号，OneNET 云平台地址：https://open.iot.10086.cn

创建产品

账号注册登录成功后，点击开发者中心进入开发者中心界面；

点击 创建产品 ，输入产品基本参数，页面最下方设备接入协议选择 MQTT 协议，如下图所示：

产品创建成功之后，可以在开发者中心左侧产品概况中查看产品基础信息（如产品ID，接入协议，创建时间，产品 APIkey 等，后面有用）。

接入设备

在开发者中心左侧设备管理中点击添加设备按钮添加设备，设备名称我们填入test1。鉴权信息是为了区分每一个不同的设备，如果创建了多个设备，要确保每个设备的鉴权信息都不一样，我们这里填入201807171718,填完之后点击接入设备

添加 APIkey

接入设备之后，可以看到设备管理的界面多了一个设备，设备的右边有一些操作设备的按钮，点击查看详情按钮

此设备的相关信息就都显示出来了，比如：设备 ID、鉴权信息、设备 APIkey，这些信息需要记下，在ENV配置时会用到。

点击按钮添加 APIkey，APIKey 的名称一般和设备相关联，我们这里填入test_APIKey，关联设备写入我们刚刚创建的设备test1。

开启 onenet 软件包

打开 env 工具输入 menuconfig 按照下面的路径开启 onenet 软件包

RT-Thread online packages

IoT - internet of things --->

IoT Cloud --->

[*] OneNET: China Mobile OneNet cloud SDK for RT-Thread

进入 onenet 软件包的配置菜单按下图所示配置，里面的信息依据自己的产品和设备的实际情况填写

--- OneNET: China Mobile OneNet cloud SDK for RT-Thread

[ ] Enable OneNET sample

[*] Enable support MQTT protocol

[ ] Enable OneNET automatic register device (NEW)

(35936966) device id

(201807171718) auth info

(H3ak5Bbl0NxpW3QVVe33InnPxOg=) api key

(156418) product id

(dVZ=ZjVJvGjXIUDsbropzg1a8Dw=) master/product apikey (NEW)

version (latest) --->

Enable OneNET sample ：开启 OneNET 示例代码

Enable support MQTT protocol ：开启 MQTT 协议连接 OneNET 支持

Enable OneNET automatic register device ：开启 OneNET 自动注册设备功能

device id ：配置云端创建设备时获取的 设备ID

auth info ：配置云端创建产品时 用户自定义的鉴权信息 (每个产品的每个设备唯一)

api key ：配置云端创建设备时获取的 APIkey

product id ：配置云端创建产品时获取的 产品ID

master/product apikey ：配置云端创建产品时获取的 产品APIKey

示例文件介绍

利用 ENV 生成工程后，我们可以在工程的 onenet 目录下看到onenet_sample.c文件，该文件是 OneNET 软件包的示例展示，主要是展示用户如何使用 OneNET 软件包上传数据和接收命令。

运行示例

在使用 OneNET 软件包之前必须要先调用onenet_mqtt_init这个命令进行初始化，初始化完成后设备会自动连接 OneNET 平台。

msh />onenet_mqtt_init

[D/ONENET] (mqtt_connect_callback:85) Enter mqtt_connect_callback!

[D/[MQTT] ] ipv4 address port: 6002

[D/[MQTT] ] HOST = '183.230.40.39'

[I/ONENET] RT-Thread OneNET package(V0.2.0) initialize success.

msh />[I/[MQTT] ] MQTT server connect success

[D/ONENET] (mqtt_online_callback:90) Enter mqtt_online_callback!

上传数据

初始化完成后，用户可以调用onenet_upload_cycle这个命令周期性的往云平台上传数据。输入这个命令后，设备会每隔 5s 向数据流 temperature 上传一个随机值。并将上传的数据打印到 shell 窗口。

msh />onenet_upload_cycle

msh />[D/ONENET] (onenet_upload_data:106) buffer : {"temperature":32}

[D/ONENET] (onenet_upload_data:106) buffer : {"temperature":51}

我们打开 OneNET 平台，在设备管理的界面点击数据流管理按钮进入数据流界面。

点击temperature数据流右边的小箭头显示数据流信息，我们就可以看到刚刚上传的数据了。

如果用户想往别的数据流发送信息，可以使用以下 API 往云平台上传数据。

onenet_mqtt_publish_digitonenet_mqtt_publish_string

命令格式如下所示

onenet_mqtt_publish_digit 数据流名称 要上传的数据

onenet_mqtt_publish_string 数据流名称 要上传的字符串

输入命令后没有返回错误信息就表示上传成功。

示例如下

msh />onenet_mqtt_publish_digit test 1

msh />onenet_mqtt_publish_string test 1

msh />onenet_mqtt_publish_digit test 2

msh />onenet_mqtt_publish_string test 1

在数据流管理页面，我们可以看到多出来个 test 数据流，里面的数据就是我们刚刚上传的数据。

接收命令

在初始化时，命令响应回调函数默认指向了空，想要接收命令，必须设置命令响应回调函数，在 shell 中输入命令onenet_set_cmd_rsp,就把示例文件里的命令响应回调函数挂载上了，这个响应函数在接收到命令后会把命令打印出来。

msh />onenet_set_cmd_rsp

我们点击设备管理界面的发送命令按钮。

在弹出来的窗口里输出 hello rt-thread！，然后点击发送命令。

就可以在 shell 中看到云平台下发的命令了。

msh />onenet_set_cmd_rsp

msh />[D/ONENET] (mqtt_callback:60) topic $creq/6db0c1b2-9a7e-5e4a-8897-bf62d4a3461f

receive a message

[D/ONENET] (mqtt_callback:62) message length is 18

[D/ONENET] (onenet_cmd_rsp_cb:107) recv data is hello rt-thread！

原作者：RT-Thread 软件包手册