OneNet接入用户手册--实战篇v1.0

1/66OneNet接入用户手册—实战篇v1.02/66目录1.准备工作...........................................................................................................................31.1接入流程总览......................................................................................................................31.2用户注册..............................................................................................................................32.添加设备...........................................................................................................................53.通信方式选择....................................................................................................................94.用调试工具连接平台........................................................................................................94.1GPRS方式...........................................................................................................................114.1.1硬件准备...................................................................................................................124.1.2串口配置...................................................................................................................144.1.3RestFulAPI上传数据.................................................................................................164.1.4EDP协议上传数据.....................................................................................................204.2WIFI方式............................................................................................................................254.2.1准备工作....................................................................................................................254.2.2串口配置...................................................................................................................264.2.3RestFulAPI上传数据.................................................................................................264.2.4EDP方式上传数据.....................................................................................................284.3以太网口............................................................................................................................314.3.1准备工作....................................................................................................................314.3.2RestFulAPI上传数据.................................................................................................324.3.3EDP方式上传数据.....................................................................................................325.硬件选择.........................................................................................................................356.代码实例.........................................................................................................................366.1ONENET数据上传（EDP协议）.........................................................................................376.2数据（透传）转发（EDP协议）.....................................................................................406.3RESTFULAPI数据上传.................................................................................................476.4事件告警（触发器使用）.................................................................................................527.添加应用.........................................................................................................................598.常见问题.........................................................................................................................643/661.准备工作1.1接入流程总览OneNet接入过程大致如下：开始用户注册数据上传结束终端和服务器建立TCP连接设备创建用户要接入OneNet，首先要在OneNet平台上进行注册用户、创建设备等一系列准备工作，然后要通过网络和OneNet服务器建立TCP连接，最后将用户数据按照一定的协议(比如：EDP、RestFulAPI)打包上传至OneNet平台，从而实现设备终端接入。1.2用户注册在接入OneNet之前，需在平台网站注册用户账户，登陆网址：，显示如下界面：4/66点击云平台入口”马上接入”：注册账号并登陆：5/662.添加设备用户注册账号并登陆后，进入“设备管理”入口，点击“添加一个设备”进行设备创建：输入设备创建信息:6/66EDP扩展信息设置界面如下，其中默认路由在使用EDP协议进行数据转发是才进行设置：平台收到EDP数据消息，若EDP数据包中的目的地址长度为0，即没有目的地址，则平台将该消息转发到设备注册时的默认目的地址即默认路由。添加数据流:7/66在一个设备下面可以连续添加多个数据流，如下图，我们添加了sys_time、bin_data两个数据流。我们可以为我们的设备添加多个不同的ApiKey，这些ApiKey可以分发给不同的终端设备，平台使用ApiKey对终端设备进行数据访问鉴权，当要限制某个终端设备访问平台数据的时候，可以改变或者删除分配给该终端设备的ApiKey，那么该终端设备就无法对平台数据进行操作。这里我们联系添加了两个ApiKey，添加第一个ApiKey8/66如下图：添加第二个ApiKey：在触发器模块当中添加触发器，对设定条件的事件告警进行监控，触发器的原理是：一旦监控的数据流数据满足设定的条件，就会触发一个HTTP请求，将异常事件的内容发送给设定的服务器，所以用户9/66如果要使用触发器功能，必须建立自己的HTTP服务器，触发器添加如下图所示：3.通信方式选择设备终端接入OneNet平台的通信方式也是多种多样的，比较常用的有GPRS、无线WIFI、以太网口。GPRS方式需要GPRS模块和SIM卡的支持，无线WIFI模块需要WIFI模块支持。4.用调试工具连接平台为了熟悉设备云的接入过程，用户可以在PC机上使用测试工具手动连接平台，并向指定设备传输数据，三种通信方式（GPRS、无线WIFI、以太网口）下，连接平台的操作过程略有不同，下面对三种方式接入设备云过程依次进行说明。我们的目标是向设备云平台设备ID为131658的设备下sys_time10/66数据流传输数据一个整型数据50。运用ApiKey1作为该设备上传数据的ApiKey。RestFulAPI基于HTTP协议（详见）和json数据格式（详见），适合平台资源管理、平台与平台之间数据对接、使用短连接上报终端数据、时间序列化数据存储等场景，EDP协议基于TCP协议的，该协议只传输数据包到达目的地，不保证传输的顺序与到达的顺序相同，事务机制需要在上层实现；若客户端同时发起两次请求，服务器返回时，不保障返回报文的顺序。，EDP协议适合于数据的长连接上报、透传、转发、存储、数据主动下发等场景。下面分别讲述在PC机上使用测试工具运用RestFulAPI方式和EDP方式手动连接平台，并向指定设备传输数据上传数据过程，旨在让大家了解数据上传的基本过程和原理。按照RestFul方