Question

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

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

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

文件目录结构

OneNET
│   README.md                       // 软件包使用说明
│   SConscript                      // RT-Thread 默认的构建脚本
├───docs 
│   └───figures                     // 文档使用图片
│   │   api.md                      // API 使用说明
│   │   introduction.md             // 软件包详细介绍
│   │   principle.md                // 实现原理
│   │   README.md                   // 文档结构说明
│   │   samples.md                  // 软件包示例
│   │   user-guide.md               // 使用说明
│   │   port.md                     // 移植说明文档
│   └───version.md                  // 版本
├───ports                           // 移植文件                 
│   └───rt_ota_key_port.c           // 移植文件模板
├───samples                         // 示例代码
│   └───onenet_sample.c             // 软件包应用示例代码
├───inc                             // 头文件
└───src                             // 源文件

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 的文件系统后，可以直接将文件系统内的文件以二进制的方式上传至云端。