OneNET文档中心

快速开始

OneNET作为中国移动通信集团推出的第一个也是唯一一个专业的物联网开放云平台,提供了丰富的智能硬件开发工具和可靠的服务,助力各类终端设备迅速接入网络,实现数据传输、数据存储、数据管理等完整的交互流程。


简介


本文档只从逻辑上简单梳理设备真正接入OneNET之前,在平台侧需要做的准备工作,目的在于让初次使用OneNET的用户了解设备接入OneNET的前期流程。

下面将详细介绍,希望帮助您更加快速地在OneNET上创建您的产品,即您真实的硬件产品在平台的对应。


用户注册


为了使用OneNET设备云的强大功能,您首要做的是在OneNET上注册您的开发者账号,来创建您专属的“开发者中心”;

点击首页右上角的“注册”按钮,注册用户账号;

填写用户名、用户密码、有效邮箱地址(或者有效手机号码)等,点击获取验证码,打开邮箱邮件查看验证码,并完成注册;

OneNET支持“个人用户”和“企业用户”两种入驻方式,您可以根据您的实际情况选择注册方式;

注册完成后,回到主页点击“登录”,即可进入OneNET的官方主页,并由此进入到您的“开发者中心”。

产品创建


接下来,为了使用OneNET的强大功能和服务,您需要在OneNET平台上创建您的产品;

点击“开发者中心”,进入相应的“产品列表”管理页面,在这里您可以新建并管理您的产品;

点击右上角的 “创建产品”,在弹出页面中按照提示填写产品的基本信息,进行产品创建;

在创建过程中,请您按照提示尽可能完整、全面地填写相应内容,这样更方便您后期对产品进行管理;


在创建过程最后一步,系统会提示让您选择“设备接入方式”和“设备接入协议”,OneNET提供公开协议和私有协议两种产品类型,关于这两类协议,请看下面详细介绍。

协议介绍


OneNET作为一个开放的物联网服务平台,能够支持符合当前行业应用的多种协议的解析和转换。公开协议包括EDP、MODBUS、MQTT以及HTTP等。由于各协议都有其专门的详细的协议内容描述文档,因此这里只对协议做简单介绍。

公开协议

1.EDP协议

EDP协议(Enhanced Device Protocol)是OneNET平台根据物联网特点专门定制的完全公开的基于TCP的长连接协议,提供设备接入、加密传输、数据存储等功能,协议的特点和功能包括:

  • 长连接协议

  • 终端数据点上报,支持的数据点类型包括

    • 整型(int)

    • 浮点数(float)

    • 字符串(string)

    • JSON

    • 二进制数据

  • 平台数据下发

  • 端到端数据转发


2.Modbus协议

Modbus协议是应用于电子控制器上的一种通用工业标准协议。此协议支持传统的RS-232、RS-422、RS-485和以太网设备。典型工业设备包括 PLC、DTU等均使用Modbus协议作为它们之间的标准协议,协议的特点和功能包括:

  • 长连接协议

  • OneNET平台为Modbus主机

  • 通过单条数据流的属性确定单条下发命令的内容以及周期

  • 自动将终端上报的数据转化为数据流中的数据点

协议的典型应用场景如下:



3.MQTT协议

MQTT协议是一个面向物联网应用的即时通信协议,使用TCP/IP提供网络连接,能够对负载内容实现消息屏蔽传输,开销小,可以有效降低网络流量,协议的特点和功能包括:

  • 长连接协议

  • 终端数据点上报,支持的数据点类型包括:

    • 整型(int)

    • 浮点数(float)

    • 字符串(string)

    • JSON格式

  • 平台消息下发

  • 基于Topic的订阅、发布以及消息推送,可以实现设备间的消息单播以及组播


4.HTTP协议

OneNET支持设备采用HTTP 协议即遵循RestFul原则接入平台,协议具有接入鉴权、控制命令下发、告警出发等功能,适合平台与平台之间数据对接,特点和功能包括:

  • 短连接协议

  • 终端数据点上报,支持的数据点类型包括:

    • 整型(int)

    • 浮点数(float)

    • 字符串(string)

    • JSON格式

    • 二进制数据

  • 平台侧相关资源管理(见API接口文档)


5.JT/T808协议

OneNET基于JT/T808协议定义了一个扩展协议JTEXT,可以让已经基于JT/T808协议传输数据的设备快速接入平台,协议的特点和功能包括:

  • 交通部定制的用于车辆动态监控的标准通信协议

  • 设备和平台可以保持长连接,可及时检测设备的上/下线状态

  • 标准的“位置信息汇报”等消息格式,方便已支持JT/T808协议的终端快速接入平台

  • 基于“上/下数据透传”模式,可以灵活上传用户自定义的数据,查询数据最新响应


私有协议RGMP

考虑到尽可能简化开发者的开发流程,提高用户设备数据传输的安全性,OneNET为设备接入平台提供了专门的私有协议,即RGMP协议(Remote Gateway Management Protocol)。

RGMP 协议与公开协议最大的不同是OneNET平台不提供协议的报文说明,而是根据开发者定义的设备数据模型自动生成SDK源码,开发者将SDK嵌入到设备中,实现与平台的对接。

RGMP协议具有业务数据格式灵活、数据传输紧凑高效以及实时性高等优点,其主要特点和功能包括:

  • 私有的报文格式,保证数据安全性

  • 终端数据点上报,支持的数据点类型包括:

    • 整型(int)

    • 浮点数(float)

    • 字符串(string)

    • 二进制数据

    • 布尔值

  • 远程配置更新

  • 平台通知信息下发

  • 远程固件升级(OTA

协议的典型应用场景如下:

请根据您的产品功能需求,选择接入协议,点击“确定”按钮,完成产品创建。

创建完成后,在弹出的对话框可进一步创建设备或者返回到产品列表页面;

在产品列表页面会列出您创建的全部产品,可直接对各产品进行编辑删除操作,也可以点击产品名称,进入该产品的管理页面;


至此,您已经在OneNET上完成了产品的创建。

若您选择的是EDPMQTTHTTPModbus或者JT\T808作为接入协议,请进入公开协议产品指南了解详情;

若您选择的是RGMP作为接入协议,请进入私有协议产品指南了解详情。